Select a current caption track from among available tracks

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.

TIP

Closed captions are always enabled. All default closed-caption tracks are considered to be present. Default tracks (such as CC1-CC4, CS1-CS6) are enumerated in ClosedCaptionsTrack.DefaultCCTypes. When playback begins, TVSDK looks for activity on any of these channels. If it finds activity, it sets the isActive method for that track and dispatches the MediaPlayer.PlaybackEventListener.onUpdated event.

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

  2. Listen for these events:

    • MediaPlayer.PlaybackEventListener.onStateChanged with state MediaPlayer.PlayerState.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 = 
          mediaPlayer.getCurrentItem().getClosedCaptionsTracks();
    
  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)) { 
            mediaPlayer.getCurrentItem().selectClosedCaptionsTrack(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

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now