@c3voc/clappr-audio-track-selector NPM

Clappr Audio Track Selector Plugin

Allows you to select the audio language in a multi-language stream. Designed to work with both HLS and MPEG-DASH video streams.

MPEG-Dash language selection requires the specially patched @c3voc/dash-shaka-playback.

Usage

Add both Clappr and Audio Track Selector plugin scripts to your HTML:

<head>
  <script type="text/javascript" src="http://cdn.clappr.io/latest/clappr.min.js"></script>
  <script type="text/javascript" src="dist/audio-track-selector.js"></script>
</head>

Then just add AudioTrackSelector into the list of plugins of your player instance:

var player = new Clappr.Player({
  source: "http://your.video/here.m3u8",
  plugins: {
    'core': [AudioTrackSelector]
  }
});

Compatibility

Only been tested on : PC: Firefox v52.0 Opera v30.0 Chrome/Chromium v56.0.2924 Mobile: Android v5.0.1 (Default Browser,Chrome) iOS v10.2.1 (Default Browser,Chrome,Opera Mini)

Sample m3u8 File:

#EXTM3U #EXT-X-VERSION:3 #EXT-X-ALLOW-CACHE:NO

#EXT-X-MEDIA:TYPE=AUDIO,GROUP-ID="main_audio",CODECS="mp4a.40.5",LANGUAGE="spa",NAME="Track 2 spa",DEFAULT=NO,URI="audio_2-hls.m3u8" #EXT-X-MEDIA:TYPE=AUDIO,GROUP-ID="main_audio",CODECS="mp4a.40.5",LANGUAGE="eng",NAME="Track 3 eng",DEFAULT=NO,URI="audio_3-hls.m3u8" #EXT-X-MEDIA:TYPE=AUDIO,GROUP-ID="main_audio",CODECS="mp4a.40.5",LANGUAGE="eng",NAME="Track 4 eng2",DEFAULT=NO,URI="audio_4-hls.m3u8" #EXT-X-MEDIA:TYPE=AUDIO,GROUP-ID="main_audio",CODECS="mp4a.40.5",LANGUAGE="deu",NAME="Track 1 deu",DEFAULT=YES,AUTOSELECT=YES,URI="audio_1-hls.m3u8"

#EXT-X-STREAM-INF:BANDWIDTH=1391346,RESOLUTION=1280x720,CODECS="avc1.4d001f,mp4a.40.5",AUDIO="main_audio" B7913837368DE745F53D31B4CA27BEE5-hls.m3u8 #EXT-X-STREAM-INF:BANDWIDTH=891346,RESOLUTION=854x480,CODECS="avc1.4d001f,mp4a.40.5",AUDIO="main_audio" 1B76D37AE0FD9054953FEDD89D7BA736-hls.m3u8

All the playbacks that follow these rules:

must trigger PLAYBACK_LEVELS_AVAILABLE with an ordered array of levels
to have a property levels, initialized with [] and then after filled with the proper levels
to have a property currentLevel (set/get), the level switch will happen when id (currentLevel) is changed (playback.currentLevel = id)
optionally, trigger events: PLAYBACK_LEVEL_SWITCH_START and PLAYBACK_LEVEL_SWITCH_END
id=-1 will be always the Auto level

clappr plugin

clappr clappr-zepto

@everything-registry/sub-chunk-151 @infinitebrahmanuniverse/nolb-_c3 @zalastax/nolb-_c3 @c3voc/player

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago