The SourceBuffer interface represents a chunk of media to be passed into an HTMLMediaElement and played, via a MediaSource object. This can be made up of one or several media segments.

Documentation SourceBuffer by Mozilla Contributors, licensed under CC-BY-SA 2.5.

See also:

Variables

appendWindowEnd:Float

Controls the timestamp for the end of the append window.

appendWindowStart:Float

Controls the timestamp for the start of the append window. This is a timestamp range that can be used to filter what media data is appended to the SourceBuffer. Coded media frames with timestamps within this range will be appended, whereas those outside the range will be filtered out.

read onlybuffered:TimeRanges

Returns the time ranges that are currently buffered in the SourceBuffer.

mode:SourceBufferAppendMode

Controls how the order of media segments in the SourceBuffer is handled, in terms of whether they can be appended in any order, or they have to be kept in a strict sequence.

onerror:Function

Fired whenever an error occurs during SourceBuffer.appendBuffer() or SourceBuffer.appendStream()SourceBuffer.updating changes from true to false.

onupdate:Function

Fired whenever SourceBuffer.appendBuffer() method or the SourceBuffer.remove() completes. SourceBuffer.updating changes from true to false. This event is fired before onupdateend.

onupdateend:Function

Fired whenever SourceBuffer.appendBuffer() method or the SourceBuffer.remove() has ended. This event is fired after onupdate.

onupdatestart:Function

Fired whenever the value of SourceBuffer.updating transitions from false to true.

timestampOffset:Float

Controls the offset applied to timestamps inside media segments that are subsequently appended to the SourceBuffer.

read onlyupdating:Bool

A boolean indicating whether the SourceBuffer is currently being updated — i.e. whether an SourceBuffer.appendBuffer(), SourceBuffer.appendStream(), or SourceBuffer.remove() operation is currently in progress.

Methods

abort():Void

Aborts the current segment and resets the segment parser.

Throws:

null

DOMError

appendBuffer(data:ArrayBufferView):Void

appendBuffer(data:ArrayBuffer):Void

Appends media segment data from an ArrayBuffer or ArrayBufferView object to the SourceBuffer.

Throws:

null

DOMError

changeType(type:String):Void

Changes the MIME type that future calls to SourceBuffer.appendBuffer will expect the new data to conform to.

Throws:

null

DOMError

remove(start:Float, end:Float):Void

Removes media segments within a specific time range from the SourceBuffer.

Throws:

null

DOMError

Inherited Variables

Inherited Methods

Defined by EventTarget

addEventListener(type:String, listener:Function, ?options:EitherType<AddEventListenerOptions, Bool>, ?wantsUntrusted:Bool):Void

addEventListener(type:String, listener:EventListener, ?options:EitherType<AddEventListenerOptions, Bool>, ?wantsUntrusted:Bool):Void

Register an event handler of a specific event type on the EventTarget.

Throws:

null

DOMError

dispatchEvent(event:Event):Bool

Dispatch an event to this EventTarget.

Throws:

null

DOMError

removeEventListener(type:String, listener:Function, ?options:EitherType<EventListenerOptions, Bool>):Void

removeEventListener(type:String, listener:EventListener, ?options:EitherType<EventListenerOptions, Bool>):Void

Removes an event listener from the EventTarget.

Throws:

null

DOMError