You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cordova.apache.org by vi...@apache.org on 2015/06/12 16:42:17 UTC
[2/2] cordova-plugin-media git commit: CB-9128 cordova-plugin-media
documentation translation: cordova-plugin-media
CB-9128 cordova-plugin-media documentation translation: cordova-plugin-media
Project: http://git-wip-us.apache.org/repos/asf/cordova-plugin-media/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-plugin-media/commit/07136807
Tree: http://git-wip-us.apache.org/repos/asf/cordova-plugin-media/tree/07136807
Diff: http://git-wip-us.apache.org/repos/asf/cordova-plugin-media/diff/07136807
Branch: refs/heads/master
Commit: 07136807f078a432c9dbe9057b11ff51741192c1
Parents: db7434e
Author: Victor Sosa <vi...@apache.org>
Authored: Fri Jun 12 09:41:49 2015 -0500
Committer: Victor Sosa <vi...@apache.org>
Committed: Fri Jun 12 09:41:49 2015 -0500
----------------------------------------------------------------------
doc/de/README.md | 509 ++++++++++++++++++++++++++++++++++++++++++++++++++
doc/es/README.md | 509 ++++++++++++++++++++++++++++++++++++++++++++++++++
doc/fr/README.md | 404 +++++++++++++++++++++++++++++++++++++++
doc/it/README.md | 509 ++++++++++++++++++++++++++++++++++++++++++++++++++
doc/ja/README.md | 509 ++++++++++++++++++++++++++++++++++++++++++++++++++
doc/ko/README.md | 509 ++++++++++++++++++++++++++++++++++++++++++++++++++
doc/pl/README.md | 509 ++++++++++++++++++++++++++++++++++++++++++++++++++
doc/zh/README.md | 509 ++++++++++++++++++++++++++++++++++++++++++++++++++
8 files changed, 3967 insertions(+)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-plugin-media/blob/07136807/doc/de/README.md
----------------------------------------------------------------------
diff --git a/doc/de/README.md b/doc/de/README.md
new file mode 100644
index 0000000..8fb1aba
--- /dev/null
+++ b/doc/de/README.md
@@ -0,0 +1,509 @@
+<!--
+# license: 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.
+-->
+
+# cordova-plugin-media
+
+[](https://travis-ci.org/apache/cordova-plugin-media)
+
+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.
+
+Dieses Plugin wird einen globalen `Media`-Konstruktor definiert.
+
+Obwohl im globalen Gültigkeitsbereich, steht es nicht bis nach dem `deviceready`-Ereignis.
+
+ document.addEventListener("deviceready", onDeviceReady, false);
+ function onDeviceReady() {
+ console.log(Media);
+ }
+
+
+## Installation
+
+ cordova plugin add cordova-plugin-media
+
+
+## Unterstützte Plattformen
+
+ * Android
+ * BlackBerry 10
+ * iOS
+ * Windows Phone 7 und 8
+ * Tizen
+ * Windows 8
+ * Windows
+ * Browser
+
+## Windows Phone Macken
+
+ * 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](http://msdn.microsoft.com/en-us/library/windowsphone/develop/hh184838(v=vs.92).aspx).
+
+## Medien
+
+ var media = new Media(src, mediaSuccess, [mediaError], [mediaStatus]);
+
+
+### Parameter
+
+ * **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)*
+
+### Konstanten
+
+Die folgenden Konstanten werden als einzigem Parameter an den `mediaStatus`-Rückruf gemeldet:
+
+ * `Media.MEDIA_NONE`= 0;
+ * `Media.MEDIA_STARTING`= 1;
+ * `Media.MEDIA_RUNNING`= 2;
+ * `Media.MEDIA_PAUSED`= 3;
+ * `Media.MEDIA_STOPPED`= 4;
+
+### Methoden
+
+ * `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.
+
+### Zusätzliche ReadOnly-Parameter
+
+ * **Position**: die Position innerhalb der audio-Wiedergabe in Sekunden.
+
+ * Nicht während des Spiels automatisch aktualisiert; Rufen Sie `getCurrentPosition` zu aktualisieren.
+
+ * **Dauer**: die Dauer der Medien, in Sekunden.
+
+## media.getCurrentPosition
+
+Gibt die aktuelle Position in einer Audiodatei. Außerdem aktualisiert `das Medienobjekt` `position`-Parameter.
+
+ media.getCurrentPosition(mediaSuccess, [mediaError]);
+
+
+### Parameter
+
+ * **MediaSuccess**: der Rückruf, der die aktuelle Position in Sekunden übergeben wird.
+
+ * **Medienfehler**: (Optional) der Rückruf ausgeführt, wenn ein Fehler auftritt.
+
+### Kurzes Beispiel
+
+ // 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
+
+Gibt die Dauer einer Audiodatei in Sekunden. Wenn die Dauer unbekannt ist, wird der Wert-1 zurückgegeben.
+
+ media.getDuration();
+
+
+### Kurzes Beispiel
+
+ // 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
+
+Pausen Abspielen einer Audiodatei.
+
+ media.pause();
+
+
+### Kurzes Beispiel
+
+ // 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
+
+Startet oder setzt fort, Abspielen einer Audiodatei.
+
+ media.play();
+
+
+### Kurzes Beispiel
+
+ // 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 Macken
+
+ * **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
+
+
+## media.release
+
+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 sollten die `release`-Funktion für alle `Media`-Ressourcen aufrufen, die nicht mehr benötigt wird.
+
+ media.release();
+
+
+### Kurzes Beispiel
+
+ // Audio player
+ //
+ var my_media = new Media(src, onSuccess, onError);
+
+ my_media.play();
+ my_media.stop();
+ my_media.release();
+
+
+## media.seekTo
+
+Legt die aktuelle Position in einer Audiodatei.
+
+ media.seekTo(milliseconds);
+
+
+### Parameter
+
+ * **miliseconds**: die Position die Wiedergabeposition innerhalb des Audiotracks in Millisekunden festgelegt.
+
+### Kurzes Beispiel
+
+ // 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 Macken
+
+ * BlackBerry OS 5-Geräten unterstützt nicht.
+
+## media.setVolume
+
+Stellen Sie die Lautstärke für eine audio-Datei.
+
+ media.setVolume(volume);
+
+
+### Parameter
+
+ * **volume**: die Lautstärke für Wiedergabe fest. Der Wert muss im Bereich zwischen 0,0 und 1,0 liegen.
+
+### Unterstützte Plattformen
+
+ * Android
+ * iOS
+
+### Kurzes Beispiel
+
+ // 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
+
+Beginnt mit der Aufnahme einer audio-Datei.
+
+ media.startRecord();
+
+
+### Unterstützte Plattformen
+
+ * Android
+ * iOS
+ * Windows Phone 7 und 8
+ * Windows
+
+### Kurzes Beispiel
+
+ // 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();
+ }
+
+
+### Android Eigenarten
+
+ * Android-Geräte aufnehmen Audio im Adaptive Sprachcodecs Format. Die angegebene Datei sollte mit einer Endung *.amr* enden.
+ * Die Hardware-Lautstärkeregler sind bis zu den Mediendatenträger angeschlossen, während alle Medienobjekte lebendig sind. Das letzte erstelltes Medium Objekt `release()` aufgerufen hat, werden einmal die Lautstärkeregler auf ihr Standardverhalten zurückgesetzt. Die Steuerelemente werden auch auf Seitennavigation, zurückgesetzt, wenn dies alle Medienobjekte freigibt.
+
+### iOS Macken
+
+ * 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")
+
+
+### Windows-Eigenheiten
+
+ * Windows-Geräte können MP3, M4A und WMA-Formate für die aufgezeichneten Audio. Jedoch ist in den meisten Fällen es nicht möglich, MP3 für audio-Aufnahme auf *Windows Phone 8.1* -Geräten verwenden, da ein MP3-Encoder [nicht mit Windows Phone geliefert ist](https://msdn.microsoft.com/en-us/library/windows/apps/windows.media.mediaproperties.mediaencodingprofile.createmp3.aspx).
+
+ * 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 /<filename>' URI.
+
+ * Allen Unterverzeichnissen in Rekordzeit angegeben muss bereits vorhanden sein.
+
+### Tizen Macken
+
+ * Tizen Geräten unterstützt nicht.
+
+## media.stop
+
+Beendet die Wiedergabe einer Audiodatei.
+
+ media.stop();
+
+
+### Kurzes Beispiel
+
+ // 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
+
+Stoppt die Aufnahme einer audio-Datei.
+
+ media.stopRecord();
+
+
+### Unterstützte Plattformen
+
+ * Android
+ * iOS
+ * Windows Phone 7 und 8
+ * Windows
+
+### Kurzes Beispiel
+
+ // 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 Macken
+
+ * Tizen Geräten unterstützt nicht.
+
+## Medienfehler
+
+Ein `MediaError`-Objekt wird an die `mediaError`-Callback-Funktion zurückgegeben, wenn ein Fehler auftritt.
+
+### Eigenschaften
+
+ * **Code**: einer der vordefinierten Fehlercodes aufgeführt.
+
+ * **message**: eine Fehlermeldung beschreibt die Details des Fehlers.
+
+### Konstanten
+
+ * `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
http://git-wip-us.apache.org/repos/asf/cordova-plugin-media/blob/07136807/doc/es/README.md
----------------------------------------------------------------------
diff --git a/doc/es/README.md b/doc/es/README.md
new file mode 100644
index 0000000..78ce570
--- /dev/null
+++ b/doc/es/README.md
@@ -0,0 +1,509 @@
+<!--
+# license: 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.
+-->
+
+# cordova-plugin-media
+
+[](https://travis-ci.org/apache/cordova-plugin-media)
+
+Este plugin proporciona la capacidad de grabar y reproducir archivos de audio en un dispositivo.
+
+**Nota**: la implementación actual no se adhiere a una especificación del W3C para la captura de los medios de comunicación y se proporciona únicamente para su comodidad. Una futura implementación se adherirá a la más reciente especificación W3C y puede desaprueban las API actuales.
+
+Este plugin define un global `Media` Constructor.
+
+Aunque en el ámbito global, no estará disponible hasta después de la `deviceready` evento.
+
+ document.addEventListener("deviceready", onDeviceReady, false);
+ function onDeviceReady() {
+ console.log(Media);
+ }
+
+
+## Instalación
+
+ cordova plugin add cordova-plugin-media
+
+
+## Plataformas soportadas
+
+ * Android
+ * BlackBerry 10
+ * iOS
+ * Windows Phone 7 y 8
+ * Tizen
+ * Windows 8
+ * Windows
+ * Explorador
+
+## Windows Phone rarezas
+
+ * Archivo único multimedia puede reproducir en un momento.
+
+ * Hay restricciones estrictas sobre cómo interactúa la aplicación con otros medios. Consulte la [documentación de Microsoft para obtener más detalles](http://msdn.microsoft.com/en-us/library/windowsphone/develop/hh184838(v=vs.92).aspx).
+
+## Los medios de comunicación
+
+ var media = new Media(src, mediaSuccess, [mediaError], [mediaStatus]);
+
+
+### Parámetros
+
+ * **src**: un URI que contiene el contenido de audio. *(DOMString)*
+
+ * **mediaSuccess**: (opcional) la devolución de llamada que se ejecuta después de que un objeto `Media` ha completado el juego actual, registro o acción. *(Function)*
+
+ * **mediaError**: (opcional) la devolución de llamada que se ejecuta si se produce un error. *(Función)*
+
+ * **mediaStatus**: (opcional) la devolución de llamada que se ejecuta para indicar cambios en el estado. *(Función)*
+
+### Constantes
+
+Las siguientes constantes son reportadas como el único parámetro a la `mediaStatus` callback:
+
+ * `Media.MEDIA_NONE` = 0;
+ * `Media.MEDIA_STARTING` = 1;
+ * `Media.MEDIA_RUNNING` = 2;
+ * `Media.MEDIA_PAUSED` = 3;
+ * `Media.MEDIA_STOPPED` = 4;
+
+### Métodos
+
+ * `media.getCurrentPosition`: devuelve la posición actual dentro de un archivo de audio.
+
+ * `media.getDuration`: devuelve la duración de un archivo de audio.
+
+ * `media.play`: iniciar o reanudar reproducción de un archivo de audio.
+
+ * `media.pause`: pausar la reproducción de un archivo de audio.
+
+ * `media.release`: libera recursos de audio del sistema operativo subyacente.
+
+ * `media.seekTo`: mueve la posición dentro del archivo de audio.
+
+ * `media.setVolume`: ajuste el volumen de reproducción de audio.
+
+ * `media.startRecord`: iniciar la grabación de un archivo de audio.
+
+ * `media.stopRecord`: dejar de grabar un archivo de audio.
+
+ * `media.stop`: deja de jugar a un archivo de audio.
+
+### Parámetros adicionales ReadOnly
+
+ * **posición**: la posición dentro de la reproducción de audio, en segundos.
+
+ * No actualizada automáticamente durante la reproducción; Llame a `getCurrentPosition` para actualizar.
+
+ * **duration**: la duración de los medios de comunicación, en segundos.
+
+## media.getCurrentPosition
+
+Devuelve la posición actual dentro de un archivo de audio. También actualiza el `Media` del objeto `position` parámetro.
+
+ media.getCurrentPosition(mediaSuccess, [mediaError]);
+
+
+### Parámetros
+
+ * **mediaSuccess**: la devolución de llamada que se pasa a la posición actual en segundos.
+
+ * **mediaError**: (opcional) la devolución de llamada para ejecutar si se produce un error.
+
+### Ejemplo rápido
+
+ // 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
+
+Devuelve la duración de un archivo de audio en segundos. Si se desconoce la duración, devuelve un valor de -1.
+
+ media.getDuration();
+
+
+### Ejemplo rápido
+
+ // 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
+
+Detiene temporalmente la reproducción de un archivo de audio.
+
+ media.pause();
+
+
+### Ejemplo rápido
+
+ // 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
+
+Inicia o reanuda la reproducción de un archivo de audio.
+
+ media.play();
+
+
+### Ejemplo rápido
+
+ // 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 rarezas
+
+ * **numberOfLoops**: pasar esta opción al método `play` para especificar el número de veces que desea que los medios de archivo para jugar, por ejemplo:
+
+ var myMedia = new Media("http://audio.ibeat.org/content/p1rj1s/p1rj1s_-_rockGuitar.mp3")
+ myMedia.play({ numberOfLoops: 2 })
+
+
+ * **playAudioWhenScreenIsLocked**: pasar en esta opción el método `play` para especificar si desea permitir la reproducción cuando la pantalla está bloqueada. Si se omite establecido en `true` (el valor predeterminado), el estado del botón mute hardware, por ejemplo:
+
+ var myMedia = new Media("http://audio.ibeat.org/content/p1rj1s/p1rj1s_-_rockGuitar.mp3")
+ myMedia.play({ playAudioWhenScreenIsLocked : false })
+
+
+ * **orden de búsqueda de archivos**: cuando se proporciona sólo un nombre de archivo o ruta simple, iOS busca en el directorio `www` para el archivo, luego en el directorio de la aplicación `documents/tmp`:
+
+ 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
+
+Libera los recursos de audio del sistema operativo subyacente. Esto es particularmente importante para Android, ya que hay una cantidad finita de instancias de OpenCore para la reproducción multimedia. Las aplicaciones deben llamar el `release` función para cualquier `Media` recurso que ya no es necesario.
+
+ media.release();
+
+
+### Ejemplo rápido
+
+ // Audio player
+ //
+ var my_media = new Media(src, onSuccess, onError);
+
+ my_media.play();
+ my_media.stop();
+ my_media.release();
+
+
+## media.seekTo
+
+Establece la posición actual dentro de un archivo de audio.
+
+ media.seekTo(milliseconds);
+
+
+### Parámetros
+
+ * **milliseconds**: la posición para ajustar la posición de reproducción en el audio, en milisegundos.
+
+### Ejemplo rápido
+
+ // 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 rarezas
+
+ * No compatible con dispositivos BlackBerry OS 5.
+
+## media.setVolume
+
+Ajuste el volumen para un archivo de audio.
+
+ media.setVolume(volume);
+
+
+### Parámetros
+
+ * **volume**: el volumen para la reproducción. El valor debe estar dentro del rango de 0.0 a 1.0.
+
+### Plataformas soportadas
+
+ * Android
+ * iOS
+
+### Ejemplo rápido
+
+ // 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
+
+Empieza a grabar un archivo de audio.
+
+ media.startRecord();
+
+
+### Plataformas soportadas
+
+ * Android
+ * iOS
+ * Windows Phone 7 y 8
+ * Windows
+
+### Ejemplo rápido
+
+ // 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();
+ }
+
+
+### Rarezas Android
+
+ * Dispositivos Android grabación audio en formato Adaptive Multi-rate. El archivo especificado debe terminar con una extensión de *.amr*.
+ * Los controles de volumen del hardware están conectados hasta el volumen de los medios de comunicación, mientras que los objetos a los medios de comunicación están vivos. Una vez creado el último objeto multimedia ha `release()` llamado en él, los controles de volumen volverá a su comportamiento por defecto. Los controles también se restablecen en la navegación de la página, como esto libera todos los objetos de los medios de comunicación.
+
+### iOS rarezas
+
+ * iOS únicos registros a archivos de tipo *.wav* y devuelve un error si el archivo de extensión el nombre es no es correcto.
+
+ * Si no se proporciona una ruta completa, la grabación se coloca en el directorio de la aplicación `documents/tmp`. Esto se puede acceder mediante el `File` API utilizando `LocalFileSystem.TEMPORARY`. Ya debe existir cualquier subdirectorio especificado en un tiempo récord.
+
+ * Archivos pueden ser grabados y jugó de nuevo usando los documentos URI:
+
+ var myMedia = new Media("documents://beer.mp3")
+
+
+### Windows rarezas
+
+ * Dispositivos Windows pueden usar MP3, M4A y WMA formatos de grabado de audio. Sin embargo en la mayoría de los casos no es posible utilizar MP3 para grabar audio en los dispositivos *Windows Phone 8.1* , debido a que un codificador de MP3 es [no enviado con Windows Phone](https://msdn.microsoft.com/en-us/library/windows/apps/windows.media.mediaproperties.mediaencodingprofile.createmp3.aspx).
+
+ * Si no se proporciona una ruta completa, la grabación se coloca en el directorio AppData/temp. Esto puede accederse a través de la `Archivo` Usando API `LocalFileSystem.TEMPORARY` o ' ms-appdata: temporal / / / /<filename>' URI.
+
+ * Ya debe existir cualquier subdirectorio especificado en un tiempo récord.
+
+### Rarezas Tizen
+
+ * No compatible con dispositivos Tizen.
+
+## media.stop
+
+Deja de reproducir un archivo de audio.
+
+ media.stop();
+
+
+### Ejemplo rápido
+
+ // 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
+
+Detiene la grabación de un archivo de audio.
+
+ media.stopRecord();
+
+
+### Plataformas soportadas
+
+ * Android
+ * iOS
+ * Windows Phone 7 y 8
+ * Windows
+
+### Ejemplo rápido
+
+ // 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);
+ }
+
+
+### Rarezas Tizen
+
+ * No compatible con dispositivos Tizen.
+
+## MediaError
+
+A `MediaError` objeto es devuelto a la `mediaError` función de devolución de llamada cuando se produce un error.
+
+### Propiedades
+
+ * **code**: uno de los códigos de error predefinido enumerados a continuación.
+
+ * **mensaje**: un mensaje de error que describe los detalles del error.
+
+### Constantes
+
+ * `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
http://git-wip-us.apache.org/repos/asf/cordova-plugin-media/blob/07136807/doc/fr/README.md
----------------------------------------------------------------------
diff --git a/doc/fr/README.md b/doc/fr/README.md
new file mode 100644
index 0000000..db3d3d1
--- /dev/null
+++ b/doc/fr/README.md
@@ -0,0 +1,404 @@
+<!--
+# license: 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.
+-->
+
+# cordova-plugin-media
+
+[](https://travis-ci.org/apache/cordova-plugin-media)
+
+Ce plugin permet d'enregistrer et de lire des fichiers audio sur un périphérique.
+
+**Remarque**: l'implémentation actuelle n'est pas conforme à une spécification du W3C pour la capture de médias et est fournie pour plus de commodité seulement. Une prochaine implémentation adhèrera à la toute dernière spécification du W3C, ce qui aura probablement pour effet de déprécier l'API actuelle.
+
+Ce plugin définit un global `Media` constructeur.
+
+Bien que dans la portée globale, il n'est pas disponible jusqu'après la `deviceready` événement.
+
+ document.addEventListener (« deviceready », onDeviceReady, false) ;
+ function onDeviceReady() {console.log(Media);}
+
+
+## Installation
+
+ cordova plugin add cordova-plugin-media
+
+
+## Plates-formes supportées
+
+ * Android
+ * BlackBerry 10
+ * iOS
+ * Windows Phone 7 et 8
+ * Paciarelli
+ * Windows 8
+ * Windows
+ * Navigateur
+
+## Windows Phone Quirks
+
+ * Un seul fichier média peut être lu à la fois.
+
+ * Il y a des restrictions strictes concernant la façon dont votre application interagit avec d'autres médias. Consultez la [documentation de Microsoft pour plus d'informations](http://msdn.microsoft.com/en-us/library/windowsphone/develop/hh184838(v=vs.92).aspx).
+
+## Media
+
+ médias var = new Media (src, mediaSuccess, [mediaError], [mediaStatus]) ;
+
+
+### Paramètres
+
+ * **src** : l'URI du contenu audio. *(DOMString)*
+
+ * **mediaSuccess** : (facultative) la fonction callback exécutée après que la lecture en cours, l'action d'enregistrement ou l'arrêt de lecture de l'objet `Media` soit terminée. *(Function)*
+
+ * **mediaError** : (facultative) la fonction callback exécutée si une erreur survient. *(Function)*
+
+ * **mediaStatus** : (facultative) la fonction callback exécutée lors de chaque changement d'état. *(Function)*
+
+### Constantes
+
+Les constantes suivantes sont déclarées comme le seul paramètre à la `mediaStatus` Rappel :
+
+ * `Media.MEDIA_NONE` = 0;
+ * `Media.MEDIA_STARTING` = 1;
+ * `Media.MEDIA_RUNNING` = 2;
+ * `Media.MEDIA_PAUSED` = 3;
+ * `Media.MEDIA_STOPPED` = 4;
+
+### Méthodes
+
+ * `media.getCurrentPosition` : retourne la position de lecture dans un fichier audio.
+
+ * `media.getDuration`: retourne la durée d'un fichier audio.
+
+ * `media.play` : permet de commencer ou reprendre la lecture d'un fichier audio.
+
+ * `media.pause` : interrompt la lecture d'un fichier audio.
+
+ * `media.release` : libère les ressources audio correspondantes du système d'exploitation.
+
+ * `media.seekTo` : déplace la position de lecture au sein du fichier audio.
+
+ * `media.setVolume` : permet de régler le volume du clip audio.
+
+ * `media.startRecord` : commence l'enregistrement d'un fichier audio.
+
+ * `media.stopRecord` : arrête l'enregistrement d'un fichier audio.
+
+ * `media.stop` : arrête la lecture d'un fichier audio.
+
+### Paramètres supplémentaires en lecture seule
+
+ * **position** : la position de lecture sein du clip audio, en secondes.
+
+ * La valeur n'est pas automatiquement rafraichie pendant la lecture ; un appel à `getCurrentPosition` permet sa mise à jour.
+
+ * **duration** : la durée du média, en secondes.
+
+## media.getCurrentPosition
+
+Retourne la position courante dans un fichier audio. Met également à jour la `Media` de l'objet `position` paramètre.
+
+ media.getCurrentPosition (mediaSuccess, [mediaError]) ;
+
+
+### Paramètres
+
+ * **mediaSuccess** : la fonction callback à laquelle est transmise la position actuelle exprimée en secondes.
+
+ * **mediaError** : (facultative) la fonction callback exécutée si une erreur se produit.
+
+### Exemple court
+
+ Lecteur audio / / var my_media = new Media (src, onSuccess, onError) ;
+
+ Mise à jour media positionner chaque deuxième mediaTimer de var = setInterval(function () {/ / get médias position my_media.getCurrentPosition (/ / fonction de rappel réussi (position) {si (position > -1) {console.log((position) + "secondes") ;
+ }}, / / fonction de rappel d'erreur (e) {console.log ("Error getting pos =" + e) ;
+ }
+ );
+ }, 1000) ;
+
+
+## media.getDuration
+
+Retourne la durée d'un fichier audio en quelques secondes. Si on ne connaît pas la durée, elle retourne la valeur -1.
+
+ media.getDuration() ;
+
+
+### Exemple court
+
+ Lecteur audio / / var my_media = new Media (src, onSuccess, onError) ;
+
+ Obtenez durée var compteur = 0 ;
+ var timerDur = setInterval(function() {Compteur = compteur + 100 ;
+ Si (contrer > 2000) {clearInterval(timerDur) ;
+ } var dur = my_media.getDuration() ;
+ Si (dur > 0) {clearInterval(timerDur) ;
+ document.getElementById('audio_duration').innerHTML = (dur) + "secondes" ;
+ }}, 100) ;
+
+
+## media.pause
+
+Suspendre la lecture d'un fichier audio.
+
+ Media.pause() ;
+
+
+### Exemple court
+
+ Lire les données audio / / function playAudio(url) {/ / lire le fichier audio à my_media var url = nouveaux médias (url, / / fonction de rappel réussi () {console.log ("playAudio (): Audio succès");}, / / fonction de rappel d'erreur (err) {console.log ("playAudio (): erreur Audio:" + err);}) ;
+
+ Lecture audio my_media.play() ;
+
+ Pause après 10 secondes setTimeout (function () {media.pause() ;
+ }, 10000) ;
+ }
+
+
+## media.play
+
+Commence ou reprend la lecture d'un fichier audio.
+
+ Media.Play() ;
+
+
+### Exemple court
+
+ Lire les données audio / / function playAudio(url) {/ / lire le fichier audio à url var my_media = new Media (url, / / fonction de rappel réussi () {console.log ("playAudio (): Audio succès") ;
+ }, / / fonction de rappel d'erreur (err) {console.log ("playAudio (): Audio Error:" + err) ;
+ }
+ );
+ Lecture audio my_media.play() ;
+ }
+
+
+### Notes au sujet d'iOS
+
+ * **numberOfLoops** : transmettre cette option à la méthode `play` permet de spécifier le nombre de lectures à la suite d'un fichier donné, par exemple :
+
+ var myMedia = new Media("http://audio.ibeat.org/content/p1rj1s/p1rj1s_-_rockGuitar.mp3")
+ myMedia.play({ numberOfLoops: 2 })
+
+
+ * **playAudioWhenScreenIsLocked** : transmettre cette option à la méthode `play` permet de spécifier si la lecture doit continuer même lorsque l'écran de l'appareil est verrouillé. Si la valeur est `true` (par défaut), le bouton matériel mute est ignoré, par exemple :
+
+ var myMedia = new Media("http://audio.ibeat.org/content/p1rj1s/p1rj1s_-_rockGuitar.mp3")
+ myMedia.play({ playAudioWhenScreenIsLocked : false })
+
+
+ * **ordre de recherche de fichier** : si un nom de fichier ou chemin d'accès simple est fourni, iOS recherche d'abord le fichier correspondant dans le répertoire `www`, puis dans le répertoire `documents/tmp` appartenant à l'application :
+
+ var myMedia = new Media("audio/beer.mp3")
+ myMedia.play() // recherche d'abord le fichier www/audio/beer.mp3 puis <application>/documents/tmp/audio/beer.mp3
+
+
+## media.release
+
+Libère les ressources audio du système d'exploitation sous-jacent. Cela est particulièrement important pour Android, puisqu'il y a une quantité finie d'instances OpenCore pour la lecture du média. Les applications doivent appeler le `release` fonction pour tout `Media` ressource qui n'est plus nécessaire.
+
+ Media.Release() ;
+
+
+### Exemple court
+
+ Lecteur audio / / var my_media = new Media (src, onSuccess, onError) ;
+
+ my_media.Play() ;
+ my_media.Stop() ;
+ my_media.Release() ;
+
+
+## media.seekTo
+
+Définit la position actuelle dans un fichier audio.
+
+ media.seekTo(milliseconds) ;
+
+
+### Paramètres
+
+ * **milliseconds** : la nouvelle position de lecture au sein du fichier audio, en millisecondes.
+
+### Exemple court
+
+ Lecteur audio / / var my_media = new Media (src, onSuccess, onError) ;
+ my_media.Play() ;
+ SeekTo à 10 secondes après 5 secondes setTimeout(function() {my_media.seekTo(10000);}, 5000) ;
+
+
+### BlackBerry 10 Quirks
+
+ * Cette méthode n'est pas prise en charge sur les périphériques BlackBerry OS 5.
+
+## media.setVolume
+
+Régler le volume du fichier audio.
+
+ media.setVolume(volume) ;
+
+
+### Paramètres
+
+ * **volume** : le volume à utiliser pour la lecture. La valeur doit être comprise entre 0.0 et 1.0 inclus.
+
+### Plates-formes supportées
+
+ * Android
+ * iOS
+
+### Exemple court
+
+ Lire les données audio / / function playAudio(url) {/ / lire le fichier audio à my_media var url = nouveaux médias (url, / / réussite rappel function() {console.log ("playAudio (): Audio succès") ;
+ }, / / erreur rappel function(err) {console.log ("playAudio (): Audio Error:" + err) ;
+ });
+
+ Lecture audio my_media.play() ;
+
+ Couper le volume après 2 secondes setTimeout(function() {my_media.setVolume('0.0') ;
+ }, 2000) ;
+
+ Réglez le volume à 1.0 après 5 secondes setTimeout(function() {my_media.setVolume('1.0') ;
+ }, 5000) ;
+ }
+
+
+## media.startRecord
+
+Pour démarrer l'enregistrement d'un fichier audio.
+
+ media.startRecord() ;
+
+
+### Plates-formes supportées
+
+ * Android
+ * iOS
+ * Windows Phone 7 et 8
+ * Windows
+
+### Exemple court
+
+ Enregistrer de l'audio / / function recordAudio() {var src = « myrecording.mp3 » ;
+ var mediaRec = new Media (src, / / réussite rappel function() {console.log ("recordAudio (): Audio succès") ;
+ }, / / erreur rappel function(err) {console.log ("recordAudio (): Audio Error:" + err.code) ;
+ });
+
+ MediaRec.startRecord() audio record ;
+ }
+
+
+### Quirks Android
+
+ * Les appareils Android enregistrent de l'audio au format Adaptive Multi-Rate. Le nom de fichier spécifié doit donc comporter une extension *.amr*.
+ * Les contrôles de volume du matériel sont câblés jusqu'au volume de médias tandis que tous les objets multimédia sont vivants. Une fois créé le dernier objet multimédia a `release()` appelé à ce sujet, les contrôles de volume revenir à leur comportement par défaut. Les contrôles sont également réinitialisés sur la navigation de la page, car cela libère tous les objets multimédias.
+
+### Notes au sujet d'iOS
+
+ * iOS produit uniquement des enregistrements sous la forme de fichier de type *.wav* et renvoie une erreur si l'extension du nom de fichier est incorrecte.
+
+ * Si un chemin d'accès complet n'est pas précisé, l'enregistrement est placé dans le répertoire `documents/tmp` correspondant à l'application. Il sera ensuite accessible via l'API `File` en utilisant la constante `LocalFileSystem.TEMPORARY`. Tout sous-répertoire présent dans le chemin d'accès au moment de l'enregistrement doit déjà exister.
+
+ * Les fichiers peuvent être enregistrés et lus à l'aide de l'URI des documents :
+
+ var myMedia = new Media("documents://beer.mp3")
+
+
+### Bizarreries de Windows
+
+ * Les périphériques Windows peuvent utiliser MP3, M4A et WMA formats pour enregistrement audio. Toutefois, dans la plupart des cas, il n'est pas possible d'utiliser le MP3 pour l'enregistrement audio sur les périphériques *Windows Phone 8.1* , car un encodeur MP3 n'est [pas livré avec Windows Phone](https://msdn.microsoft.com/en-us/library/windows/apps/windows.media.mediaproperties.mediaencodingprofile.createmp3.aspx).
+
+ * Si un chemin d'accès complet n'est pas fourni, l'enregistrement est placé dans le répertoire AppData/temp. Ce qui peut être consulté le `Fichier` À l'aide de l'API `LocalFileSystem.TEMPORARY` ou ' ms-appdata : temp / / / /<filename>' URI.
+
+ * Tout sous-répertoire présent dans le chemin d'accès au moment de l'enregistrement doit déjà exister.
+
+### Bizarreries de paciarelli
+
+ * Pas pris en charge sur les appareils paciarelli.
+
+## media.stop
+
+Arrête la lecture d'un fichier audio.
+
+ Media.Stop() ;
+
+
+### Exemple court
+
+ Lire les données audio / / function playAudio(url) {/ / lire le fichier audio à my_media var url = nouveaux médias (url, / / réussite rappel function() {console.log ("playAudio (): Audio succès") ;
+ }, / / erreur rappel function(err) {console.log ("playAudio (): Audio Error:" + err) ;
+ }
+ );
+
+ Lecture audio my_media.play() ;
+
+ Pause après 10 secondes setTimeout(function() {my_media.stop() ;
+ }, 10000) ;
+ }
+
+
+## media.stopRecord
+
+Arrête d'enregistrer un fichier audio.
+
+ media.stopRecord() ;
+
+
+### Plates-formes supportées
+
+ * Android
+ * iOS
+ * Windows Phone 7 et 8
+ * Windows
+
+### Exemple court
+
+ Enregistrer de l'audio / / function recordAudio() {var src = « myrecording.mp3 » ;
+ var mediaRec = new Media (src, / / réussite rappel function() {console.log ("recordAudio (): Audio succès") ;
+ }, / / erreur rappel function(err) {console.log ("recordAudio (): Audio Error:" + err.code) ;
+ }
+ );
+
+ MediaRec.startRecord() audio record ;
+
+ Arrêter l'enregistrement après 10 secondes setTimeout(function() {mediaRec.stopRecord() ;
+ }, 10000) ;
+ }
+
+
+### Bizarreries de paciarelli
+
+ * Pas pris en charge sur les appareils paciarelli.
+
+## MediaError
+
+A `MediaError` objet est retourné à la `mediaError` fonction de rappel lorsqu'une erreur survient.
+
+### Propriétés
+
+ * **code**: l'un des codes d'erreur prédéfinis énumérés ci-dessous.
+
+ * **message**: un message d'erreur décrivant les détails de l'erreur.
+
+### Constantes
+
+ * `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
http://git-wip-us.apache.org/repos/asf/cordova-plugin-media/blob/07136807/doc/it/README.md
----------------------------------------------------------------------
diff --git a/doc/it/README.md b/doc/it/README.md
new file mode 100644
index 0000000..f99ef37
--- /dev/null
+++ b/doc/it/README.md
@@ -0,0 +1,509 @@
+<!--
+# license: 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.
+-->
+
+# cordova-plugin-media
+
+[](https://travis-ci.org/apache/cordova-plugin-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.
+
+Questo plugin definisce un costruttore `Media` globale.
+
+Anche se in ambito globale, non è disponibile fino a dopo l'evento `deviceready`.
+
+ document.addEventListener("deviceready", onDeviceReady, false);
+ function onDeviceReady() {
+ console.log(Media);
+ }
+
+
+## Installazione
+
+ cordova plugin add cordova-plugin-media
+
+
+## Piattaforme supportate
+
+ * Android
+ * BlackBerry 10
+ * iOS
+ * Windows Phone 7 e 8
+ * Tizen
+ * Windows 8
+ * Windows
+ * Browser
+
+## 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](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 al metodo di callback `mediaStatus`:
+
+ * `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 parametro di `position` dell'oggetto `Media`.
+
+ 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 la funzione di `release` qualsiasi risorsa `Media` 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
+
+### 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 ** .
+ * I controlli di volume di hardware sono cablati a volume media mentre eventuali oggetti multimediali sono vivi. Una volta l'ultimi Media creati oggetto ha `release()` chiamato su di esso, i controlli di volume di tornare alla loro comportamento predefinito. I controlli vengono reimpostati anche sulla pagina di navigazione, come questo rilascia tutti gli oggetti multimediali.
+
+### 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
+
+ * Dispositivi Windows possono utilizzare MP3, M4A e WMA formati per l'audio registrato. Tuttavia, nella maggior parte dei casi non è possibile utilizzare MP3 per la registrazione audio su dispositivi *Windows Phone 8.1* , perché un encoder MP3 è [non forniti con Windows Phone](https://msdn.microsoft.com/en-us/library/windows/apps/windows.media.mediaproperties.mediaencodingprofile.createmp3.aspx).
+
+ * 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
+
+### 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
+
+Un oggetto ` MediaError` viene restituito alla funzione di callback ` mediaError` 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
http://git-wip-us.apache.org/repos/asf/cordova-plugin-media/blob/07136807/doc/ja/README.md
----------------------------------------------------------------------
diff --git a/doc/ja/README.md b/doc/ja/README.md
new file mode 100644
index 0000000..37de0fe
--- /dev/null
+++ b/doc/ja/README.md
@@ -0,0 +1,509 @@
+<!--
+# license: 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.
+-->
+
+# cordova-plugin-media
+
+[](https://travis-ci.org/apache/cordova-plugin-media)
+
+このプラグインは、記録し、デバイス上のオーディオ ファイルを再生する機能を提供します。
+
+**注**: 現在の実装では、メディアのキャプチャのための W3C 仕様に準拠していないとは便宜上提供されるだけです。 将来の実装を最新の W3C 仕様に準拠し、現在 Api をとがめることがあります。
+
+このプラグインでは、グローバル `Media` のコンス トラクターを定義します。
+
+グローバル スコープではあるがそれがないまで `deviceready` イベントの後です。
+
+ document.addEventListener("deviceready", onDeviceReady, false);
+ function onDeviceReady() {
+ console.log(Media);
+ }
+
+
+## インストール
+
+ cordova plugin add cordova-plugin-media
+
+
+## サポートされているプラットフォーム
+
+ * アンドロイド
+ * ブラックベリー 10
+ * iOS
+ * Windows Phone 7 と 8
+ * Tizen
+ * Windows 8
+ * Windows
+ * ブラウザー
+
+## Windows Phone の癖
+
+ * のみ 1 つのメディア ファイルは、一度に再生できます。
+
+ * アプリケーションと他のメディアとの対話に厳格な制限があります。 [詳細については、Microsoft のマニュアル](http://msdn.microsoft.com/en-us/library/windowsphone/develop/hh184838(v=vs.92).aspx)を参照してください。.
+
+## メディア
+
+ var media = new Media(src, mediaSuccess, [mediaError], [mediaStatus]);
+
+
+### パラメーター
+
+ * **src**: オーディオのコンテンツを含む URI。*（，）*
+
+ * **mediaSuccess**: (省略可能) 後に実行するコールバックを `Media` 再生用に現在、レコード、または stop アクション オブジェクトが完了しました。*(機能)*
+
+ * **mediaError**: (省略可能) エラーが発生した場合に実行されるコールバック。*(機能)*
+
+ * **mediaStatus**: (省略可能) 状態の変化を示すために実行されるコールバック。*(機能)*
+
+### 定数
+
+次の定数は、`mediaStatus` コールバックを唯一のパラメーターとして報告されます。
+
+ * `Media.MEDIA_NONE` = 0;
+ * `Media.MEDIA_STARTING` = 1;
+ * `Media.MEDIA_RUNNING` = 2;
+ * `Media.MEDIA_PAUSED` = 3;
+ * `Media.MEDIA_STOPPED` = 4;
+
+### メソッド
+
+ * `media.getCurrentPosition`: オーディオ ファイル内の現在位置を返します。
+
+ * `media.getDuration`: オーディオ ファイルの継続時間を返します。
+
+ * `media.play`: 開始またはオーディオ ファイルの再生を再開します。
+
+ * `media.pause`： オーディオ ファイルの再生を一時停止。
+
+ * `media.release`: 基になるオペレーティング システムのオーディオ リソースを解放します。
+
+ * `media.seekTo`: オーディオ ファイル内の位置を移動します。
+
+ * `media.setVolume`: オーディオの再生ボリュームを設定します。
+
+ * `media.startRecord`： オーディオ ファイルの録音を開始します。
+
+ * `media.stopRecord`: オーディオ ファイルの録音を停止します。
+
+ * `media.stop`: オーディオ ファイルの再生を停止します。
+
+### 追加読み取り専用パラメーター
+
+ * **位置**： 数秒でオーディオの再生では、内の位置。
+
+ * 自動的に更新されません; のプレイ中にコール `getCurrentPosition` を更新します。
+
+ * **期間**: 秒で、メディアの期間。
+
+## media.getCurrentPosition
+
+オーディオ ファイル内の現在位置を返します。また、`Media` オブジェクトの `position` パラメーターを更新します。
+
+ media.getCurrentPosition(mediaSuccess, [mediaError]);
+
+
+### パラメーター
+
+ * **mediaSuccess**: 秒の現在の位置を渡されるコールバック。
+
+ * **mediaError**: (省略可能) コールバックでエラーが発生した場合に実行します。
+
+### 簡単な例
+
+ // 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
+
+オーディオ ファイルの継続時間 (秒単位) を返します。期間は知られている、-1 の値が返されます。
+
+ 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);
+
+
+## media.pause
+
+オーディオ ファイルの再生を一時停止します。
+
+ 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);
+ }
+
+
+## media.play
+
+開始またはオーディオ ファイルの再生を再開します。
+
+ 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();
+ }
+
+
+### iOS の癖
+
+ * **numberOfLoops**: このオプションを指定して、 `play` メディア ファイルを再生する、例えば回数を指定する方法。
+
+ var myMedia = new Media("http://audio.ibeat.org/content/p1rj1s/p1rj1s_-_rockGuitar.mp3")
+ myMedia.play({ numberOfLoops: 2 })
+
+
+ * **playAudioWhenScreenIsLocked**: このオプションを渡す、 `play` 、画面がロックされているときに再生を許可するかどうかを指定するメソッド。 場合に設定されている `true` (既定値)、例えば、ハードウェア ミュート ボタンの状態は無視されます。
+
+ var myMedia = new Media("http://audio.ibeat.org/content/p1rj1s/p1rj1s_-_rockGuitar.mp3")
+ myMedia.play({ playAudioWhenScreenIsLocked : false })
+
+
+ * **ファイル検索の順序**: iOS の検索でファイル名または単純なパスのみが提供される場合、 `www` ディレクトリ、ファイルをアプリケーションの `documents/tmp` ディレクトリ。
+
+ 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
+
+基になるオペレーティング システムのオーディオ リソースを解放します。 メディアの再生のための OpenCore インスタンスの有限な量があるので、人造人間のため特に重要です。 アプリケーションが不要な `Media` リソースの `release` の関数を呼び出す必要があります。
+
+ media.release();
+
+
+### 簡単な例
+
+ // Audio player
+ //
+ var my_media = new Media(src, onSuccess, onError);
+
+ my_media.play();
+ my_media.stop();
+ my_media.release();
+
+
+## media.seekTo
+
+オーディオ ファイル内の現在位置を設定します。
+
+ 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);
+
+
+### ブラックベリー 10 癖
+
+ * ブラックベリー OS 5 デバイスでサポートされていません。
+
+## media.setVolume
+
+オーディオ ファイルの音量を設定します。
+
+ media.setVolume(volume);
+
+
+### パラメーター
+
+ * **ボリューム**: ボリュームの再生を設定します。値は 0.0 ～ 1.0 の範囲内である必要があります。
+
+### サポートされているプラットフォーム
+
+ * アンドロイド
+ * iOS
+
+### 簡単な例
+
+ // 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
+
+オーディオ ファイルの録音を開始します。
+
+ media.startRecord();
+
+
+### サポートされているプラットフォーム
+
+ * アンドロイド
+ * iOS
+ * Windows Phone 7 と 8
+ * Windows
+
+### 簡単な例
+
+ // 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();
+ }
+
+
+### Android の癖
+
+ * Android 端末適応型マルチレート形式にオーディオを録音します。指定したファイルは、 *.amr*拡張子で終わる必要があります。
+ * メディア オブジェクトが生きている間、ハードウェアのボリューム コントロールは有線メディア ボリュームまで。 一度 `release()` それと呼ばれるオブジェクトには最後に作成したメディア、ボリューム コントロールのデフォルトの動作に戻ります。 コントロールは、すべてのメディア オブジェクトをリリースこれとしてページ ナビゲーションにもリセットされます。
+
+### iOS の癖
+
+ * iOS の種類*.wav*と返しますエラー場合は、ファイル名拡張子がファイルをレコードのみが修正されません。
+
+ * 記録は、アプリケーションの配置の完全なパスを指定しない場合 `documents/tmp` ディレクトリ。 これを介してアクセスすることができます、 `File` API を使用して `LocalFileSystem.TEMPORARY` 。 記録時に指定された任意のサブディレクトリに存在する必要があります。
+
+ * ファイルを記録し、再生することができますドキュメント URI を使用して。
+
+ var myMedia = new Media("documents://beer.mp3")
+
+
+### Windows の癖
+
+ * Windows デバイスで使用できる MP3、M4A、WMA 形式は、オーディオを記録しました。 しかしほとんどの場合は不可能だ MP3 エンコーダーが[Windows Phone に付属していない](https://msdn.microsoft.com/en-us/library/windows/apps/windows.media.mediaproperties.mediaencodingprofile.createmp3.aspx)ので、 *8.1 の Windows Phone*デバイスでオーディオ録音の MP3 を使用するには.
+
+ * 完全なパスを指定しない場合、記録は AppData/temp ディレクトリに配置されます。これを介してアクセスすることができます、 `ファイル` API を使用してください。 `LocalFileSystem.TEMPORARY` または ' ms appdata: temp////<filename>' URI。
+
+ * 記録時に指定された任意のサブディレクトリに存在する必要があります。
+
+### Tizen の癖
+
+ * Tizen のデバイスでサポートされていません。
+
+## media.stop
+
+オーディオ ファイルの再生を停止します。
+
+ 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);
+ }
+
+
+## media.stopRecord
+
+オーディオ ファイルの録音を停止します。
+
+ media.stopRecord();
+
+
+### サポートされているプラットフォーム
+
+ * アンドロイド
+ * iOS
+ * Windows Phone 7 と 8
+ * Windows
+
+### 簡単な例
+
+ // 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 の癖
+
+ * Tizen のデバイスでサポートされていません。
+
+## MediaError
+
+`MediaError` オブジェクトにエラーが発生したときに `mediaError` コールバック関数に返されます。
+
+### プロパティ
+
+ * **コード**: 次のいずれかの定義済みのエラー コード。
+
+ * **メッセージ**: エラーの詳細を説明するエラー メッセージ。
+
+### 定数
+
+ * `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
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org