MediaRecorder.stop()
MediaRecorder.stop()
メソッド(MediaStream 収録 API の一部)は、メディアキャプチャを停止するために使用します。
stop()
メソッドを呼び出すと、 UA は次の手順を実行するタスクをキューに入れます。
MediaRecorder.state
が "inactive" の場合は、DOM のInvalidState
エラーを発生させてこれらの手順を終了します。MediaRecorder.state
が "inactive" でない場合は、次の手順に進みます。MediaRecorder.state
を "inactive" に設定してメディアのキャプチャを停止します。- 収集されたデータの Blob を含む
dataavailable
イベントを発生させます。 stop
イベントを発生させます。
構文
js
stop()
引数
なし。
返値
なし (undefined
)。
エラー
MediaRecorder
オブジェクトの MediaRecorder.state
が "inactive" のときに stop()
メソッドが呼び出されると、InvalidState
エラーが発生します — メディアキャプチャが既に停止している場合は停止しても意味がありません。
例
js
stop.onclick = () => {
mediaRecorder.stop();
console.log("レコーダー停止、データ使用可能");
};
仕様書
Specification |
---|
MediaStream Recording # dom-mediarecorder-stop |
ブラウザーの互換性
BCD tables only load in the browser
関連情報
- MediaStream 収録 API の使用
- ウェブディクタフォン: MediaRecorder + getUserMedia + Web Audio API 可視化デモ、Chris Mills 著(GitHub のソース)。(英語)
- simpl.info の MediaStream 収録のデモ、Sam Dutton 著。(英語)
Navigator.getUserMedia