Return-Path: X-Original-To: apmail-cordova-commits-archive@www.apache.org Delivered-To: apmail-cordova-commits-archive@www.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id 62F2618F32 for ; Wed, 6 Apr 2016 09:27:20 +0000 (UTC) Received: (qmail 77063 invoked by uid 500); 6 Apr 2016 09:27:19 -0000 Delivered-To: apmail-cordova-commits-archive@cordova.apache.org Received: (qmail 76711 invoked by uid 500); 6 Apr 2016 09:27:19 -0000 Mailing-List: contact commits-help@cordova.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Delivered-To: mailing list commits@cordova.apache.org Received: (qmail 75040 invoked by uid 99); 6 Apr 2016 09:27:18 -0000 Received: from git1-us-west.apache.org (HELO git1-us-west.apache.org) (140.211.11.23) by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 06 Apr 2016 09:27:18 +0000 Received: by git1-us-west.apache.org (ASF Mail Server at git1-us-west.apache.org, from userid 33) id 2BF47DFD5B; Wed, 6 Apr 2016 09:27:18 +0000 (UTC) Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit From: dblotsky@apache.org To: commits@cordova.apache.org Date: Wed, 06 Apr 2016 09:28:00 -0000 Message-Id: <54b8d84fba3c473a85795a94b40553bb@git.apache.org> In-Reply-To: <0ea60741dd3e40f489f34a02f10641c5@git.apache.org> References: <0ea60741dd3e40f489f34a02f10641c5@git.apache.org> X-Mailer: ASF-Git Admin Mailer Subject: [44/51] [partial] docs commit: Adding both Chinese versions. http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.1.0/cordova/media/capture/MediaFile.getFormatData.md ---------------------------------------------------------------------- diff --git a/www/docs/zh-cn/3.1.0/cordova/media/capture/MediaFile.getFormatData.md b/www/docs/zh-cn/3.1.0/cordova/media/capture/MediaFile.getFormatData.md new file mode 100644 index 0000000..aca3ff5 --- /dev/null +++ b/www/docs/zh-cn/3.1.0/cordova/media/capture/MediaFile.getFormatData.md @@ -0,0 +1,52 @@ +--- +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. + +title: MediaFile.getFormatData +--- + +# MediaFile.getFormatData + +> 檢索格式媒體捕獲檔的資訊。 + + mediaFile.getFormatData (MediaFileDataSuccessCB successCallback) [MediaFileDataErrorCB errorCallback] ; + + +## 說明 + +此函數以非同步方式嘗試檢索該媒體檔案的格式資訊。 如果成功,它將調用 `MediaFileDataSuccessCB` 回檔與 `[MediaFileData](MediaFileData.html)` 物件。 如果該嘗試失敗,此函數將調用 `MediaFileDataErrorCB` 回檔。 + +## 支援的平臺 + +* Android 系統 +* 黑莓手機 WebWorks (OS 5.0 和更高) +* iOS +* Windows Phone 7 和 8 +* Windows 8 + +## 黑莓 WebWorks 怪癖 + +不為媒體檔案,所以所有有關的資訊提供一個 API `[MediaFileData](MediaFileData.html)` 物件返回的預設值。 + +## Android 的怪癖 + +訪問媒體檔案格式資訊的 API 的限制,所以並不是所有 `[MediaFileData](MediaFileData.html)` 支援的屬性。 + +## iOS 的怪癖 + +訪問媒體檔案格式資訊的 API 的限制,所以並不是所有 `[MediaFileData](MediaFileData.html)` 支援的屬性。 \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.1.0/cordova/media/capture/MediaFile.md ---------------------------------------------------------------------- diff --git a/www/docs/zh-cn/3.1.0/cordova/media/capture/MediaFile.md b/www/docs/zh-cn/3.1.0/cordova/media/capture/MediaFile.md new file mode 100644 index 0000000..a3764e1 --- /dev/null +++ b/www/docs/zh-cn/3.1.0/cordova/media/capture/MediaFile.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. + +title: 媒體 +--- + +# 媒體 + +> 封裝媒體捕獲檔的屬性。 + +## 屬性 + +* **名稱**: 檔的名稱,不包含路徑資訊。() DOMString + +* **完整路徑**: 檔,包括名稱的完整路徑。() DOMString + +* **類型**: 檔的 mime 類型 (DOMString) + +* **lastModifiedDate**: 日期和檔的上次修改時間。(日期) + +* **大小**: 檔的大小,以位元組為單位。(人數) + +## 方法 + +* **MediaFile.getFormatData**: 檢索該媒體檔案的格式資訊。 \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.1.0/cordova/media/capture/MediaFileData.md ---------------------------------------------------------------------- diff --git a/www/docs/zh-cn/3.1.0/cordova/media/capture/MediaFileData.md b/www/docs/zh-cn/3.1.0/cordova/media/capture/MediaFileData.md new file mode 100644 index 0000000..0c54544 --- /dev/null +++ b/www/docs/zh-cn/3.1.0/cordova/media/capture/MediaFileData.md @@ -0,0 +1,79 @@ +--- +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. + +title: MediaFileData +--- + +# MediaFileData + +> 封裝有關的媒體檔案的格式資訊。 + +## 屬性 + +* **編解碼器**: 實際的音訊和視頻內容的格式。() DOMString + +* **位元速率**: 內容的平均位元速率。值為零的圖像。(人數) + +* **高度**: 圖像或視頻以圖元為單位的高度。值為零的音訊剪輯。(人數) + +* **寬度**: 圖像或視頻以圖元為單位的寬度。值為零的音訊剪輯。(人數) + +* **持續時間**: 以秒為單位的視頻或音效片段的長度。值為零的圖像。(人數) + +## 黑莓 WebWorks 怪癖 + +沒有 API 提供的格式資訊的媒體檔案,所以 `MediaFileData` 物件返回的 `[MediaFile.getFormatData](MediaFile.getFormatData.html)` 功能以下預設值: + +* **編解碼器**: 不受支援,並且返回`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/a890e4de/www/docs/zh-cn/3.1.0/cordova/media/capture/capture.md ---------------------------------------------------------------------- diff --git a/www/docs/zh-cn/3.1.0/cordova/media/capture/capture.md b/www/docs/zh-cn/3.1.0/cordova/media/capture/capture.md new file mode 100644 index 0000000..34df43f --- /dev/null +++ b/www/docs/zh-cn/3.1.0/cordova/media/capture/capture.md @@ -0,0 +1,118 @@ +--- +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. + +title: 捕獲 +--- + +# 捕獲 + +> 提供對設備的音訊、 圖像和視頻捕獲功能的訪問。 + +**重要的隱私注:**收集和使用的圖像、 視頻或音訊裝置的攝像頭或麥克風從提出了重要的隱私問題。 您的應用程式的隱私權原則應該討論應用程式如何使用這種感應器和記錄的資料是否與任何其他方共用。 另外,如果攝像機或麥克風的應用程式的使用在使用者介面中不是明顯的你應該在您的應用程式訪問的相機或麥克風 (如果設備作業系統不會這樣做已經) 之前提供只是在時間的通知。 該通知應提供相同的資訊上文指出的並獲取該使用者的許可權 (例如,通過為**確定**並**不感謝**提出的選擇)。 請注意有些應用程式市場可能需要您的應用程式提供只是時間的通知,並從訪問攝像機或麥克風之前使用者獲得的許可權。 有關詳細資訊,請參閱隱私指南。 + +## 物件 + +* 捕獲 +* [CaptureAudioOptions](captureAudioOptions.html) +* [CaptureImageOptions](captureImageOptions.html) +* [CaptureVideoOptions](captureVideoOptions.html) +* CaptureCallback +* [CaptureErrorCB](CaptureErrorCB.html) +* [配置](ConfigurationData.html) +* [媒體](../media.html) +* [MediaFileData](MediaFileData.html) + +## 方法 + +* [capture.captureAudio](captureAudio.html) +* [capture.captureImage](captureImage.html) +* [capture.captureVideo](captureVideo.html) +* [MediaFile.getFormatData](MediaFile.getFormatData.html) + +## 範圍 + +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](captureAudio.html)`: 啟動設備的音訊錄音應用程式來記錄音訊剪輯。 + +* `[capture.captureImage](captureImage.html)`: 啟動設備的攝像頭應用程式採取的照片。 + +* `[capture.captureVideo](captureVideo.html)`: 啟動設備的視頻錄影機應用程式要錄製的視頻。 + +## 支援的平臺 + +* Android 系統 +* 黑莓手機 WebWorks (OS 5.0 和更高) +* iOS +* Windows Phone 7 和 8 +* Windows 8 + +## 訪問功能 + +從 3.0 版,科爾多瓦作為*外掛程式*實現了設備級 Api。 使用 CLI 的 `plugin` 命令,描述在命令列介面,可以添加或刪除一個專案,為此功能: + + $ cordova plugin add org.apache.cordova.media-capture + $ cordova plugin ls + [ 'org.apache.cordova.media-capture' ] + $ cordova plugin rm org.apache.cordova.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`) + + + + + + + + + + +一些平臺可能支援此功能,而無需任何特殊的配置。請參見在概述部分中*的平臺支援*。 \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.1.0/cordova/media/capture/captureAudio.md ---------------------------------------------------------------------- diff --git a/www/docs/zh-cn/3.1.0/cordova/media/capture/captureAudio.md b/www/docs/zh-cn/3.1.0/cordova/media/capture/captureAudio.md new file mode 100644 index 0000000..4388ebe --- /dev/null +++ b/www/docs/zh-cn/3.1.0/cordova/media/capture/captureAudio.md @@ -0,0 +1,139 @@ +--- +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. + +title: capture.captureAudio +--- + +# capture.captureAudio + +> 啟動音訊答錄機應用程式並返回有關捕獲音訊剪輯檔的資訊。 + + navigator.device.capture.captureAudio( + CaptureCB captureSuccess, CaptureErrorCB captureError, [CaptureAudioOptions options] + ); + + +## 說明 + +開始非同步作業以捕獲使用該設備的預設音訊錄製應用程式的音訊錄製。 該操作允許設備使用者的單個會話中捕獲多個錄音。 + +在捕獲操作結束時或者在使用者退出音訊錄音應用程式或由指定的錄音的最大數目 `[CaptureAudioOptions](captureAudioOptions.html).limit` 到達。 如果沒有 `limit` 指定參數的值,它將預設為一 (1) 和捕獲操作終止後使用者記錄單個音訊剪輯。 + +在捕獲操作完成後, `CaptureCallback` 執行與陣列的 `MediaFile` 物件描述每個捕獲音訊剪輯檔。 如果使用者終止操作之前捕獲音訊剪輯時, `CaptureErrorCallback` 與執行 `[CaptureError](CaptureError.html)` 物件中,設有 `[CaptureError](CaptureError.html).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}); + + +## 完整的示例 + + + + + Capture Audio + + + + + + +
+ + + + +## 黑莓 WebWorks 怪癖 + +* 科爾多瓦的黑莓 WebWorks 嘗試啟動**錄音筆記**提供的應用程式,由 RIM,來捕獲音訊錄製。 這款應用程式會收到 `[CaptureError](CaptureError.html).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/a890e4de/www/docs/zh-cn/3.1.0/cordova/media/capture/captureAudioOptions.md ---------------------------------------------------------------------- diff --git a/www/docs/zh-cn/3.1.0/cordova/media/capture/captureAudioOptions.md b/www/docs/zh-cn/3.1.0/cordova/media/capture/captureAudioOptions.md new file mode 100644 index 0000000..58e3e85 --- /dev/null +++ b/www/docs/zh-cn/3.1.0/cordova/media/capture/captureAudioOptions.md @@ -0,0 +1,51 @@ +--- +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. + +title: CaptureAudioOptions +--- + +# 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/a890e4de/www/docs/zh-cn/3.1.0/cordova/media/capture/captureImage.md ---------------------------------------------------------------------- diff --git a/www/docs/zh-cn/3.1.0/cordova/media/capture/captureImage.md b/www/docs/zh-cn/3.1.0/cordova/media/capture/captureImage.md new file mode 100644 index 0000000..21fa94e --- /dev/null +++ b/www/docs/zh-cn/3.1.0/cordova/media/capture/captureImage.md @@ -0,0 +1,130 @@ +--- +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. + +title: capture.captureImage +--- + +# capture.captureImage + +> 啟動攝像頭應用程式並返回有關捕獲的影像檔的資訊。 + + navigator.device.capture.captureImage( + CaptureCB captureSuccess, CaptureErrorCB captureError, [CaptureImageOptions options] + ); + + +## 說明 + +開始非同步作業以捕獲圖像使用該設備的攝像頭應用程式。該操作允許使用者在一個會話中捕獲多個圖像。 + +在捕獲操作結束或者當使用者關閉攝像頭應用程式或由指定的錄音的最大數目 `[CaptureAudioOptions](captureAudioOptions.html).limit` 到達。 如果沒有 `limit` 指定的值,它將預設為一 (1) 和捕獲操作終止後使用者捕獲單個圖像。 + +在捕獲操作完成後,它將調用 `[CaptureCB](CaptureCB.html)` 回檔與陣列的 `MediaFile` 物件描述每個捕獲的影像檔。 如果使用者終止之前捕獲圖像,操作 `[CaptureErrorCB](CaptureErrorCB.html)` 回檔執行與 `[CaptureError](CaptureError.html)` 物件特色 `[CaptureError](CaptureError.html).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}); + + +## 完整的示例 + + + + + Capture Image + + + + + + +
+ + \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.1.0/cordova/media/capture/captureImageOptions.md ---------------------------------------------------------------------- diff --git a/www/docs/zh-cn/3.1.0/cordova/media/capture/captureImageOptions.md b/www/docs/zh-cn/3.1.0/cordova/media/capture/captureImageOptions.md new file mode 100644 index 0000000..4548a4f --- /dev/null +++ b/www/docs/zh-cn/3.1.0/cordova/media/capture/captureImageOptions.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. + +title: CaptureImageOptions +--- + +# 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/a890e4de/www/docs/zh-cn/3.1.0/cordova/media/capture/captureVideo.md ---------------------------------------------------------------------- diff --git a/www/docs/zh-cn/3.1.0/cordova/media/capture/captureVideo.md b/www/docs/zh-cn/3.1.0/cordova/media/capture/captureVideo.md new file mode 100644 index 0000000..2176b69 --- /dev/null +++ b/www/docs/zh-cn/3.1.0/cordova/media/capture/captureVideo.md @@ -0,0 +1,131 @@ +--- +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. + +title: capture.captureVideo +--- + +# capture.captureVideo + +> 啟動視頻錄製器應用程式並返回有關捕獲的視訊短片檔的資訊。 + + navigator.device.capture.captureVideo( + CaptureCB captureSuccess, CaptureErrorCB captureError, [CaptureVideoOptions options] + ); + + +## 說明 + +開始非同步作業以捕獲使用該設備的視頻錄製應用程式的視頻錄製。該操作允許使用者在一個會話中捕獲多個錄音。 + +在捕獲操作結束時或者在使用者退出視頻錄製應用程式或由指定的錄音的最大數目 `[CaptureVideoOptions](captureVideoOptions.html).limit` 到達。 如果沒有 `limit` 指定參數的值,它將預設為一 (1) 和捕獲操作終止後使用者記錄單個視訊短片。 + +在捕獲操作完成後,它 `[CaptureCB](CaptureCB.html)` 回檔執行與陣列的 `MediaFile` 物件描述每個捕獲視訊短片檔。 如果使用者終止之前捕獲的視訊短片,操作 `[CaptureErrorCB](CaptureErrorCB.html)` 回檔執行與 `[CaptureError](CaptureError.html)` 物件特色 `[CaptureError](CaptureError.html).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}); + + +## 完整的示例 + + + + + Capture Video + + + + + + +
+ + + + +## 黑莓 WebWorks 怪癖 + +* 科爾多瓦的黑莓 WebWorks 嘗試啟動**視頻錄影機**提供的應用程式,由 RIM,以捕獲視頻的錄製。 這款應用程式會收到 `[CaptureError](CaptureError.html).CAPTURE_NOT_SUPPORTED` 錯誤代碼,如果應用程式未安裝在設備上。 \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.1.0/cordova/media/capture/captureVideoOptions.md ---------------------------------------------------------------------- diff --git a/www/docs/zh-cn/3.1.0/cordova/media/capture/captureVideoOptions.md b/www/docs/zh-cn/3.1.0/cordova/media/capture/captureVideoOptions.md new file mode 100644 index 0000000..e153977 --- /dev/null +++ b/www/docs/zh-cn/3.1.0/cordova/media/capture/captureVideoOptions.md @@ -0,0 +1,47 @@ +--- +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. + +title: CaptureVideoOptions +--- + +# 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/a890e4de/www/docs/zh-cn/3.1.0/cordova/media/media.getCurrentPosition.md ---------------------------------------------------------------------- diff --git a/www/docs/zh-cn/3.1.0/cordova/media/media.getCurrentPosition.md b/www/docs/zh-cn/3.1.0/cordova/media/media.getCurrentPosition.md new file mode 100644 index 0000000..0af3022 --- /dev/null +++ b/www/docs/zh-cn/3.1.0/cordova/media/media.getCurrentPosition.md @@ -0,0 +1,179 @@ +--- +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. + +title: media.getCurrentPosition +--- + +# 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); + + +## 完整的示例 + + + + + Media Example + + + + + + Play Audio + Pause Playing Audio + Stop Playing Audio +

