Select a current caption track from among available tracks

Last update: 2023-10-02

You can select a track from a list of currently available closed-caption tracks. This becomes the current track, which is displayed when visibility is on. Some tracks might not be available initially, so listen for the event that indicates that more have become available.

  1. Wait for the media player to be in at least the PREPARED status.

  2. Listen for these events:

    • MediaPlayerEvent.STATUS_CHANGED with status MediaPlayerStatus.INITIALIZED: The initial list of closed-caption tracks is available.
  3. Get a list of all currently available closed-caption tracks.

    For example:

    List<ClosedCaptionsTrack> ccTracks =
  4. Select an available track to be the current track.

    For example:

    // Select the initial CC track.
    for (int i = 0; i < ccTracks.size(); i++) {
        ClosedCaptionsTrack track = ccTracks.get(i);
        if (track.getName().equals(INITIAL_CC_TRACK)) {
              selectedClosedCaptionsIndex = i;
  5. Implement a listener for the event that indicates that more tracks are available. When TVSDK dispatches the event, retrieve the current list of available tracks.

    Retrieve the list each time that the event occurs to ensure that you always have the most current list.

On this page