Update javadoc for FLAG_READ_WITHIN_GOP_SAMPLE_DEPENDENCIES

Reflects that FLAG_READ_WITHIN_GOP_SAMPLE_DEPENDENCIES only parses
H.264 bitstream, and that H.265 parsing will be controlled with
another flag.

PiperOrigin-RevId: 712921990
This commit is contained in:
dancho 2025-01-07 08:31:02 -08:00 committed by Copybara-Service
parent ec50358784
commit 229aadc91b
3 changed files with 4 additions and 16 deletions

View File

@ -163,8 +163,8 @@ public final class BundledChunkExtractor implements ExtractorOutput, ChunkExtrac
} }
/** /**
* Sets whether within GOP sample dependency information should be parsed as part of extraction. * Sets whether within GOP sample dependency information for {@linkplain MimeTypes#VIDEO_H264
* Defaults to {@code false}. * H.264} video should be parsed as part of extraction. Defaults to {@code false}.
* *
* <p>Having access to additional sample dependency information can speed up seeking. See {@link * <p>Having access to additional sample dependency information can speed up seeking. See {@link
* FragmentedMp4Extractor#FLAG_READ_WITHIN_GOP_SAMPLE_DEPENDENCIES}. * FragmentedMp4Extractor#FLAG_READ_WITHIN_GOP_SAMPLE_DEPENDENCIES}.

View File

@ -137,7 +137,7 @@ public class FragmentedMp4Extractor implements Extractor {
/** /**
* Flag to extract additional sample dependency information, and mark output buffers with {@link * Flag to extract additional sample dependency information, and mark output buffers with {@link
* C#BUFFER_FLAG_NOT_DEPENDED_ON}. * C#BUFFER_FLAG_NOT_DEPENDED_ON} for {@linkplain MimeTypes#VIDEO_H264 H.264} video.
* *
* <p>This class always marks the samples at the start of each group of picture (GOP) with {@link * <p>This class always marks the samples at the start of each group of picture (GOP) with {@link
* C#BUFFER_FLAG_KEY_FRAME}. Usually, key frames can be decoded independently, without depending * C#BUFFER_FLAG_KEY_FRAME}. Usually, key frames can be decoded independently, without depending
@ -146,12 +146,6 @@ public class FragmentedMp4Extractor implements Extractor {
* <p>Setting this flag enables elementary stream parsing to identify disposable samples that are * <p>Setting this flag enables elementary stream parsing to identify disposable samples that are
* not depended on by other samples. Any disposable sample can be safely omitted, and the rest of * not depended on by other samples. Any disposable sample can be safely omitted, and the rest of
* the track will remain valid. * the track will remain valid.
*
* <p>Supported formats are:
*
* <ul>
* <li>{@linkplain MimeTypes#VIDEO_H264 H.264}
* </ul>
*/ */
public static final int FLAG_READ_WITHIN_GOP_SAMPLE_DEPENDENCIES = 1 << 6; // 64 public static final int FLAG_READ_WITHIN_GOP_SAMPLE_DEPENDENCIES = 1 << 6; // 64

View File

@ -138,7 +138,7 @@ public final class Mp4Extractor implements Extractor, SeekMap {
/** /**
* Flag to extract additional sample dependency information, and mark output buffers with {@link * Flag to extract additional sample dependency information, and mark output buffers with {@link
* C#BUFFER_FLAG_NOT_DEPENDED_ON}. * C#BUFFER_FLAG_NOT_DEPENDED_ON} for {@linkplain MimeTypes#VIDEO_H264 H.264} video.
* *
* <p>This class always marks the samples at the start of each group of picture (GOP) with {@link * <p>This class always marks the samples at the start of each group of picture (GOP) with {@link
* C#BUFFER_FLAG_KEY_FRAME}. Usually, key frames can be decoded independently, without depending * C#BUFFER_FLAG_KEY_FRAME}. Usually, key frames can be decoded independently, without depending
@ -147,12 +147,6 @@ public final class Mp4Extractor implements Extractor, SeekMap {
* <p>Setting this flag enables elementary stream parsing to identify disposable samples that are * <p>Setting this flag enables elementary stream parsing to identify disposable samples that are
* not depended on by other samples. Any disposable sample can be safely omitted, and the rest of * not depended on by other samples. Any disposable sample can be safely omitted, and the rest of
* the track will remain valid. * the track will remain valid.
*
* <p>Supported formats are:
*
* <ul>
* <li>{@linkplain MimeTypes#VIDEO_H264 H.264}
* </ul>
*/ */
public static final int FLAG_READ_WITHIN_GOP_SAMPLE_DEPENDENCIES = 1 << 5; public static final int FLAG_READ_WITHIN_GOP_SAMPLE_DEPENDENCIES = 1 << 5;