Skip to main content

How to control audio track behavior

You can control which audio tracks are used for playback and whether audio tracks are automatically enabled when the player loads. This is useful when you want to choose which audio to play, or when you want to restrict playback to discrete audio files only.

Use cases​

  • Disable muxed audio: Forces playback from discrete audio files only, ignoring muxed audio tracks
  • Disable first track auto enable: Require manual enabling of audio tracks instead of auto-playing the first track
note

Which audio tracks/channels are enabled when the app loads can also be set with the components query parameter. This provides explicit control over which audio track and channels are active on startup.

  • Read about the Components Query Parameter here: Launch API: Components query parameter
  • The disableMuxedAudio and disableFirstTrackAutoEnable settings define the default behavior only
  • If the URL includes a components parameter, it takes precedence and will determine which audio tracks and channels are enabled regardless of these defaults.

Disable muxed audio tracks​

To disable playback of audio tracks that are muxed (embedded) in video files:

Disable muxed audio
{
  "settings": {
    "disableMuxedAudio": true
  }
}

When enabled, only discrete audio files will be available for playback (unless they are later activated in the UI). Audio tracks embedded in video files will be ignored.

Disable automatic audio enabling​

By default, the first audio track is automatically enabled when the player loads. To require manual selection:

Disable auto-enable first track
{
  "settings": {
    "disableFirstTrackAutoEnable": true
  }
}

When enabled, users must manually enable audio tracks from the audio track selector.

Combined configuration​

Both settings can be used together:

Full control over audio behavior
{
  "settings": {
    "disableMuxedAudio": true,
    "disableFirstTrackAutoEnable": true
  }
}

This configuration will:

  1. Only show discrete audio files in the timeline
  2. Require users to manually select which audio track to play
Try it out

Reference​

See reference for details: Launch template settings : Playback Options.