Media
Il
Media
oggetto fornisce la possibilità di registrare e riprodurre i file audio su un dispositivo.
var media = new Media(src, mediaSuccess, [mediaError], [mediaStatus]);
Nota: L'implementazione corrente non aderisce a una specifica del W3C per l'acquisizione di supporti e viene fornito solo per comodità. Una futura realizzazione aderirà alla specifica W3C più recente e può deprecare le API corrente.
Parametri
src: un URI contenente il contenuto audio. (DOMString)
mediaSuccess: (facoltativo) il callback che viene eseguito dopo un
Media
oggetto ha completato il gioco corrente, record o interrompere l'azione. (Funzione)errore mediaError: (facoltativo) il callback che viene eseguito se si verifica un errore. (Funzione)
mediaStatus: (facoltativo) il callback che viene eseguito per indicare i cambiamenti di stato. (Funzione)
Costanti
Costanti sono segnalate come unico parametro per il mediaStatus
callback:
-
Media.MEDIA_NONE
= 0; -
Media.MEDIA_STARTING
= 1; -
Media.MEDIA_RUNNING
= 2; -
Media.MEDIA_PAUSED
= 3; -
Media.MEDIA_STOPPED
= 4;
Metodi
[media.getCurrentPosition](media.getCurrentPosition.html)
: Restituisce la posizione corrente all'interno di un file audio.[media.getDuration](media.getDuration.html)
: Restituisce la durata di un file audio.media.play
: Iniziare o riprendere la riproduzione di un file audio.media.pause
: Pausa la riproduzione di un file audio.[media.release](media.release.html)
: Libera risorse audio del sistema operativo sottostante.[media.seekTo](media.seekTo.html)
: Sposta la posizione all'interno del file audio.[media.setVolume](media.setVolume.html)
: Impostare il volume per la riproduzione audio.[media.startRecord](media.startRecord.html)
: Iniziare a registrare un file audio.[media.stopRecord](media.stopRecord.html)
: Interrompere la registrazione di un file audio.[media.stop](media.stop.html)
: Interrompere la riproduzione di un file audio.
Parametri supplementari ReadOnly
posizione: la posizione all'interno della riproduzione audio, in pochi secondi.
- Non aggiornate automaticamente durante il gioco; chiamare
getCurrentPosition
per l'aggiornamento.
- Non aggiornate automaticamente durante il gioco; chiamare
durata: la durata dei media, in secondi.
Piattaforme supportate
- Android
- BlackBerry WebWorks (OS 5.0 e superiori)
- iOS
- Windows Phone 7.5
- Tizen
- Windows 8
La funzionalità di accesso
A partire dalla versione 3.0, Cordova implementa le API a livello di dispositivo come plugin. Utilizzare la CLI plugin
comando, descritto in Command-Line Interface, aggiungere o rimuovere questa funzionalità per un progetto:
$ cordova plugin aggiungere org.apache.cordova.media $ cordova plugin ls ['org.apache.cordova.media'] $ cordova plugin rm org.apache.cordova.media
Questi comandi si applicano a tutte le piattaforme mirate, ma modificano le impostazioni di configurazione specifiche della piattaforma descritte di seguito:
Android
(in app/res/xml/config.xml) <feature name="Media"> <param name="android-package" value="org.apache.cordova.AudioHandler" /> </feature> (in app/AndroidManifest.xml) <uses-permission android:name="android.permission.RECORD_AUDIO" /> <uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" /> <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
BlackBerry WebWorks
(in www/plugins.xml) <feature name="Capture"> <param name="blackberry-package" value="org.apache.cordova.media.MediaCapture" /> </feature>
iOS (in
config.xml
)<feature name="Media"> <param name="ios-package" value="CDVSound" /> </feature>
Windows Phone (in
Properties/WPAppManifest.xml
)<Capabilities> <Capability Name="ID_CAP_MEDIALIB" /> <Capability Name="ID_CAP_MICROPHONE" /> <Capability Name="ID_HW_FRONTCAMERA" /> <Capability Name="ID_CAP_ISV_CAMERA" /> <Capability Name="ID_CAP_CAMERA" /> </Capabilities>
Riferimento: il manifesto dell'applicazione per Windows Phone
Alcune piattaforme possono supportare questa funzionalità senza richiedere alcuna configurazione speciale. Vedere Supporto piattaforma nella sezione panoramica.
Stranezze di Windows Phone
File sola multimediale può essere riprodotti in un momento.
Ci sono severe restrizioni su come l'applicazione interagisce con altri media. Vedere la documentazione di Microsoft per maggiori dettagli.