+ + \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.1.0/cordova/media/media.getDuration.md ---------------------------------------------------------------------- diff --git a/www/docs/zh-cn/3.1.0/cordova/media/media.getDuration.md b/www/docs/zh-cn/3.1.0/cordova/media/media.getDuration.md new file mode 100644 index 0000000..a705bde --- /dev/null +++ b/www/docs/zh-cn/3.1.0/cordova/media/media.getDuration.md @@ -0,0 +1,165 @@ +--- +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. + +title: media.getDuration +--- + +# 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); + + +## 完整的示例 + + + + + Media Example + + + + + + Play Audio + Pause Playing Audio + Stop Playing Audio +

+ + \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.1.0/cordova/media/media.md ---------------------------------------------------------------------- diff --git a/www/docs/zh-cn/3.1.0/cordova/media/media.md b/www/docs/zh-cn/3.1.0/cordova/media/media.md new file mode 100644 index 0000000..fb06be7 --- /dev/null +++ b/www/docs/zh-cn/3.1.0/cordova/media/media.md @@ -0,0 +1,151 @@ +--- +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. + +title: 媒體 +--- + +# 媒體 + +> `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.getCurrentPosition.html)`: 返回一個音訊檔內的當前位置。 + +* `[media.getDuration](media.getDuration.html)`: 返回一個音訊檔的持續時間。 + +* `[media.play](media.play.html)`: 啟動或繼續播放音訊檔。 + +* `[media.pause](media.pause.html)`: 暫停播放的音訊檔。 + +* `[media.release](media.release.html)`: 釋放底層作業系統的音訊資源。 + +* `[media.seekTo](media.seekTo.html)`: 在音訊檔內移動的位置。 + +* `[media.setVolume](media.setVolume.html)`: 設置音訊播放的音量。 + +* `[media.startRecord](media.startRecord.html)`: 開始錄製的音訊檔。 + +* `[media.stopRecord](media.stopRecord.html)`: 停止錄製的音訊檔。 + +* `[media.stop](media.stop.html)`: 停止播放音訊檔。 + +## 附加唯讀參數 + +* **位置**: 內音訊播放,以秒為單位的位置。 + + * 不會自動更新期間播放 ;調用 `getCurrentPosition` 來更新。 + +* **持續時間**: 媒體的持續時間以秒為單位。 + +## 支援的平臺 + +* Android 系統 +* 黑莓手機 WebWorks (OS 5.0 和更高) +* iOS +* Windows Phone 7.5 +* Tizen +* Windows 8 + +## 訪問功能 + +從 3.0 版,科爾多瓦作為*外掛程式*實現了設備級 Api。 使用 CLI 的 `plugin` 命令,描述在命令列介面,可以添加或刪除一個專案,為此功能: + + $ 科爾多瓦外掛程式添加 org.apache.cordova.media $ 科爾多瓦外掛程式 ls ['org.apache.cordova.media'] $ 科爾多瓦外掛程式 rm org.apache.cordova.media + + +這些命令適用于所有有針對性的平臺,但修改如下所述的特定于平臺的配置設置: + +* Android 系統 + + (in app/res/xml/config.xml) + + + + + (in app/AndroidManifest.xml) + + + + + +* 黑莓手機 WebWorks + + (in www/plugins.xml) + + + + + +* (在 iOS`config.xml`) + + + + + + +* (在 Windows Phone`Properties/WPAppManifest.xml`) + + + + + + + + + + + 引用:[為 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/a890e4de/www/docs/zh-cn/3.1.0/cordova/media/media.pause.md ---------------------------------------------------------------------- diff --git a/www/docs/zh-cn/3.1.0/cordova/media/media.pause.md b/www/docs/zh-cn/3.1.0/cordova/media/media.pause.md new file mode 100644 index 0000000..e4e73ee --- /dev/null +++ b/www/docs/zh-cn/3.1.0/cordova/media/media.pause.md @@ -0,0 +1,167 @@ +--- +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. + +title: media.pause +--- + +# 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); + } + + +## 完整的示例 + + + + + Media Example + + + + + + Play Audio + Pause Playing Audio + Stop Playing Audio +

