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 2012/07/12 23:04:38 UTC
[19/25] copy docs/jp/1.7.0 to docs/jp/1.8.1
http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/0756c5c4/docs/jp/1.8.1/cordova/geolocation/geolocation.watchPosition.md
----------------------------------------------------------------------
diff --git a/docs/jp/1.8.1/cordova/geolocation/geolocation.watchPosition.md b/docs/jp/1.8.1/cordova/geolocation/geolocation.watchPosition.md
new file mode 100644
index 0000000..434810c
--- /dev/null
+++ b/docs/jp/1.8.1/cordova/geolocation/geolocation.watchPosition.md
@@ -0,0 +1,127 @@
+---
+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.
+---
+
+geolocation.watchPosition
+=========================
+
+デバイスの現在の位置情報の変化を監視します。
+
+ var watchId = navigator.geolocation.watchPosition(geolocationSuccess,
+ [geolocationError],
+ [geolocationOptions]);
+
+パラメーター
+----------
+
+- __geolocationSuccess__: 現在位置情報の取得成功時に呼ばれるコールバック関数を表します
+- __geolocationError__: (オプション) エラー発生時に呼ばれるコールバック関数を表します
+- __geolocationOptions__: (オプション) 位置情報取得のオプションを表します
+
+返り値
+-------
+
+- __String__: 位置変化を参照する watch ID を返します。 watch ID は `geolocation.clearWatch` に渡すことで位置変化の監視を中止することができます。
+
+概要
+-----------
+
+`geolocation.watchPosition` 関数は非同期関数です。位置情報に変化があった場合に、デバイスの現在位置を返します。デバイスが新しい位置情報を取得したとき、 `Position` オブジェクトとともに `geolocationSuccess` コールバック関数が呼び出されます。エラーが発生した場合、 `PositionError` オブジェクトとともに `geolocationError` コールバック関数が呼び出されます。
+
+サポートされているプラットフォーム
+-------------------
+
+- Android
+- BlackBerry WebWorks (OS 5.0 以上)
+- iPhone
+- Windows Phone 7 (Mango)
+- Bada 1.2 & 2.x
+
+使用例
+-------------
+
+ // 成功時のコールバック関数
+ // このメソッドは GPS の現在座標を保持する
+ // `Position` オブジェクトを引数とする
+ //
+ function onSuccess(position) {
+ var element = document.getElementById('geolocation');
+ element.innerHTML = '緯度: ' + position.coords.latitude + '<br />' +
+ '経度: ' + position.coords.longitude + '<br />' +
+ '<hr />' + element.innerHTML;
+ }
+
+ // エラー時のコールバック関数は PositionError オブジェクトを受けとる
+ //
+ function onError(error) {
+ alert('コード: ' + error.code + '\n' +
+ 'メッセージ: ' + error.message + '\n');
+ }
+
+ // 3秒ごとに位置情報を取得する設定 (オプション)
+ //
+ var watchID = navigator.geolocation.watchPosition(onSuccess, onError, { frequency: 3000 });
+
+
+詳細な使用例
+------------
+
+ <!DOCTYPE html>
+ <html>
+ <head>
+ <title>デバイスプロパティーの使用例</title>
+
+ <script type="text/javascript" charset="utf-8" src="cordova-1.7.0.js"></script>
+ <script type="text/javascript" charset="utf-8">
+
+ // Cordova の読み込み完了まで待機
+ //
+ document.addEventListener("deviceready", onDeviceReady, false);
+
+ var watchID = null;
+
+ // Cordova 準備完了
+ //
+ function onDeviceReady() {
+ // 3秒ごとに更新
+ var options = { frequency: 3000 };
+ watchID = navigator.geolocation.watchPosition(onSuccess, onError, options);
+ }
+
+ // onSuccess Geolocation
+ //
+ function onSuccess(position) {
+ var element = document.getElementById('geolocation');
+ element.innerHTML = '緯度: ' + position.coords.latitude + '<br />' +
+ '経度: ' + position.coords.longitude + '<br />' +
+ '<hr />' + element.innerHTML;
+ }
+
+ // エラー時のコールバック関数は PositionError オブジェクトを受けとる
+ //
+ function onError(error) {
+ alert('コード: ' + error.code + '\n' +
+ 'メッセージ: ' + error.message + '\n');
+ }
+
+ </script>
+ </head>
+ <body>
+ <p id="geolocation">位置情報を監視中...</p>
+ </body>
+ </html>
http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/0756c5c4/docs/jp/1.8.1/cordova/geolocation/parameters/geolocation.options.md
----------------------------------------------------------------------
diff --git a/docs/jp/1.8.1/cordova/geolocation/parameters/geolocation.options.md b/docs/jp/1.8.1/cordova/geolocation/parameters/geolocation.options.md
new file mode 100644
index 0000000..b7934fd
--- /dev/null
+++ b/docs/jp/1.8.1/cordova/geolocation/parameters/geolocation.options.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.
+---
+
+geolocationOptions
+==================
+
+位置情報取得の設定をカスタマイズするためのパラメーターを表します。
+
+ { maximumAge: 3000, timeout: 5000, enableHighAccuracy: true };
+
+オプション
+-------
+
+- __frequency:__ 位置情報を取得する頻度をミリ秒で表します。 このオプションは W3C の仕様に含まれておらず、将来的には実装が廃止されます。 maximumAge を代わりに使用してください。 _(Number)_ (デフォルト: 10000)
+- __enableHighAccuracy:__ より精度の高い位置情報を取得するためのヒントを提供するかどうかを表します _(Boolean)_
+- __timeout:__ `geolocation.getCurrentPosition` または `geolocation.watchPosition` 関数が呼び出されたときに、それぞれに対応する `geolocationSuccess` コールバック関数が呼ばれるまでの最大経過時間をミリ秒単位で表します _(Number)_
+- __maximumAge:__ キャッシュされた位置情報の取得を許容する最大時間をミリ秒単位で表します _(Number)_
+
+Android に関する注意点
+--------------
+
+Android 2.x のシミュレーターは enableHighAccuracy オプションが true にセットしない限り位置情報の取得結果を通知しません。
+
+ { enableHighAccuracy: true }
+
http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/0756c5c4/docs/jp/1.8.1/cordova/geolocation/parameters/geolocationError.md
----------------------------------------------------------------------
diff --git a/docs/jp/1.8.1/cordova/geolocation/parameters/geolocationError.md b/docs/jp/1.8.1/cordova/geolocation/parameters/geolocationError.md
new file mode 100644
index 0000000..507669e
--- /dev/null
+++ b/docs/jp/1.8.1/cordova/geolocation/parameters/geolocationError.md
@@ -0,0 +1,32 @@
+---
+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.
+---
+
+geolocationError
+================
+
+位置情報取得関数にエラーが発生したときに呼び出されるコールバック関数です。
+
+ function(error) {
+ // エラー処理
+ }
+
+パラメーター
+----------
+
+- __error:__ デバイスから返されるエラーを表します (`PositionError`)
http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/0756c5c4/docs/jp/1.8.1/cordova/geolocation/parameters/geolocationSuccess.md
----------------------------------------------------------------------
diff --git a/docs/jp/1.8.1/cordova/geolocation/parameters/geolocationSuccess.md b/docs/jp/1.8.1/cordova/geolocation/parameters/geolocationSuccess.md
new file mode 100644
index 0000000..14c1e2d
--- /dev/null
+++ b/docs/jp/1.8.1/cordova/geolocation/parameters/geolocationSuccess.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.
+---
+
+geolocationSuccess
+==================
+
+位置情報取得に成功したときに呼び出されるコールバック関数です。
+
+ function(position) {
+ // 任意のコード
+ }
+
+パラメーター
+----------
+
+- __position:__ デバイスによって返される位置情報を表します (`Position`)
+
+使用例
+-------
+
+ function geolocationSuccess(position) {
+ alert('緯度: ' + position.coords.latitude + '\n' +
+ '経度: ' + position.coords.longitude + '\n' +
+ '高度: ' + position.coords.altitude + '\n' +
+ '位置精度: ' + position.coords.accuracy + '\n' +
+ '高度精度: ' + position.coords.altitudeAccuracy + '\n' +
+ '方位: ' + position.coords.heading + '\n' +
+ '速度: ' + position.coords.speed + '\n' +
+ 'タイムスタンプ: ' + new Date(position.timestamp) + '\n');
+ }
http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/0756c5c4/docs/jp/1.8.1/cordova/media/MediaError/mediaError.md
----------------------------------------------------------------------
diff --git a/docs/jp/1.8.1/cordova/media/MediaError/mediaError.md b/docs/jp/1.8.1/cordova/media/MediaError/mediaError.md
new file mode 100644
index 0000000..e867eb8
--- /dev/null
+++ b/docs/jp/1.8.1/cordova/media/MediaError/mediaError.md
@@ -0,0 +1,44 @@
+---
+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.
+---
+
+MediaError
+==========
+
+`MediaError` オブジェクトは、エラー発生時に `mediaError` コールバック関数に渡されます。
+
+プロパティー
+----------
+
+- __code:__ 事前に定義された以下のエラーコードのうちの1つを表します
+- __message:__ エラーの内容を表すエラーメッセージを表します
+
+定数
+---------
+
+- `MediaError.MEDIA_ERR_ABORTED`
+- `MediaError.MEDIA_ERR_NETWORK`
+- `MediaError.MEDIA_ERR_DECODE`
+- `MediaError.MEDIA_ERR_NONE_SUPPORTED`
+
+
+概要
+-----------
+
+`MediaError` オブジェクトは、エラー発生時に `mediaError` コールバック関数に渡されます。
+
http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/0756c5c4/docs/jp/1.8.1/cordova/media/Parameters/mediaError.md
----------------------------------------------------------------------
diff --git a/docs/jp/1.8.1/cordova/media/Parameters/mediaError.md b/docs/jp/1.8.1/cordova/media/Parameters/mediaError.md
new file mode 100644
index 0000000..9275667
--- /dev/null
+++ b/docs/jp/1.8.1/cordova/media/Parameters/mediaError.md
@@ -0,0 +1,32 @@
+---
+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.
+---
+
+mediaError
+==========
+
+メディア関数群にエラーが発生したときのユーザーによって定義されるコールバック関数です。
+
+ function(error) {
+ // エラー処理
+ }
+
+パラメーター
+----------
+
+- __error:__ デバイスから返されるエラーを表します (`MediaError`)
http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/0756c5c4/docs/jp/1.8.1/cordova/media/capture/CaptureCB.md
----------------------------------------------------------------------
diff --git a/docs/jp/1.8.1/cordova/media/capture/CaptureCB.md b/docs/jp/1.8.1/cordova/media/capture/CaptureCB.md
new file mode 100644
index 0000000..d828045
--- /dev/null
+++ b/docs/jp/1.8.1/cordova/media/capture/CaptureCB.md
@@ -0,0 +1,44 @@
+---
+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.
+---
+
+CaptureCB
+=========
+
+> メディアキャプチャー操作が成功した場合に呼び出されます。
+
+ function captureSuccess( MediaFile[] mediaFiles ) { ... };
+
+概要
+-----------
+
+この関数は、キャプチャー操作が正常に完了したときに呼び出されます。これは、メディアファイルがキャプチャーされ、ユーザーがメディアキャプチャーアプリを終了した、もしくはキャプチャーの取得制限値に達したという意味です。
+
+それぞれの MediaFile オブジェクトはキャプチャーされたメディアファイルを表します。
+
+使用例
+-------------
+
+ // capture コールバック関数
+ function captureSuccess(mediaFiles) {
+ var i, path, len;
+ for (i = 0, len = mediaFiles.length; i < len; i += 1) {
+ path = mediaFiles[i].fullPath;
+ // ファイルを使用した処理
+ }
+ };
http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/0756c5c4/docs/jp/1.8.1/cordova/media/capture/CaptureError.md
----------------------------------------------------------------------
diff --git a/docs/jp/1.8.1/cordova/media/capture/CaptureError.md b/docs/jp/1.8.1/cordova/media/capture/CaptureError.md
new file mode 100644
index 0000000..268f72c
--- /dev/null
+++ b/docs/jp/1.8.1/cordova/media/capture/CaptureError.md
@@ -0,0 +1,37 @@
+---
+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.
+---
+
+CaptureError
+============
+
+> 失敗したメディアキャプチャー操作のエラーコードをカプセル化します。
+
+プロパティー
+----------
+
+- __code:__ 事前に定義された以下のエラーコードのうちの1つを表します
+
+定数
+---------
+
+- CaptureError.`CAPTURE_INTERNAL_ERR`: カメラまたはマイクが画像または音のキャプチャーに失敗した場合。
+- CaptureError.`CAPTURE_APPLICATION_BUSY`: カメラアプリまたはオーディオ録音アプリが現在他のキャプチャーリクエストを扱っている場合。
+- CaptureError.`CAPTURE_INVALID_ARGUMENT`: API の使用方法が不正であった場合 (例: limit パラメーターの値が1未満である) 。
+- CaptureError.`CAPTURE_NO_MEDIA_FILES`: ユーザーが何もキャプチャーせずにカメラアプリやオーディオ録音アプリを終了した場合。
+- CaptureError.`CAPTURE_NOT_SUPPORTED`: キャプチャー操作のリクエストがサポートされていない場合。
http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/0756c5c4/docs/jp/1.8.1/cordova/media/capture/CaptureErrorCB.md
----------------------------------------------------------------------
diff --git a/docs/jp/1.8.1/cordova/media/capture/CaptureErrorCB.md b/docs/jp/1.8.1/cordova/media/capture/CaptureErrorCB.md
new file mode 100644
index 0000000..828fb56
--- /dev/null
+++ b/docs/jp/1.8.1/cordova/media/capture/CaptureErrorCB.md
@@ -0,0 +1,40 @@
+---
+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.
+---
+
+CaptureErrorCB
+==============
+
+> メディアキャプチャー操作中にエラーが発生した場合に呼び出されます。
+
+ function captureError( CaptureError error ) { ... };
+
+概要
+-----------
+
+この関数は、もしメディアキャプチャーアプリを起動しようとして、アプリがビジー状態であってエラーが発生した場合、もしキャプチャー操作実行中にエラーが発生した場合、もしユーザーによってメディアファイルがキャプチャーされる前にキャプチャー操作がキャンセルされた場合などに呼び出されます。
+
+この関数は適切なエラーコードが含まれた CaptureError オブジェクトを伴って呼び出されます。
+
+使用例
+-------------
+
+ // capture エラーコールバック関数
+ var captureError = function(error) {
+ navigator.notification.alert('Error code: ' + error.code, null, 'Capture Error');
+ };
http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/0756c5c4/docs/jp/1.8.1/cordova/media/capture/ConfigurationData.md
----------------------------------------------------------------------
diff --git a/docs/jp/1.8.1/cordova/media/capture/ConfigurationData.md b/docs/jp/1.8.1/cordova/media/capture/ConfigurationData.md
new file mode 100644
index 0000000..60195ef
--- /dev/null
+++ b/docs/jp/1.8.1/cordova/media/capture/ConfigurationData.md
@@ -0,0 +1,62 @@
+---
+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.
+---
+
+ConfigurationData
+=================
+
+> デバイスがサポートしているメディアキャプチャーのパラメーターのセットをカプセル化します。
+
+概要
+-----------
+
+このオブジェクトは、デバイスによってサポートされているメディアキャプチャーのモードを表すために使われています。設定データは MIME type とビデオまたはイメージキャプチャーのためのサイズ情報を含んでいます。
+
+MIME type は [RFC2046](http://www.ietf.org/rfc/rfc2046.txt) に従っています。 例:
+
+- video/3gpp
+- video/quicktime
+- image/jpeg
+- audio/amr
+- audio/wav
+
+プロパティー
+----------
+
+- __type:__ ASCII エンコードされた小文字の文字列でメディアタイプを表します。 (DOMString)
+- __height:__ 画像またはビデオの高さをピクセルで表します。 オーディオの場合は、0に設定されます。 (Number)
+- __width:__ 画像またはビデオの幅をピクセルで表します。 オーディオの場合は、0に設定されます。 (Number)
+
+使用例
+-------------
+
+ // サポートされている画像のモードを取得
+ var imageModes = navigator.device.capture.supportedImageModes;
+
+ // 幅が一番高い解像度を持つモードを選択
+ var width = 0;
+ var selectedmode;
+ for each (var mode in imageModes) {
+ if (mode.width > width) {
+ width = mode.width;
+ selectedmode = mode;
+ }
+ }
+
+
+どのプラットフォームからもサポートされていません。全ての設定データは空となっています。
http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/0756c5c4/docs/jp/1.8.1/cordova/media/capture/MediaFile.getFormatData.md
----------------------------------------------------------------------
diff --git a/docs/jp/1.8.1/cordova/media/capture/MediaFile.getFormatData.md b/docs/jp/1.8.1/cordova/media/capture/MediaFile.getFormatData.md
new file mode 100644
index 0000000..003a8cc
--- /dev/null
+++ b/docs/jp/1.8.1/cordova/media/capture/MediaFile.getFormatData.md
@@ -0,0 +1,53 @@
+---
+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]
+ );
+
+概要
+-----------
+
+この関数は、メディアファイルのフォーマット情報の取得を非同期で試みます。もし成功すれば、 MediaFileData オブジェクトを伴った MediaFileDataSuccessCB コールバック関数を呼び出します。もし失敗すれば、 MediaFileDataErrorCB コールバック関数を呼び出します。
+
+サポートされているプラットフォーム
+-------------------
+
+- Android
+- BlackBerry WebWorks (OS 5.0 以上)
+- iOS
+- Windows Phone 7 (Mango)
+
+BlackBerry WebWorks に関する注意点
+--------------------------
+メディアファイルのフォーマット情報を提供する API はありません。従って、全ての MediaFileData オブジェクトはデフォルト値で返されます。詳しくは MediaFileData のドキュメントをご覧ください。
+
+Android に関する注意点
+--------------
+メディアファイルのフォーマット情報を取得する API は限定されています。従って、全ての MediaFileData のプロパティーがサポートされている訳ではありません。詳しくは MediaFileData のドキュメントをご覧ください。
+
+iOS に関する注意点
+----------
+メディアファイルのフォーマット情報を取得する API は限定されています。従って、全ての MediaFileData のプロパティーがサポートされている訳ではありません。詳しくは MediaFileData のドキュメントをご覧ください。
http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/0756c5c4/docs/jp/1.8.1/cordova/media/capture/MediaFile.md
----------------------------------------------------------------------
diff --git a/docs/jp/1.8.1/cordova/media/capture/MediaFile.md b/docs/jp/1.8.1/cordova/media/capture/MediaFile.md
new file mode 100644
index 0000000..0896e88
--- /dev/null
+++ b/docs/jp/1.8.1/cordova/media/capture/MediaFile.md
@@ -0,0 +1,37 @@
+---
+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
+=========
+
+> メディアキャプチャーファイルのプロパティーをカプセル化します。
+
+プロパティー
+----------
+
+- __name:__ パス情報を含まないファイルの名前を表します。 (DOMString)
+- __fullPath:__ ファイルの名前を含むフルパスを表します。 (DOMString)
+- __type:__ ファイルの mime type を表します。 (DOMString)
+- __lastModifiedDate:__ ファイルの最終更新日時を表します。 (Date)
+- __size:__ ファイルのサイズをバイトで表します。 (Number)
+
+メソッド
+-------
+
+- __MediaFile.getFormatData:__ メディアファイルのフォーマット情報を取得します。
http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/0756c5c4/docs/jp/1.8.1/cordova/media/capture/MediaFileData.md
----------------------------------------------------------------------
diff --git a/docs/jp/1.8.1/cordova/media/capture/MediaFileData.md b/docs/jp/1.8.1/cordova/media/capture/MediaFileData.md
new file mode 100644
index 0000000..b209551
--- /dev/null
+++ b/docs/jp/1.8.1/cordova/media/capture/MediaFileData.md
@@ -0,0 +1,62 @@
+---
+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
+=============
+
+> メディアファイルのフォーマット情報をカプセル化します。
+
+プロパティー
+----------
+
+- __codecs:__ オーディオやビデオの実際のフォーマットを表します。 (DOMString)
+- __bitrate:__ ファイルの平均ビットレートを表します。画像の場合は、0に設定されます。 (Number)
+- __height:__ 画像またはビデオの高さをピクセルで表します。オーディオの場合は、0に設定されます。 (Number)
+- __width:__ 画像またはビデオの幅をピクセルで表します。オーディオの場合は、0に設定されます。 (Number)
+- __duration:__ ビデオまたはオーディオの長さを秒で表します。画像の場合は、0に設定されます。 (Number)
+
+BlackBerry WebWorks に関する注意点
+--------------------------
+メディアファイルのフォーマット情報を提供する API はありません。 MediaFileData オブジェクトは、 MediaFile.getFormatData 関数によって返され、以下のようなデフォルト値を持ちます:
+
+- __codecs:__ サポートされていません。この属性は常に null となります。
+- __bitrate:__ サポートされていません。この属性は常に0となります。
+- __height:__ サポートされていません。この属性は常に0となります。
+- __width:__ サポートされていません。この属性は常に0となります。
+- __duration:__ サポートされていません。この属性は常に0となります。
+
+Android に関する注意点
+--------------
+MediaFileData プロパティーへのサポートは以下のとおりです:
+
+- __codecs:__ サポートされていません。この属性は常に null となります。
+- __bitrate:__ サポートされていません。この属性は常に0となります。
+- __height:__ サポートされています。 (画像及びビデオに限る) 。
+- __width:__ サポートされています。 (画像及びビデオに限る) 。
+- __duration:__ サポートされています。 (オーディオ及びビデオに限る) 。
+
+iOS に関する注意点
+----------
+MediaFileData プロパティーへのサポートは以下のとおりです:
+
+- __codecs:__ サポートされていません。この属性は常に null となります。
+- __bitrate:__ iOS4 のデバイスにおいて、オーディオのみサポートされています。この属性は、画像とビデオについては常に0となります。
+- __height:__ サポートされています。 (画像及びビデオに限る) 。
+- __width:__ サポートされています。 (画像及びビデオに限る) 。
+- __duration:__ サポートされています。 (オーディオ及びビデオに限る) 。
http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/0756c5c4/docs/jp/1.8.1/cordova/media/capture/capture.md
----------------------------------------------------------------------
diff --git a/docs/jp/1.8.1/cordova/media/capture/capture.md b/docs/jp/1.8.1/cordova/media/capture/capture.md
new file mode 100644
index 0000000..9a9e44c
--- /dev/null
+++ b/docs/jp/1.8.1/cordova/media/capture/capture.md
@@ -0,0 +1,75 @@
+---
+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
+=======
+
+> デバイスのオーディオ、イメージ、ビデオキャプチャー機能への制御を提供します。
+
+オブジェクト
+-------
+
+- Capture
+- CaptureAudioOptions
+- CaptureImageOptions
+- CaptureVideoOptions
+- CaptureCB
+- CaptureErrorCB
+- ConfigurationData
+- MediaFile
+- MediaFileData
+
+メソッド
+-------
+
+- capture.captureAudio
+- capture.captureImage
+- capture.captureVideo
+- MediaFile.getFormatData
+
+スコープ
+-----
+
+__capture__ オブジェクトは __navigator.device__ オブジェクトに割り当てられており、そのためグローバルスコープです。
+
+ // グローバル capture オブジェクト
+ var capture = navigator.device.capture;
+
+プロパティー
+----------
+
+- __supportedAudioModes:__ デバイスによってサポートされているオーディオ録音のフォーマットです。 (ConfigurationData[])
+- __supportedImageModes:__ デバイスによってサポートされている記録用の画像サイズやフォーマットです。 (ConfigurationData[])
+- __supportedVideoModes:__ デバイスによってサポートされている記録用のビデオ解像度やフォーマットです。 (ConfigurationData[])
+
+メソッド
+-------
+
+- capture.captureAudio: オーディオ録音のために、デバイスのオーディオ録音アプリを起動します。
+- capture.captureImage: 画像取得のために、デバイスのカメラアプリを起動します。
+- capture.captureVideo: ビデオ録画のために、デバイスのビデオ録画アプリを起動します。
+
+
+サポートされているプラットフォーム
+-------------------
+
+- Android
+- BlackBerry WebWorks (OS 5.0 以上)
+- iOS
+- Windows Phone 7 (Mango)
http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/0756c5c4/docs/jp/1.8.1/cordova/media/capture/captureAudio.md
----------------------------------------------------------------------
diff --git a/docs/jp/1.8.1/cordova/media/capture/captureAudio.md b/docs/jp/1.8.1/cordova/media/capture/captureAudio.md
new file mode 100644
index 0000000..538da8b
--- /dev/null
+++ b/docs/jp/1.8.1/cordova/media/capture/captureAudio.md
@@ -0,0 +1,140 @@
+---
+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が使用され、キャプチャー操作はユーザーが1度オーディオを録音した後に終了します。
+
+キャプチャー操作が終了した時、それぞれのオーディオ録音ファイル情報が書かれた MediaFile オブジェクトの配列を伴った CaptureCB コールバック関数を呼び出します。もしオーディオがキャプチャーされる前にユーザーによって操作が終了されたら、 CaptureError.`CAPTURE_NO_MEDIA_FILES` エラーコードを持つ CaptureError オブジェクトを伴った CaptureErrorCB コールバック関数が呼び出されます。
+
+サポートされているプラットフォーム
+-------------------
+
+- Android
+- BlackBerry WebWorks (OS 5.0 以上)
+- iOS
+- Windows Phone 7 (Mango)
+
+使用例
+-------------
+
+ // capture コールバック関数
+ var captureSuccess = function(mediaFiles) {
+ var i, path, len;
+ for (i = 0, len = mediaFiles.length; i < len; i += 1) {
+ path = mediaFiles[i].fullPath;
+ // ファイルを使用した処理
+ }
+ };
+
+ // capture エラーコールバック関数
+ var captureError = function(error) {
+ navigator.notification.alert('Error code: ' + error.code, null, 'Capture Error');
+ };
+
+ // オーディオキャプチャーを開始
+ navigator.device.capture.captureAudio(captureSuccess, captureError, {limit:2});
+
+詳細な使用例
+------------
+
+ <!DOCTYPE html>
+ <html>
+ <head>
+ <title>オーディオキャプチャー</title>
+
+ <script type="text/javascript" charset="utf-8" src="cordova-1.7.0.js"></script>
+ <script type="text/javascript" charset="utf-8" src="json2.js"></script>
+ <script type="text/javascript" charset="utf-8">
+
+ // キャプチャー操作の正常終了時の処理
+ //
+ function captureSuccess(mediaFiles) {
+ var i, len;
+ for (i = 0, len = mediaFiles.length; i < len; i += 1) {
+ uploadFile(mediaFiles[i]);
+ }
+ }
+
+ // エラー発生時の処理
+ //
+ function captureError(error) {
+ var msg = 'キャプチャー中にエラーが発生しました: ' + error.code;
+ navigator.notification.alert(msg, null, 'エラー');
+ }
+
+ // ボタンがクリックされた場合の処理
+ //
+ function captureAudio() {
+ // デバイスのオーディオ録音アプリを起動し、
+ // ユーザーに2つまでオーディオの録音を許可する
+ navigator.device.capture.captureAudio(captureSuccess, captureError, {limit: 2});
+ }
+
+ // ファイルをサーバーにアップロード
+ 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('アップロード成功: ' + result.responseCode);
+ console.log(result.bytesSent + ' バイト送信');
+ },
+ function(error) {
+ console.log('ファイルのアップロードに失敗 ' + path + ': ' + error.code);
+ },
+ { fileName: name });
+ }
+
+ </script>
+ </head>
+ <body>
+ <button onclick="captureAudio();">オーディオキャプチャー</button> <br>
+ </body>
+ </html>
+
+BlackBerry WebWorks に関する注意点
+--------------------------
+
+- Cordova for BlackBerry WebWorks は、オーディオ録音のために RIM より提供されている __Voice Notes Recorder__ の起動を試みます。デベロッパーは、もしアプリがインストールされていない場合は CaptureError.`CAPTURE_NOT_SUPPORTED` エラーを受け取ります。
+
+iOS に関する注意点
+----------
+
+- iOS にはデフォルトのオーディオ録音アプリがないため、シンプルなユーザーインターフェースが提供されます。
+
+Windows Phone 7 に関する注意点
+----------
+
+- Windows Phone 7 にはデフォルトのオーディオ録音アプリがないため、シンプルなユーザーインターフェースが提供されます。
http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/0756c5c4/docs/jp/1.8.1/cordova/media/capture/captureAudioOptions.md
----------------------------------------------------------------------
diff --git a/docs/jp/1.8.1/cordova/media/capture/captureAudioOptions.md b/docs/jp/1.8.1/cordova/media/capture/captureAudioOptions.md
new file mode 100644
index 0000000..a2d27b9
--- /dev/null
+++ b/docs/jp/1.8.1/cordova/media/capture/captureAudioOptions.md
@@ -0,0 +1,56 @@
+---
+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
+===================
+
+> オーディオキャプチャーのオプションをカプセル化します。
+
+プロパティー
+----------
+
+- __limit:__ 一つのキャプチャー操作で録音できるオーディオクリップの最大値を表します。値は1以上の必要があります (デフォルトは1です) 。
+- __duration:__ オーディオクリップの最大録音時間を秒で表します。
+- __mode:__ 選択されたオーディオのモードを表します。値は `capture.supportedAudioModes` の中の一つである必要があります。
+
+使用例
+-------------
+
+ // キャプチャー操作時のオーディオクリップの最大値を3に制限、最大録音時間を10秒に設定
+ var options = { limit: 3, duration: 10 };
+
+ navigator.device.capture.captureAudio(captureSuccess, captureError, options);
+
+Android に関する注意点
+--------------
+
+- __duration__ パラメーターはサポートされていません。録画時間をプログラム的に制限することは出来ません。
+- __mode__ パラメーターはサポートされていません。録音のフォーマットをプログラム的に変更することは出来ません。録音は Adaptive Multi-Rate (AMR) フォーマット (audio/amr) を使用してエンコードされます。
+
+BlackBerry WebWorks に関する注意点
+--------------------------
+
+- __duration__ パラメーターはサポートされていません。録画時間をプログラム的に制限することは出来ません。
+- __mode__ パラメーターはサポートされていません。録音のフォーマットをプログラム的に変更することは出来ません。録音は Adaptive Multi-Rate (AMR) フォーマット (audio/amr) を使用してエンコードされます。
+
+iOS に関する注意点
+----------
+
+- __limit__ パラメーターはサポートされていません。1つのキャプチャー操作につき1つの録音が作られます。
+- __mode__ パラメーターはサポートされていません。録音のフォーマットをプログラム的に変更することは出来ません。録音は Waveform Audio (WAV) フォーマット (audio/wav) を使用してエンコードされます。
http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/0756c5c4/docs/jp/1.8.1/cordova/media/capture/captureImage.md
----------------------------------------------------------------------
diff --git a/docs/jp/1.8.1/cordova/media/capture/captureImage.md b/docs/jp/1.8.1/cordova/media/capture/captureImage.md
new file mode 100644
index 0000000..a38bb75
--- /dev/null
+++ b/docs/jp/1.8.1/cordova/media/capture/captureImage.md
@@ -0,0 +1,132 @@
+---
+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]
+ );
+
+概要
+-----------
+
+このメソッドは、デバイスのカメラアプリを使用して、画像をキャプチャーするための非同期操作を開始します。この操作はユーザーに、単一セッションで複数の画像のキャプチャーをユーザーに許可します。
+
+キャプチャー操作は、ユーザーがカメラアプリを終了するか、 CaptureImageOption の中の __limit__ パラメーターで指定された最大撮影回数に達した場合に終了します。もし __limit__ パラメーターが指定されていない場合は、デフォルト値である1が使用され、キャプチャー操作はユーザーが1度画像を撮影した後に終了します。
+
+キャプチャー操作が終了した時、それぞれの画像ファイル情報が書かれた MediaFile オブジェクトの配列を伴った CaptureCB コールバック関数を呼び出します。もし画像がキャプチャーされる前にユーザーによって操作が終了されたら、 CaptureError.`CAPTURE_NO_MEDIA_FILES` エラーコードを持つ CaptureError オブジェクトを伴った CaptureErrorCB コールバック関数が呼び出されます。
+
+サポートされているプラットフォーム
+-------------------
+
+- Android
+- BlackBerry WebWorks (OS 5.0 以上)
+- iOS
+- Windows Phone 7 (Mango)
+
+Windows Phone 7 に関する注意点
+----------------------
+
+Zune とデバイスが接続している間は、ネイティブカメラアプリケーションは起動せずに、エラーコールバックが呼び出されます。
+
+使用例
+-------------
+
+ // capture コールバック関数
+ var captureSuccess = function(mediaFiles) {
+ var i, path, len;
+ for (i = 0, len = mediaFiles.length; i < len; i += 1) {
+ path = mediaFiles[i].fullPath;
+ // ファイルを使用した処理
+ }
+ };
+
+ // capture エラーコールバック関数
+ var captureError = function(error) {
+ navigator.notification.alert('Error code: ' + error.code, null, 'Capture Error');
+ };
+
+ // 画像のキャプチャーを開始
+ navigator.device.capture.captureImage(captureSuccess, captureError, {limit:2});
+
+詳細な使用例
+------------
+
+ <!DOCTYPE html>
+ <html>
+ <head>
+ <title>画像キャプチャー</title>
+
+ <script type="text/javascript" charset="utf-8" src="cordova-1.7.0.js"></script>
+ <script type="text/javascript" charset="utf-8" src="json2.js"></script>
+ <script type="text/javascript" charset="utf-8">
+
+ // キャプチャー操作の正常終了時の処理
+ //
+ function captureSuccess(mediaFiles) {
+ var i, len;
+ for (i = 0, len = mediaFiles.length; i < len; i += 1) {
+ uploadFile(mediaFiles[i]);
+ }
+ }
+
+ // エラー発生時の処理
+ //
+ function captureError(error) {
+ var msg = 'キャプチャー中にエラーが発生しました: ' + error.code;
+ navigator.notification.alert(msg, null, 'エラー');
+ }
+
+ // ボタンがクリックされた場合の処理
+ //
+ function captureImage() {
+ // デバイスのカメラアプリを起動、
+ // ユーザーに2つまで画像のキャプチャーを許可する
+ navigator.device.capture.captureImage(captureSuccess, captureError, {limit: 2});
+ }
+
+ // ファイルをサーバーにアップロード
+ 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('アップロード成功: ' + result.responseCode);
+ console.log(result.bytesSent + ' バイト送信');
+ },
+ function(error) {
+ console.log('ファイルのアップロードに失敗 ' + path + ': ' + error.code);
+ },
+ { fileName: name });
+ }
+
+ </script>
+ </head>
+ <body>
+ <button onclick="captureImage();">画像キャプチャー</button> <br>
+ </body>
+ </html>
+
+
http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/0756c5c4/docs/jp/1.8.1/cordova/media/capture/captureImageOptions.md
----------------------------------------------------------------------
diff --git a/docs/jp/1.8.1/cordova/media/capture/captureImageOptions.md b/docs/jp/1.8.1/cordova/media/capture/captureImageOptions.md
new file mode 100644
index 0000000..45b3298
--- /dev/null
+++ b/docs/jp/1.8.1/cordova/media/capture/captureImageOptions.md
@@ -0,0 +1,53 @@
+---
+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
+===================
+
+> 画像キャプチャーのオプションをカプセル化します。
+
+プロパティー
+----------
+
+- __limit:__ 一つのキャプチャー操作で撮影できる画像の最大値を表します。値は1以上の必要があります (デフォルトは1です) 。
+- __mode:__ 選択された画像のモードを表します。値は `capture.supportedImageModes` の中の一つである必要があります。
+
+使用例
+-------------
+
+ // キャプチャー操作時の取得画像の最大値を3に制限
+ var options = { limit: 3 };
+
+ navigator.device.capture.captureImage(captureSuccess, captureError, options);
+
+Android に関する注意点
+--------------
+
+- __mode__ パラメーターはサポートされていません。画像のサイズとフォーマットはプログラム的に変更することはできません。しかし、画像サイズはユーザーによって変更することは可能です。画像は JPEG フォーマット (image/jpeg) で保存されます。
+
+BlackBerry WebWorks に関する注意点
+--------------------------
+
+- __mode__ パラメーターはサポートされていません。画像のサイズとフォーマットはプログラム的に変更することはできません。しかし、画像サイズはユーザーによって変更することは可能です。画像は JPEG フォーマット (image/jpeg) で保存されます。
+
+iOS に関する注意点
+----------
+
+- __limit__ パラメーターはサポートされていません。1つのキャプチャー操作につき1つの画像が撮影されます。
+- __mode__ パラメーターはサポートされていません。画像のサイズとフォーマットはプログラム的に変更することはできません。画像は JPEG フォーマット (image/jpeg) で保存されます。
http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/0756c5c4/docs/jp/1.8.1/cordova/media/capture/captureVideo.md
----------------------------------------------------------------------
diff --git a/docs/jp/1.8.1/cordova/media/capture/captureVideo.md b/docs/jp/1.8.1/cordova/media/capture/captureVideo.md
new file mode 100644
index 0000000..76656d5
--- /dev/null
+++ b/docs/jp/1.8.1/cordova/media/capture/captureVideo.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.
+---
+
+capture.captureVideo
+====================
+
+> ビデオ録画アプリを起動し、キャプチャーしたビデオファイルの情報を返します。
+
+ navigator.device.capture.captureVideo(
+ CaptureCB captureSuccess, CaptureErrorCB captureError, [CaptureVideoOptions options]
+ );
+
+概要
+-----------
+
+このメソッドは、デバイスのビデオ録画アプリを使用して、ビデオをキャプチャーするための非同期操作を開始します。この操作はユーザーに、単一セッションで複数のビデオのキャプチャーをユーザーに許可します。
+
+キャプチャー操作は、ユーザーがビデオ録画アプリを終了するか、 CaptureVideoOptions の中の __limit__ パラメーターで指定された最大録画回数に達した場合に終了します。もし __limit__ パラメーターが指定されていない場合は、デフォルト値である1が使用され、キャプチャー操作はユーザーが1度ビデオを録画した後に終了します。
+
+キャプチャー操作が終了した時、それぞれのビデオ録画ファイル情報が書かれた MediaFile オブジェクトの配列を伴った CaptureCB コールバック関数を呼び出します。もしオーディオがキャプチャーされる前にユーザーによって操作が終了されたら、 CaptureError.`CAPTURE_NO_MEDIA_FILES` エラーコードを持つ CaptureError オブジェクトを伴った CaptureErrorCB コールバック関数が呼び出されます。
+
+サポートされているプラットフォーム
+-------------------
+
+- Android
+- BlackBerry WebWorks (OS 5.0 以上)
+- iOS
+- Windows Phone 7 (Mango)
+
+使用例
+-------------
+
+ // capture コールバック関数
+ var captureSuccess = function(mediaFiles) {
+ var i, path, len;
+ for (i = 0, len = mediaFiles.length; i < len; i += 1) {
+ path = mediaFiles[i].fullPath;
+ // ファイルを使用した処理
+ }
+ };
+
+ // capture エラーコールバック関数
+ var captureError = function(error) {
+ navigator.notification.alert('Error code: ' + error.code, null, 'Capture Error');
+ };
+
+ // ビデオキャプチャーを開始
+ navigator.device.capture.captureVideo(captureSuccess, captureError, {limit:2});
+
+詳細な使用例
+------------
+
+ <!DOCTYPE html>
+ <html>
+ <head>
+ <title>ビデオキャプチャー</title>
+
+ <script type="text/javascript" charset="utf-8" src="cordova-1.7.0.js"></script>
+ <script type="text/javascript" charset="utf-8" src="json2.js"></script>
+ <script type="text/javascript" charset="utf-8">
+
+ // キャプチャー操作の正常終了時の処理
+ //
+ function captureSuccess(mediaFiles) {
+ var i, len;
+ for (i = 0, len = mediaFiles.length; i < len; i += 1) {
+ uploadFile(mediaFiles[i]);
+ }
+ }
+
+ // エラー発生時の処理
+ //
+ function captureError(error) {
+ var msg = 'キャプチャー中にエラーが発生しました: ' + error.code;
+ navigator.notification.alert(msg, null, 'エラー');
+ }
+
+ // ボタンがクリックされた場合の処理
+ //
+ function captureVideo() {
+ // デバイスのビデオ録画アプリを起動し、
+ // ユーザーに2つまでビデオの録画を許可する
+ navigator.device.capture.captureVideo(captureSuccess, captureError, {limit: 2});
+ }
+
+ // ファイルをサーバーにアップロード
+ 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('アップロード成功: ' + result.responseCode);
+ console.log(result.bytesSent + ' バイト送信');
+ },
+ function(error) {
+ console.log('ファイルのアップロードに失敗 ' + path + ': ' + error.code);
+ },
+ { fileName: name });
+ }
+
+ </script>
+ </head>
+ <body>
+ <button onclick="captureVideo();">ビデオキャプチャー</button> <br>
+ </body>
+ </html>
+
+BlackBerry WebWorks に関する注意点
+--------------------------
+
+- Cordova for BlackBerry WebWorks は、ビデオ録画のために RIM より提供されている __Video Recorder__ の起動を試みます。デベロッパーは、もしアプリがインストールされていない場合は CaptureError.`CAPTURE_NOT_SUPPORTED` エラーを受け取ります。
http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/0756c5c4/docs/jp/1.8.1/cordova/media/capture/captureVideoOptions.md
----------------------------------------------------------------------
diff --git a/docs/jp/1.8.1/cordova/media/capture/captureVideoOptions.md b/docs/jp/1.8.1/cordova/media/capture/captureVideoOptions.md
new file mode 100644
index 0000000..0d1b7f5
--- /dev/null
+++ b/docs/jp/1.8.1/cordova/media/capture/captureVideoOptions.md
@@ -0,0 +1,59 @@
+---
+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
+===================
+
+> ビデオキャプチャーのオプションをカプセル化します。
+
+プロパティー
+----------
+
+- __limit:__ 一つのキャプチャー操作で録画できるビデオの最大値を表します。値は1以上の必要があります (デフォルトは1です) 。
+- __duration:__ ビデオクリップの最大録画時間を秒で表します。
+- __mode:__ 選択されたビデオのモードを表します。値は `capture.supportedVideoModes` の中の一つである必要があります。
+
+使用例
+-------------
+
+ // キャプチャー操作時のビデオクリップの最大値を3に制限
+ var options = { limit: 3 };
+
+ navigator.device.capture.captureVideo(captureSuccess, captureError, options);
+
+Android に関する注意点
+--------------
+
+- __duration__ パラメーターはサポートされていません。録画時間をプログラム的に制限することは出来ません。
+- __mode__ パラメーターはサポートされていません。ビデオのサイズとフォーマットはプログラム的に変更することはできません。しかし、これらのパラメーターはユーザーによって変更することは可能です。デフォルトでは、ビデオは 3GPP (video/3gpp) フォーマットで録画されます。
+
+
+BlackBerry WebWorks に関する注意点
+--------------------------
+
+- __duration__ パラメーターはサポートされていません。 録画時間をプログラム的に制限することは出来ません。
+- __mode__ パラメーターはサポートされていません。 ビデオのサイズとフォーマットはプログラム的に変更することはできません。しかし、これらのパラメーターはユーザーによって変更することは可能です。 デフォルトでは、ビデオは 3GPP (video/3gpp) フォーマットで録画されます。
+
+iOS に関する注意点
+----------
+
+- __limit__ パラメーターはサポートされていません。1つのキャプチャー操作につき1つのビデオが録画されます。
+- __duration__ パラメーターはサポートされていません。録画時間をプログラム的に制限することは出来ません。
+- __mode__ パラメーターはサポートされていません。ビデオのサイズとフォーマットはプログラム的に変更することはできません。デフォルトでは、ビデオは MOV (video/quicktime) フォーマットで録画されます。
+
http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/0756c5c4/docs/jp/1.8.1/cordova/media/media.getCurrentPosition.md
----------------------------------------------------------------------
diff --git a/docs/jp/1.8.1/cordova/media/media.getCurrentPosition.md b/docs/jp/1.8.1/cordova/media/media.getCurrentPosition.md
new file mode 100644
index 0000000..f1f6c76
--- /dev/null
+++ b/docs/jp/1.8.1/cordova/media/media.getCurrentPosition.md
@@ -0,0 +1,172 @@
+---
+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.getCurrentPosition` 関数は Media オブジェクトのオーディオファイルの現在再生位置を返す非同期関数です。 Media オブジェクト内の __position__ パラメーターの値も更新します。
+
+サポートされているプラットフォーム
+-------------------
+
+- Android
+- iOS
+- Windows Phone 7 (Mango)
+
+使用例
+-------------
+
+ // オーディオプレイヤー
+ //
+ var my_media = new Media(src, onSuccess, onError);
+
+ // メディアの再生位置を一秒ごとに更新
+ var mediaTimer = setInterval(function() {
+ // 再生位置を取得
+ my_media.getCurrentPosition(
+ // 呼び出し成功
+ function(position) {
+ if (position > -1) {
+ console.log((position) + " sec");
+ }
+ },
+ // 呼び出し失敗
+ 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>メディアの使用例</title>
+
+ <script type="text/javascript" charset="utf-8" src="cordova-1.7.0.js"></script>
+ <script type="text/javascript" charset="utf-8">
+
+ // Cordova の読み込み完了まで待機
+ //
+ document.addEventListener("deviceready", onDeviceReady, false);
+
+ // Cordova 準備完了
+ //
+ function onDeviceReady() {
+ playAudio("http://audio.ibeat.org/content/p1rj1s/p1rj1s_-_rockGuitar.mp3");
+ }
+
+ // オーディオプレイヤー
+ //
+ var my_media = null;
+ var mediaTimer = null;
+
+ // オーディオ再生
+ //
+ function playAudio(src) {
+ // src から Media オブジェクトを作成
+ my_media = new Media(src, onSuccess, onError);
+
+ // オーディオ再生
+ my_media.play();
+
+ // my_media の再生位置を一秒ごとに更新
+ if (mediaTimer == null) {
+ mediaTimer = setInterval(function() {
+ // my_media の再生位置を取得
+ my_media.getCurrentPosition(
+ // 呼び出し成功
+ function(position) {
+ if (position > -1) {
+ setAudioPosition((position) + " sec");
+ }
+ },
+ // 呼び出し失敗
+ function(e) {
+ console.log("Error getting pos=" + e);
+ setAudioPosition("Error: " + e);
+ }
+ );
+ }, 1000);
+ }
+ }
+
+ // オーディオ一時停止
+ //
+ function pauseAudio() {
+ if (my_media) {
+ my_media.pause();
+ }
+ }
+
+ // オーディオ停止
+ //
+ function stopAudio() {
+ if (my_media) {
+ my_media.stop();
+ }
+ clearInterval(mediaTimer);
+ mediaTimer = null;
+ }
+
+ // 成功時のコールバック関数
+ //
+ function onSuccess() {
+ console.log("playAudio():Audio Success");
+ }
+
+ // エラー時のコールバック関数
+ //
+ function onError(error) {
+ alert('コード: ' + error.code + '\n' +
+ 'メッセージ: ' + error.message + '\n');
+ }
+
+ // 再生位置をセット
+ //
+ 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');">再生</a>
+ <a href="#" class="btn large" onclick="pauseAudio();">一時停止</a>
+ <a href="#" class="btn large" onclick="stopAudio();">停止</a>
+ <p id="audio_position"></p>
+ </body>
+ </html>
http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/0756c5c4/docs/jp/1.8.1/cordova/media/media.getDuration.md
----------------------------------------------------------------------
diff --git a/docs/jp/1.8.1/cordova/media/media.getDuration.md b/docs/jp/1.8.1/cordova/media/media.getDuration.md
new file mode 100644
index 0000000..04dc427
--- /dev/null
+++ b/docs/jp/1.8.1/cordova/media/media.getDuration.md
@@ -0,0 +1,164 @@
+---
+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
+- iOS
+- Windows Phone 7 (Mango)
+
+使用例
+-------------
+
+ // オーディオプレイヤー
+ //
+ var my_media = new Media(src, onSuccess, onError);
+
+ // 再生時間を取得
+ 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>メディアの使用例</title>
+
+ <script type="text/javascript" charset="utf-8" src="cordova-1.7.0.js"></script>
+ <script type="text/javascript" charset="utf-8">
+
+ // Cordova の読み込み完了まで待機
+ //
+ document.addEventListener("deviceready", onDeviceReady, false);
+
+ // Cordova 準備完了
+ //
+ function onDeviceReady() {
+ playAudio("http://audio.ibeat.org/content/p1rj1s/p1rj1s_-_rockGuitar.mp3");
+ }
+
+ // オーディオプレイヤー
+ //
+ var my_media = null;
+ var mediaTimer = null;
+
+ // オーディオ再生
+ //
+ function playAudio(src) {
+ // src から Media オブジェクトを作成
+ my_media = new Media(src, onSuccess, onError);
+
+ // オーディオ再生
+ my_media.play();
+
+ // my_media の再生位置を一秒ごとに更新
+ if (mediaTimer == null) {
+ mediaTimer = setInterval(function() {
+ // my_media の再生位置を取得
+ my_media.getCurrentPosition(
+ // 呼び出し成功
+ function(position) {
+ if (position > -1) {
+ setAudioPosition((position) + " sec");
+ }
+ },
+ // 呼び出し失敗
+ function(e) {
+ console.log("Error getting pos=" + e);
+ setAudioPosition("Error: " + e);
+ }
+ );
+ }, 1000);
+ }
+ }
+
+ // オーディオ一時停止
+ //
+ function pauseAudio() {
+ if (my_media) {
+ my_media.pause();
+ }
+ }
+
+ // オーディオ停止
+ //
+ function stopAudio() {
+ if (my_media) {
+ my_media.stop();
+ }
+ clearInterval(mediaTimer);
+ mediaTimer = null;
+ }
+
+ // 成功時のコールバック関数
+ //
+ function onSuccess() {
+ console.log("playAudio():Audio Success");
+ }
+
+ // エラー時のコールバック関数
+ //
+ function onError(error) {
+ alert('コード: ' + error.code + '\n' +
+ 'メッセージ: ' + error.message + '\n');
+ }
+
+ // 再生位置をセット
+ //
+ 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');">再生</a>
+ <a href="#" class="btn large" onclick="pauseAudio();">一時停止</a>
+ <a href="#" class="btn large" onclick="stopAudio();">停止</a>
+ <p id="audio_position"></p>
+ </body>
+ </html>
http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/0756c5c4/docs/jp/1.8.1/cordova/media/media.md
----------------------------------------------------------------------
diff --git a/docs/jp/1.8.1/cordova/media/media.md b/docs/jp/1.8.1/cordova/media/media.md
new file mode 100644
index 0000000..d9c89e4
--- /dev/null
+++ b/docs/jp/1.8.1/cordova/media/media.md
@@ -0,0 +1,63 @@
+---
+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
+=====
+
+> `Media` オブジェクトは、デバイス上でのオーディオファイルの再生や録音などといった機能をサポートします。
+
+ var media = new Media(src, mediaSuccess, [mediaError], [mediaStatus]);
+
+
+注意: 現在の実装はメディアキャプチャーに関する W3C の仕様を満たしていません。利便性のためだけに提供されています。将来的には最新の W3C の仕様に合わせるとともに、現在の API を廃止することも検討されています。
+
+パラメーター
+----------
+
+- __src__: オーディオコンテンツを示す URI を表します _(DOMString)_
+- __mediaSuccess__: (オプション) Media オブジェクトが再生、録音、停止などのアクションを完了したときに呼ばれるコールバック関数を表します _(Function)_
+- __mediaError__: (オプション) エラー発生時に呼ばれるコールバック関数を表します _(Function)_
+- __mediaStatus__: (オプション) ステータスが変わったときに呼ばれるコールバック関数を表します _(Function)_
+
+メソッド
+-------
+
+- media.getCurrentPosition: オーディオファイル内の現在の再生位置を返します
+- media.getDuration: オーディオファイルの再生時間を返します
+- media.play: オーディオファイルを再生または再開します
+- media.pause: オーディオファイルを一時停止します
+- media.release: OS のオーディオリソースを開放します
+- media.seekTo: オーディオファイル中の再生位置を動かします
+- media.startRecord: オーディオファイルの録音を開始します
+- media.stopRecord: オーディオファイルの録音を停止します
+- media.stop: オーディオファイルを停止します
+
+追加の読み取り専用パラメーター
+---------------------
+
+- ___position__: 再生位置を秒単位で表します。 再生中は自動的に値が更新されないので、 getCurrentPosition メソッドを呼び、値を更新します
+- ___duration__: メディアの再生時間を秒単位で表します
+
+サポートされているプラットフォーム
+-------------------
+
+- Android
+- iOS
+- Windows Phone 7 (Mango)
+