Ionic-Cordova Media
このプラグインを使用すると、デバイスでオーディオファイルを録音および再生できます。
メディアの使用
他のすべてのCordovaプラグインと同様に、最初に行う必要があるのは、コマンドプロンプトウィンドウからプラグインをインストールすることです。
C:\Users\Username\Desktop\MyApp>cordova plugin add cordova-plugin-media
これで、プラグインを使用する準備が整いました。次のコードサンプルでは、srcこのチュートリアルで使用するソースmp3ファイルです。に配置されますjs フォルダですが、追加する必要があります /android_asset/www/ その前に、それはアンドロイドデバイスで使用することができます。
完全な機能は、 $ionicPlatform.ready()プラグインが使用される前にすべてがロードされることを保証する関数。その後、作成していますmedia を使用してオブジェクト newMedia(src)方法。ザ・media オブジェクトは、再生、一時停止、停止、および解放機能を追加するために使用されます。
コントローラコード
.controller('MyCtrl', function($scope, $ionicPlatform, $cordovaMedia) {
$ionicPlatform.ready(function() {
var src = "/android_asset/www/js/song.mp3";
var media = $cordovaMedia.newMedia(src);
$scope.playMedia = function() {
media.play();
};
$scope.pauseMedia = function() {
media.pause();
};
$scope.stopMedia = function() {
media.stop();
};
$scope.$on('destroy', function() {
media.release();
});
});
}
また、再生、一時停止、停止機能を呼び出すための3つのボタンを作成します。
<button class = "button" ng-click = "playMedia()">PLAY</button>
<button class = "button" ng-click = "pauseMedia()">PAUSE</button>
<button class = "button" ng-click = "stopMedia()">STOP</button>
このプラグインを機能させるには、エミュレーターまたはモバイルデバイスで実行する必要があります。ユーザーが再生ボタンをタップすると、song.mp3 再生を開始します。
上記の例で、私たちが使用していることがわかります srcオプションパラメータとして。に使用できる他のオプションのパラメータがありますnewMedia 方法。
オプションのパラメータ
次の表に、使用可能なすべてのオプションパラメータを示します。
パラメータ | タイプ | 詳細 |
---|---|---|
mediaSuccess | 関数 | 現在の再生/録音または停止アクションが完了した後に呼び出されます。 |
mediaError | 関数 | エラーが発生したときに呼び出されます。 |
mediaStatus | 関数 | ステータスの変更を表示するために呼び出されます。 |
次の表に、使用可能なすべてのメソッドを示します。
利用可能な方法
次の表に、使用可能なすべての方法を示します。
方法 | パラメーター | 詳細 |
---|---|---|
newMedia(parameter1) | src | 将来のメソッドで使用されるメディアオブジェクトを返します。 src オーディオコンテンツのURIです。 |
getCurrentPosition | / | オーディオファイル内の現在の位置を返します。 |
getDuration | / | オーディオファイルの長さを返します。 |
演奏する | / | 再生を開始または再開するために使用されます。 |
一時停止 | / | 再生を一時停止するために使用されます。 |
やめる | / | 再生を停止するために使用されます。 |
リリース | / | オーディオリソースを解放するために使用されます。 |
seekTo(parameter1) | ミリ秒 | 再生位置をミリ秒単位で設定するために使用されます。 |
setVolume(parameter1) | ボリューム | 音量を変更するために使用されます。範囲は0から1です |
startRecord() | / | 録音を開始するために使用されます。 |
stopRecord | / | 記録を停止するために使用されます。 |