+ + \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.1.0/cordova/media/media.play.md ---------------------------------------------------------------------- diff --git a/www/docs/zh-cn/3.1.0/cordova/media/media.play.md b/www/docs/zh-cn/3.1.0/cordova/media/media.play.md new file mode 100644 index 0000000..2fb696a --- /dev/null +++ b/www/docs/zh-cn/3.1.0/cordova/media/media.play.md @@ -0,0 +1,190 @@ +--- +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. + +title: media.play +--- + +# 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(); + } + + +## 完整的示例 + + + + + Media Example + + + + + + Play Audio + Pause Playing Audio + Stop Playing Audio +

+ + + + +## 黑莓 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 /documents/tmp/audio/beer.mp3 \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.1.0/cordova/media/media.release.md ---------------------------------------------------------------------- diff --git a/www/docs/zh-cn/3.1.0/cordova/media/media.release.md b/www/docs/zh-cn/3.1.0/cordova/media/media.release.md new file mode 100644 index 0000000..6614f8b --- /dev/null +++ b/www/docs/zh-cn/3.1.0/cordova/media/media.release.md @@ -0,0 +1,155 @@ +--- +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. + +title: media.release +--- + +# 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(); + + +## 完整的示例 + + + + + Media Example + + + + + + Play Audio + Pause Playing Audio + Stop Playing Audio +

