MediaSource: addSourceBuffer() メソッド
利用可能性は限定的
この機能はベースラインではありません。最も広く使用されているブラウザーの一部で動作しません。
Want more browser support for this feature? Tell us why.
addSourceBuffer() は MediaSource インターフェイスのメソッドで、指定された MIME タイプの新しい SourceBuffer を作成し、MediaSource の sourceBuffers リストに追加します。 新しい SourceBuffer も返されます。
構文
addSourceBuffer(mimeType)
引数
mimeType-
文字列で、
MediaSourceに作成して追加するSourceBufferの MIME タイプを指定します。
返値
作成され、メディアソースに追加された新しいソースバッファーを表す SourceBuffer オブジェクト。
例外
InvalidAccessErrorDOMException-
mimeTypeに指定された値は、有効な MIME タイプではなく空の文字列です。 InvalidStateErrorDOMException-
MediaSourceのreadyStateは"open"でありません。 NotSupportedErrorDOMException-
指定された
mimeTypeはユーザーエージェントでサポートされていないか、メディアソースのsourceBuffersリストに既に含まれている他のSourceBufferオブジェクトの MIME タイプと互換性がありません。 QuotaExceededErrorDOMException-
ユーザーエージェントはこれ以上
SourceBufferオブジェクトを処理できないか、指定されたmimeTypeを使用して新しいSourceBufferを作成すると、SourceBuffer の構成がサポートされなくなります。
例
次のスニペットは、Nick Desaulniers によって書かれた例からのものです（ライブで完全なデモを見るか、ソースをダウンロードしてさらに調査してください）。ここでは定義されていませんが、関数 getMediaSource() は MediaSource を返します。
const assetURL = "frag_bunny.mp4";
// Blink はコーデックに関して特定する必要がある
// ./mp4info frag_bunny.mp4 | grep Codec
const mimeCodec = 'video/mp4; codecs="avc1.42E01E, mp4a.40.2"';
const mediaSource = getMediaSource();
if ("MediaSource" in window && MediaSource.isTypeSupported(mimeCodec)) {
console.log(mediaSource.readyState); // closed
mediaSource.addEventListener("sourceopen", sourceOpen);
video.src = URL.createObjectURL(mediaSource);
} else {
console.error(
"サポートされていない MIME タイプまたはコーデック: ",
mimeCodec,
);
}
function sourceOpen() {
console.log(this.readyState); // open
const sourceBuffer = mediaSource.addSourceBuffer(mimeCodec);
fetchAB(assetURL, (buf) => {
sourceBuffer.addEventListener("updateend", () => {
mediaSource.endOfStream();
video.play();
console.log(mediaSource.readyState); // ended
});
sourceBuffer.appendBuffer(buf);
});
}
仕様書
| 仕様書 |
|---|
| Media Source Extensions™ # dom-mediasource-addsourcebuffer |