Dieses Plugin bietet die Möglichkeit zum Aufzeichnen und Wiedergeben von audio-Dateien auf einem Gerät.
Hinweis: die aktuelle Implementierung eine W3C-Spezifikation für Medien-Capture nicht einhalten, und wird nur zu Informationszwecken zur Verfügung gestellt. Zukünftiger Implementierungen wird an der aktuellen W3C-Spezifikation und kann die aktuellen APIs entweiht.
cordova plugin add org.apache.cordova.media
Nur eine Mediendatei kann gleichzeitig abgespielt werden.
Es gibt strenge Beschränkungen, wie Ihre Anwendung mit anderen Medien interagiert. Finden Sie in der Microsoft-Dokumentation für details.
var media = new Media(src, mediaSuccess, [mediaError], [mediaStatus]);
Src: ein URI mit der audio-Inhalte. (DOM-String und enthält)
MediaSuccess: (Optional) der Rückruf, der nach dem führt ein Media
-Objekt abgeschlossen hat, die aktuelle Wiedergabe, Aufzeichnung oder Stop-Action. (Funktion)
Medienfehler: (Optional) der Rückruf, der ausgeführt wird, wenn ein Fehler auftritt. (Funktion)
MediaStatus: (Optional) der Rückruf, der ausgeführt wird, um Statusänderungen anzugeben. (Funktion)
Die folgenden Konstanten werden gemeldet, als einzigem Parameter an die mediaStatus
Rückruf:
Media.MEDIA_NONE
= 0;Media.MEDIA_STARTING
= 1;Media.MEDIA_RUNNING
= 2;Media.MEDIA_PAUSED
= 3;Media.MEDIA_STOPPED
= 4;media.getCurrentPosition
: Gibt die aktuelle Position in einer Audiodatei.
media.getDuration
: Gibt die Dauer einer Audiodatei.
media.play
: Starten Sie oder fortsetzen Sie der Wiedergabe einer Audiodatei.
media.pause
: Anhalten der Wiedergabe einer Audiodatei.
media.release
: Das zugrunde liegende Betriebssystem audio Ressourcen frei.
media.seekTo
: Verschiebt die Position innerhalb der audio-Datei.
media.setVolume
: Stellen Sie die Lautstärke für die Audiowiedergabe.
media.startRecord
: Starten der Aufnahme einer audio-Datei.
media.stopRecord
: Stoppen Sie die Aufnahme einer audio-Datei.
media.stop
: Abspielen einer Audiodatei zu stoppen.
Position: die Position innerhalb der audio-Wiedergabe in Sekunden.
getCurrentPosition
zu aktualisieren.Dauer: die Dauer der Medien, in Sekunden.
Gibt die aktuelle Position in einer Audiodatei. Aktualisiert auch die Media
des Objekts position
Parameter.
media.getCurrentPosition(mediaSuccess, [mediaError]);
MediaSuccess: der Rückruf, der die aktuelle Position in Sekunden übergeben wird.
Medienfehler: (Optional) der Rückruf ausgeführt, wenn ein Fehler auftritt.
// Audio player // var my_media = new Media(src, onSuccess, onError); // Update media position every second var mediaTimer = setInterval(function () { // get media position my_media.getCurrentPosition( // success callback function (position) { if (position > -1) { console.log((position) + " sec"); } }, // error callback function (e) { console.log("Error getting pos=" + e); } ); }, 1000);
Gibt die Dauer einer Audiodatei in Sekunden. Wenn die Dauer unbekannt ist, wird der Wert-1 zurückgegeben.
media.getDuration();
// Audio player // var my_media = new Media(src, onSuccess, onError); // Get duration var counter = 0; var timerDur = setInterval(function() { counter = counter + 100; if (counter > 2000) { clearInterval(timerDur); } var dur = my_media.getDuration(); if (dur > 0) { clearInterval(timerDur); document.getElementById('audio_duration').innerHTML = (dur) + " sec"; } }, 100);
Pausen Abspielen einer Audiodatei.
media.pause();
// Play audio // function playAudio(url) { // Play the audio file at url var my_media = new Media(url, // success callback function () { console.log("playAudio():Audio Success"); }, // error callback function (err) { console.log("playAudio():Audio Error: " + err); } ); // Play audio my_media.play(); // Pause after 10 seconds setTimeout(function () { media.pause(); }, 10000); }
Startet oder setzt fort, Abspielen einer Audiodatei.
media.play();
// Play audio // function playAudio(url) { // Play the audio file at url var my_media = new Media(url, // success callback function () { console.log("playAudio():Audio Success"); }, // error callback function (err) { console.log("playAudio():Audio Error: " + err); } ); // Play audio my_media.play(); }
NumberOfLoops: übergeben Sie diese Option, um die play
-Methode können Sie die Anzahl der angeben soll die Mediendatei ausspielen, z.B.:
var myMedia = new Media("http://audio.ibeat.org/content/p1rj1s/p1rj1s_-_rockGuitar.mp3") myMedia.play({ numberOfLoops: 2 })
PlayAudioWhenScreenIsLocked: übergeben Sie diese Option, um die play
-Methode können Sie angeben, ob Sie möchten Wiedergabe zu ermöglichen, wenn der Bildschirm gesperrt ist. Wenn legen Sie auf true
(der Standardwert), der Zustand der die mute Taste wird ignoriert, z.B.:
var myMedia = new Media("http://audio.ibeat.org/content/p1rj1s/p1rj1s_-_rockGuitar.mp3") myMedia.play({ playAudioWhenScreenIsLocked : false })
Reihenfolge der Dateisuche: Wenn nur ein Dateiname oder Pfad angegeben wird, sucht iOS in das www
Verzeichnis für die Datei, dann in der Anwendung documents/tmp
Verzeichnis:
var myMedia = new Media("audio/beer.mp3") myMedia.play() // first looks for file in www/audio/beer.mp3 then in <application>/documents/tmp/audio/beer.mp3
Das zugrunde liegende Betriebssystem audio Ressourcen frei. Dies ist besonders wichtig für Android, da gibt es eine begrenzte Anzahl von OpenCore-Instanzen für die Medienwiedergabe. Anwendungen rufen die release
-Funktion für alle Media
Ressource, die nicht mehr benötigt wird.
media.release();
// Audio player // var my_media = new Media(src, onSuccess, onError); my_media.play(); my_media.stop(); my_media.release();
Legt die aktuelle Position in einer Audiodatei.
media.seekTo(milliseconds);
// Audio player // var my_media = new Media(src, onSuccess, onError); my_media.play(); // SeekTo to 10 seconds after 5 seconds setTimeout(function() { my_media.seekTo(10000); }, 5000);
Stellen Sie die Lautstärke für eine audio-Datei.
media.setVolume(volume);
// Play audio // function playAudio(url) { // Play the audio file at url var my_media = new Media(url, // success callback function() { console.log("playAudio():Audio Success"); }, // error callback function(err) { console.log("playAudio():Audio Error: "+err); }); // Play audio my_media.play(); // Mute volume after 2 seconds setTimeout(function() { my_media.setVolume('0.0'); }, 2000); // Set volume to 1.0 after 5 seconds setTimeout(function() { my_media.setVolume('1.0'); }, 5000); }
Beginnt mit der Aufnahme einer audio-Datei.
media.startRecord();
// Record audio // function recordAudio() { var src = "myrecording.mp3"; var mediaRec = new Media(src, // success callback function() { console.log("recordAudio():Audio Success"); }, // error callback function(err) { console.log("recordAudio():Audio Error: "+ err.code); }); // Record audio mediaRec.startRecord(); }
iOS nur Datensätze, die Dateien des Typs WAV und gibt ein Fehler, wenn die Dateinamen-Erweiterung ist richtig nicht.
Wenn ein vollständiger Pfad nicht angegeben ist, wird die Aufzeichnung in der Anwendung platziert documents/tmp
Verzeichnis. Erreichbar über die File
-API verwenden LocalFileSystem.TEMPORARY
. Allen Unterverzeichnissen in Rekordzeit angegeben muss bereits vorhanden sein.
Dateien können aufgezeichnet und spielte mit die Dokumenten URI zurück:
var myMedia = new Media("documents://beer.mp3")
Wenn Sie ein vollständiger Pfad nicht angegeben ist, wird die Aufnahme im AppData/Temp-Verzeichnis platziert. Erreichbar über die Datei
API verwenden LocalFileSystem.TEMPORARY
oder "ms-Appdata: / / / Temp /' URI.
Allen Unterverzeichnissen in Rekordzeit angegeben muss bereits vorhanden sein.
Beendet die Wiedergabe einer Audiodatei.
Media.Stop();
// Play audio // function playAudio(url) { // Play the audio file at url var my_media = new Media(url, // success callback function() { console.log("playAudio():Audio Success"); }, // error callback function(err) { console.log("playAudio():Audio Error: "+err); } ); // Play audio my_media.play(); // Pause after 10 seconds setTimeout(function() { my_media.stop(); }, 10000); }
Stoppt die Aufnahme einer audio-Datei.
media.stopRecord();
// Record audio // function recordAudio() { var src = "myrecording.mp3"; var mediaRec = new Media(src, // success callback function() { console.log("recordAudio():Audio Success"); }, // error callback function(err) { console.log("recordAudio():Audio Error: "+ err.code); } ); // Record audio mediaRec.startRecord(); // Stop recording after 10 seconds setTimeout(function() { mediaRec.stopRecord(); }, 10000); }
A MediaError
Objekt wird zurückgegeben, um die mediaError
Callback-Funktion, wenn ein Fehler auftritt.
Code: einer der vordefinierten Fehlercodes aufgeführt.
Nachricht: eine Fehlermeldung beschreibt die Details des Fehlers.
MediaError.MEDIA_ERR_ABORTED
= 1MediaError.MEDIA_ERR_NETWORK
= 2MediaError.MEDIA_ERR_DECODE
= 3MediaError.MEDIA_ERR_NONE_SUPPORTED
= 4