media-sequence

HTML5 media sequenced playback API: play one or multiple sequences of a same audio or video with plain JavaScript.

Usage no npm install needed!

<script type="module">
  import mediaSequence from 'https://cdn.skypack.dev/media-sequence';
</script>

README

media-sequence

Manual and automatic HTML5 media sequenced playback. And plain JavaScript, no library required.

Installation

npm bower old school
npm install --save media-sequence bower install --save media-sequence download zip file

Usage

var sequences = [{start: 0, end: 5}, {start: 12, end: 13}, {start: 21, end: 31}];
var sequencer = new MediaSequence(new Audio('path/to/audio.ogg'), sequences);

sequencer.playAll();

API

new MediaSequence(el, sequences)

sequencer.add(sequences)

Adds new sequences to the actual stack.

sequencer.playAll()

Registers event listeners and starts the playback of all the sequences in a row.

sequencer.playFrom(start, end)

Starts the playback from the start time and stops automatically at the end time.

sequencer.getNext(referenceTime, options)

Returns the next sequence from a referenceTime numbered value.

var ms = new MediaSequencer(…, [{ start: 3, end: 5 }, { start: 12, end: 13 }]);

ms.getNext(0);
// { start: 3, end: 5 }

ms.getNext(3);
// { start: 12, end: 13 }

If the options.overlap value is set to true, the returned sequence is allowed to overlap:

var ms = new MediaSequencer(…, [{ start: 3, end: 5 }, {start: 3, end: 10 }, { start: 12, end: 13 }]);

ms.getNext(3);
// { start: 12, end: 13 }

ms.getNext(3, { overlap: true });
// {start: 3, end: 5 }

Licence

Copyright 2014 British Broadcasting Corporation

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.