diff options
Diffstat (limited to 'plugins/org.apache.cordova.media/doc/de/index.md')
| -rw-r--r-- | plugins/org.apache.cordova.media/doc/de/index.md | 494 |
1 files changed, 494 insertions, 0 deletions
diff --git a/plugins/org.apache.cordova.media/doc/de/index.md b/plugins/org.apache.cordova.media/doc/de/index.md new file mode 100644 index 00000000..e3e6cd73 --- /dev/null +++ b/plugins/org.apache.cordova.media/doc/de/index.md @@ -0,0 +1,494 @@ +<!--- + Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. +--> + +# org.apache.cordova.media + +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. + +### 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 rufen die `release` -Funktion für alle `Media` Ressource, 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 + +* **Millisekunden**: 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 + +* **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 + +### 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 8 + +### 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. + +### 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 8 Macken + +* 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 8 + +### 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 + +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`= 1 +* `MediaError.MEDIA_ERR_NETWORK`= 2 +* `MediaError.MEDIA_ERR_DECODE`= 3 +* `MediaError.MEDIA_ERR_NONE_SUPPORTED`= 4
\ No newline at end of file |