BinarySearchSeeker.TimestampSearchResult

Artifact: androidx.media3:media3-extractor

Kotlin |Java

public final class BinarySearchSeeker.TimestampSearchResult

Represents possible search results for searchForTimestamp.

Summary

Constants
`static final BinarySearchSeeker.TimestampSearchResult`	`NO_TIMESTAMP_IN_RANGE_RESULT`
`static final int`	`TYPE_NO_TIMESTAMP = -3` The search didn't find any timestamps.
`static final int`	`TYPE_POSITION_OVERESTIMATED = -1` The search found only timestamps larger than the target timestamp.
`static final int`	`TYPE_POSITION_UNDERESTIMATED = -2` The search found only timestamps smaller than the target timestamp.
`static final int`	`TYPE_TARGET_TIMESTAMP_FOUND = 0` The search found a timestamp that it deems close enough to the given target.

Public methods
`static BinarySearchSeeker.TimestampSearchResult`	`overestimatedResult( long newCeilingTimestamp, long newCeilingBytePosition )` Returns a result to signal that the current position in the input stream overestimates the true position of the target frame, and the `BinarySearchSeeker` should modify its `SeekOperationParams`'s ceiling timestamp and byte position using the given values.
`static BinarySearchSeeker.TimestampSearchResult`	`targetFoundResult(long resultBytePosition)` Returns a result to signal that the target timestamp has been found at `resultBytePosition`, and the seek operation can stop.
`static BinarySearchSeeker.TimestampSearchResult`	`underestimatedResult( long newFloorTimestamp, long newCeilingBytePosition )` Returns a result to signal that the current position in the input stream underestimates the true position of the target frame, and the `BinarySearchSeeker` should modify its `SeekOperationParams`'s floor timestamp and byte position using the given values.

Constants

NO_TIMESTAMP_IN_RANGE_RESULT

public static final BinarySearchSeeker.TimestampSearchResult NO_TIMESTAMP_IN_RANGE_RESULT

TYPE_NO_TIMESTAMP

public static final int TYPE_NO_TIMESTAMP = -3

The search didn't find any timestamps.

TYPE_POSITION_OVERESTIMATED

public static final int TYPE_POSITION_OVERESTIMATED = -1

The search found only timestamps larger than the target timestamp.

TYPE_POSITION_UNDERESTIMATED

public static final int TYPE_POSITION_UNDERESTIMATED = -2

The search found only timestamps smaller than the target timestamp.

TYPE_TARGET_TIMESTAMP_FOUND

public static final int TYPE_TARGET_TIMESTAMP_FOUND = 0

The search found a timestamp that it deems close enough to the given target.

Public methods

overestimatedResult

public static BinarySearchSeeker.TimestampSearchResult overestimatedResult(
    long newCeilingTimestamp,
    long newCeilingBytePosition
)

Returns a result to signal that the current position in the input stream overestimates the true position of the target frame, and the BinarySearchSeeker should modify its SeekOperationParams's ceiling timestamp and byte position using the given values.

targetFoundResult

public static BinarySearchSeeker.TimestampSearchResult targetFoundResult(long resultBytePosition)

Returns a result to signal that the target timestamp has been found at resultBytePosition, and the seek operation can stop.

underestimatedResult

public static BinarySearchSeeker.TimestampSearchResult underestimatedResult(
    long newFloorTimestamp,
    long newCeilingBytePosition
)

Returns a result to signal that the current position in the input stream underestimates the true position of the target frame, and the BinarySearchSeeker should modify its SeekOperationParams's floor timestamp and byte position using the given values.