Cordova - Media

Wtyczka Cordova media służy do nagrywania i odtwarzania dźwięków w aplikacjach Cordova.

Krok 1 - Instalacja wtyczki Media

Wtyczkę Media można zainstalować, uruchamiając następujący kod w command prompt okno.

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

Krok 2 - Dodaj przyciski

W tym samouczku stworzymy prosty odtwarzacz audio. Stwórzmy przyciski, które będą nam potrzebneindex.html.

<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>

Krok 3 - Dodaj detektory zdarzenia

Teraz musimy dodać detektory zdarzeń dla naszych przycisków w środku onDeviceReady funkcja wewnątrz index.js.

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);

Krok 4A - Funkcja odtwarzania

Pierwsza funkcja, którą zamierzamy dodać, to playAudio. DefiniujemymyMediapoza funkcją, ponieważ chcemy go użyć w funkcjach, które zostaną dodane później (pauza, stop, volumeUp i volumeDown). Ten kod jest umieszczony windex.js plik.

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();
}

Możemy kliknąć PLAY przycisk, aby uruchomić muzykę fortepianową z src ścieżka.

Krok 4B - Funkcje pauzy i zatrzymania

Kolejne funkcje, których potrzebujemy, to pauseAudio i stopAudio.

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

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

Teraz możemy wstrzymać lub zatrzymać dźwięk fortepianu, klikając PAUSE lub STOP guziki.

Krok 4C - Funkcje głośności

Aby ustawić głośność, możemy użyć setVolumemetoda. Ta metoda przyjmuje parametr o wartościach z0 do 1. Ustawimy wartość początkową na0.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);
   }
}

Po naciśnięciu VOLUME UP lub VOLUME DOWN możemy zmienić wartość głośności o 0.1.

W poniższej tabeli przedstawiono inne metody, które zapewnia ta wtyczka.

S.Nr Metoda i szczegóły
1

getCurrentPosition

Zwraca bieżącą pozycję audio.

2

getDuration

Zwraca czas trwania dźwięku.

3

play

Służy do uruchamiania lub wznawiania dźwięku.

4

pause

Służy do wstrzymywania dźwięku.

5

release

Zwalnia zasoby audio systemu operacyjnego.

6

seekTo

Służy do zmiany pozycji audio.

7

setVolume

Służy do ustawiania głośności dźwięku.

8

startRecord

Rozpocznij nagrywanie pliku audio.

9

stopRecord

Zatrzymaj nagrywanie pliku audio.

10

stop

Zatrzymaj odtwarzanie pliku audio.