From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- files/ja/web/api/sourcebuffer/abort/index.html | 97 ++++++++++++++++++++++++++ 1 file changed, 97 insertions(+) create mode 100644 files/ja/web/api/sourcebuffer/abort/index.html (limited to 'files/ja/web/api/sourcebuffer/abort') diff --git a/files/ja/web/api/sourcebuffer/abort/index.html b/files/ja/web/api/sourcebuffer/abort/index.html new file mode 100644 index 0000000000..fc17a4e2a3 --- /dev/null +++ b/files/ja/web/api/sourcebuffer/abort/index.html @@ -0,0 +1,97 @@ +--- +title: SourceBuffer.abort() +slug: Web/API/SourceBuffer/abort +tags: + - API + - Audio + - Experimental + - MSE + - Media Source Extensions + - Method + - Reference + - SourceBuffer + - Video + - abort +translation_of: Web/API/SourceBuffer/abort +--- +
{{draft}}{{APIRef("Media Source Extensions")}}{{SeeCompatTable}}
+ +

{{domxref("SourceBuffer")}} インターフェイスの abort() メソッドは、現在のセグメントを打ち切り、セグメントパーサーをリセットします。

+ +

構文

+ +
sourceBuffer.abort();
+
+ +

パラメーター

+ +

なし。

+ +

戻り値

+ +

{{jsxref('undefined')}}。

+ +

例外

+ + + + + + + + + + + + + + +
例外説明
InvalidStateError親メディアソースの {{domxref("MediaSource.readyState")}} プロパティが open と等しくないか、この SourceBuffer が {{domxref("MediaSource")}} から取り除かれています。
+ +

例

+ +

abort() の仕様の説明はやや混乱します。 例えば、パーサーの状態のリセット（reset parser state）のステップ1を検討してください。 MSE API は完全に非同期ですが、この手順は同期（ブロッキング）操作を示唆しているように見えますが、これは意味がありません。

+ +

つまり、現在の実装は、ソースバッファで発生している現在の追加（またはその他）操作を停止し、すぐに操作を再開したい特定の状況で役立ちます。 例えば、次のコードを検討してください。

+ +
sourceBuffer.addEventListener('updateend', function (_) {
+  ...
+});
+
+sourceBuffer.appendBuffer(buf);
+ +

appendBuffer の呼び出し後、updateend イベントが発生する前（つまり、バッファは追加されているが、操作はまだ完了していない）に、ユーザーが新しいポイントを探して動画を「スクラブ」するとします。 この場合、ソースバッファで abort() を手動で呼び出して現在のバッファのデコードを停止し、動画の現在の新しい位置に関連する新しく要求されたセグメントを取得して追加します。

+ +

Nick Desaulnier の bufferWhenNeeded デモで同様の動作を確認できます。 48行目では、イベントリスナーが再生中の動画に追加され、seek() という関数が seeking イベントが発生したときに実行されます。 行92〜101では、seek() 関数が定義されています。 ここで、{{domxref("MediaSource.readyState")}} が open に設定されている場合、abort() が呼び出されることに注意してください。 つまり、新しいソースバッファを受信する準備ができていることを意味します。 この時点で、現在のセグメントを打ち切り、新しいシーク位置のセグメントを取得するだけの価値があります（checkBuffer() および getCurrentSegment() を参照）。

+ +

仕様

+ + + + + + + + + + + + + + +
仕様状態コメント
{{SpecName('Media Source Extensions', '#idl-def-sourcebuffer-abort()', 'abort()')}}{{Spec2('Media Source Extensions')}}初期定義
+ +

ブラウザーの互換性

+ +
+ + +

{{Compat("api.SourceBuffer.abort")}}

+
+ +

関連情報

+ + -- cgit v1.2.3-54-g00ecf