You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cordova.apache.org by mw...@apache.org on 2013/01/02 23:25:39 UTC
[5/16] Copy docs/jp/2.0.0 to docs/jp/2.1.0
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/4272ca34/docs/jp/2.1.0/cordova/geolocation/Position/position.md
----------------------------------------------------------------------
diff --git a/docs/jp/2.1.0/cordova/geolocation/Position/position.md b/docs/jp/2.1.0/cordova/geolocation/Position/position.md
new file mode 100644
index 0000000..619c5e6
--- /dev/null
+++ b/docs/jp/2.1.0/cordova/geolocation/Position/position.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.
+---
+
+Position
+========
+
+geolocation API によって作成された位置情報とタイムスタンプ (`Position`) とを扱うオブジェクトです。
+
+プロパティー
+----------
+
+- __coords:__ 地理座標を表します _(Coordinates)_
+- __timestamp:__ タイムスタンプ値を表します _(Date)_
+
+概要
+-----------
+
+`Position` オブジェクトは Cordova によって作られ、コールバック関数を通してユーザーに返されます。
+
+サポートされているプラットフォーム
+-------------------
+
+- Android
+- BlackBerry WebWorks (OS 5.0 以上)
+- iOS
+- Windows Phone 7 (Mango)
+- Bada 1.2 & 2.x
+- webOS
+
+使用例
+-------------
+
+ // 成功時のコールバック関数
+ //
+ var onSuccess = function(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' +
+ 'タイムスタンプ: ' + position.timestamp + '\n');
+ };
+
+ // エラー時のコールバック関数は PositionError オブジェクトを受けとる
+ //
+ function onError(error) {
+ alert('コード: ' + error.code + '\n' +
+ 'メッセージ: ' + error.message + '\n');
+ }
+
+ navigator.geolocation.getCurrentPosition(onSuccess, onError);
+
+詳細な使用例
+------------
+
+ <!DOCTYPE html>
+ <html>
+ <head>
+ <title>デバイスプロパティーの使用例</title>
+
+ <script type="text/javascript" charset="utf-8" src="cordova-2.0.0.js"></script>
+ <script type="text/javascript" charset="utf-8">
+
+ // Cordova の読み込み完了まで待機
+ //
+ document.addEventListener("deviceready", onDeviceReady, false);
+
+ // Cordova 準備完了
+ //
+ function onDeviceReady() {
+ navigator.geolocation.getCurrentPosition(onSuccess, onError);
+ }
+
+ // onSuccess Geolocation
+ //
+ function onSuccess(position) {
+ var element = document.getElementById('geolocation');
+ element.innerHTML = '緯度: ' + position.coords.latitude + '<br />' +
+ '経度: ' + position.coords.longitude + '<br />' +
+ '高度: ' + position.coords.altitude + '<br />' +
+ '位置精度: ' + position.coords.accuracy + '<br />' +
+ '高度精度: ' + position.coords.altitudeAccuracy + '<br />' +
+ '方位: ' + position.coords.heading + '<br />' +
+ '速度: ' + position.coords.speed + '<br />' +
+ 'タイムスタンプ: ' + position.timestamp + '<br />';
+ }
+
+ // エラー時のコールバック関数は 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/cordova-docs/blob/4272ca34/docs/jp/2.1.0/cordova/geolocation/PositionError/positionError.md
----------------------------------------------------------------------
diff --git a/docs/jp/2.1.0/cordova/geolocation/PositionError/positionError.md b/docs/jp/2.1.0/cordova/geolocation/PositionError/positionError.md
new file mode 100755
index 0000000..ffd7e10
--- /dev/null
+++ b/docs/jp/2.1.0/cordova/geolocation/PositionError/positionError.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.
+---
+
+PositionError
+========
+
+`PositionError` オブジェクトは、エラーが発生したときに `geolocationError` コールバック関数に渡されます。
+
+プロパティー
+----------
+
+- __code:__ 事前に定義された以下のエラーコードのうちの1つを表します
+- __message:__ エラーの内容を表すエラーメッセージを表します
+
+定数
+---------
+
+- `PositionError.PERMISSION_DENIED`
+- `PositionError.POSITION_UNAVAILABLE`
+- `PositionError.TIMEOUT`
+
+概要
+-----------
+
+`PositionError` オブジェクトは、位置情報取得に関するエラーが発生したときに `geolocationError` コールバック関数を通してユーザーに返されます。
+
+### `PositionError.PERMISSION_DENIED`
+
+ユーザーがアプリケーションに対して、位置情報の取得を許可しなかった場合に返されます。これはプラットフォームに依存します。
+
+### `PositionError.POSITION_UNAVAILABLE`
+
+デバイスが位置を取得できなかった場合に返されます。大抵、これはデバイスがネットワークに接続されていない、および/または衛生情報が取得出来なかったことを意味します。
+
+### `PositionError.TIMEOUT`
+
+デバイスが、 `geolocationOptions` の `timeout` プロパティーによって指定された時間内に位置が取得できなかった場合に返されます。 `geolocation.watchPosition` と一緒に使用するとき、このエラーは `geolocationError` コールバックの中で毎 `timeout` ミリ秒後呼ばれる可能性があります。
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/4272ca34/docs/jp/2.1.0/cordova/geolocation/geolocation.clearWatch.md
----------------------------------------------------------------------
diff --git a/docs/jp/2.1.0/cordova/geolocation/geolocation.clearWatch.md b/docs/jp/2.1.0/cordova/geolocation/geolocation.clearWatch.md
new file mode 100644
index 0000000..ac8f5fc
--- /dev/null
+++ b/docs/jp/2.1.0/cordova/geolocation/geolocation.clearWatch.md
@@ -0,0 +1,117 @@
+---
+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.clearWatch
+======================
+
+watch ID パラメーターによって参照されるデバイスの位置情報の監視を停止します。
+
+ navigator.geolocation.clearWatch(watchID);
+
+パラメーター
+----------
+
+- __watchID:__ `watchPosition` 関数での監視を停止したい watchID を表します (String)
+
+概要
+-----------
+
+`geolocation.clearWatch` 関数は、 `watchID` によって参照される `geolocation.watchPosition` 関数を停止させるによって、位置情報の監視を停止します。
+
+サポートされているプラットフォーム
+-------------------
+
+- Android
+- BlackBerry WebWorks (OS 5.0 以上)
+- iOS
+- Windows Phone 7 (Mango)
+- Bada 1.2 & 2.x
+- webOS
+
+使用例
+-------------
+
+ // 位置の変化を監視し、取得可能なもっとも精度の高い位置を使います
+ // (オプション)
+ //
+ var watchID = navigator.geolocation.watchPosition(onSuccess, onError, { enableHighAccuracy: true });
+
+ // ... 後に続く ...
+
+ navigator.geolocation.clearWatch(watchID);
+
+
+詳細な使用例
+------------
+
+ <!DOCTYPE html>
+ <html>
+ <head>
+ <title>デバイスプロパティーの使用例</title>
+
+ <script type="text/javascript" charset="utf-8" src="cordova-2.0.0.js"></script>
+ <script type="text/javascript" charset="utf-8">
+
+ // Cordova の読み込み完了まで待機
+ //
+ document.addEventListener("deviceready", onDeviceReady, false);
+
+ var watchID = null;
+
+ // Cordova 準備完了
+ //
+ function onDeviceReady() {
+ // デバイスで有効な最も制度の高い位置で更新
+ //
+ var options = { enableHighAccuracy: true };
+ 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;
+ }
+
+ // 先に開始された監視を停止する
+ //
+ function clearWatch() {
+ if (watchID != null) {
+ navigator.geolocation.clearWatch(watchID);
+ watchID = null;
+ }
+ }
+
+ // エラー時のコールバック関数は PositionError オブジェクトを受けとる
+ //
+ function onError(error) {
+ alert('コード: ' + error.code + '\n' +
+ 'メッセージ: ' + error.message + '\n');
+ }
+
+ </script>
+ </head>
+ <body>
+ <p id="geolocation">位置情報を監視中...</p>
+ <button onclick="clearWatch();">監視の停止</button>
+ </body>
+ </html>
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/4272ca34/docs/jp/2.1.0/cordova/geolocation/geolocation.getCurrentPosition.md
----------------------------------------------------------------------
diff --git a/docs/jp/2.1.0/cordova/geolocation/geolocation.getCurrentPosition.md b/docs/jp/2.1.0/cordova/geolocation/geolocation.getCurrentPosition.md
new file mode 100644
index 0000000..e657750
--- /dev/null
+++ b/docs/jp/2.1.0/cordova/geolocation/geolocation.getCurrentPosition.md
@@ -0,0 +1,126 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+geolocation.getCurrentPosition
+==============================
+
+デバイスの現在位置を `Position` オブジェクトとして返します。
+
+ navigator.geolocation.getCurrentPosition(geolocationSuccess,
+ [geolocationError],
+ [geolocationOptions]);
+
+パラメーター
+----------
+
+- __geolocationSuccess__: 現在位置情報の取得成功時に呼ばれるコールバック関数を表します
+- __geolocationError__: (オプション) エラー発生時に呼ばれるコールバック関数を表します
+- __geolocationOptions__: (オプション) 位置情報取得のオプションを表します
+
+概要
+-----------
+
+`geolocation.getCurrentPositon` 関数は非同期関数です。 `geolocationSuccess` コールバック関数に、`Position` オブジェクトをパラメーターとしてデバイスの現在位置を返します。エラーが発生した場合、 `PositionError` オブジェクトとともに `geolocationError` コールバック関数が呼び出されます。
+
+
+サポートされているプラットフォーム
+-------------------
+
+- Android
+- BlackBerry WebWorks (OS 5.0 以上)
+- iOS
+- Windows Phone 7 (Mango)
+- Bada 1.2 & 2.x
+- webOS
+
+使用例
+-------------
+
+ // 成功時のコールバック関数
+ // このメソッドは GPS の現在座標を保持する
+ // `Position` オブジェクトを引数とする
+ //
+ var onSuccess = function(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' +
+ 'タイムスタンプ: ' + position.timestamp + '\n');
+ };
+
+ // エラー時のコールバック関数は PositionError オブジェクトを受けとる
+ //
+ function onError(error) {
+ alert('コード: ' + error.code + '\n' +
+ 'メッセージ: ' + error.message + '\n');
+ }
+
+ navigator.geolocation.getCurrentPosition(onSuccess, onError);
+
+詳細な使用例
+------------
+
+ <!DOCTYPE html>
+ <html>
+ <head>
+ <title>デバイスプロパティーの使用例</title>
+
+ <script type="text/javascript" charset="utf-8" src="cordova-2.0.0.js"></script>
+ <script type="text/javascript" charset="utf-8">
+
+ // Cordova の読み込み完了まで待機
+ //
+ document.addEventListener("deviceready", onDeviceReady, false);
+
+ // Cordova 準備完了
+ //
+ function onDeviceReady() {
+ navigator.geolocation.getCurrentPosition(onSuccess, onError);
+ }
+
+ // onSuccess Geolocation
+ //
+ function onSuccess(position) {
+ var element = document.getElementById('geolocation');
+ element.innerHTML = '緯度: ' + position.coords.latitude + '<br />' +
+ '経度: ' + position.coords.longitude + '<br />' +
+ '高度: ' + position.coords.altitude + '<br />' +
+ '位置精度: ' + position.coords.accuracy + '<br />' +
+ '高度精度: ' + position.coords.altitudeAccuracy + '<br />' +
+ '方位: ' + position.coords.heading + '<br />' +
+ '速度: ' + position.coords.speed + '<br />' +
+ 'タイムスタンプ: ' + position.timestamp + '<br />';
+ }
+
+ // エラー時のコールバック関数は 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/cordova-docs/blob/4272ca34/docs/jp/2.1.0/cordova/geolocation/geolocation.md
----------------------------------------------------------------------
diff --git a/docs/jp/2.1.0/cordova/geolocation/geolocation.md b/docs/jp/2.1.0/cordova/geolocation/geolocation.md
new file mode 100644
index 0000000..897c68d
--- /dev/null
+++ b/docs/jp/2.1.0/cordova/geolocation/geolocation.md
@@ -0,0 +1,104 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+Geolocation
+===========
+
+> `geolocation` オブジェクトはデバイスの GPS センサーへのアクセスを提供します。
+
+Geolocation は緯度や経度といったデバイスの位置情報を提供します。主に Global Positioning System (GPS) から位置情報を取得しますが、 IP アドレスや RFID, WiFi, Bluetooh, MAC アドレス, 基地局 ID などのソースからも現在位置を推測します。ただしこの API がデバイスの正確な位置を特定する保証はありません。
+
+この API は [W3C Geo location API Specification](http://dev.w3.org/geo/api/spec-source.html) をベースとしています。いくつかのデバイス (Android, BlackBerry, Bada, Windows Phone 7, webOS) ではすでにこの機能の実装を提供しています。 これらについては、 Cordova の実装ではなくビルトインのサポートが実行されます。位置情報のサポートがされてないデバイスについては、Cordovaの実装によってW3Cの仕様に沿った機能が提供されます。
+
+メソッド
+-------
+
+- geolocation.getCurrentPosition
+- geolocation.watchPosition
+- geolocation.clearWatch
+
+
+引数
+---------
+
+- geolocationSuccess
+- geolocationError
+- geolocationOptions
+
+オブジェクト (読み取り専用)
+-------------------
+
+- Position
+- PositionError
+- Coordinates
+
+パーミッション
+-----------
+
+### Android
+
+#### app/res/xml/plugins.xml
+
+ <plugin name="Geolocation" value="org.apache.cordova.GeoBroker" />
+
+#### app/AndroidManifest.xml
+
+ <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
+ <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
+ <uses-permission android:name="android.permission.ACCESS_LOCATION_EXTRA_COMMANDS" />
+
+### Bada
+
+ パーミッションの設定は必要ありません。
+
+### BlackBerry WebWorks
+
+#### www/plugins.xml
+
+ <plugin name="Geolocation" value="org.apache.cordova.geolocation.Geolocation" />
+
+#### www/config.xml
+
+ <rim:permissions>
+ <rim:permit>read_geolocation</rim:permit>
+ </rim:permissions>
+
+### iOS
+
+#### App/Supporting Files/Cordova.plist
+
+ <key>Plugins</key>
+ <dict>
+ <key>Geolocation</key>
+ <string>CDVLocation</string>
+ </dict>
+
+### webOS
+
+ パーミッションの設定は必要ありません。
+
+### Windows Phone
+
+#### Properties/WPAppManifest.xml
+
+ <Capabilities>
+ <Capability Name="ID_CAP_LOCATION" />
+ </Capabilities>
+
+参照: [Application Manifest for Windows Phone](http://msdn.microsoft.com/en-us/library/ff769509%28v=vs.92%29.aspx)
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/4272ca34/docs/jp/2.1.0/cordova/geolocation/geolocation.watchPosition.md
----------------------------------------------------------------------
diff --git a/docs/jp/2.1.0/cordova/geolocation/geolocation.watchPosition.md b/docs/jp/2.1.0/cordova/geolocation/geolocation.watchPosition.md
new file mode 100644
index 0000000..09dbdd7
--- /dev/null
+++ b/docs/jp/2.1.0/cordova/geolocation/geolocation.watchPosition.md
@@ -0,0 +1,128 @@
+---
+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 以上)
+- iOS
+- Windows Phone 7 (Mango)
+- Bada 1.2 & 2.x
+- webOS
+
+使用例
+-------------
+
+ // 成功時のコールバック関数
+ // このメソッドは 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');
+ }
+
+ // もし30秒ごとに更新が取得できない場合、エラーが投げられる (オプション)
+ //
+ var watchID = navigator.geolocation.watchPosition(onSuccess, onError, { frequency: 30000 });
+
+
+詳細な使用例
+------------
+
+ <!DOCTYPE html>
+ <html>
+ <head>
+ <title>デバイスプロパティーの使用例</title>
+
+ <script type="text/javascript" charset="utf-8" src="cordova-2.0.0.js"></script>
+ <script type="text/javascript" charset="utf-8">
+
+ // Cordova の読み込み完了まで待機
+ //
+ document.addEventListener("deviceready", onDeviceReady, false);
+
+ var watchID = null;
+
+ // Cordova 準備完了
+ //
+ function onDeviceReady() {
+ // もし30秒ごとに更新が取得できない場合、エラーが投げられる
+ var options = { frequency: 30000 };
+ 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/cordova-docs/blob/4272ca34/docs/jp/2.1.0/cordova/geolocation/parameters/geolocation.options.md
----------------------------------------------------------------------
diff --git a/docs/jp/2.1.0/cordova/geolocation/parameters/geolocation.options.md b/docs/jp/2.1.0/cordova/geolocation/parameters/geolocation.options.md
new file mode 100644
index 0000000..264e054
--- /dev/null
+++ b/docs/jp/2.1.0/cordova/geolocation/parameters/geolocation.options.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.
+---
+
+geolocationOptions
+==================
+
+位置情報 (`Position`) 取得の設定をカスタマイズするためのパラメーターを表します。
+
+ { maximumAge: 3000, timeout: 5000, enableHighAccuracy: true };
+
+オプション
+-------
+
+- __enableHighAccuracy:__ より精度の高い位置情報を取得するためのヒントを提供するかどうかを表します。デフォルトでは、デバイスはネットワークベースでの位置情報取得を試みます。プロパティーを `true` と設定することで、衛星位置情報などの精度の高い方法を使用します _(Boolean)_
+- __timeout:__ `geolocation.getCurrentPosition` または `geolocation.watchPosition` 関数が呼び出されたときに、それぞれに対応する `geolocationSuccess` コールバック関数が呼ばれるまでの最大経過時間をミリ秒単位で表します。もし `geolocationSuccess` コールバック関数がこの時間内に呼ばれなかった場合、 `PositionError.TIMEOUT` エラーコードを伴った `geolocationError` コールバック関数が呼び出されます。注意: `geolocation.watchPosition` と一緒に使われる場合、 `geolocationError` コールバックが毎 `timeout` ミリ秒呼び出される可能性があります _(Number)_
+- __maximumAge:__ キャッシュされた位置情報の取得を許容する最大時間をミリ秒単位で表します _(Number)_
+
+Android に関する注意点
+--------------
+
+Android 2.x のシミュレーターは enableHighAccuracy オプションが true にセットしない限り位置情報の取得結果を通知しません。
+
+ { enableHighAccuracy: true }
+
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/4272ca34/docs/jp/2.1.0/cordova/geolocation/parameters/geolocationError.md
----------------------------------------------------------------------
diff --git a/docs/jp/2.1.0/cordova/geolocation/parameters/geolocationError.md b/docs/jp/2.1.0/cordova/geolocation/parameters/geolocationError.md
new file mode 100644
index 0000000..507669e
--- /dev/null
+++ b/docs/jp/2.1.0/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/cordova-docs/blob/4272ca34/docs/jp/2.1.0/cordova/geolocation/parameters/geolocationSuccess.md
----------------------------------------------------------------------
diff --git a/docs/jp/2.1.0/cordova/geolocation/parameters/geolocationSuccess.md b/docs/jp/2.1.0/cordova/geolocation/parameters/geolocationSuccess.md
new file mode 100644
index 0000000..d519071
--- /dev/null
+++ b/docs/jp/2.1.0/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
+==================
+
+位置情報取得に成功したとき (`geolocation.getCurrentPosition` と一緒に使われた時) 、または位置情報が変化したとき (`geolocation.watchPosition` と一緒に使われた時) に呼び出されるコールバック関数です。
+
+ 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' +
+ 'タイムスタンプ: ' + position.timestamp + '\n');
+ }
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/4272ca34/docs/jp/2.1.0/cordova/media/MediaError/mediaError.md
----------------------------------------------------------------------
diff --git a/docs/jp/2.1.0/cordova/media/MediaError/mediaError.md b/docs/jp/2.1.0/cordova/media/MediaError/mediaError.md
new file mode 100644
index 0000000..e867eb8
--- /dev/null
+++ b/docs/jp/2.1.0/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/cordova-docs/blob/4272ca34/docs/jp/2.1.0/cordova/media/Parameters/mediaError.md
----------------------------------------------------------------------
diff --git a/docs/jp/2.1.0/cordova/media/Parameters/mediaError.md b/docs/jp/2.1.0/cordova/media/Parameters/mediaError.md
new file mode 100644
index 0000000..9275667
--- /dev/null
+++ b/docs/jp/2.1.0/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/cordova-docs/blob/4272ca34/docs/jp/2.1.0/cordova/media/capture/CaptureCB.md
----------------------------------------------------------------------
diff --git a/docs/jp/2.1.0/cordova/media/capture/CaptureCB.md b/docs/jp/2.1.0/cordova/media/capture/CaptureCB.md
new file mode 100644
index 0000000..d828045
--- /dev/null
+++ b/docs/jp/2.1.0/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/cordova-docs/blob/4272ca34/docs/jp/2.1.0/cordova/media/capture/CaptureError.md
----------------------------------------------------------------------
diff --git a/docs/jp/2.1.0/cordova/media/capture/CaptureError.md b/docs/jp/2.1.0/cordova/media/capture/CaptureError.md
new file mode 100644
index 0000000..268f72c
--- /dev/null
+++ b/docs/jp/2.1.0/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/cordova-docs/blob/4272ca34/docs/jp/2.1.0/cordova/media/capture/CaptureErrorCB.md
----------------------------------------------------------------------
diff --git a/docs/jp/2.1.0/cordova/media/capture/CaptureErrorCB.md b/docs/jp/2.1.0/cordova/media/capture/CaptureErrorCB.md
new file mode 100644
index 0000000..828fb56
--- /dev/null
+++ b/docs/jp/2.1.0/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/cordova-docs/blob/4272ca34/docs/jp/2.1.0/cordova/media/capture/ConfigurationData.md
----------------------------------------------------------------------
diff --git a/docs/jp/2.1.0/cordova/media/capture/ConfigurationData.md b/docs/jp/2.1.0/cordova/media/capture/ConfigurationData.md
new file mode 100644
index 0000000..60195ef
--- /dev/null
+++ b/docs/jp/2.1.0/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/cordova-docs/blob/4272ca34/docs/jp/2.1.0/cordova/media/capture/MediaFile.getFormatData.md
----------------------------------------------------------------------
diff --git a/docs/jp/2.1.0/cordova/media/capture/MediaFile.getFormatData.md b/docs/jp/2.1.0/cordova/media/capture/MediaFile.getFormatData.md
new file mode 100644
index 0000000..003a8cc
--- /dev/null
+++ b/docs/jp/2.1.0/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/cordova-docs/blob/4272ca34/docs/jp/2.1.0/cordova/media/capture/MediaFile.md
----------------------------------------------------------------------
diff --git a/docs/jp/2.1.0/cordova/media/capture/MediaFile.md b/docs/jp/2.1.0/cordova/media/capture/MediaFile.md
new file mode 100644
index 0000000..0896e88
--- /dev/null
+++ b/docs/jp/2.1.0/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/cordova-docs/blob/4272ca34/docs/jp/2.1.0/cordova/media/capture/MediaFileData.md
----------------------------------------------------------------------
diff --git a/docs/jp/2.1.0/cordova/media/capture/MediaFileData.md b/docs/jp/2.1.0/cordova/media/capture/MediaFileData.md
new file mode 100644
index 0000000..b209551
--- /dev/null
+++ b/docs/jp/2.1.0/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/cordova-docs/blob/4272ca34/docs/jp/2.1.0/cordova/media/capture/capture.md
----------------------------------------------------------------------
diff --git a/docs/jp/2.1.0/cordova/media/capture/capture.md b/docs/jp/2.1.0/cordova/media/capture/capture.md
new file mode 100644
index 0000000..4c05d43
--- /dev/null
+++ b/docs/jp/2.1.0/cordova/media/capture/capture.md
@@ -0,0 +1,134 @@
+---
+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)
+
+パーミッション
+-----------
+
+### Android
+
+#### app/res/xml/plugins.xml
+
+ <plugin name="Capture" value="org.apache.cordova.Capture"/>
+
+#### app/AndroidManifest.xml
+
+ <uses-permission android:name="android.permission.RECORD_AUDIO" />
+ <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
+
+### Bada
+
+#### manifest.xml
+
+ <Privilege>
+ <Name>RECORDING</Name>
+ </Privilege>
+
+### BlackBerry WebWorks
+
+#### www/plugins.xml
+
+ <plugin name="Capture" value="org.apache.cordova.capture.MediaCapture" />
+
+#### www/config.xml
+
+ <feature id="blackberry.system" required="true" version="1.0.0.0" />
+ <feature id="blackberry.io.file" required="true" version="1.0.0.0" />
+
+### iOS
+
+#### App/Supporting Files/Cordova.plist
+
+ <key>Plugins</key>
+ <dict>
+ <key>Capture</key>
+ <string>CDVCapture</string>
+ </dict>
+
+### webOS
+
+ パーミッションの設定は必要ありません。
+
+### Windows Phone
+
+#### Properties/WPAppManifest.xml
+
+ <Capabilities>
+ <Capability Name="ID_CAP_MEDIALIB" />
+ <Capability Name="ID_CAP_MICROPHONE" />
+ <Capability Name="ID_HW_FRONTCAMERA" />
+ <Capability Name="ID_CAP_ISV_CAMERA" />
+ <Capability Name="ID_CAP_CAMERA" />
+ </Capabilities>
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/4272ca34/docs/jp/2.1.0/cordova/media/capture/captureAudio.md
----------------------------------------------------------------------
diff --git a/docs/jp/2.1.0/cordova/media/capture/captureAudio.md b/docs/jp/2.1.0/cordova/media/capture/captureAudio.md
new file mode 100644
index 0000000..82a7cfe
--- /dev/null
+++ b/docs/jp/2.1.0/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-2.0.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/cordova-docs/blob/4272ca34/docs/jp/2.1.0/cordova/media/capture/captureAudioOptions.md
----------------------------------------------------------------------
diff --git a/docs/jp/2.1.0/cordova/media/capture/captureAudioOptions.md b/docs/jp/2.1.0/cordova/media/capture/captureAudioOptions.md
new file mode 100644
index 0000000..a2d27b9
--- /dev/null
+++ b/docs/jp/2.1.0/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/cordova-docs/blob/4272ca34/docs/jp/2.1.0/cordova/media/capture/captureImage.md
----------------------------------------------------------------------
diff --git a/docs/jp/2.1.0/cordova/media/capture/captureImage.md b/docs/jp/2.1.0/cordova/media/capture/captureImage.md
new file mode 100644
index 0000000..0e5154a
--- /dev/null
+++ b/docs/jp/2.1.0/cordova/media/capture/captureImage.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.
+---
+
+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)
+- Bada 2.x
+
+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-2.0.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>
+
+
+Bada に関する注意点
+-----------
+
+Bada は _captureImage_ を他のデバイスと同様にサポートします。しかしながら、カメラアプリを起動せずにビデオや画像を webview 内でキャプチャー出来る _別の_ モードが存在します。このモードを使うためには、以下の手順が必要です:
+
+1. _<div>_ 要素をドキュメントのどこかに作成し、 "preview" といったような id を付与します
+
+ <div id="preview"></div>
+
+2. カメラプレビューを以下のメソッドで初期化します
+
+ navigator.camera.showPreview("preview");
+
+3. プレビューを取得した後、以下のことが可能です
+
+ 3.1 画像をキャプチャー
+
+ var options = { destinationFilename: "images/cam01.jpg", highRes: false};
+ navigator.capture.captureImage(success, fail, options);
+
+3. 以下のメソッドでカメラプレビュー画面を隠します
+
+ navigator.camera.hidePreview("preview");
+
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/4272ca34/docs/jp/2.1.0/cordova/media/capture/captureImageOptions.md
----------------------------------------------------------------------
diff --git a/docs/jp/2.1.0/cordova/media/capture/captureImageOptions.md b/docs/jp/2.1.0/cordova/media/capture/captureImageOptions.md
new file mode 100644
index 0000000..45b3298
--- /dev/null
+++ b/docs/jp/2.1.0/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) で保存されます。