MediaRecorder.stop()
Baseline
広く利用可能
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2021年4月以降、すべてのブラウザーで利用可能です。
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("レコーダー停止、データ使用可能");
};
仕様書
| 仕様書 |
|---|
| MediaStream Recording> # dom-mediarecorder-stop> |
ブラウザーの互換性
関連情報
- MediaStream 収録 API の使用
- ウェブディクタフォン: MediaRecorder + getUserMedia + Web Audio API 可視化デモ、Chris Mills 著(GitHub のソース)。(英語)
- simpl.info の MediaStream 収録のデモ、Sam Dutton 著。(英語)
Navigator.getUserMedia