diff options
Diffstat (limited to 'plugins/org.apache.cordova.media/doc/it')
| -rw-r--r-- | plugins/org.apache.cordova.media/doc/it/index.md | 494 |
1 files changed, 494 insertions, 0 deletions
diff --git a/plugins/org.apache.cordova.media/doc/it/index.md b/plugins/org.apache.cordova.media/doc/it/index.md new file mode 100644 index 00000000..50da3aaf --- /dev/null +++ b/plugins/org.apache.cordova.media/doc/it/index.md @@ -0,0 +1,494 @@ +<!--- + Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. +--> + +# org.apache.cordova.media + +Questo plugin consente di registrare e riprodurre i file audio su un dispositivo. + +**Nota**: l'implementazione attuale non aderisce a una specifica del W3C per l'acquisizione di mezzi e viene fornito solo per comodità. Una futura realizzazione aderirà alla specifica W3C più recente e può deprecare le API corrente. + +## Installazione + + cordova plugin add org.apache.cordova.media + + +## Piattaforme supportate + +* Android +* BlackBerry 10 +* iOS +* Windows Phone 7 e 8 +* Tizen +* Windows 8 + +## 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][1]. + + [1]: http://msdn.microsoft.com/en-us/library/windowsphone/develop/hh184838(v=vs.92).aspx + +## Media + + var media = new Media(src, mediaSuccess, [mediaError], [mediaStatus]); + + +### 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`: Restituisce la posizione corrente all'interno di un file audio. + +* `media.getDuration`: 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`: Libera risorse audio del sistema operativo sottostante. + +* `media.seekTo`: Sposta la posizione all'interno del file audio. + +* `media.setVolume`: Impostare il volume per la riproduzione audio. + +* `media.startRecord`: Iniziare a registrare un file audio. + +* `media.stopRecord`: Interrompere la registrazione di un file audio. + +* `media.stop`: 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. + +* **durata**: la durata dei media, in secondi. + +## media.getCurrentPosition + +Restituisce la posizione corrente all'interno di un file audio. Aggiorna anche il `Media` dell'oggetto `position` parametro. + + media.getCurrentPosition(mediaSuccess, [mediaError]); + + +### Parametri + +* **mediaSuccess**: il callback passato la posizione corrente in pochi secondi. + +* **errore mediaError**: (facoltativo) il callback da eseguire se si verifica un errore. + +### Esempio rapido + + // 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); + + +## media.getDuration + +Restituisce la durata di un file audio in secondi. Se la durata è sconosciuta, essa restituisce un valore di -1. + + media.getDuration(); + + +### Esempio rapido + + // 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); + + +## Media.pause + +Sospende la riproduzione di un file audio. + + media.pause(); + + +### Esempio rapido + + // 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); + } + + +## Media.Play + +Avvia o riprende la riproduzione di un file audio. + + media.play(); + + +### Esempio rapido + + // 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(); + } + + +### iOS stranezze + +* **numberOfLoops**: passare questa opzione per il `play` metodo per specificare il numero di volte desiderato file multimediale per riprodurre, ad esempio: + + var myMedia = new Media("http://audio.ibeat.org/content/p1rj1s/p1rj1s_-_rockGuitar.mp3") + myMedia.play({ numberOfLoops: 2 }) + + +* **playAudioWhenScreenIsLocked**: questa opzione per passare il `play` metodo per specificare se si desidera consentire la riproduzione quando lo schermo è bloccato. Se impostato su `true` (il valore predefinito), viene ignorato lo stato del pulsante mute hardware, ad esempio: + + var myMedia = new Media("http://audio.ibeat.org/content/p1rj1s/p1rj1s_-_rockGuitar.mp3") + myMedia.play({ playAudioWhenScreenIsLocked : false }) + + +* **ordine di ricerca di file**: quando viene fornito solo un nome file o percorso semplice, cerca in iOS il `www` directory per il file, quindi l'applicazione `documents/tmp` directory: + + 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 + + +## media.release + +Rilascia le risorse audio del sistema operativo sottostante. Ciò è particolarmente importante per Android, dato che ci sono una quantità finita di OpenCore istanze per la riproduzione multimediale. Le applicazioni devono chiamare il `release` funzione per qualsiasi `Media` risorsa che non è più necessario. + + media.release(); + + +### Esempio rapido + + // Audio player + // + var my_media = new Media(src, onSuccess, onError); + + my_media.play(); + my_media.stop(); + my_media.release(); + + +## media.seekTo + +Imposta la posizione corrente all'interno di un file audio. + + media.seekTo(milliseconds); + + +### Parametri + +* **millisecondi**: posizione per impostare la posizione di riproduzione all'interno l'audio, in millisecondi. + +### Esempio rapido + + // 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); + + +### BlackBerry 10 capricci + +* Non è supportato sui dispositivi BlackBerry OS 5. + +## media.setVolume + +Impostare il volume per un file audio. + + media.setVolume(volume); + + +### Parametri + +* **volume**: il volume impostato per la riproduzione. Il valore deve essere all'interno della gamma di 0,0 e 1,0. + +### Piattaforme supportate + +* Android +* iOS + +### Esempio rapido + + // 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); + } + + +## media.startRecord + +Avvia la registrazione di un file audio. + + media.startRecord(); + + +### Piattaforme supportate + +* Android +* iOS +* Windows Phone 7 e 8 +* Windows 8 + +### Esempio rapido + + // 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(); + } + + +### Stranezze Android + +* Dispositivi Android registrano audio in formato Adaptive Multi-Rate. Il file specificato deve terminare con l'estensione ** . + +### iOS stranezze + +* iOS solo i record per i file di tipo *WAV* e restituisce un errore se il file di nome estensione è non corretto. + +* Se non è specificato un percorso completo, la registrazione viene inserita nell'applicazione `documents/tmp` directory. Questo si può accedere tramite il `File` API utilizzando `LocalFileSystem.TEMPORARY` . Deve esistere alcuna sottodirectory specificate a tempo di record. + +* I file possono essere registrati e giocati indietro usando i documenti URI: + + var myMedia = new Media("documents://beer.mp3") + + +### Stranezze di Windows 8 + +* Se non è specificato un percorso completo, la registrazione viene inserita nella directory AppData/temp. Questo si può accedere tramite il `File` Utilizzando API `LocalFileSystem.TEMPORARY` o ' ms-appdata: / / temp /<filename>' URI. + +* Deve esistere alcuna sottodirectory specificate a tempo di record. + +### Tizen stranezze + +* Tizen periferiche non supportano. + +## media.stop + +Interrompe la riproduzione di un file audio. + + Media.Stop(); + + +### Esempio rapido + + // 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); + } + + +## media.stopRecord + +Smette di registrare un file audio. + + media.stopRecord(); + + +### Piattaforme supportate + +* Android +* iOS +* Windows Phone 7 e 8 +* Windows 8 + +### Esempio rapido + + // 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); + } + + +### Tizen stranezze + +* Tizen periferiche non supportano. + +## Errore MediaError + +A `MediaError` oggetto viene restituito alla `mediaError` funzione di callback quando si verifica un errore. + +### Proprietà + +* **codice**: uno dei codici di errore predefiniti elencati di seguito. + +* **messaggio**: un messaggio di errore che descrive i dettagli dell'errore. + +### Costanti + +* `MediaError.MEDIA_ERR_ABORTED`= 1 +* `MediaError.MEDIA_ERR_NETWORK`= 2 +* `MediaError.MEDIA_ERR_DECODE`= 3 +* `MediaError.MEDIA_ERR_NONE_SUPPORTED`= 4
\ No newline at end of file |