Cordova - 媒体

Cordova 媒体插件用于在 Cordova 应用中录制和播放音频。

步骤 1 - 安装媒体插件

可以在命令提示符窗口中运行以下代码来安装媒体插件。

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

步骤 2 - 添加按钮

在本教程中，我们将创建简单的音频播放器。让我们在 index.html 中创建我们需要的按钮。

<button id = "playAudio">PLAY</button>
<button id = "pauseAudio">暂停</button>
<button id = "stopAudio">停止</button>
<button id = "volumeUp">调高音量</button>
<button id = "volumeDown">调低音量</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。我们在函数外部定义 myMedia，因为我们想在稍后要添加的函数（pause、stop、volumeUp 和 volumeDown）中使用它。此代码位于 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);
   }
}

一旦我们按下音量增大或音量减小，我们就可以将音量值改变0.1。

下表显示了此插件提供的其他方法。