MediaRecorder.start()

構文

start()
start(timeslice)

引数

timeslice 省略可

各 Blob に収録するミリ秒数。 この引数が含まれていない場合は、requestData() メソッドが呼び出されて Blob が取得され、メディアの収録を継続する新しい Blob の作成のきっかけがない限り、メディア期間全体が単一の Blob に収録されます。

返値

なし (undefined)。

例外

すぐに検出できるエラーは DOM 例外としてスローされます。 他のすべてのエラーは、MediaRecorder オブジェクトに送られた error イベントを通じて報告されます。 onerror イベントハンドラーを実装することで、これらのエラーに対応することができます。

InvalidModificationError DOMException

収録中のストリームのトラック数が変更された場合に発生します。メディアの収録中にトラックを追加したり削除したりすることはできません。

InvalidStateError DOMException

MediaRecorder が inactive 状態ではない場合に発生します。すでに収録中の場合は、メディアの収録を開始することはできません。 state プロパティを参照してください。

NotSupportedError DOMException

収録しようとしているメディアストリームが非アクティブであるか、ストリームの 1 つ以上のトラックが現在の設定を使用して収録できない形式である場合に発生します。

SecurityError DOMException

MediaStream が収録を禁止するように設定されている場合に発生します。 これは、例えば、ユーザーが入力機器を使用する許可を拒否したときに getUserMedia() を使用して取得されたソースの場合などです。この例外は、収録開始後にソースメディアのセキュリティオプションが変更された場合にも error イベントとして配信される可能性があります。

UnknownError DOMException

収録処理中に何か他の問題が発生した場合に発生します。

例

record.onclick = () => {
  mediaRecorder.start();
  console.log("収録を開始しました。");
};

仕様書

ブラウザーの互換性

関連情報

• MediaStream 収録 API の使用
• ウェブディクタフォン: MediaRecorder + getUserMedia + Web Audio API 可視化デモ、Chris Mills 著（GitHub のソース）。（英語）
• simpl.info の MediaStream 収録のデモ、Sam Dutton 著。（英語）
• getUserMedia()