これがないドキュメントの最新バージョンです！ Click here for the latest released version.

Media

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

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

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

パラメーター

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

定数

以下の定数は mediaStatus コールバック関数への引数としてのみ使用されます。

Media.MEDIA_NONE = 0;
Media.MEDIA_STARTING = 1;
Media.MEDIA_RUNNING = 2;
Media.MEDIA_PAUSED = 3;
Media.MEDIA_STOPPED = 4;

メソッド

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

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

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

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

Android
BlackBerry WebWorks (OS 5.0 以上)
iOS
Windows Phone 7.5
Tizen

パーミッション

Android

app/res/xml/config.xml

<plugin name="Media" value="org.apache.cordova.AudioHandler" />

app/AndroidManifest.xml

<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

Bada

manifest.xml

<Privilege>
    <Name>RECORDING</Name>
</Privilege>

BlackBerry WebWorks

www/plugins.xml

<plugin name="Capture" value="org.apache.cordova.media.MediaCapture" />

iOS

App/Supporting Files/Cordova.plist

<key>Plugins</key>
<dict>
    <key>Media</key>
    <string>CDVSound</string>
</dict>

webOS

パーミッションの設定は必要ありません。

Windows Phone

Properties/WPAppManifest.xml

<Capabilities>
    <Capability Name="ID_CAP_MEDIALIB" />
    <Capability Name="ID_CAP_MICROPHONE" />
    <Capability Name="ID_HW_FRONTCAMERA" />
    <Capability Name="ID_CAP_ISV_CAMERA" />
    <Capability Name="ID_CAP_CAMERA" />
</Capabilities>

参照: Application Manifest for Windows Phone

Tizen

パーミッションの設定は必要ありません。

Windows Phone に関する注意点

一度に一つのメディアファイルのみ再生できます。
アプリケーションが他のメディアとどのように関わるかには、厳しい制限があります。詳しくは http://msdn.microsoft.com/en-us/library/windowsphone/develop/hh184838(v=vs.92).aspx を参照してください。