+ + \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.1.0/cordova/media/media.seekTo.md ---------------------------------------------------------------------- diff --git a/www/docs/zh-cn/3.1.0/cordova/media/media.seekTo.md b/www/docs/zh-cn/3.1.0/cordova/media/media.seekTo.md new file mode 100644 index 0000000..165c1fa --- /dev/null +++ b/www/docs/zh-cn/3.1.0/cordova/media/media.seekTo.md @@ -0,0 +1,158 @@ +--- +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. + +title: media.seekTo +--- + +# 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); + + +## 完整的示例 + + + + + Media Example + + + + + + Play Audio + Stop Playing Audio +

+ + + + +## 黑莓 WebWorks 怪癖 + +* 黑莓 OS 5 設備上不支援。 \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.1.0/cordova/media/media.setVolume.md ---------------------------------------------------------------------- diff --git a/www/docs/zh-cn/3.1.0/cordova/media/media.setVolume.md b/www/docs/zh-cn/3.1.0/cordova/media/media.setVolume.md new file mode 100644 index 0000000..4a7e061 --- /dev/null +++ b/www/docs/zh-cn/3.1.0/cordova/media/media.setVolume.md @@ -0,0 +1,176 @@ +--- +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. + +title: media.setVolume +--- + +# 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); + } + + +## 完整的示例 + + + + + Media Example + + + + + + Play Audio + Mute Audio + Unmute Audio + Stop Playing Audio +

+ + \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.1.0/cordova/media/media.startRecord.md ---------------------------------------------------------------------- diff --git a/www/docs/zh-cn/3.1.0/cordova/media/media.startRecord.md b/www/docs/zh-cn/3.1.0/cordova/media/media.startRecord.md new file mode 100644 index 0000000..6b4e813 --- /dev/null +++ b/www/docs/zh-cn/3.1.0/cordova/media/media.startRecord.md @@ -0,0 +1,154 @@ +--- +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. + +title: media.startRecord +--- + +# 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(); + } + + +## 完整的示例 + + + + + Device Properties Example + + + + + +

Recording audio...

+

+ + + + +## 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 --------------------------------------------------------------------- To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org For additional commands, e-mail: commits-help@cordova.apache.org