TsUtil

Artifact: androidx.media3:media3-extractor

Kotlin |Java

@UnstableApi
public final class TsUtil

Utilities method for extracting MPEG-TS streams.

Summary

Public methods
`static int`	`findSyncBytePosition(byte[] data, int startPosition, int limitPosition)` Returns the position of the first TS_SYNC_BYTE within the range [startPosition, limitPosition) from the provided data array, or returns limitPosition if sync byte could not be found.
`static boolean`	`isStartOfTsPacket(byte[] data, int start, int limit, int searchPosition)` Returns whether a TS packet starts at `searchPosition` according to the MPEG-TS synchronization recommendations.
`static long`	`readPcrFromPacket( ParsableByteArray packetBuffer, int startOfPacket, int pcrPid )` Returns the PCR value read from a given TS packet.

Public methods

findSyncBytePosition

public static int findSyncBytePosition(byte[] data, int startPosition, int limitPosition)

Returns the position of the first TS_SYNC_BYTE within the range [startPosition, limitPosition) from the provided data array, or returns limitPosition if sync byte could not be found.

isStartOfTsPacket

public static boolean isStartOfTsPacket(byte[] data, int start, int limit, int searchPosition)

Returns whether a TS packet starts at searchPosition according to the MPEG-TS synchronization recommendations.

ISO/IEC 13818-1:2015 Annex G recommends that 5 sync bytes emulating the start of 5 consecutive TS packets should never occur as part of the TS packets' contents. So, this method returns true when data contains a sync byte at searchPosition, and said sync byte is also one of five consecutive sync bytes separated from each other by the size of a TS packet.

Parameters
`byte[] data`	The array holding the data to search in.
`int start`	The first valid position in `data` from which a sync byte can be read.
`int limit`	The first invalid position in `data`, after which no data should be read.
`int searchPosition`	The position to check for a TS packet start.

Returns
`boolean`	Whether a TS packet starts at `searchPosition`.

readPcrFromPacket

public static long readPcrFromPacket(
    ParsableByteArray packetBuffer,
    int startOfPacket,
    int pcrPid
)

Returns the PCR value read from a given TS packet.

Parameters
`ParsableByteArray packetBuffer`	The buffer that holds the packet.
`int startOfPacket`	The starting position of the packet in the buffer.
`int pcrPid`	The PID for valid packets that contain PCR values.

Returns
`long`	The PCR value read from the packet, if its PID is equal to `pcrPid` and it contains a valid PCR value. Returns `TIME_UNSET` otherwise.