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/2fb46e23 Tree: http://git-wip-us.apache.org/repos/asf/cordova-plugin-media/tree/2fb46e23 Diff: http://git-wip-us.apache.org/repos/asf/cordova-plugin-media/diff/2fb46e23 Branch: refs/heads/master Commit: 2fb46e23ba05501edc7cdea380f065ece2087cb7 Parents: 400df60 Author: ldeluca <[email protected]> Authored: Tue May 27 21:36:50 2014 -0400 Committer: ldeluca <[email protected]> Committed: Tue May 27 21:36:50 2014 -0400 ---------------------------------------------------------------------- doc/de/index.md | 488 +++++++++++++++++++++++++++++++++++++++++++++++++++ doc/ja/index.md | 8 +- 2 files changed, 492 insertions(+), 4 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/cordova-plugin-media/blob/2fb46e23/doc/de/index.md ---------------------------------------------------------------------- diff --git a/doc/de/index.md b/doc/de/index.md new file mode 100644 index 0000000..38d4f3a --- /dev/null +++ b/doc/de/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 + +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. + +## Installation + + cordova plugin add org.apache.cordova.media + + +## Unterstützte Plattformen + +* Android +* BlackBerry 10 +* iOS +* Windows Phone 7 und 8 +* Tizen +* Windows 8 + +## 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][1]. + + [1]: 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 gemeldet, als einzigem Parameter an die `mediaStatus` Rückruf: + +* `Media.MEDIA_NONE`= 0; +* `Media.MEDIA_STARTING`= 1; +* `Media.MEDIA_RUNNING`= 2; +* `Media.MEDIA_PAUSED`= 3; +* `Media.MEDIA_STOPPED`= 4; + +### 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. Aktualisiert auch die `Media` des Objekts `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. + +### Kleines 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(); + + +### Kleines 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(); + + +### Kleines 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(); + + +### Kleines 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 rufen die `release` -Funktion für alle `Media` Ressource, die nicht mehr benötigt wird. + + media.release(); + + +### Kleines 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 + +* **Millisekunden**: die Position die Wiedergabeposition innerhalb des Audiotracks in Millisekunden festgelegt. + +### Kleines 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 + +* **Lautstärke**: die Lautstärke für Wiedergabe fest. Der Wert muss im Bereich zwischen 0,0 und 1,0 liegen. + +### Unterstützte Plattformen + +* Android +* iOS + +### Kleines 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 8 + +### Kleines 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 Macken + +* Android-Geräte aufnehmen Audio im Adaptive Sprachcodecs Format. Die angegebene Datei sollte mit einer Endung *.amr* enden. + +### 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") + + +### Tizen Macken + +* Tizen Geräten unterstützt nicht. + +## media.stop + +Beendet die Wiedergabe einer Audiodatei. + + Media.Stop(); + + +### Kleines 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 8 + +### Kleines 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 + +A `MediaError` Objekt wird zurückgegeben, um die `mediaError` Callback-Funktion, wenn ein Fehler auftritt. + +### Eigenschaften + +* **Code**: einer der vordefinierten Fehlercodes aufgeführt. + +* **Nachricht**: eine Fehlermeldung beschreibt die Details des Fehlers. + +### Konstanten + +* `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/2fb46e23/doc/ja/index.md ---------------------------------------------------------------------- diff --git a/doc/ja/index.md b/doc/ja/index.md index 5b74c1c..2ed4fdc 100644 --- a/doc/ja/index.md +++ b/doc/ja/index.md @@ -19,7 +19,7 @@ # org.apache.cordova.media -This plugin provides the ability to record and play back audio files on a device. +ãã®ãã©ã°ã¤ã³ã¯ãè¨é²ããããã¤ã¹ä¸ã®ãªã¼ãã£ãª ãã¡ã¤ã«ãåçããæ©è½ãæä¾ãã¾ãã **注**: ç¾å¨ã®å®è£ ã§ã¯ãã¡ãã£ã¢ã®ãã£ããã£ã®ããã® W3C ä»æ§ã«æºæ ãã¦ããªãã¨ã¯ä¾¿å®ä¸æä¾ãããã ãã§ãã å°æ¥ã®å®è£ ãææ°ã® W3C ä»æ§ã«æºæ ããç¾å¨ Api ãã¨ããããã¨ãããã¾ãã @@ -102,7 +102,7 @@ This plugin provides the ability to record and play back audio files on a device ## media.getCurrentPosition -Returns the current position within an audio file. Also updates the `Media` object's `position` parameter. +ãªã¼ãã£ãª ãã¡ã¤ã«å ã®ç¾å¨ä½ç½®ãè¿ãã¾ããã¾ãæ´æ°ãã¦ã `Media` ãªãã¸ã§ã¯ãã® `position` ãã©ã¡ã¼ã¿ã¼ã media.getCurrentPosition(mediaSuccess, [mediaError]); @@ -139,7 +139,7 @@ Returns the current position within an audio file. Also updates the `Media` obje ## media.getDuration -Returns the duration of an audio file in seconds. If the duration is unknown, it returns a value of -1. +ãªã¼ãã£ãª ãã¡ã¤ã«ã®ç¶ç¶æé (ç§åä½) ãè¿ãã¾ããæéã¯ç¥ããã¦ããã-1 ã®å¤ãè¿ããã¾ãã media.getDuration(); @@ -245,7 +245,7 @@ Returns the duration of an audio file in seconds. If the duration is unknown, it ## media.release -åºã«ãªããªãã¬ã¼ãã£ã³ã° ã·ã¹ãã ã®ãªã¼ãã£ãª ãªã½ã¼ã¹ã解æ¾ãã¾ãã This is particularly important for Android, since there are a finite amount of OpenCore instances for media playback. ã¢ããªã±ã¼ã·ã§ã³ãå¼ã³åºãå¿ è¦ãããã¾ãã `release` ä»»æã®é¢æ° `Media` ã¯ããã¯ãå¿ è¦ãªãªã½ã¼ã¹ã§ãã +åºã«ãªããªãã¬ã¼ãã£ã³ã° ã·ã¹ãã ã®ãªã¼ãã£ãª ãªã½ã¼ã¹ã解æ¾ãã¾ãã ã¡ãã£ã¢ã®åçã®ããã® OpenCore ã¤ã³ã¹ã¿ã³ã¹ã®æéãªéãããã®ã§ã人é 人éã®ããç¹ã«éè¦ã§ãã ã¢ããªã±ã¼ã·ã§ã³ãå¼ã³åºãå¿ è¦ãããã¾ãã `release` ä»»æã®é¢æ° `Media` ã¯ããã¯ãå¿ è¦ãªãªã½ã¼ã¹ã§ãã media.release();
