You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cordova.apache.org by be...@apache.org on 2013/02/21 15:07:49 UTC

docs commit: [CB-571] iOS Audio updates

Updated Branches:
  refs/heads/master 6d1cf0b79 -> dc5de6711


[CB-571]  iOS Audio updates

Updated the iOS Quirks for play and record


Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/dc5de671
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/dc5de671
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/dc5de671

Branch: refs/heads/master
Commit: dc5de671164363232415cba434e7e48a20bc9b86
Parents: 6d1cf0b
Author: Becky Gibson <be...@apache.org>
Authored: Thu Feb 21 09:02:39 2013 -0500
Committer: Becky Gibson <be...@apache.org>
Committed: Thu Feb 21 09:04:06 2013 -0500

----------------------------------------------------------------------
 docs/en/edge/cordova/media/media.play.md        |    8 ++++++++
 docs/en/edge/cordova/media/media.startRecord.md |    6 +++++-
 2 files changed, 13 insertions(+), 1 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/dc5de671/docs/en/edge/cordova/media/media.play.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/cordova/media/media.play.md b/docs/en/edge/cordova/media/media.play.md
index f8c4429..7845f39 100644
--- a/docs/en/edge/cordova/media/media.play.md
+++ b/docs/en/edge/cordova/media/media.play.md
@@ -188,3 +188,11 @@ iOS Quirk
     
         var myMedia = new Media("http://audio.ibeat.org/content/p1rj1s/p1rj1s_-_rockGuitar.mp3")
         myMedia.play({ playAudioWhenScreenIsLocked : false })
+
+
+- __order of file search__
+
+    When only a file name or simple path is provided, iOS will search in the www for the file and then in the application documents/tmp directory.
+
+        var myMedia = new Media("audio/beer.mp3")
+        myMedia.play()  // will first look for file in www/audio/beer.mp3 then in <application>/documents/tmp/audio/beer.mp3

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/dc5de671/docs/en/edge/cordova/media/media.startRecord.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/cordova/media/media.startRecord.md b/docs/en/edge/cordova/media/media.startRecord.md
index 87a1785..2b8cc92 100644
--- a/docs/en/edge/cordova/media/media.startRecord.md
+++ b/docs/en/edge/cordova/media/media.startRecord.md
@@ -144,7 +144,11 @@ BlackBerry WebWorks Quirks
 iOS Quirks
 ----------
 
-- The file to record to must already exist and should be of type .wav. The File API's can be used to create the file.
+- iOS only records to files of type .wav and returns an error if the file name extension is not correct.
+- If a full path is not provided the recording will be placed in the <application>/documents/tmp directory.  This can be accessed via the File apis using LocalFileSystem.TEMPORARY.  Subdirectories are not created at record time and must already exist.  Thus,  myRecording.wav will work but recordings/myRecording.wav will not if the recordings directory does not already exist at <application>/documents/tmp/.
+- Files can be recorded and played back using the documents URI:
+
+        var myMedia = new Media("documents://beer.mp3")
 
 Tizen Quirks
 ----------