Media

Media オブジェクトは、デバイス上でのオーディオファイルの再生や録音などといった機能をサポートします。

var media = new Media(src, mediaSuccess, [mediaError], [mediaStatus]);

注意: 現在の実装はメディアキャプチャーに関する W3C の仕様を満たしていません。利便性のためだけに提供されています。将来的には最新の W3C の仕様に合わせるとともに、現在の API を廃止することも検討されています。

パラメーター

• src: オーディオコンテンツを示す URI を表します (DOMString)
• mediaSuccess: (オプション) Media オブジェクトが再生、録音、停止などのアクションを完了したときに呼ばれるコールバック関数を表します (Function)
• mediaError: (オプション) エラー発生時に呼ばれるコールバック関数を表します (Function)
• mediaStatus: (オプション) ステータスが変わったときに呼ばれるコールバック関数を表します (Function)

メソッド

• media.getCurrentPosition: オーディオファイル内の現在の再生位置を返します
• media.getDuration: オーディオファイルの再生時間を返します
• media.play: オーディオファイルを再生または再開します
• media.pause: オーディオファイルを一時停止します
• media.release: OS のオーディオリソースを開放します
• media.seekTo: オーディオファイル中の再生位置を動かします
• media.startRecord: オーディオファイルの録音を開始します
• media.stopRecord: オーディオファイルの録音を停止します
• media.stop: オーディオファイルを停止します

追加の読み取り専用パラメーター

• __position_: 再生位置を秒単位で表します。 再生中は自動的に値が更新されないので、 getCurrentPosition メソッドを呼び、値を更新します
• __duration_: メディアの再生時間を秒単位で表します

サポートされているプラットフォーム

• Android
• iOS
• Windows Phone 7 (Mango)