Commit 04341394 by olly Committed by Oliver Woodman

Add section to guide about track selection

-------------
Created by MOE: https://github.com/google/moe
MOE_MIGRATED_REVID=202948642
parent 8ca9a32d
...@@ -56,7 +56,7 @@ import org.checkerframework.checker.nullness.compatqual.NullableType; ...@@ -56,7 +56,7 @@ import org.checkerframework.checker.nullness.compatqual.NullableType;
* obtain a {@link ParametersBuilder} initialized with the current {@link Parameters}. The desired * obtain a {@link ParametersBuilder} initialized with the current {@link Parameters}. The desired
* modifications can be made on the builder, and the resulting {@link Parameters} can then be built * modifications can be made on the builder, and the resulting {@link Parameters} can then be built
* and set on the selector. For example the following code modifies the parameters to restrict video * and set on the selector. For example the following code modifies the parameters to restrict video
* track selections to SD, and to prefer German audio tracks: * track selections to SD, and to select a German audio track if there is one:
* *
* <pre>{@code * <pre>{@code
* // Build on the current parameters. * // Build on the current parameters.
...@@ -83,7 +83,7 @@ import org.checkerframework.checker.nullness.compatqual.NullableType; ...@@ -83,7 +83,7 @@ import org.checkerframework.checker.nullness.compatqual.NullableType;
* *
* Selection {@link Parameters} support many different options, some of which are described below. * Selection {@link Parameters} support many different options, some of which are described below.
* *
* <h3>Track selection overrides</h3> * <h3>Selecting specific tracks</h3>
* *
* Track selection overrides can be used to select specific tracks. To specify an override for a * Track selection overrides can be used to select specific tracks. To specify an override for a
* renderer, it's first necessary to obtain the tracks that have been mapped to it: * renderer, it's first necessary to obtain the tracks that have been mapped to it:
...@@ -110,13 +110,6 @@ import org.checkerframework.checker.nullness.compatqual.NullableType; ...@@ -110,13 +110,6 @@ import org.checkerframework.checker.nullness.compatqual.NullableType;
* .setSelectionOverride(rendererIndex, rendererTrackGroups, selectionOverride)); * .setSelectionOverride(rendererIndex, rendererTrackGroups, selectionOverride));
* }</pre> * }</pre>
* *
* <h3>Disabling renderers</h3>
*
* Renderers can be disabled using {@link ParametersBuilder#setRendererDisabled}. Disabling a
* renderer differs from setting a {@code null} override because the renderer is disabled
* unconditionally, whereas a {@code null} override is applied only when the track groups available
* to the renderer match the {@link TrackGroupArray} for which it was specified.
*
* <h3>Constraint based track selection</h3> * <h3>Constraint based track selection</h3>
* *
* Whilst track selection overrides make it possible to select specific tracks, the recommended way * Whilst track selection overrides make it possible to select specific tracks, the recommended way
...@@ -145,6 +138,13 @@ import org.checkerframework.checker.nullness.compatqual.NullableType; ...@@ -145,6 +138,13 @@ import org.checkerframework.checker.nullness.compatqual.NullableType;
* only applied to periods whose tracks match those for which the override was set. * only applied to periods whose tracks match those for which the override was set.
* </ul> * </ul>
* *
* <h3>Disabling renderers</h3>
*
* Renderers can be disabled using {@link ParametersBuilder#setRendererDisabled}. Disabling a
* renderer differs from setting a {@code null} override because the renderer is disabled
* unconditionally, whereas a {@code null} override is applied only when the track groups available
* to the renderer match the {@link TrackGroupArray} for which it was specified.
*
* <h3>Tunneling</h3> * <h3>Tunneling</h3>
* *
* Tunneled playback can be enabled in cases where the combination of renderers and selected tracks * Tunneled playback can be enabled in cases where the combination of renderers and selected tracks
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or sign in to comment