You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cordova.apache.org by ld...@apache.org on 2014/07/07 19:51:22 UTC
[07/10] git commit: Lisa testing pulling in plugins for plugin:
cordova-plugin-media
Lisa testing pulling in plugins for plugin: 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/400df60a
Tree: http://git-wip-us.apache.org/repos/asf/cordova-plugin-media/tree/400df60a
Diff: http://git-wip-us.apache.org/repos/asf/cordova-plugin-media/diff/400df60a
Branch: refs/heads/master
Commit: 400df60aa0659749bc4407e458e6d9421568b7d1
Parents: 10f5438
Author: ldeluca <ld...@us.ibm.com>
Authored: Tue May 27 21:22:23 2014 -0400
Committer: ldeluca <ld...@us.ibm.com>
Committed: Tue May 27 21:22:23 2014 -0400
----------------------------------------------------------------------
doc/it/index.md | 488 +++++++++++++++++++++++++++++++++++++++++++++++++++
doc/ko/index.md | 488 +++++++++++++++++++++++++++++++++++++++++++++++++++
doc/pl/index.md | 488 +++++++++++++++++++++++++++++++++++++++++++++++++++
doc/zh/index.md | 488 +++++++++++++++++++++++++++++++++++++++++++++++++++
4 files changed, 1952 insertions(+)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-plugin-media/blob/400df60a/doc/it/index.md
----------------------------------------------------------------------
diff --git a/doc/it/index.md b/doc/it/index.md
new file mode 100644
index 0000000..1ef9b07
--- /dev/null
+++ b/doc/it/index.md
@@ -0,0 +1,488 @@
+<!---
+ 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")
+
+
+### 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`
+* `MediaError.MEDIA_ERR_NETWORK`
+* `MediaError.MEDIA_ERR_DECODE`
+* `MediaError.MEDIA_ERR_NONE_SUPPORTED`
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-plugin-media/blob/400df60a/doc/ko/index.md
----------------------------------------------------------------------
diff --git a/doc/ko/index.md b/doc/ko/index.md
new file mode 100644
index 0000000..b197b91
--- /dev/null
+++ b/doc/ko/index.md
@@ -0,0 +1,488 @@
+<!---
+ 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
+
+이 플러그인 기록 장치에 오디오 파일을 재생 하는 기능을 제공 합니다.
+
+**참고**: 현재 구현 미디어 캡처에 대 한 W3C 사양을 준수 하지 않는 및 편의 위해서만 제공 됩니다. 미래 구현 최신 W3C 사양을 준수 한다 고 현재 Api 사용 중지 될 수 있습니다.
+
+## 설치
+
+ cordova plugin add org.apache.cordova.media
+
+
+## 지원 되는 플랫폼
+
+* 안 드 로이드
+* 블랙베리 10
+* iOS
+* Windows Phone 7과 8
+* Tizen
+* 윈도우 8
+
+## Windows Phone 단점
+
+* 한 번에 하나의 미디어 파일을 다시 재생할 수 있습니다.
+
+* 응용 프로그램 다른 미디어와 상호 작용 하는 방법에 대 한 엄격한 제한이 있다. [자세한 내용은 Microsoft 문서][1] 를 참조 하십시오.
+
+ [1]: http://msdn.microsoft.com/en-us/library/windowsphone/develop/hh184838(v=vs.92).aspx
+
+## 미디어
+
+ var media = new Media(src, mediaSuccess, [mediaError], [mediaStatus]);
+
+
+### 매개 변수
+
+* **src**: 오디오 콘텐츠를 포함 하는 URI. *(DOMString)*
+
+* **mediaSuccess**: (선택 사항) 후 실행 되는 콜백 한 `Media` 개체 현재 재생, 기록, 또는 중지 작업을 완료 했습니다. *(기능)*
+
+* **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 인스턴스 때문에 안 드 로이드를 위해 특히 중요 하다입니다. 응용 프로그램 호출 해야는 `release` 함수에 대 한 `Media` 리소스를 더 이상 필요 합니다.
+
+ 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
+* 윈도우 8
+
+### 빠른 예제
+
+ // 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();
+ }
+
+
+### 안 드 로이드 단점
+
+* 안 드 로이드 장치 적응 다중 속도 형식에서 오디오를 기록합니다. 지정 된 파일 *.amr* 확장명으로 끝나야 합니다.
+
+### iOS 단점
+
+* iOS만 레코드 형식을 *.wav* 및 반환 오류 경우 파일 이름 확장명의 파일을 수정 하지.
+
+* 전체 경로 제공 하지 않으면 응용 프로그램의 기록 배치 됩니다 `documents/tmp` 디렉터리. 이 통해 액세스할 수 있는 `File` API를 사용 하 여 `LocalFileSystem.TEMPORARY` . 기록 시간에 지정 된 하위 디렉터리에 이미 존재 해야 합니다.
+
+* 파일을 기록 하 고 재생할 수 있습니다 문서 URI를 사용 하 여 다시:
+
+ var myMedia = new Media("documents://beer.mp3")
+
+
+### 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
+* 윈도우 8
+
+### 빠른 예제
+
+ // 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
+
+A `MediaError` 개체에 반환 됩니다는 `mediaError` 콜백 함수 오류가 발생 합니다.
+
+### 속성
+
+* **코드**: 미리 정의 된 오류 코드 중 하나가 아래에 나열 된.
+
+* **메시지**: 오류 세부 정보를 설명 하는 오류 메시지.
+
+### 상수
+
+* `MediaError.MEDIA_ERR_ABORTED`
+* `MediaError.MEDIA_ERR_NETWORK`
+* `MediaError.MEDIA_ERR_DECODE`
+* `MediaError.MEDIA_ERR_NONE_SUPPORTED`
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-plugin-media/blob/400df60a/doc/pl/index.md
----------------------------------------------------------------------
diff --git a/doc/pl/index.md b/doc/pl/index.md
new file mode 100644
index 0000000..4eee351
--- /dev/null
+++ b/doc/pl/index.md
@@ -0,0 +1,488 @@
+<!---
+ 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
+
+Plugin daje możliwość nagrywania i odtwarzania plików audio na urządzeniu.
+
+**Uwaga**: Obecna implementacja nie stosować się do specyfikacji W3C do przechwytywania mediów i jest dostarczane jedynie dla wygody. Przyszłej realizacji będą przylegać do najnowszych specyfikacji W3C i może potępiać bieżące interfejsów API.
+
+## Instalacji
+
+ cordova plugin add org.apache.cordova.media
+
+
+## Obsługiwane platformy
+
+* Android
+* Jeżyna 10
+* iOS
+* Windows Phone 7 i 8
+* Tizen
+* Windows 8
+
+## Windows Phone dziwactwa
+
+* Tylko jeden plik mogą być zagrany w tył w czasie.
+
+* Istnieją ścisłe ograniczenia na jak aplikacja współdziała z innymi mediami. Zobacz [Microsoft dokumentacji szczegóły][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]);
+
+
+### Parametry
+
+* **src**: URI zawierający zawartość audio. *(DOMString)*
+
+* **mediaSuccess**: (opcjonalne) wywołania zwrotnego, który wykonuje po `Media` obiektu została zakończona bieżącej gry, rekordu lub działania stop. *(Funkcja)*
+
+* **mediaError**: (opcjonalne) wywołania zwrotnego, która wykonuje w przypadku wystąpienia błędu. *(Funkcja)*
+
+* **mediaStatus**: (opcjonalne) wywołania zwrotnego, który wykonuje wskazać zmiany statusu. *(Funkcja)*
+
+### Stałe
+
+Poniższe stałe są zgłaszane jako parametr tylko do `mediaStatus` wywołania zwrotnego:
+
+* `Media.MEDIA_NONE`= 0;
+* `Media.MEDIA_STARTING`= 1;
+* `Media.MEDIA_RUNNING`= 2;
+* `Media.MEDIA_PAUSED`= 3;
+* `Media.MEDIA_STOPPED`= 4;
+
+### Metody
+
+* `media.getCurrentPosition`: Zwraca bieżącej pozycji w pliku audio.
+
+* `media.getDuration`: Zwraca czas trwania pliku audio.
+
+* `media.play`: Rozpoczęcie lub wznowienie odtwarzania pliku audio.
+
+* `media.pause`: Wstrzymanie odtwarzania pliku audio.
+
+* `media.release`: Zwalnia zasoby audio system operacyjny.
+
+* `media.seekTo`: Porusza się pozycji w pliku audio.
+
+* `media.setVolume`: Ustaw głośność odtwarzania dźwięku.
+
+* `media.startRecord`: Nagrywanie pliku audio.
+
+* `media.stopRecord`: Zatrzymaj nagrywanie pliku audio.
+
+* `media.stop`: Zatrzymania odtwarzania pliku audio.
+
+### Parametry dodatkowe ReadOnly
+
+* **stanowisko**: stanowisko w odtwarzaniu dźwięku, w kilka sekund.
+
+ * Nie jest automatycznie aktualizowana podczas odtwarzania; wywołanie `getCurrentPosition` aktualizacji.
+
+* **czas**: trwania mediów, w kilka sekund.
+
+## media.getCurrentPosition
+
+Zwraca bieżącą pozycję w pliku audio. Również aktualizacje `Media` obiektu `position` parametr.
+
+ media.getCurrentPosition(mediaSuccess, [mediaError]);
+
+
+### Parametry
+
+* **mediaSuccess**: wywołania zwrotnego, który jest przekazywany bieżącej pozycji w kilka sekund.
+
+* **mediaError**: (opcjonalne) wywołanie zwrotne do wykonać, jeśli wystąpi błąd.
+
+### Szybki przykład
+
+ // 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
+
+Zwraca czas trwania pliku audio w kilka sekund. Jeśli czas trwania jest nieznane, to zwraca wartość -1.
+
+ media.getDuration();
+
+
+### Szybki przykład
+
+ // 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
+
+Wstrzymuje odtwarzanie pliku audio.
+
+ media.pause();
+
+
+### Szybki przykład
+
+ // 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
+
+Rozpoczyna się lub wznawia odtwarzanie pliku audio.
+
+ media.play();
+
+
+### Szybki przykład
+
+ // 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 dziwactwa
+
+* **numberOfLoops**: przekazać tę opcję, aby `play` Metoda, aby określić ile razy chcesz, pliku multimedialnego do gry, np.:
+
+ var myMedia = new Media("http://audio.ibeat.org/content/p1rj1s/p1rj1s_-_rockGuitar.mp3")
+ myMedia.play({ numberOfLoops: 2 })
+
+
+* **playAudioWhenScreenIsLocked**: przekazać tę opcję, aby `play` Metoda, aby określić, czy chcesz umożliwić odtwarzanie, gdy ekran jest zablokowana. Jeśli zestaw `true` (wartość domyślna), stan przycisku Wycisz sprzętu jest ignorowane, np.:
+
+ var myMedia = new Media("http://audio.ibeat.org/content/p1rj1s/p1rj1s_-_rockGuitar.mp3")
+ myMedia.play({ playAudioWhenScreenIsLocked : false })
+
+
+* **kolejność wyszukiwania plików**: gdy tylko nazwa pliku lub ścieżka prosta pod warunkiem, iOS wyszukiwania w `www` katalogu, pliku, a następnie w aplikacji `documents/tmp` katalogu:
+
+ 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
+
+Zwalnia zasoby audio system operacyjny. Jest to szczególnie ważne dla systemu Android, ponieważ istnieje skończona ilość podstawie OpenCore wystąpień do odtwarzania multimediów. Aplikacje powinny wywoływać `release` funkcja dla każdego `Media` zasób, który nie jest już potrzebna.
+
+ media.release();
+
+
+### Szybki przykład
+
+ // Audio player
+ //
+ var my_media = new Media(src, onSuccess, onError);
+
+ my_media.play();
+ my_media.stop();
+ my_media.release();
+
+
+## media.seekTo
+
+Ustawia bieżącej pozycji w pliku audio.
+
+ media.seekTo(milliseconds);
+
+
+### Parametry
+
+* **milisekund**: stanowisko ustala pozycję odtwarzania w audio, w milisekundach.
+
+### Szybki przykład
+
+ // 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);
+
+
+### Jeżyna 10 dziwactwa
+
+* Nie obsługiwane na urządzeniach BlackBerry OS w wersji 5.
+
+## media.setVolume
+
+Ustaw głośność pliku audio.
+
+ media.setVolume(volume);
+
+
+### Parametry
+
+* **wielkość**: wielkość ustawić odtwarzanie. Wartość musi być z zakresu od 0.0 do 1.0.
+
+### Obsługiwane platformy
+
+* Android
+* iOS
+
+### Szybki przykład
+
+ // 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
+
+Rozpoczyna nagrywanie pliku audio.
+
+ media.startRecord();
+
+
+### Obsługiwane platformy
+
+* Android
+* iOS
+* Windows Phone 7 i 8
+* Windows 8
+
+### Szybki przykład
+
+ // 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 dziwactwa
+
+* Urządzenia z systemem Android nagrywanie dźwięku w formacie Adaptive Multi-Rate. Określony plik powinien kończyć się rozszerzeniem *AMR* .
+
+### iOS dziwactwa
+
+* iOS tylko rekordy do plików typu *.wav* i zwraca błąd, jeśli nazwa pliku rozszerzenie jest nie prawidłowe.
+
+* Jeśli nie podano pełną ścieżkę, nagrywanie jest umieszczony w aplikacji `documents/tmp` katalogu. To mogą być dostępne za pośrednictwem `File` za pomocą interfejsu API `LocalFileSystem.TEMPORARY` . Każdy podkatalog określony w rekordowym czasie musi już istnieć.
+
+* Pliki mogą być zapisywane i grał z powrotem za pomocą dokumentów URI:
+
+ var myMedia = new Media("documents://beer.mp3")
+
+
+### Osobliwości Tizen
+
+* Nie obsługiwane na Tizen urządzenia.
+
+## media.stop
+
+Zatrzymuje odtwarzanie pliku audio.
+
+ Media.stop();
+
+
+### Szybki przykład
+
+ // 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
+
+Zatrzymuje nagrywanie pliku audio.
+
+ media.stopRecord();
+
+
+### Obsługiwane platformy
+
+* Android
+* iOS
+* Windows Phone 7 i 8
+* Windows 8
+
+### Szybki przykład
+
+ // 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);
+ }
+
+
+### Osobliwości Tizen
+
+* Nie obsługiwane na Tizen urządzenia.
+
+## MediaError
+
+A `MediaError` obiekt jest zwracany do `mediaError` funkcji wywołania zwrotnego, gdy wystąpi błąd.
+
+### Właściwości
+
+* **Kod**: jeden z kodów błędów wstępnie zdefiniowanych poniżej.
+
+* **wiadomość**: komunikat o błędzie, opisując szczegóły błędu.
+
+### Stałe
+
+* `MediaError.MEDIA_ERR_ABORTED`
+* `MediaError.MEDIA_ERR_NETWORK`
+* `MediaError.MEDIA_ERR_DECODE`
+* `MediaError.MEDIA_ERR_NONE_SUPPORTED`
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-plugin-media/blob/400df60a/doc/zh/index.md
----------------------------------------------------------------------
diff --git a/doc/zh/index.md b/doc/zh/index.md
new file mode 100644
index 0000000..c9c8907
--- /dev/null
+++ b/doc/zh/index.md
@@ -0,0 +1,488 @@
+<!---
+ 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
+
+這個外掛程式提供錄製和播放設備上的音訊檔的能力。
+
+**注**： 當前的實現並不遵循 W3C 規範的媒體捕獲和僅用於提供方便。 將來的實現將堅持以最新的 W3C 規範和可能棄用當前 Api。
+
+## 安裝
+
+ cordova plugin add org.apache.cordova.media
+
+
+## 支援的平臺
+
+* Android 系統
+* 黑莓 10
+* iOS
+* Windows Phone 7 和 8
+* Tizen
+* Windows 8
+
+## Windows Phone 怪癖
+
+* 只有一個媒體檔案，可以播放一次。
+
+* 沒有嚴格限制對您的應用程式與其他媒體的對話模式。 請參見[Microsoft 文檔的詳細資訊][1].
+
+ [1]: http://msdn.microsoft.com/en-us/library/windowsphone/develop/hh184838(v=vs.92).aspx
+
+## 媒體
+
+ var media = new Media(src, mediaSuccess, [mediaError], [mediaStatus]);
+
+
+### 參數
+
+* **src**： 包含音訊內容的 URI。*() DOMString*
+
+* **mediaSuccess**： （可選） 後執行的回檔 `Media` 物件已完成當前戲劇、 記錄或停止行動。*（函數）*
+
+* **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
+
+釋放底層作業系統的音訊資源。 這是特別重要的 android 作業系統，因為有了有限數量的 OpenCore 實例播放媒體。 應用程式應當調用 `release` 函數的任何 `Media` 不再需要的資源。
+
+ 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 的範圍內。
+
+### 支援的平臺
+
+* Android 系統
+* 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() ；
+
+
+### 支援的平臺
+
+* Android 系統
+* iOS
+* Windows Phone 7 和 8
+* Windows 8
+
+### 快速的示例
+
+ // 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*副檔名結尾。
+
+### iOS 的怪癖
+
+* iOS 只記錄到檔的類型*.wav*和返回一個錯誤如果檔副檔名不正確。
+
+* 如果未提供的完整路徑，錄音放在應用程式的 `documents/tmp` 目錄。 這可以通過訪問 `File` API 使用 `LocalFileSystem.TEMPORARY` 。 在記錄時指定的任何子目錄中必須已經存在。
+
+* 檔可以記錄和演奏的後面使用的檔的 URI：
+
+ var myMedia = new Media("documents://beer.mp3")
+
+
+### 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() ；
+
+
+### 支援的平臺
+
+* Android 系統
+* iOS
+* Windows Phone 7 和 8
+* Windows 8
+
+### 快速的示例
+
+ // 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
+
+A `MediaError` 物件返回到 `mediaError` 時出現錯誤的回呼函數。
+
+### 屬性
+
+* **代碼**： 下面列出的預定義的錯誤代碼之一。
+
+* **消息**： 錯誤訊息描述該錯誤的詳細資訊。
+
+### 常量
+
+* `MediaError.MEDIA_ERR_ABORTED`
+* `MediaError.MEDIA_ERR_NETWORK`
+* `MediaError.MEDIA_ERR_DECODE`
+* `MediaError.MEDIA_ERR_NONE_SUPPORTED`
\ No newline at end of file