Cordova-メディア

Cordovaメディアプラグインは、Cordovaアプリでオーディオサウンドを録音および再生するために使用されます。

手順1-メディアプラグインのインストール

メディアプラグインをインストールするには、*コマンドプロンプト*ウィンドウで次のコードを実行します。

C:\Users\username\Desktop\CordovaProject>cordova plugin add cordova-plugin-media

ステップ2-ボタンを追加する

このチュートリアルでは、シンプルなオーディオプレーヤーを作成します。 indexl に必要なボタンを作成しましょう。

<button id = "playAudio">PLAY</button>
<button id = "pauseAudio">PAUSE</button>
<button id = "stopAudio">STOP</button>
<button id = "volumeUp">VOLUME UP</button>
<button id = "volumeDown">VOLUME DOWN</button>

手順3-イベントリスナーの追加

次に、 index.js 内の onDeviceReady 関数内にボタンのイベントリスナーを追加する必要があります。

document.getElementById("playAudio").addEventListener("click", playAudio);
document.getElementById("pauseAudio").addEventListener("click", pauseAudio);
document.getElementById("stopAudio").addEventListener("click", stopAudio);
document.getElementById("volumeUp").addEventListener("click", volumeUp);
document.getElementById("volumeDown").addEventListener("click", volumeDown);

ステップ4A-プレイ機能

追加する最初の関数は playAudio です。後で追加する関数（pause、stop、volumeUp、volumeDown）で使用するため、関数の外で myMedia を定義しています。このコードは index.js ファイルに配置されます。

var myMedia = null;
function playAudio() {
   var src = "/android_asset/www/audio/piano.mp3";

   if(myMedia === null) {
      myMedia = new Media(src, onSuccess, onError);

      function onSuccess() {
         console.log("playAudio Success");
      }

      function onError(error) {
         console.log("playAudio Error: " + error.code);
      }
   }
   myMedia.play();
}

*PLAY* ボタンをクリックして、 *src* パスからピアノ音楽を開始できます。

ステップ4B-機能の一時停止と停止

次に必要な関数は pauseAudio と stopAudio です。

function pauseAudio() {
   if(myMedia) {
      myMedia.pause();
   }
}

function stopAudio() {
   if(myMedia) {
      myMedia.stop();
   }
   myMedia = null;
}

*PAUSE* または *STOP* ボタンをクリックして、ピアノの音を一時停止または停止できます。

ステップ4C-ボリューム機能

ボリュームを設定するには、 setVolume メソッドを使用できます。このメソッドは、 0 から 1 の値を持つパラメーターを取ります。開始値を 0.5 に設定します。

var volumeValue = 0.5;
function volumeUp() {
   if(myMedia && volumeValue < 1) {
      myMedia.setVolume(volumeValue += 0.1);
   }
}

function volumeDown() {
   if(myMedia && volumeValue > 0) {
      myMedia.setVolume(volumeValue -= 0.1);
   }
}

*VOLUME UP* または *VOLUME DOWN* を押すと、ボリューム値を *0.1* ずつ変更できます。

次の表は、このプラグインが提供する他のメソッドを示しています。

S.No	Method & Details
1	getCurrentPosition オーディオの現在の位置を返します。
2	getDuration オーディオの継続時間を返します。
3	play オーディオの開始または再開に使用されます。
4	pause オーディオの一時停止に使用されます。
5	release 基盤となるオペレーティングシステムのオーディオリソースを解放します。
6	seekTo オーディオの位置を変更するために使用されます。
7	setVolume オーディオの音量を設定するために使用されます。
8	startRecord オーディオファイルの録音を開始します。
9	stopRecord オーディオファイルの録音を停止します。
10	stop オーディオファイルの再生を停止します。

Cordova-media

目次