You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cordova.apache.org by mw...@apache.org on 2013/08/30 19:25:56 UTC
[06/36] Add edge for Spanish, French, and Chinese.
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/992e9151/docs/zh/edge/cordova/media/capture/MediaFile.getFormatData.md
----------------------------------------------------------------------
diff --git a/docs/zh/edge/cordova/media/capture/MediaFile.getFormatData.md b/docs/zh/edge/cordova/media/capture/MediaFile.getFormatData.md
new file mode 100644
index 0000000..19e7284
--- /dev/null
+++ b/docs/zh/edge/cordova/media/capture/MediaFile.getFormatData.md
@@ -0,0 +1,46 @@
+---
+
+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.
+---
+
+# MediaFile.getFormatData
+
+> 检索格式媒体捕获文件的信息。
+
+ mediaFile.getFormatData （MediaFileDataSuccessCB successCallback） [MediaFileDataErrorCB errorCallback] ；
+
+
+## 说明
+
+此函数以异步方式尝试检索该媒体文件的格式信息。 如果成功，它将调用 `MediaFileDataSuccessCB` 回调与 `MediaFileData` 对象。 如果该尝试失败，此函数将调用 `MediaFileDataErrorCB` 回调。
+
+## 支持的平台
+
+* Android 系统
+* 黑莓手机 WebWorks （OS 5.0 和更高）
+* iOS
+* Windows Phone 7 和 8
+* Windows 8
+
+## 黑莓 WebWorks 怪癖
+
+不为媒体文件，所以所有有关的信息提供一个 API `MediaFileData` 对象返回的默认值。
+
+## Android 的怪癖
+
+访问媒体文件格式信息的 API 的限制，所以并不是所有 `MediaFileData` 支持的属性。
+
+## iOS 的怪癖
+
+访问媒体文件格式信息的 API 的限制，所以并不是所有 `MediaFileData` 支持的属性。
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/992e9151/docs/zh/edge/cordova/media/capture/MediaFile.md
----------------------------------------------------------------------
diff --git a/docs/zh/edge/cordova/media/capture/MediaFile.md b/docs/zh/edge/cordova/media/capture/MediaFile.md
new file mode 100644
index 0000000..45b5e87
--- /dev/null
+++ b/docs/zh/edge/cordova/media/capture/MediaFile.md
@@ -0,0 +1,35 @@
+---
+
+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.
+---
+
+# 媒体
+
+> 封装媒体捕获文件的属性。
+
+## 属性
+
+* **名称**： 文件的名称，不包含路径信息。() DOMString
+
+* **完整路径**： 文件，包括名称的完整路径。() DOMString
+
+* **类型**： 文件的 mime 类型 (DOMString)
+
+* **lastModifiedDate**： 日期和文件的上次修改时间。（日期）
+
+* **大小**： 文件的大小，以字节为单位。（人数）
+
+## 方法
+
+* **MediaFile.getFormatData**: 检索该媒体文件的格式信息。
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/992e9151/docs/zh/edge/cordova/media/capture/MediaFileData.md
----------------------------------------------------------------------
diff --git a/docs/zh/edge/cordova/media/capture/MediaFileData.md b/docs/zh/edge/cordova/media/capture/MediaFileData.md
new file mode 100644
index 0000000..36e3231
--- /dev/null
+++ b/docs/zh/edge/cordova/media/capture/MediaFileData.md
@@ -0,0 +1,73 @@
+---
+
+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.
+---
+
+# MediaFileData
+
+> 封装有关的媒体文件的格式信息。
+
+## 属性
+
+* **编解码器**： 实际的音频和视频内容的格式。() DOMString
+
+* **比特率**： 内容的平均比特率。值为零的图像。（人数）
+
+* **高度**： 图像或视频以像素为单位的高度。值为零的音频剪辑。（人数）
+
+* **宽度**： 图像或视频以像素为单位的宽度。值为零的音频剪辑。（人数）
+
+* **持续时间**： 以秒为单位的视频或声音剪辑的长度。值为零的图像。（人数）
+
+## 黑莓 WebWorks 怪癖
+
+没有 API 提供的格式信息的媒体文件，所以 `MediaFileData` 对象返回的 `MediaFile.getFormatData` 功能以下默认值：
+
+* **编解码器**： 不受支持，并且返回`null`.
+
+* **比特率**: 不受支持，并且返回零。
+
+* **高度**: 不受支持，并且返回零。
+
+* **宽度**: 不受支持，并且返回零。
+
+* **持续时间**： 不受支持，并且返回零。
+
+## Android 的怪癖
+
+支持以下 `MediaFileData` 属性：
+
+* **编解码器**： 不受支持，并且返回`null`.
+
+* **比特率**: 不受支持，并且返回零。
+
+* **高度**： 支持： 仅图像和视频文件。
+
+* **宽度**： 支持： 仅图像和视频文件。
+
+* **持续时间**： 支持： 仅音频和视频文件。
+
+## iOS 的怪癖
+
+支持以下 `MediaFileData` 属性：
+
+* **编解码器**： 不受支持，并且返回`null`.
+
+* **比特率**： 仅音频 iOS4 设备上受支持。对于图像和视频，返回零。
+
+* **高度**： 支持： 仅图像和视频文件。
+
+* **宽度**： 支持： 仅图像和视频文件。
+
+* **持续时间**： 支持： 仅音频和视频文件。
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/992e9151/docs/zh/edge/cordova/media/capture/capture.md
----------------------------------------------------------------------
diff --git a/docs/zh/edge/cordova/media/capture/capture.md b/docs/zh/edge/cordova/media/capture/capture.md
new file mode 100644
index 0000000..8b07c54
--- /dev/null
+++ b/docs/zh/edge/cordova/media/capture/capture.md
@@ -0,0 +1,104 @@
+---
+
+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.
+---
+
+# 捕获
+
+> 提供对设备的音频、 图像和视频捕获功能的访问。
+
+**重要的隐私注：**收集和使用的图像、 视频或音频设备的摄像头或麦克风从提出了重要的隐私问题。 您的应用程序的隐私策略应该讨论应用程序如何使用这种传感器和记录的数据是否与任何其他方共享。 另外，如果摄像机或麦克风的应用程序的使用在用户界面中不是明显的你应该在您的应用程序访问的相机或麦克风 （如果设备操作系统不会这样做已经） 之前提供只是在时间的通知。 该通知应提供相同的信息上文指出的并获取该用户的权限 （例如，通过为**确定**并**不感谢**提出的选择）。 请注意有些应用程序市场可能需要您的应用程序提供只是时间的通知，并从访问摄像机或麦克风之前用户获得的权限。 有关详细信息，请参阅隐私指南。
+
+## 对象
+
+* 捕获
+* CaptureAudioOptions
+* CaptureImageOptions
+* CaptureVideoOptions
+* CaptureCallback
+* CaptureErrorCB
+* 配置
+* 媒体
+* MediaFileData
+
+## 方法
+
+* capture.captureAudio
+* capture.captureImage
+* capture.captureVideo
+* MediaFile.getFormatData
+
+## 范围
+
+The `capture` object is assigned to the `navigator.device` object, and therefore has global scope.
+
+ // The global capture object
+ var capture = navigator.device.capture;
+
+
+## 属性
+
+* **supportedAudioModes**： 音频录音设备所支持的格式。(ConfigurationData[])
+
+* **supportedImageModes**： 录制图像大小和格式的设备支持。(ConfigurationData[])
+
+* **supportedVideoModes**： 录制的视频分辨率和设备支持的格式。(ConfigurationData[])
+
+## 方法
+
+* `capture.captureAudio`： 启动设备的音频录音应用程序来记录音频剪辑。
+
+* `capture.captureImage`： 启动设备的摄像头应用程序采取的照片。
+
+* `capture.captureVideo`： 启动设备的视频录像机应用程序要录制的视频。
+
+## 支持的平台
+
+* Android 系统
+* 黑莓手机 WebWorks （OS 5.0 和更高）
+* iOS
+* Windows Phone 7 和 8
+* Windows 8
+
+## 访问功能
+
+从 3.0 版，科尔多瓦作为*插件*实现了设备级 Api。 使用 CLI 的 `plugin` 命令，描述在命令行界面，可以添加或删除一个项目，为此功能：
+
+ $ cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-media-capture.git
+ $ cordova plugin rm org.apache.cordova.core.media-capture
+
+
+这些命令适用于所有有针对性的平台，但修改如下所述的特定于平台的配置设置：
+
+* Android 系统
+
+ (in app/res/xml/plugins.xml) < 功能名称 ="捕获">< 参数名称 ="android 包"value="org.apache.cordova.Capture"/ >< / 功能 > (在 app/AndroidManifest.xml) < 使用权限 android:name="android.permission.RECORD_AUDIO"/ >< 使用权限 android:name="android.permission.WRITE_EXTERNAL_STORAGE"/ >
+
+
+* 黑莓手机 WebWorks
+
+ (in www/plugins.xml) < 功能名称 ="捕获">< 参数名称 ="黑莓手机-包"value="org.apache.cordova.capture.MediaCapture"/ >< / 功能 > (在 www/config.xml) < 功能 id="blackberry.system"所需 ="true"版本 ="1.0.0.0"/ >< 功能 id="blackberry.io.file"所需 ="true"版本 ="1.0.0.0"/ >
+
+
+* （在 iOS`config.xml`)
+
+ < 功能名称 ="捕获">< 参数名称 ="ios 包"值 ="CDVCapture"/ >< / 功能 >
+
+
+* （在 Windows Phone`Properties/WPAppManifest.xml`)
+
+ < 功能 >< 功能名称 ="ID_CAP_MEDIALIB"/ >< 能力名称 ="ID_CAP_MICROPHONE"/ >< 功能名称 ="ID_HW_FRONTCAMERA"/ >< 功能名称 ="ID_CAP_ISV_CAMERA"/ >< 能力名称 ="ID_CAP_CAMERA"/ >< / 功能 >
+
+
+一些平台可能支持此功能，而无需任何特殊的配置。有关概述，请参见平台支持。
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/992e9151/docs/zh/edge/cordova/media/capture/captureAudio.md
----------------------------------------------------------------------
diff --git a/docs/zh/edge/cordova/media/capture/captureAudio.md b/docs/zh/edge/cordova/media/capture/captureAudio.md
new file mode 100644
index 0000000..40ee4c8
--- /dev/null
+++ b/docs/zh/edge/cordova/media/capture/captureAudio.md
@@ -0,0 +1,133 @@
+---
+
+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.
+---
+
+# capture.captureAudio
+
+> 启动音频录音机应用程序并返回有关捕获音频剪辑文件的信息。
+
+ navigator.device.capture.captureAudio(
+ CaptureCB captureSuccess, CaptureErrorCB captureError, [CaptureAudioOptions options]
+ );
+
+
+## 说明
+
+开始异步操作以捕获使用该设备的默认音频录制应用程序的音频录制。 该操作允许设备用户的单个会话中捕获多个录音。
+
+在捕获操作结束时或者在用户退出音频录音应用程序或由指定的录音的最大数目 `CaptureAudioOptions.limit` 到达。 如果没有 `limit` 指定参数的值，它将默认为一 (1) 和捕获操作终止后用户记录单个音频剪辑。
+
+在捕获操作完成后， `CaptureCallback` 执行与数组的 `MediaFile` 对象描述每个捕获音频剪辑文件。 如果用户终止操作之前捕获音频剪辑时， `CaptureErrorCallback` 与执行 `CaptureError` 对象中，设有 `CaptureError.CAPTURE_NO_MEDIA_FILES` 错误代码。
+
+## 支持的平台
+
+* Android 系统
+* 黑莓手机 WebWorks （OS 5.0 和更高）
+* iOS
+* Windows Phone 7 和 8
+* Windows 8
+
+## 快速的示例
+
+ // capture callback
+ var captureSuccess = function(mediaFiles) {
+ var i, path, len;
+ for (i = 0, len = mediaFiles.length; i < len; i += 1) {
+ path = mediaFiles[i].fullPath;
+ // do something interesting with the file
+ }
+ };
+
+ // capture error callback
+ var captureError = function(error) {
+ navigator.notification.alert('Error code: ' + error.code, null, 'Capture Error');
+ };
+
+ // start audio capture
+ navigator.device.capture.captureAudio(captureSuccess, captureError, {limit:2});
+
+
+## 完整的示例
+
+ <!DOCTYPE html>
+ <html>
+ <head>
+ <title>Capture Audio</title>
+
+ <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
+ <script type="text/javascript" charset="utf-8" src="json2.js"></script>
+ <script type="text/javascript" charset="utf-8">
+
+ // Called when capture operation is finished
+ //
+ function captureSuccess(mediaFiles) {
+ var i, len;
+ for (i = 0, len = mediaFiles.length; i < len; i += 1) {
+ uploadFile(mediaFiles[i]);
+ }
+ }
+
+ // Called if something bad happens.
+ //
+ function captureError(error) {
+ var msg = 'An error occurred during capture: ' + error.code;
+ navigator.notification.alert(msg, null, 'Uh oh!');
+ }
+
+ // A button will call this function
+ //
+ function captureAudio() {
+ // Launch device audio recording application,
+ // allowing user to capture up to 2 audio clips
+ navigator.device.capture.captureAudio(captureSuccess, captureError, {limit: 2});
+ }
+
+ // Upload files to server
+ function uploadFile(mediaFile) {
+ var ft = new FileTransfer(),
+ path = mediaFile.fullPath,
+ name = mediaFile.name;
+
+ ft.upload(path,
+ "http://my.domain.com/upload.php",
+ function(result) {
+ console.log('Upload success: ' + result.responseCode);
+ console.log(result.bytesSent + ' bytes sent');
+ },
+ function(error) {
+ console.log('Error uploading file ' + path + ': ' + error.code);
+ },
+ { fileName: name });
+ }
+
+ </script>
+ </head>
+ <body>
+ <button onclick="captureAudio();">Capture Audio</button> <br>
+ </body>
+ </html>
+
+
+## 黑莓 WebWorks 怪癖
+
+* 科尔多瓦的黑莓 WebWorks 尝试启动**录音笔记**提供的应用程序，由 RIM，来捕获音频录制。 这款应用程序会收到 `CaptureError.CAPTURE_NOT_SUPPORTED` 错误代码，如果应用程序未安装在设备上。
+
+## iOS 的怪癖
+
+* iOS 没有默认的音频录音应用程序，因此提供了一个简单的用户界面。
+
+## Windows Phone 7 和 8 怪癖
+
+* Windows Phone 7 没有默认的音频录音应用程序，因此提供了一个简单的用户界面。
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/992e9151/docs/zh/edge/cordova/media/capture/captureAudioOptions.md
----------------------------------------------------------------------
diff --git a/docs/zh/edge/cordova/media/capture/captureAudioOptions.md b/docs/zh/edge/cordova/media/capture/captureAudioOptions.md
new file mode 100644
index 0000000..af9d844
--- /dev/null
+++ b/docs/zh/edge/cordova/media/capture/captureAudioOptions.md
@@ -0,0 +1,45 @@
+---
+
+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.
+---
+
+# CaptureAudioOptions
+
+> 封装的音频捕获的配置选项。
+
+## 属性
+
+* **限制**： 音频剪辑设备用户可以在单个捕获操作中记录的最大数目。值必须是大于或等于 1 （默认为 1）。
+
+* **持续时间**： 音频的声音剪辑，以秒为单位的最长期限。
+
+## 快速的示例
+
+ // limit capture operation to 3 media files, no longer than 10 seconds each
+ var options = { limit: 3, duration: 10 };
+
+ navigator.device.capture.captureAudio(captureSuccess, captureError, options);
+
+
+## Android 的怪癖
+
+* `duration`参数不受支持。记录长度不能局限以编程方式。
+
+## 黑莓 WebWorks 怪癖
+
+* `duration`参数不受支持。记录长度不能局限以编程方式。
+
+## iOS 的怪癖
+
+* `limit`参数不受支持，所以只有一个记录可以创建的每个调用。
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/992e9151/docs/zh/edge/cordova/media/capture/captureImage.md
----------------------------------------------------------------------
diff --git a/docs/zh/edge/cordova/media/capture/captureImage.md b/docs/zh/edge/cordova/media/capture/captureImage.md
new file mode 100644
index 0000000..3425cde
--- /dev/null
+++ b/docs/zh/edge/cordova/media/capture/captureImage.md
@@ -0,0 +1,124 @@
+---
+
+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.
+---
+
+# capture.captureImage
+
+> 启动摄像头应用程序并返回有关捕获的图像文件的信息。
+
+ navigator.device.capture.captureImage(
+ CaptureCB captureSuccess, CaptureErrorCB captureError, [CaptureImageOptions options]
+ );
+
+
+## 说明
+
+开始异步操作以捕获图像使用该设备的摄像头应用程序。该操作允许用户在一个会话中捕获多个图像。
+
+在捕获操作结束或者当用户关闭摄像头应用程序或由指定的录音的最大数目 `CaptureAudioOptions.limit` 到达。 如果没有 `limit` 指定的值，它将默认为一 (1) 和捕获操作终止后用户捕获单个图像。
+
+在捕获操作完成后，它将调用 `CaptureCB` 回调与数组的 `MediaFile` 对象描述每个捕获的图像文件。 如果用户终止之前捕获图像，操作 `CaptureErrorCB` 回调执行与 `CaptureError` 对象特色 `CaptureError.CAPTURE_NO_MEDIA_FILES` 错误代码。
+
+## 支持的平台
+
+* Android 系统
+* 黑莓手机 WebWorks （OS 5.0 和更高）
+* iOS
+* Windows Phone 7 和 8
+* Windows 8
+
+## Windows Phone 7 的怪癖
+
+调用本机摄像头应用程序，同时通过 Zune 连接您的设备不工作，并错误回调执行。
+
+## 快速的示例
+
+ // capture callback
+ var captureSuccess = function(mediaFiles) {
+ var i, path, len;
+ for (i = 0, len = mediaFiles.length; i < len; i += 1) {
+ path = mediaFiles[i].fullPath;
+ // do something interesting with the file
+ }
+ };
+
+ // capture error callback
+ var captureError = function(error) {
+ navigator.notification.alert('Error code: ' + error.code, null, 'Capture Error');
+ };
+
+ // start image capture
+ navigator.device.capture.captureImage(captureSuccess, captureError, {limit:2});
+
+
+## 完整的示例
+
+ <!DOCTYPE html>
+ <html>
+ <head>
+ <title>Capture Image</title>
+
+ <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
+ <script type="text/javascript" charset="utf-8" src="json2.js"></script>
+ <script type="text/javascript" charset="utf-8">
+
+ // Called when capture operation is finished
+ //
+ function captureSuccess(mediaFiles) {
+ var i, len;
+ for (i = 0, len = mediaFiles.length; i < len; i += 1) {
+ uploadFile(mediaFiles[i]);
+ }
+ }
+
+ // Called if something bad happens.
+ //
+ function captureError(error) {
+ var msg = 'An error occurred during capture: ' + error.code;
+ navigator.notification.alert(msg, null, 'Uh oh!');
+ }
+
+ // A button will call this function
+ //
+ function captureImage() {
+ // Launch device camera application,
+ // allowing user to capture up to 2 images
+ navigator.device.capture.captureImage(captureSuccess, captureError, {limit: 2});
+ }
+
+ // Upload files to server
+ function uploadFile(mediaFile) {
+ var ft = new FileTransfer(),
+ path = mediaFile.fullPath,
+ name = mediaFile.name;
+
+ ft.upload(path,
+ "http://my.domain.com/upload.php",
+ function(result) {
+ console.log('Upload success: ' + result.responseCode);
+ console.log(result.bytesSent + ' bytes sent');
+ },
+ function(error) {
+ console.log('Error uploading file ' + path + ': ' + error.code);
+ },
+ { fileName: name });
+ }
+
+ </script>
+ </head>
+ <body>
+ <button onclick="captureImage();">Capture Image</button> <br>
+ </body>
+ </html>
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/992e9151/docs/zh/edge/cordova/media/capture/captureImageOptions.md
----------------------------------------------------------------------
diff --git a/docs/zh/edge/cordova/media/capture/captureImageOptions.md b/docs/zh/edge/cordova/media/capture/captureImageOptions.md
new file mode 100644
index 0000000..dbb7042
--- /dev/null
+++ b/docs/zh/edge/cordova/media/capture/captureImageOptions.md
@@ -0,0 +1,35 @@
+---
+
+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.
+---
+
+# CaptureImageOptions
+
+> 封装图像捕获的配置选项。
+
+## 属性
+
+* **限制**： 用户可以在单个捕获操作中捕获的图像的最大数目。值必须是大于或等于 1 （默认为 1）。
+
+## 快速的示例
+
+ // limit capture operation to 3 images
+ var options = { limit: 3 };
+
+ navigator.device.capture.captureImage(captureSuccess, captureError, options);
+
+
+## iOS 的怪癖
+
+* **限制**参数不受支持，并只有一个图像采取每次调用的。
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/992e9151/docs/zh/edge/cordova/media/capture/captureVideo.md
----------------------------------------------------------------------
diff --git a/docs/zh/edge/cordova/media/capture/captureVideo.md b/docs/zh/edge/cordova/media/capture/captureVideo.md
new file mode 100644
index 0000000..e09b4ca
--- /dev/null
+++ b/docs/zh/edge/cordova/media/capture/captureVideo.md
@@ -0,0 +1,125 @@
+---
+
+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.
+---
+
+# capture.captureVideo
+
+> 启动视频录制器应用程序并返回有关捕获的视频剪辑文件的信息。
+
+ navigator.device.capture.captureVideo(
+ CaptureCB captureSuccess, CaptureErrorCB captureError, [CaptureVideoOptions options]
+ );
+
+
+## 说明
+
+开始异步操作以捕获使用该设备的视频录制应用程序的视频录制。该操作允许用户在一个会话中捕获多个录音。
+
+在捕获操作结束时或者在用户退出视频录制应用程序或由指定的录音的最大数目 `CaptureVideoOptions.limit` 到达。 如果没有 `limit` 指定参数的值，它将默认为一 (1) 和捕获操作终止后用户记录单个视频剪辑。
+
+在捕获操作完成后，它 `CaptureCB` 回调执行与数组的 `MediaFile` 对象描述每个捕获视频剪辑文件。 如果用户终止之前捕获的视频剪辑，操作 `CaptureErrorCB` 回调执行与 `CaptureError` 对象特色 `CaptureError.CAPTURE_NO_MEDIA_FILES` 错误代码。
+
+## 支持的平台
+
+* Android 系统
+* 黑莓手机 WebWorks （OS 5.0 和更高）
+* iOS
+* Windows Phone 7 和 8
+* Windows 8
+
+## 快速的示例
+
+ // capture callback
+ var captureSuccess = function(mediaFiles) {
+ var i, path, len;
+ for (i = 0, len = mediaFiles.length; i < len; i += 1) {
+ path = mediaFiles[i].fullPath;
+ // do something interesting with the file
+ }
+ };
+
+ // capture error callback
+ var captureError = function(error) {
+ navigator.notification.alert('Error code: ' + error.code, null, 'Capture Error');
+ };
+
+ // start video capture
+ navigator.device.capture.captureVideo(captureSuccess, captureError, {limit:2});
+
+
+## 完整的示例
+
+ <!DOCTYPE html>
+ <html>
+ <head>
+ <title>Capture Video</title>
+
+ <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
+ <script type="text/javascript" charset="utf-8" src="json2.js"></script>
+ <script type="text/javascript" charset="utf-8">
+
+ // Called when capture operation is finished
+ //
+ function captureSuccess(mediaFiles) {
+ var i, len;
+ for (i = 0, len = mediaFiles.length; i < len; i += 1) {
+ uploadFile(mediaFiles[i]);
+ }
+ }
+
+ // Called if something bad happens.
+ //
+ function captureError(error) {
+ var msg = 'An error occurred during capture: ' + error.code;
+ navigator.notification.alert(msg, null, 'Uh oh!');
+ }
+
+ // A button will call this function
+ //
+ function captureVideo() {
+ // Launch device video recording application,
+ // allowing user to capture up to 2 video clips
+ navigator.device.capture.captureVideo(captureSuccess, captureError, {limit: 2});
+ }
+
+ // Upload files to server
+ function uploadFile(mediaFile) {
+ var ft = new FileTransfer(),
+ path = mediaFile.fullPath,
+ name = mediaFile.name;
+
+ ft.upload(path,
+ "http://my.domain.com/upload.php",
+ function(result) {
+ console.log('Upload success: ' + result.responseCode);
+ console.log(result.bytesSent + ' bytes sent');
+ },
+ function(error) {
+ console.log('Error uploading file ' + path + ': ' + error.code);
+ },
+ { fileName: name });
+ }
+
+ </script>
+ </head>
+ <body>
+ <button onclick="captureVideo();">Capture Video</button> <br>
+ </body>
+ </html>
+
+
+## 黑莓 WebWorks 怪癖
+
+* 科尔多瓦的黑莓 WebWorks 尝试启动**视频录像机**提供的应用程序，由 RIM，以捕获视频的录制。 这款应用程序会收到 `CaptureError.CAPTURE_NOT_SUPPORTED` 错误代码，如果应用程序未安装在设备上。
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/992e9151/docs/zh/edge/cordova/media/capture/captureVideoOptions.md
----------------------------------------------------------------------
diff --git a/docs/zh/edge/cordova/media/capture/captureVideoOptions.md b/docs/zh/edge/cordova/media/capture/captureVideoOptions.md
new file mode 100644
index 0000000..42ffe21
--- /dev/null
+++ b/docs/zh/edge/cordova/media/capture/captureVideoOptions.md
@@ -0,0 +1,41 @@
+---
+
+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.
+---
+
+# CaptureVideoOptions
+
+> 封装视频捕获的配置选项。
+
+## 属性
+
+* **限制**： 该设备的用户可以在单个捕获操作中捕获的视频剪辑的最大数目。值必须是大于或等于 1 （默认为 1）。
+
+* **持续时间**： 视频剪辑，以秒为单位的最长期限。
+
+## 快速的示例
+
+ // limit capture operation to 3 video clips
+ var options = { limit: 3 };
+
+ navigator.device.capture.captureVideo(captureSuccess, captureError, options);
+
+
+## 黑莓 WebWorks 怪癖
+
+* 不支持的**持续时间**参数，所以录制的长度不能以编程方式加以限制。
+
+## iOS 的怪癖
+
+* **限制**参数不受支持。只有一个视频记录每次调用的。
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/992e9151/docs/zh/edge/cordova/media/media.getCurrentPosition.md
----------------------------------------------------------------------
diff --git a/docs/zh/edge/cordova/media/media.getCurrentPosition.md b/docs/zh/edge/cordova/media/media.getCurrentPosition.md
new file mode 100644
index 0000000..6dab893
--- /dev/null
+++ b/docs/zh/edge/cordova/media/media.getCurrentPosition.md
@@ -0,0 +1,173 @@
+---
+
+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.
+---
+
+# media.getCurrentPosition
+
+返回一个音频文件内的当前位置。
+
+ media.getCurrentPosition(mediaSuccess, [mediaError]);
+
+
+## 参数
+
+* **mediaSuccess**： 传递的当前的位置，以秒为单位的回调。
+
+* **mediaError**： （可选） 回调执行如果发生错误。
+
+## 说明
+
+一个异步的函数，它返回的基础音频文件的当前位置 `Media` 对象。此外可以更新 `Media` 对象的 `position` 参数。
+
+## 支持的平台
+
+* Android 系统
+
+* 黑莓手机 WebWorks （OS 5.0 和更高）
+
+* iOS
+
+* Windows Phone 7 和 8
+
+* Tizen
+
+* Windows 8
+
+## 快速的示例
+
+ // 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);
+
+
+## 完整的示例
+
+ <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
+ "http://www.w3.org/TR/html4/strict.dtd">
+ <html>
+ <head>
+ <title>Media Example</title>
+
+ <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
+ <script type="text/javascript" charset="utf-8">
+
+ // Wait for device API libraries to load
+ //
+ document.addEventListener("deviceready", onDeviceReady, false);
+
+ // device APIs are available
+ //
+ function onDeviceReady() {
+ playAudio("http://audio.ibeat.org/content/p1rj1s/p1rj1s_-_rockGuitar.mp3");
+ }
+
+ // Audio player
+ //
+ var my_media = null;
+ var mediaTimer = null;
+
+ // Play audio
+ //
+ function playAudio(src) {
+ // Create Media object from src
+ my_media = new Media(src, onSuccess, onError);
+
+ // Play audio
+ my_media.play();
+
+ // Update my_media position every second
+ if (mediaTimer == null) {
+ mediaTimer = setInterval(function() {
+ // get my_media position
+ my_media.getCurrentPosition(
+ // success callback
+ function(position) {
+ if (position > -1) {
+ setAudioPosition((position) + " sec");
+ }
+ },
+ // error callback
+ function(e) {
+ console.log("Error getting pos=" + e);
+ setAudioPosition("Error: " + e);
+ }
+ );
+ }, 1000);
+ }
+ }
+
+ // Pause audio
+ //
+ function pauseAudio() {
+ if (my_media) {
+ my_media.pause();
+ }
+ }
+
+ // Stop audio
+ //
+ function stopAudio() {
+ if (my_media) {
+ my_media.stop();
+ }
+ clearInterval(mediaTimer);
+ mediaTimer = null;
+ }
+
+ // onSuccess Callback
+ //
+ function onSuccess() {
+ console.log("playAudio():Audio Success");
+ }
+
+ // onError Callback
+ //
+ function onError(error) {
+ alert('code: ' + error.code + '\n' +
+ 'message: ' + error.message + '\n');
+ }
+
+ // Set audio position
+ //
+ function setAudioPosition(position) {
+ document.getElementById('audio_position').innerHTML = position;
+ }
+
+ </script>
+ </head>
+ <body>
+ <a href="#" class="btn large" onclick="playAudio('http://audio.ibeat.org/content/p1rj1s/p1rj1s_-_rockGuitar.mp3');">Play Audio</a>
+ <a href="#" class="btn large" onclick="pauseAudio();">Pause Playing Audio</a>
+ <a href="#" class="btn large" onclick="stopAudio();">Stop Playing Audio</a>
+ <p id="audio_position"></p>
+ </body>
+ </html>
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/992e9151/docs/zh/edge/cordova/media/media.getDuration.md
----------------------------------------------------------------------
diff --git a/docs/zh/edge/cordova/media/media.getDuration.md b/docs/zh/edge/cordova/media/media.getDuration.md
new file mode 100644
index 0000000..292f871
--- /dev/null
+++ b/docs/zh/edge/cordova/media/media.getDuration.md
@@ -0,0 +1,159 @@
+---
+
+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.
+---
+
+# media.getDuration
+
+返回一个音频文件的持续时间。
+
+ media.getDuration();
+
+
+## 说明
+
+`media.getDuration`方法执行同步，以秒为单位，返回该音频文件的持续时间，如果已知。如果持续时间是未知的则返回值为-1。
+
+## 支持的平台
+
+* Android 系统
+* 黑莓手机 WebWorks （OS 5.0 和更高）
+* iOS
+* Windows Phone 7 和 8
+* Tizen
+* Windows 8
+
+## 快速的示例
+
+ // 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);
+
+
+## 完整的示例
+
+ <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
+ "http://www.w3.org/TR/html4/strict.dtd">
+ <html>
+ <head>
+ <title>Media Example</title>
+
+ <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
+ <script type="text/javascript" charset="utf-8">
+
+ // Wait for device API libraries to load
+ //
+ document.addEventListener("deviceready", onDeviceReady, false);
+
+ // device APIs are available
+ //
+ function onDeviceReady() {
+ playAudio("http://audio.ibeat.org/content/p1rj1s/p1rj1s_-_rockGuitar.mp3");
+ }
+
+ // Audio player
+ //
+ var my_media = null;
+ var mediaTimer = null;
+
+ // Play audio
+ //
+ function playAudio(src) {
+ // Create Media object from src
+ my_media = new Media(src, onSuccess, onError);
+
+ // Play audio
+ my_media.play();
+
+ // Update my_media position every second
+ if (mediaTimer == null) {
+ mediaTimer = setInterval(function() {
+ // get my_media position
+ my_media.getCurrentPosition(
+ // success callback
+ function(position) {
+ if (position > -1) {
+ setAudioPosition((position) + " sec");
+ }
+ },
+ // error callback
+ function(e) {
+ console.log("Error getting pos=" + e);
+ setAudioPosition("Error: " + e);
+ }
+ );
+ }, 1000);
+ }
+ }
+
+ // Pause audio
+ //
+ function pauseAudio() {
+ if (my_media) {
+ my_media.pause();
+ }
+ }
+
+ // Stop audio
+ //
+ function stopAudio() {
+ if (my_media) {
+ my_media.stop();
+ }
+ clearInterval(mediaTimer);
+ mediaTimer = null;
+ }
+
+ // onSuccess Callback
+ //
+ function onSuccess() {
+ console.log("playAudio():Audio Success");
+ }
+
+ // onError Callback
+ //
+ function onError(error) {
+ alert('code: ' + error.code + '\n' +
+ 'message: ' + error.message + '\n');
+ }
+
+ // Set audio position
+ //
+ function setAudioPosition(position) {
+ document.getElementById('audio_position').innerHTML = position;
+ }
+
+ </script>
+ </head>
+ <body>
+ <a href="#" class="btn large" onclick="playAudio('http://audio.ibeat.org/content/p1rj1s/p1rj1s_-_rockGuitar.mp3');">Play Audio</a>
+ <a href="#" class="btn large" onclick="pauseAudio();">Pause Playing Audio</a>
+ <a href="#" class="btn large" onclick="stopAudio();">Stop Playing Audio</a>
+ <p id="audio_position"></p>
+ </body>
+ </html>
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/992e9151/docs/zh/edge/cordova/media/media.md
----------------------------------------------------------------------
diff --git a/docs/zh/edge/cordova/media/media.md b/docs/zh/edge/cordova/media/media.md
new file mode 100644
index 0000000..dc8a96e
--- /dev/null
+++ b/docs/zh/edge/cordova/media/media.md
@@ -0,0 +1,126 @@
+---
+
+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.
+---
+
+# 媒体
+
+> `Media`对象提供录制和播放设备上的音频文件的能力。
+
+ var media = new Media(src, mediaSuccess, [mediaError], [mediaStatus]);
+
+
+**注：**当前的实现并不遵循 W3C 规范的媒体捕获，并仅用于提供方便。 将来的实现将坚持以最新的 W3C 规范和可能弃用当前 Api。
+
+## 参数
+
+* **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` 来更新。
+
+* **持续时间**: 媒体的持续时间以秒为单位。
+
+## 支持的平台
+
+* Android 系统
+* 黑莓手机 WebWorks （OS 5.0 和更高）
+* iOS
+* Windows Phone 7.5
+* Tizen
+* Windows 8
+
+## 访问功能
+
+从 3.0 版，科尔多瓦作为*插件*实现了设备级 Api。 使用 CLI 的 `plugin` 命令，描述在命令行界面，可以添加或删除一个项目，为此功能：
+
+ $ cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-media.git
+
+
+这些命令适用于所有有针对性的平台，但修改如下所述的特定于平台的配置设置：
+
+* Android 系统
+
+ (in app/res/xml/config.xml) < 功能名称 ="媒体">< 参数名称 ="android 包"value="org.apache.cordova.AudioHandler"/ >< / 功能 > (在 app/AndroidManifest.xml) < 使用权限 android:name="android.permission.RECORD_AUDIO"/ >< 使用权限 android:name="android.permission.MODIFY_AUDIO_SETTINGS"/ >< 使用权限 android:name="android.permission.WRITE_EXTERNAL_STORAGE"/ >
+
+
+* 黑莓手机 WebWorks
+
+ (in www/plugins.xml) < 功能名称 ="捕获">< 参数名称 ="黑莓手机-包"value="org.apache.cordova.media.MediaCapture"/ >< / 功能 >
+
+
+* （在 iOS`config.xml`)
+
+ < 功能名称 ="媒体">< 参数名称 ="ios 包"值 ="CDVSound"/ >< / 功能 >
+
+
+* （在 Windows Phone`Properties/WPAppManifest.xml`)
+
+ < 功能 >< 功能名称 ="ID_CAP_MEDIALIB"/ >< 能力名称 ="ID_CAP_MICROPHONE"/ >< 功能名称 ="ID_HW_FRONTCAMERA"/ >< 功能名称 ="ID_CAP_ISV_CAMERA"/ >< 能力名称 ="ID_CAP_CAMERA"/ >< / 功能 >
+
+
+ 引用：[为 Windows Phone 应用程序清单][1]
+
+ [1]: http://msdn.microsoft.com/en-us/library/ff769509%28v=vs.92%29.aspx
+
+一些平台可能支持此功能，而无需任何特殊的配置。有关概述，请参见平台支持。
+
+### Windows Phone 怪癖
+
+* 只有一个媒体文件，可以播放一次。
+
+* 没有严格限制对您的应用程序与其他媒体的交互方式。 请参见[Microsoft 文档的详细信息][2].
+
+ [2]: http://msdn.microsoft.com/en-us/library/windowsphone/develop/hh184838(v=vs.92).aspx
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/992e9151/docs/zh/edge/cordova/media/media.pause.md
----------------------------------------------------------------------
diff --git a/docs/zh/edge/cordova/media/media.pause.md b/docs/zh/edge/cordova/media/media.pause.md
new file mode 100644
index 0000000..c927378
--- /dev/null
+++ b/docs/zh/edge/cordova/media/media.pause.md
@@ -0,0 +1,161 @@
+---
+
+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.
+---
+
+# media.pause
+
+暂停播放音频文件。
+
+ media.pause();
+
+
+## 说明
+
+`media.pause`方法执行同步，并暂停播放音频文件。
+
+## 支持的平台
+
+* Android 系统
+* 黑莓手机 WebWorks （OS 5.0 和更高）
+* iOS
+* Windows Phone 7 和 8
+* Tizen
+* Windows 8
+
+## 快速的示例
+
+ // 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);
+ }
+
+
+## 完整的示例
+
+ <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
+ "http://www.w3.org/TR/html4/strict.dtd">
+ <html>
+ <head>
+ <title>Media Example</title>
+
+ <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
+ <script type="text/javascript" charset="utf-8">
+
+ // Wait for device API libraries to load
+ //
+ document.addEventListener("deviceready", onDeviceReady, false);
+
+ // device APIs are available
+ //
+ function onDeviceReady() {
+ playAudio("http://audio.ibeat.org/content/p1rj1s/p1rj1s_-_rockGuitar.mp3");
+ }
+
+ // Audio player
+ //
+ var my_media = null;
+ var mediaTimer = null;
+
+ // Play audio
+ //
+ function playAudio(src) {
+ // Create Media object from src
+ my_media = new Media(src, onSuccess, onError);
+
+ // Play audio
+ my_media.play();
+
+ // Update my_media position every second
+ if (mediaTimer == null) {
+ mediaTimer = setInterval(function() {
+ // get my_media position
+ my_media.getCurrentPosition(
+ // success callback
+ function(position) {
+ if (position > -1) {
+ setAudioPosition((position) + " sec");
+ }
+ },
+ // error callback
+ function(e) {
+ console.log("Error getting pos=" + e);
+ setAudioPosition("Error: " + e);
+ }
+ );
+ }, 1000);
+ }
+ }
+
+ // Pause audio
+ //
+ function pauseAudio() {
+ if (my_media) {
+ my_media.pause();
+ }
+ }
+
+ // Stop audio
+ //
+ function stopAudio() {
+ if (my_media) {
+ my_media.stop();
+ }
+ clearInterval(mediaTimer);
+ mediaTimer = null;
+ }
+
+ // onSuccess Callback
+ //
+ function onSuccess() {
+ console.log("playAudio():Audio Success");
+ }
+
+ // onError Callback
+ //
+ function onError(error) {
+ alert('code: ' + error.code + '\n' +
+ 'message: ' + error.message + '\n');
+ }
+
+ // Set audio position
+ //
+ function setAudioPosition(position) {
+ document.getElementById('audio_position').innerHTML = position;
+ }
+
+ </script>
+ </head>
+ <body>
+ <a href="#" class="btn large" onclick="playAudio('http://audio.ibeat.org/content/p1rj1s/p1rj1s_-_rockGuitar.mp3');">Play Audio</a>
+ <a href="#" class="btn large" onclick="pauseAudio();">Pause Playing Audio</a>
+ <a href="#" class="btn large" onclick="stopAudio();">Stop Playing Audio</a>
+ <p id="audio_position"></p>
+ </body>
+ </html>
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/992e9151/docs/zh/edge/cordova/media/media.play.md
----------------------------------------------------------------------
diff --git a/docs/zh/edge/cordova/media/media.play.md b/docs/zh/edge/cordova/media/media.play.md
new file mode 100644
index 0000000..ab8eaca
--- /dev/null
+++ b/docs/zh/edge/cordova/media/media.play.md
@@ -0,0 +1,184 @@
+---
+
+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.
+---
+
+# media.play
+
+开始或重新开始播放音频文件。
+
+ media.play();
+
+
+## 说明
+
+`media.play`方法执行同步，并开始或继续播放音频文件。
+
+## 支持的平台
+
+* Android 系统
+* 黑莓手机 WebWorks （OS 5.0 和更高）
+* iOS
+* Windows Phone 7 和 8
+* Tizen
+* Windows 8
+
+## 快速的示例
+
+ // 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();
+ }
+
+
+## 完整的示例
+
+ <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
+ "http://www.w3.org/TR/html4/strict.dtd">
+ <html>
+ <head>
+ <title>Media Example</title>
+
+ <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
+ <script type="text/javascript" charset="utf-8">
+
+ // Wait for device API libraries to load
+ //
+ document.addEventListener("deviceready", onDeviceReady, false);
+
+ // device APIs are available
+ //
+ function onDeviceReady() {
+ playAudio("http://audio.ibeat.org/content/p1rj1s/p1rj1s_-_rockGuitar.mp3");
+ }
+
+ // Audio player
+ //
+ var my_media = null;
+ var mediaTimer = null;
+
+ // Play audio
+ //
+ function playAudio(src) {
+ if (my_media == null) {
+ // Create Media object from src
+ my_media = new Media(src, onSuccess, onError);
+ } // else play current audio
+ // Play audio
+ my_media.play();
+
+ // Update my_media position every second
+ if (mediaTimer == null) {
+ mediaTimer = setInterval(function() {
+ // get my_media position
+ my_media.getCurrentPosition(
+ // success callback
+ function(position) {
+ if (position > -1) {
+ setAudioPosition((position) + " sec");
+ }
+ },
+ // error callback
+ function(e) {
+ console.log("Error getting pos=" + e);
+ setAudioPosition("Error: " + e);
+ }
+ );
+ }, 1000);
+ }
+ }
+
+ // Pause audio
+ //
+ function pauseAudio() {
+ if (my_media) {
+ my_media.pause();
+ }
+ }
+
+ // Stop audio
+ //
+ function stopAudio() {
+ if (my_media) {
+ my_media.stop();
+ }
+ clearInterval(mediaTimer);
+ mediaTimer = null;
+ }
+
+ // onSuccess Callback
+ //
+ function onSuccess() {
+ console.log("playAudio():Audio Success");
+ }
+
+ // onError Callback
+ //
+ function onError(error) {
+ alert('code: ' + error.code + '\n' +
+ 'message: ' + error.message + '\n');
+ }
+
+ // Set audio position
+ //
+ function setAudioPosition(position) {
+ document.getElementById('audio_position').innerHTML = position;
+ }
+
+ </script>
+ </head>
+ <body>
+ <a href="#" class="btn large" onclick="playAudio('http://audio.ibeat.org/content/p1rj1s/p1rj1s_-_rockGuitar.mp3');">Play Audio</a>
+ <a href="#" class="btn large" onclick="pauseAudio();">Pause Playing Audio</a>
+ <a href="#" class="btn large" onclick="stopAudio();">Stop Playing Audio</a>
+ <p id="audio_position"></p>
+ </body>
+ </html>
+
+
+## 黑莓 WebWorks 怪癖
+
+* 黑莓设备支持有限的数量的同时音频通道。 CDMA 设备仅支持单个音频通道。 其他设备都支持最多两个同时播放的频道。 尝试播放音频文件的支持金额多于导致以前播放被停止。
+
+## 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
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/992e9151/docs/zh/edge/cordova/media/media.release.md
----------------------------------------------------------------------
diff --git a/docs/zh/edge/cordova/media/media.release.md b/docs/zh/edge/cordova/media/media.release.md
new file mode 100644
index 0000000..b729f7d
--- /dev/null
+++ b/docs/zh/edge/cordova/media/media.release.md
@@ -0,0 +1,149 @@
+---
+
+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.
+---
+
+# media.release
+
+释放底层操作系统的音频资源。
+
+ media.release();
+
+
+## 说明
+
+`media.release`方法执行同步，释放出底层操作系统的音频资源。 这是特别重要的 android 操作系统，因为有了有限数量的 OpenCore 实例播放媒体。 应用程序应当调用 `release` 函数的任何 `Media` 不再需要的资源。
+
+## 支持的平台
+
+* Android 系统
+* 黑莓手机 WebWorks （OS 5.0 和更高）
+* iOS
+* Windows Phone 7 和 8
+* Tizen
+* Windows 8
+
+## 快速的示例
+
+ // Audio player
+ //
+ var my_media = new Media(src, onSuccess, onError);
+
+ my_media.play();
+ my_media.stop();
+ my_media.release();
+
+
+## 完整的示例
+
+ <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
+ "http://www.w3.org/TR/html4/strict.dtd">
+ <html>
+ <head>
+ <title>Media Example</title>
+
+ <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
+ <script type="text/javascript" charset="utf-8">
+
+ // Wait for device API libraries to load
+ //
+ document.addEventListener("deviceready", onDeviceReady, false);
+
+ // device APIs are available
+ //
+ function onDeviceReady() {
+ playAudio("http://audio.ibeat.org/content/p1rj1s/p1rj1s_-_rockGuitar.mp3");
+ }
+
+ // Audio player
+ //
+ var my_media = null;
+ var mediaTimer = null;
+
+ // Play audio
+ //
+ function playAudio(src) {
+ // Create Media object from src
+ my_media = new Media(src, onSuccess, onError);
+
+ // Play audio
+ my_media.play();
+
+ // Update my_media position every second
+ if (mediaTimer == null) {
+ mediaTimer = setInterval(function() {
+ // get my_media position
+ my_media.getCurrentPosition(
+ // success callback
+ function(position) {
+ if (position > -1) {
+ setAudioPosition((position) + " sec");
+ }
+ },
+ // error callback
+ function(e) {
+ console.log("Error getting pos=" + e);
+ setAudioPosition("Error: " + e);
+ }
+ );
+ }, 1000);
+ }
+ }
+
+ // Pause audio
+ //
+ function pauseAudio() {
+ if (my_media) {
+ my_media.pause();
+ }
+ }
+
+ // Stop audio
+ //
+ function stopAudio() {
+ if (my_media) {
+ my_media.stop();
+ }
+ clearInterval(mediaTimer);
+ mediaTimer = null;
+ }
+
+ // onSuccess Callback
+ //
+ function onSuccess() {
+ console.log("playAudio():Audio Success");
+ }
+
+ // onError Callback
+ //
+ function onError(error) {
+ alert('code: ' + error.code + '\n' +
+ 'message: ' + error.message + '\n');
+ }
+
+ // Set audio position
+ //
+ function setAudioPosition(position) {
+ document.getElementById('audio_position').innerHTML = position;
+ }
+
+ </script>
+ </head>
+ <body>
+ <a href="#" class="btn large" onclick="playAudio('http://audio.ibeat.org/content/p1rj1s/p1rj1s_-_rockGuitar.mp3');">Play Audio</a>
+ <a href="#" class="btn large" onclick="pauseAudio();">Pause Playing Audio</a>
+ <a href="#" class="btn large" onclick="stopAudio();">Stop Playing Audio</a>
+ <p id="audio_position"></p>
+ </body>
+ </html>
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/992e9151/docs/zh/edge/cordova/media/media.seekTo.md
----------------------------------------------------------------------
diff --git a/docs/zh/edge/cordova/media/media.seekTo.md b/docs/zh/edge/cordova/media/media.seekTo.md
new file mode 100644
index 0000000..960c56a
--- /dev/null
+++ b/docs/zh/edge/cordova/media/media.seekTo.md
@@ -0,0 +1,152 @@
+---
+
+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.
+---
+
+# media.seekTo
+
+在音频文件中设置的当前的位置。
+
+ media.seekTo(milliseconds);
+
+
+## 参数
+
+* **毫秒为单位）**： 要以毫秒为单位设置中，音频的播放位置的位置。
+
+## 说明
+
+`media.seekTo`异步，执行更新引用的音频文件中的当前播放位置 `Media` 对象。 此外可以更新 `Media` 对象的 `position` 参数。
+
+## 支持的平台
+
+* Android 系统
+* 黑莓手机 WebWorks （OS 6.0 和更高）
+* iOS
+* Windows Phone 7 和 8
+* Tizen
+* Windows 8
+
+## 快速的示例
+
+ // 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);
+
+
+## 完整的示例
+
+ <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
+ "http://www.w3.org/TR/html4/strict.dtd">
+ <html>
+ <head>
+ <title>Media Example</title>
+
+ <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
+ <script type="text/javascript" charset="utf-8">
+
+ // Wait for device API libraries to load
+ //
+ document.addEventListener("deviceready", onDeviceReady, false);
+
+ // device APIs are available
+ //
+ function onDeviceReady() {
+ playAudio("http://audio.ibeat.org/content/p1rj1s/p1rj1s_-_rockGuitar.mp3");
+ }
+
+ // Audio player
+ //
+ var my_media = null;
+ var mediaTimer = null;
+
+ // Play audio
+ //
+ function playAudio(src) {
+ // Create Media object from src
+ my_media = new Media(src, onSuccess, onError);
+
+ // Play audio
+ my_media.play();
+
+ // Update media position every second
+ mediaTimer = setInterval(function() {
+ // get media position
+ my_media.getCurrentPosition(
+ // success callback
+ function(position) {
+ if (position > -1) {
+ setAudioPosition(position + " sec");
+ }
+ },
+ // error callback
+ function(e) {
+ console.log("Error getting pos=" + e);
+ }
+ );
+ }, 1000);
+
+ // SeekTo to 10 seconds after 5 seconds
+ setTimeout(function() {
+ my_media.seekTo(10000);
+ }, 5000);
+ }
+
+ // Stop audio
+ //
+ function stopAudio() {
+ if (my_media) {
+ my_media.stop();
+ }
+ clearInterval(mediaTimer);
+ mediaTimer = null;
+ }
+
+ // onSuccess Callback
+ //
+ function onSuccess() {
+ console.log("playAudio():Audio Success");
+ }
+
+ // onError Callback
+ //
+ function onError(error) {
+ alert('code: ' + error.code + '\n' +
+ 'message: ' + error.message + '\n');
+ }
+
+ // Set audio position
+ //
+ function setAudioPosition(position) {
+ document.getElementById('audio_position').innerHTML = position;
+ }
+
+ </script>
+ </head>
+ <body>
+ <a href="#" class="btn large" onclick="playAudio('http://audio.ibeat.org/content/p1rj1s/p1rj1s_-_rockGuitar.mp3');">Play Audio</a>
+ <a href="#" class="btn large" onclick="stopAudio();">Stop Playing Audio</a>
+ <p id="audio_position"></p>
+ </body>
+ </html>
+
+
+## 黑莓 WebWorks 怪癖
+
+* 黑莓 OS 5 设备上不支持。
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/992e9151/docs/zh/edge/cordova/media/media.setVolume.md
----------------------------------------------------------------------
diff --git a/docs/zh/edge/cordova/media/media.setVolume.md b/docs/zh/edge/cordova/media/media.setVolume.md
new file mode 100644
index 0000000..9f34750
--- /dev/null
+++ b/docs/zh/edge/cordova/media/media.setVolume.md
@@ -0,0 +1,170 @@
+---
+
+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.
+---
+
+# media.setVolume
+
+设置音频文件的音量。
+
+ media.setVolume(volume) ；
+
+
+## 参数
+
+* **体积**： 要为播放设置的卷。值必须在 0.0 到 1.0 的范围内。
+
+## 说明
+
+函数 `media.setVolume` 是一个异步的函数，在播放音频时设置音量。
+
+## 支持的平台
+
+* 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);
+ }
+
+
+## 完整的示例
+
+ <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
+ "http://www.w3.org/TR/html4/strict.dtd">
+ <html>
+ <head>
+ <title>Media Example</title>
+
+ <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
+ <script type="text/javascript" charset="utf-8">
+
+ // Wait for Cordova to load
+ //
+ document.addEventListener("deviceready", onDeviceReady, false);
+
+ // Cordova is ready
+ //
+ function onDeviceReady() {
+ playAudio("http://audio.ibeat.org/content/p1rj1s/p1rj1s_-_rockGuitar.mp3");
+ }
+
+ // Audio player
+ //
+ var my_media = null;
+ var mediaTimer = null;
+
+ // Play audio
+ //
+ function playAudio(src) {
+ // Create Media object from src
+ my_media = new Media(src, onSuccess, onError);
+
+ // Play audio
+ my_media.play();
+
+ // Update my_media position every second
+ if (mediaTimer == null) {
+ mediaTimer = setInterval(function() {
+ // get my_media position
+ my_media.getCurrentPosition(
+ // success callback
+ function(position) {
+ if (position > -1) {
+ setAudioPosition((position) + " sec");
+ }
+ },
+ // error callback
+ function(e) {
+ console.log("Error getting pos=" + e);
+ setAudioPosition("Error: " + e);
+ }
+ );
+ }, 1000);
+ }
+ }
+
+ // Set audio volume
+ //
+ function setVolume(volume) {
+ if (my_media) {
+ my_media.setVolume(volume);
+ }
+ }
+
+ // Stop audio
+ //
+ function stopAudio() {
+ if (my_media) {
+ my_media.stop();
+ }
+ clearInterval(mediaTimer);
+ mediaTimer = null;
+ }
+
+ // onSuccess Callback
+ //
+ function onSuccess() {
+ console.log("playAudio():Audio Success");
+ }
+
+ // onError Callback
+ //
+ function onError(error) {
+ alert('code: ' + error.code + '\n' +
+ 'message: ' + error.message + '\n');
+ }
+
+ // Set audio position
+ //
+ function setAudioPosition(position) {
+ document.getElementById('audio_position').innerHTML = position;
+ }
+
+ </script>
+ </head>
+ <body>
+ <a href="#" class="btn large" onclick="playAudio('http://audio.ibeat.org/content/p1rj1s/p1rj1s_-_rockGuitar.mp3');">Play Audio</a>
+ <a href="#" class="btn large" onclick="setVolume('0.0');">Mute Audio</a>
+ <a href="#" class="btn large" onclick="setVolume('1.0');">Unmute Audio</a>
+ <a href="#" class="btn large" onclick="stopAudio();">Stop Playing Audio</a>
+ <p id="audio_position"></p>
+ </body>
+ </html>
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/992e9151/docs/zh/edge/cordova/media/media.startRecord.md
----------------------------------------------------------------------
diff --git a/docs/zh/edge/cordova/media/media.startRecord.md b/docs/zh/edge/cordova/media/media.startRecord.md
new file mode 100644
index 0000000..dd87c9e
--- /dev/null
+++ b/docs/zh/edge/cordova/media/media.startRecord.md
@@ -0,0 +1,148 @@
+---
+
+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.
+---
+
+# media.startRecord
+
+开始录制的音频文件。
+
+ media.startRecord() ；
+
+
+## 说明
+
+`media.startRecord`方法同步执行，开始录制的音频文件。
+
+## 支持的平台
+
+* Android 系统
+* 黑莓手机 WebWorks （OS 5.0 和更高）
+* 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();
+ }
+
+
+## 完整的示例
+
+ <!DOCTYPE html>
+ <html>
+ <head>
+ <title>Device Properties Example</title>
+
+ <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
+ <script type="text/javascript" charset="utf-8">
+
+ // Wait for device API libraries to load
+ //
+ document.addEventListener("deviceready", onDeviceReady, false);
+
+ // Record audio
+ //
+ function recordAudio() {
+ var src = "myrecording.amr";
+ var mediaRec = new Media(src, onSuccess, onError);
+
+ // Record audio
+ mediaRec.startRecord();
+
+ // Stop recording after 10 sec
+ var recTime = 0;
+ var recInterval = setInterval(function() {
+ recTime = recTime + 1;
+ setAudioPosition(recTime + " sec");
+ if (recTime >= 10) {
+ clearInterval(recInterval);
+ mediaRec.stopRecord();
+ }
+ }, 1000);
+ }
+
+ // device APIs are available
+ //
+ function onDeviceReady() {
+ recordAudio();
+ }
+
+ // onSuccess Callback
+ //
+ function onSuccess() {
+ console.log("recordAudio():Audio Success");
+ }
+
+ // onError Callback
+ //
+ function onError(error) {
+ alert('code: ' + error.code + '\n' +
+ 'message: ' + error.message + '\n');
+ }
+
+ // Set audio position
+ //
+ function setAudioPosition(position) {
+ document.getElementById('audio_position').innerHTML = position;
+ }
+
+ </script>
+ </head>
+ <body>
+ <p id="media">Recording audio...</p>
+ <p id="audio_position"></p>
+ </body>
+ </html>
+
+
+## Android 的怪癖
+
+* Android 设备音频格式记录的自适应多速率。指定的文件应以*.amr*扩展名结尾。
+
+## 黑莓 WebWorks 怪癖
+
+* 黑莓设备音频格式记录的自适应多速率。指定的文件必须以*.amr*扩展名结尾。
+
+## iOS 的怪癖
+
+* iOS 只记录到文件的类型*.wav*和返回一个错误如果文件扩展名不正确。
+
+* 如果未提供的完整路径，录音放在应用程序的 `documents/tmp` 目录。 这可以通过访问 `File` API 使用 `LocalFileSystem.TEMPORARY` 。 在记录时指定的任何子目录中必须已经存在。
+
+* 文件可以记录和演奏的后面使用的文件的 URI：
+
+ var myMedia = new Media("documents://beer.mp3")
+
+
+## Tizen 怪癖
+
+* Tizen 设备上不支持。
\ No newline at end of file