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/09/10 19:37:25 UTC
[40/51] [abbrv] [partial] Move Japanese to docs/ja and Korean to
docs/ko.
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/e7168dd7/docs/ja/1.8.1/cordova/file/filesystem/filesystem.md
----------------------------------------------------------------------
diff --git a/docs/ja/1.8.1/cordova/file/filesystem/filesystem.md b/docs/ja/1.8.1/cordova/file/filesystem/filesystem.md
new file mode 100644
index 0000000..2e3db56
--- /dev/null
+++ b/docs/ja/1.8.1/cordova/file/filesystem/filesystem.md
@@ -0,0 +1,91 @@
+---
+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.
+---
+
+FileSystem
+==========
+
+このオブジェクトはファイルシステムを表します。
+
+プロパティー
+----------
+
+- __name:__ ファイルシステムの名前を表します _(DOMString)_
+- __root:__ ファイルシステムのルートディレクトリを表します _(DirectoryEntry)_
+
+詳細
+-------
+
+`FileSystem` オブジェクトはファイルシステムの情報を表します。ファイルシステムの名前は既にあるファイルシステムに対して一意になります。 root プロパティーはファイルシステムのルートディレクトリを表す `DirectoryEntry` オブジェクトを保持します。
+
+サポートされているプラットフォーム
+-------------------
+
+- Android
+- BlackBerry WebWorks (OS 5.0 以上)
+- iOS
+- Windows Phone 7 (Mango)
+
+File System の使用例
+-------------------------
+
+ function onSuccess(fileSystem) {
+ console.log(fileSystem.name);
+ console.log(fileSystem.root.name);
+ }
+
+ // ファイルシステムをリクエスト
+ window.requestFileSystem(LocalFileSystem.PERSISTENT, 0, onSuccess, null);
+
+詳細な使用例
+------------
+
+ <!DOCTYPE html>
+ <html>
+ <head>
+ <title>File System の使用例</title>
+
+ <script type="text/javascript" charset="utf-8" src="cordova-1.8.1.js"></script>
+ <script type="text/javascript" charset="utf-8">
+
+ // Cordova の読み込み完了まで待機
+ //
+ document.addEventListener("deviceready", onDeviceReady, false);
+
+ // Cordova 準備完了
+ //
+ function onDeviceReady() {
+ window.requestFileSystem(LocalFileSystem.PERSISTENT, 0, onFileSystemSuccess, fail);
+ }
+
+ function onFileSystemSuccess(fileSystem) {
+ console.log(fileSystem.name);
+ console.log(fileSystem.root.name);
+ }
+
+ function fail(evt) {
+ console.log(evt.target.error.code);
+ }
+
+ </script>
+ </head>
+ <body>
+ <h1>Example</h1>
+ <p>File System</p>
+ </body>
+ </html>
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/e7168dd7/docs/ja/1.8.1/cordova/file/filetransfer/filetransfer.md
----------------------------------------------------------------------
diff --git a/docs/ja/1.8.1/cordova/file/filetransfer/filetransfer.md b/docs/ja/1.8.1/cordova/file/filetransfer/filetransfer.md
new file mode 100644
index 0000000..2eb8d9d
--- /dev/null
+++ b/docs/ja/1.8.1/cordova/file/filetransfer/filetransfer.md
@@ -0,0 +1,182 @@
+---
+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.
+---
+
+FileTransfer
+==========
+
+FileTransfer オブジェクトはファイルをサーバーにアップロードまたはサーバからダウンロードする際に使用します。
+
+プロパティー
+----------
+
+なし
+
+メソッド
+-------
+
+- __upload__: サーバーにファイルを送信
+- __download__: サーバーからファイルをダウンロード
+
+詳細
+-------
+
+`FileTransfer` オブジェクトは HTTP マルチパート POST リクエストを使ってファイルをサーバーにアップロードする機能を提供します。このメソッドは HTTP と HTTPS の両方のプロトコルをサポートします。 upload メソッドに FileUploadOptions オブジェクトを渡すことで、任意のパラメーターを追加できます。アップロードが成功した場合 FileUploadResult オブジェクトとともに success コールバック関数が呼ばれます。エラーが発生した場合は FileTransferError オブジェクトとともに error コールバック関数が呼ばれます。
+また、サーバーからファイルをダウンロードし保存することもできます (iOS と Android のみ) 。
+
+サポートされているプラットフォーム
+-------------------
+
+- Android
+- BlackBerry WebWorks (OS 5.0 以上)
+- iOS
+- Windows Phone 7 (Mango)
+
+upload
+--------------
+
+__パラメーター:__
+
+- __filePath__ - デバイス内のファイルのフルパスを表します
+- __server__ - ファイルを受け取るサーバーの URL を表します
+- __successCallback__ - Metadata オブジェクトを伴って呼び出されるコールバック関数を表します _(Function)_
+- __errorCallback__ - Metadata の取得時にエラーが起きた場合に呼び出されるコールバック関数を表します。 FileError オブジェクトを伴って呼び出されます _(Function)_
+- __options__ - ファイル名や minetype などのオプションのパラメーターを表します
+
+__使用例__
+
+ // !! fileURI の値は有効なデバイス内の有効なテキストファイルの URI であるとみなします
+
+ var win = function(r) {
+ console.log("コード = " + r.responseCode);
+ console.log("結果 = " + r.response);
+ console.log("送信バイト数 = " + r.bytesSent);
+ }
+
+ var fail = function(error) {
+ alert("エラーが発生しました: Code = " + error.code);
+ console.log("upload error source " + error.source);
+ console.log("upload error target " + error.target);
+ }
+
+ var options = new FileUploadOptions();
+ options.fileKey="file";
+ options.fileName=fileURI.substr(fileURI.lastIndexOf('/')+1);
+ options.mimeType="text/plain";
+
+ var params = new Object();
+ params.value1 = "test";
+ params.value2 = "param";
+
+ options.params = params;
+
+ var ft = new FileTransfer();
+ ft.upload(fileURI, "http://some.server.com/upload.php", win, fail, options);
+
+__詳細な使用例__
+
+ <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
+ <html>
+ <head>
+ <title>File Transfer の使用例</title>
+
+ <script type="text/javascript" charset="utf-8" src="cordova-1.8.1.js"></script>
+ <script type="text/javascript" charset="utf-8">
+
+ // Cordova の読み込み完了まで待機
+ //
+ document.addEventListener("deviceready", onDeviceReady, false);
+
+ // Cordova 準備完了
+ //
+ function onDeviceReady() {
+
+ // 写真をファイル URI として取得する場合
+ navigator.camera.getPicture(uploadPhoto,
+ function(message) { alert('写真の取得に失敗しました'); },
+ { quality: 50,
+ destinationType: navigator.camera.DestinationType.FILE_URI,
+ sourceType: navigator.camera.PictureSourceType.PHOTOLIBRARY }
+ );
+
+ }
+
+ function uploadPhoto(imageURI) {
+ var options = new FileUploadOptions();
+ options.fileKey="file";
+ options.fileName=imageURI.substr(imageURI.lastIndexOf('/')+1);
+ options.mimeType="image/jpeg";
+
+ var params = new Object();
+ params.value1 = "test";
+ params.value2 = "param";
+
+ options.params = params;
+
+ var ft = new FileTransfer();
+ ft.upload(imageURI, "http://some.server.com/upload.php", win, fail, options);
+ }
+
+ function win(r) {
+ console.log("コード = " + r.responseCode);
+ console.log("結果 = " + r.response);
+ console.log("送信バイト数 = " + r.bytesSent);
+ }
+
+ function fail(error) {
+ alert("エラーが発生しました: Code = " + error.code);
+ console.log("upload error source " + error.source);
+ console.log("upload error target " + error.target);
+ }
+
+ </script>
+ </head>
+ <body>
+ <h1>使用例</h1>
+ <p>ファイルアップロード</p>
+ </body>
+ </html>
+
+download
+--------------
+
+__パラメーター:__
+
+- __source__ - ファイルを取得するサーバーの URL を表します
+- __target__ - デバイス内のファイルのフルパスを表します
+- __successCallback__ - FileEntry オブジェクトを伴って呼び出されるコールバック関数を表します _(Function)_
+- __errorCallback__ - Metadata の取得時にエラーが起きた場合に呼び出されるコールバック関数を表します。 FileError オブジェクトを伴って呼び出されます _(Function)_
+
+__使用例__
+
+ // !! url はサーバー内の有効なファイルを指すことと filePath がデバイス内の有効な値であるとみなします
+
+ var fileTransfer = new FileTransfer();
+
+ fileTransfer.download(
+ url,
+ filePath,
+ function(entry) {
+ console.log("ダウンロード完了: " + entry.fullPath);
+ },
+ function(error) {
+ console.log("download error source " + error.source);
+ console.log("download error target " + error.target);
+ console.log("upload error code" + error.code);
+ }
+ );
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/e7168dd7/docs/ja/1.8.1/cordova/file/filetransfererror/filetransfererror.md
----------------------------------------------------------------------
diff --git a/docs/ja/1.8.1/cordova/file/filetransfererror/filetransfererror.md b/docs/ja/1.8.1/cordova/file/filetransfererror/filetransfererror.md
new file mode 100644
index 0000000..d16f2ed
--- /dev/null
+++ b/docs/ja/1.8.1/cordova/file/filetransfererror/filetransfererror.md
@@ -0,0 +1,43 @@
+---
+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.
+---
+
+FileTransferError
+========
+
+`FileTransferError` オブジェクトは、エラーが発生したときエラーコールバック関数に渡されます。
+
+プロパティー
+----------
+
+- __code__ 事前に定義された以下のエラーコードのうちの1つを表します (int)
+- __source__ ソースの URI を表します (string)
+- __target__ ターゲットの URI を表します (string)
+- __http_status__ HTTP のステータスコードを表します。この属性は、レスポンスコードが HTTP コネクションから返されたときのみ有効です (int)
+
+定数
+---------
+
+- `FileTransferError.FILE_NOT_FOUND_ERR`
+- `FileTransferError.INVALID_URL_ERR`
+- `FileTransferError.CONNECTION_ERR`
+
+概要
+-----------
+
+`FileTransferError` オブジェクトは、ファイルアップロード時にエラーが発生したときエラーコールバック関数に渡されます。
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/e7168dd7/docs/ja/1.8.1/cordova/file/fileuploadoptions/fileuploadoptions.md
----------------------------------------------------------------------
diff --git a/docs/ja/1.8.1/cordova/file/fileuploadoptions/fileuploadoptions.md b/docs/ja/1.8.1/cordova/file/fileuploadoptions/fileuploadoptions.md
new file mode 100644
index 0000000..f9c016e
--- /dev/null
+++ b/docs/ja/1.8.1/cordova/file/fileuploadoptions/fileuploadoptions.md
@@ -0,0 +1,50 @@
+---
+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.
+---
+
+FileUploadOptions
+========
+
+`FileUploadOptions` オブジェクトは upload メソッドを実行する際に FileTransfer オブジェクトに渡して、追加のパラメーターとして設定する場合に使用します。
+
+プロパティー
+----------
+
+- __fileKey:__ フォーム要素の名前を指定します。 デフォルトは "file" です (DOMString)
+- __fileName:__ サーバーに保存する際のファイル名を指定します。 デフォルトは "image.jpg" です (DOMString)
+- __mimeType:__ データの MIME 形式を指定します。 デフォルトは "image/jpeg" です (DOMString)
+- __params:__ その他の HTTP リクエストで送信されるパラメーターを指定します (Object)
+- __chunkedMode:__ アップロードにチャンクドストリーミングモードを使用するかを指定します。 デフォルトは "true" です (Boolean)
+
+
+概要
+-----------
+
+`FileUploadOptions` オブジェクトは upload メソッドを実行する際に FileTransfer オブジェクトに渡して、追加のパラメーターとして設定する場合に使用します。
+
+iOS に関する注意点
+---------
+
+- __chunkedMode:__
+ iOS ではこの値は無視されます。
+
+WP7 に関する注意点
+---------
+
+- __chunkedMode:__
+ WP7 ではこの値は無視されます。
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/e7168dd7/docs/ja/1.8.1/cordova/file/fileuploadresult/fileuploadresult.md
----------------------------------------------------------------------
diff --git a/docs/ja/1.8.1/cordova/file/fileuploadresult/fileuploadresult.md b/docs/ja/1.8.1/cordova/file/fileuploadresult/fileuploadresult.md
new file mode 100644
index 0000000..e366c58
--- /dev/null
+++ b/docs/ja/1.8.1/cordova/file/fileuploadresult/fileuploadresult.md
@@ -0,0 +1,39 @@
+---
+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.
+---
+
+FileUploadResult
+========
+
+`FileUploadResult` オブジェクトは、 FileTransfer の upload メソッドの呼び出しが成功した時に、成功コールバック関数に渡されるオブジェクトです。
+
+プロパティー
+----------
+
+- __bytesSent:__ 送信されたバイト数を表します (long)
+- __responseCode:__ サーバーから返された HTTP のレスポンスコードを表します (long)
+- __response:__ サーバーから返された HTTP のレスポンスを表します (DOMString)
+
+概要
+-----------
+
+`FileUploadResult` オブジェクトは、 FileTransfer の upload メソッドの呼び出しが成功した時に、成功コールバック関数に渡されるオブジェクトです。
+
+iOS に関する注意点
+----------
+- iOS では、成功コールバック関数に渡される FileUploadResult オブジェクトには、 responseCode も bytesSent も含まれません。
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/e7168dd7/docs/ja/1.8.1/cordova/file/filewriter/filewriter.md
----------------------------------------------------------------------
diff --git a/docs/ja/1.8.1/cordova/file/filewriter/filewriter.md b/docs/ja/1.8.1/cordova/file/filewriter/filewriter.md
new file mode 100644
index 0000000..72d19e2
--- /dev/null
+++ b/docs/ja/1.8.1/cordova/file/filewriter/filewriter.md
@@ -0,0 +1,194 @@
+---
+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.
+---
+
+FileWriter
+==========
+
+FileWriter はファイルへの書き込みを行うオブジェクトです。
+
+プロパティー
+----------
+
+- __readyState:__ 右の3種類の状態のいずれかを表します (INIT, WRITING, DONE)
+- __fileName:__ 書き込みの対象となるファイル名を表します _(DOMString)_
+- __length:__ 書き込みの対象となるファイル名を表します _(long)_
+- __position:__ ファイルポインタの現在の位置を表します _(long)_
+- __error:__ エラー情報を表します _(FileError)_
+- __onwritestart:__ 書き込み開始時に呼ばれる関数を表します _(Function)_
+- __onprogress:__ ファイル書き込み中に呼ばれ、進捗状況を報告する関数を表します (progress.loaded/progress.total) _(Function)_ - 現在サポートされていません
+- __onwrite:__ リクエストが成功したときに呼ばれる関数を表します _(Function)_
+- __onabort:__ abort() メソッドを実行したときなど、 書き込みが強制終了したときに呼ばれる関数を表します _(Function)_
+- __onerror:__ 書き込みが失敗したときに呼ばれる関数を表します _(Function)_
+- __onwriteend:__ 成功、失敗にかかわらずリクエストが完了した際に呼ばれる関数を表します _(Function)_
+
+メソッド
+-------
+
+- __abort__: 書き込みを中断します
+- __seek__: ファイルポインタを指定したバイトまで移動します
+- __truncate__: ファイルを指定した長さに切り詰めます
+- __write__: ファイルにデータを UTF-8 エンコーディングで書き込みます
+
+詳細
+-------
+
+`FileWriter` オブジェクトはデバイスのファイルシステムに書きこむ際に使用します。また、 writestart, progress, write, writeend, error や abort などのイベントを受け取るための独自のイベントリスナーを登録することも出来ます。
+
+FileWriter は一つのファイルに対して使用されます。複数回の書き込みを行うこともできます。 FileWriter はファイルポインタの位置と length 属性を指定することができるので、ファイルのどの位置からでも書き込みを行うことができます。デフォルトではファイルの開始位置にポインタがセットされ、既存のデータを上書きしながら書き込みが行われます。書き込みをファイルの最終から始める場合は、 FileWriter のコンストラクタに true をオプションとして指定してください。
+
+サポートされているプラットフォーム
+-------------------
+
+- Android
+- BlackBerry WebWorks (OS 5.0 以上)
+- iOS
+- Windows Phone 7 (Mango)
+
+Seek の例
+------------------------------
+
+ function win(writer) {
+ // ファイルポインタを EOF (ファイルの終端) に移動
+ writer.seek(writer.length);
+ };
+
+ var fail = function(evt) {
+ console.log(error.code);
+ };
+
+ entry.createWriter(win, fail);
+
+Truncate の例
+--------------------------
+
+ function win(writer) {
+ writer.truncate(10);
+ };
+
+ var fail = function(evt) {
+ console.log(error.code);
+ };
+
+ entry.createWriter(win, fail);
+
+Write の例
+-------------------
+
+ function win(writer) {
+ writer.onwrite = function(evt) {
+ console.log("書き込み成功");
+ };
+ writer.write("サンプルテキスト");
+ };
+
+ var fail = function(evt) {
+ console.log(error.code);
+ };
+
+ entry.createWriter(win, fail);
+
+Append の例
+--------------------
+
+ function win(writer) {
+ writer.onwrite = function(evt) {
+ console.log("書き込み成功");
+ };
+ writer.seek(writer.length);
+ writer.write("付加テキスト);
+ };
+
+ var fail = function(evt) {
+ console.log(error.code);
+ };
+
+ entry.createWriter(win, fail);
+
+Abort の例
+-------------------
+
+ function win(writer) {
+ writer.onwrite = function(evt) {
+ console.log("書き込み成功");
+ };
+ writer.write("サンプルテキスト");
+ writer.abort();
+ };
+
+ var fail = function(evt) {
+ console.log(error.code);
+ };
+
+ entry.createWriter(win, fail);
+
+詳細な使用例
+------------
+ <!DOCTYPE html>
+ <html>
+ <head>
+ <title>FileWriter の使用例</title>
+
+ <script type="text/javascript" charset="utf-8" src="cordova-1.8.1.js"></script>
+ <script type="text/javascript" charset="utf-8">
+
+ // Cordova の読み込み完了まで待機
+ //
+ document.addEventListener("deviceready", onDeviceReady, false);
+
+ // Cordova 準備完了
+ //
+ function onDeviceReady() {
+ window.requestFileSystem(LocalFileSystem.PERSISTENT, 0, gotFS, fail);
+ }
+
+ function gotFS(fileSystem) {
+ fileSystem.root.getFile("readme.txt", {create: true, exclusive: false}, gotFileEntry, fail);
+ }
+
+ function gotFileEntry(fileEntry) {
+ fileEntry.createWriter(gotFileWriter, fail);
+ }
+
+ function gotFileWriter(writer) {
+ writer.onwriteend = function(evt) {
+ console.log("ファイルの内容が 'some sample text' となりました");
+ writer.truncate(11);
+ writer.onwriteend = function(evt) {
+ console.log("ファイルの内容が 'some sample' となりました");
+ writer.seek(4);
+ writer.write(" different text");
+ writer.onwriteend = function(evt){
+ console.log("ファイルの内容が 'some different text' となりました");
+ }
+ };
+ };
+ writer.write("サンプルテキスト");
+ }
+
+ function fail(error) {
+ console.log(error.code);
+ }
+
+ </script>
+ </head>
+ <body>
+ <h1>使用例</h1>
+ <p>ファイルに書き込みます。</p>
+ </body>
+ </html>
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/e7168dd7/docs/ja/1.8.1/cordova/file/flags/flags.md
----------------------------------------------------------------------
diff --git a/docs/ja/1.8.1/cordova/file/flags/flags.md b/docs/ja/1.8.1/cordova/file/flags/flags.md
new file mode 100644
index 0000000..b7443af
--- /dev/null
+++ b/docs/ja/1.8.1/cordova/file/flags/flags.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.
+---
+
+Flags
+=====
+
+このオブジェクトは、 `DirectoryEntry` の __getFile__ メソッドと __getDirectory__ メソッド (ファイルやディレクトリを取得または作成するメソッド) に渡される引数として使われます。
+
+プロパティー
+----------
+
+- __create:__ もし対象のファイルまたはディレクトリが無かった場合、作成するかどうかを表します _(boolean)_
+- __exclusive:__ このプロパティー単体では効果はありません。 create プロパティーと一緒に使います。もし対象のパスが既に存在した場合は、取得するのではなくファイルまたはディレクトリの作成に失敗します _(boolean)_
+
+サポートされているプラットフォーム
+-------------------
+
+- Android
+- BlackBerry WebWorks (OS 5.0 以上)
+- iOS
+- Windows Phone 7 (Mango)
+
+使用例
+-------------
+
+ // data ディレクトリを取得します。もし存在しない場合は、作成します
+ dataDir = fileSystem.root.getDirectory("data", {create: true});
+
+ // lockfile.txt ファイルを、存在しない場合のみ作成します
+ lockFile = dataDir.getFile("lockfile.txt", {create: true, exclusive: true});
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/e7168dd7/docs/ja/1.8.1/cordova/file/localfilesystem/localfilesystem.md
----------------------------------------------------------------------
diff --git a/docs/ja/1.8.1/cordova/file/localfilesystem/localfilesystem.md b/docs/ja/1.8.1/cordova/file/localfilesystem/localfilesystem.md
new file mode 100644
index 0000000..26b1897
--- /dev/null
+++ b/docs/ja/1.8.1/cordova/file/localfilesystem/localfilesystem.md
@@ -0,0 +1,110 @@
+---
+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.
+---
+
+LocalFileSystem
+===============
+
+このオブジェクトは、ファイルシステムのルートの取得方法を提供します。
+
+メソッド
+----------
+
+- __requestFileSystem:__ ファイルシステムをリクエストします _(Function)_
+- __resolveLocalFileSystemURI:__ ローカル URI を使用して DirectoryEntry または FileEntry を取得します _(Function)_
+
+定数
+---------
+
+- `LocalFileSystem.PERSISTENT`: アプリやユーザーの許可なしに、ユーザエージェントのみでは削除されないような永続的なストレージを表します
+- `LocalFileSystem.TEMPORARY`: 永続性が保証されていないようなストレージを表します
+
+詳細
+-------
+
+`LocalFileSystem` オブジェクトのメソッドは __window__ オブジェクトに定義されています。
+
+サポートされているプラットフォーム
+-------------------
+
+- Android
+- BlackBerry WebWorks (OS 5.0 以上)
+- iOS
+- Windows Phone 7 (Mango)
+
+Request File Systemの使用例
+---------------------------------
+
+ function onSuccess(fileSystem) {
+ console.log(fileSystem.name);
+ }
+
+ // ファイルシステムをリクエスト
+ window.requestFileSystem(LocalFileSystem.PERSISTENT, 0, onSuccess, onError);
+
+Resolve Local File System URIの使用例
+-------------------------------------------
+
+ function onSuccess(fileEntry) {
+ console.log(fileEntry.name);
+ }
+
+ window.resolveLocalFileSystemURI("file:///example.txt", onSuccess, onError);
+
+詳細な使用例
+------------
+
+
+ <!DOCTYPE html>
+ <html>
+ <head>
+ <title>Local File System の使用例</title>
+
+ <script type="text/javascript" charset="utf-8" src="cordova-1.8.1.js"></script>
+ <script type="text/javascript" charset="utf-8">
+
+ // Cordova の読み込み完了まで待機
+ //
+ document.addEventListener("deviceready", onDeviceReady, false);
+
+ // Cordova 準備完了
+ //
+ function onDeviceReady() {
+ window.requestFileSystem(LocalFileSystem.PERSISTENT, 0, onFileSystemSuccess, fail);
+ window.resolveLocalFileSystemURI("file:///example.txt", onResolveSuccess, fail);
+ }
+
+ function onFileSystemSuccess(fileSystem) {
+ console.log(fileSystem.name);
+ }
+
+ function onResolveSuccess(fileEntry) {
+ console.log(fileEntry.name);
+ }
+
+ function fail(evt) {
+ console.log(evt.target.error.code);
+ }
+
+ </script>
+ </head>
+ <body>
+ <h1>使用例</h1>
+ <p>Local File System</p>
+ </body>
+ </html>
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/e7168dd7/docs/ja/1.8.1/cordova/file/metadata/metadata.md
----------------------------------------------------------------------
diff --git a/docs/ja/1.8.1/cordova/file/metadata/metadata.md b/docs/ja/1.8.1/cordova/file/metadata/metadata.md
new file mode 100644
index 0000000..34a2ec1
--- /dev/null
+++ b/docs/ja/1.8.1/cordova/file/metadata/metadata.md
@@ -0,0 +1,51 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+Metadata
+==========
+
+ファイルやディレクトリの状態を提供します。
+
+プロパティー
+----------
+
+- __modificationTime:__ ファイルまたはディレクトリの最終更新日時を表します _(Date)_
+
+詳細
+-------
+
+`Metadata` オブジェクトは、ファイルやディレクトリの状態を表します。 `DirectoryEntry` または `FileEntry` の __getMetadata__ メソッドを呼び出すことで、 Metadata オブジェクトが取得できます。
+
+サポートされているプラットフォーム
+-------------------
+
+- Android
+- BlackBerry WebWorks (OS 5.0 以上)
+- iOS
+- Windows Phone 7 (Mango)
+
+使用例
+-------------
+
+ function win(metadata) {
+ console.log("最終更新日: " + metadata.modificationTime);
+ }
+
+ // このエントリーの Metadata オブジェクトを取得
+ entry.getMetadata(win, null);
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/e7168dd7/docs/ja/1.8.1/cordova/geolocation/Coordinates/coordinates.md
----------------------------------------------------------------------
diff --git a/docs/ja/1.8.1/cordova/geolocation/Coordinates/coordinates.md b/docs/ja/1.8.1/cordova/geolocation/Coordinates/coordinates.md
new file mode 100644
index 0000000..a3cbe9a
--- /dev/null
+++ b/docs/ja/1.8.1/cordova/geolocation/Coordinates/coordinates.md
@@ -0,0 +1,125 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+Coordinates
+===========
+
+位置情報で使用される座標を格納します。
+
+プロパティー
+----------
+
+* __latitude__: 緯度を数値で表します _(Number)_
+* __longitude__: 経度を数値で表します _(Number)_
+* __altitude__: 海抜からの高度をメートル単位で表します _(Number)_
+* __accuracy__: 位置の精度をメートル単位で表します _(Number)_
+* __altitudeAccuracy__: 高度の精度をメートル単位で表します _(Number)_
+* __heading__: 北から時計回りでのデバイスの方位を角度で表します _(Number)_
+* __speed__: 現在のデバイスのスピードをメートル/秒で表します _(Number)_
+
+概要
+-----------
+
+`Coordinates` オブジェクトは `Position` オブジェクトのプロパティーとして作成されます。 `Position` オブジェクトはコールバック関数を通してユーザーに返されます。
+
+サポートされているプラットフォーム
+-------------------
+
+- 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');
+ };
+
+ // エラー時のコールバック関数
+ //
+ var onError = function() {
+ alert('エラーが発生しました。');
+ };
+
+ navigator.geolocation.getCurrentPosition(onSuccess, onError);
+
+詳細な使用例
+------------
+
+ <!DOCTYPE html>
+ <html>
+ <head>
+ <title>位置情報の使用例</title>
+ <script type="text/javascript" charset="utf-8" src="cordova-1.8.1.js"></script>
+ <script type="text/javascript" charset="utf-8">
+
+ // Cordovaの読み込み完了まで待機
+ //
+ document.addEventListener("deviceready", onDeviceReady, false);
+
+ // Cordova準備完了
+ //
+ function onDeviceReady() {
+ navigator.geolocation.getCurrentPosition(onSuccess, onError);
+ }
+
+ // `Position` プロパティーを表示
+ //
+ function onSuccess(position) {
+ var div = document.getElementById('myDiv');
+
+ div.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/>';
+ }
+
+ // エラー発生時に警告を表示
+ //
+ function onError() {
+ alert('エラーが発生しました。');
+ }
+
+ </script>
+ </head>
+ <body>
+ <div id="myDiv"></div>
+ </body>
+ </html>
+
+Android に関する注意点
+-------------
+
+このプロパティーは Android ではサポートされておらず、常に null を返します。
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/e7168dd7/docs/ja/1.8.1/cordova/geolocation/Position/position.md
----------------------------------------------------------------------
diff --git a/docs/ja/1.8.1/cordova/geolocation/Position/position.md b/docs/ja/1.8.1/cordova/geolocation/Position/position.md
new file mode 100644
index 0000000..aec86ae
--- /dev/null
+++ b/docs/ja/1.8.1/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-1.8.1.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/e7168dd7/docs/ja/1.8.1/cordova/geolocation/PositionError/positionError.md
----------------------------------------------------------------------
diff --git a/docs/ja/1.8.1/cordova/geolocation/PositionError/positionError.md b/docs/ja/1.8.1/cordova/geolocation/PositionError/positionError.md
new file mode 100755
index 0000000..ffd7e10
--- /dev/null
+++ b/docs/ja/1.8.1/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/e7168dd7/docs/ja/1.8.1/cordova/geolocation/geolocation.clearWatch.md
----------------------------------------------------------------------
diff --git a/docs/ja/1.8.1/cordova/geolocation/geolocation.clearWatch.md b/docs/ja/1.8.1/cordova/geolocation/geolocation.clearWatch.md
new file mode 100644
index 0000000..2b608d8
--- /dev/null
+++ b/docs/ja/1.8.1/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-1.8.1.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/e7168dd7/docs/ja/1.8.1/cordova/geolocation/geolocation.getCurrentPosition.md
----------------------------------------------------------------------
diff --git a/docs/ja/1.8.1/cordova/geolocation/geolocation.getCurrentPosition.md b/docs/ja/1.8.1/cordova/geolocation/geolocation.getCurrentPosition.md
new file mode 100644
index 0000000..d08c190
--- /dev/null
+++ b/docs/ja/1.8.1/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.getCurrentPosition` 関数は非同期関数です。 `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-1.8.1.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/e7168dd7/docs/ja/1.8.1/cordova/geolocation/geolocation.md
----------------------------------------------------------------------
diff --git a/docs/ja/1.8.1/cordova/geolocation/geolocation.md b/docs/ja/1.8.1/cordova/geolocation/geolocation.md
new file mode 100644
index 0000000..897c68d
--- /dev/null
+++ b/docs/ja/1.8.1/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/e7168dd7/docs/ja/1.8.1/cordova/geolocation/geolocation.watchPosition.md
----------------------------------------------------------------------
diff --git a/docs/ja/1.8.1/cordova/geolocation/geolocation.watchPosition.md b/docs/ja/1.8.1/cordova/geolocation/geolocation.watchPosition.md
new file mode 100644
index 0000000..30a28e9
--- /dev/null
+++ b/docs/ja/1.8.1/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-1.8.1.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/e7168dd7/docs/ja/1.8.1/cordova/geolocation/parameters/geolocation.options.md
----------------------------------------------------------------------
diff --git a/docs/ja/1.8.1/cordova/geolocation/parameters/geolocation.options.md b/docs/ja/1.8.1/cordova/geolocation/parameters/geolocation.options.md
new file mode 100644
index 0000000..264e054
--- /dev/null
+++ b/docs/ja/1.8.1/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/e7168dd7/docs/ja/1.8.1/cordova/geolocation/parameters/geolocationError.md
----------------------------------------------------------------------
diff --git a/docs/ja/1.8.1/cordova/geolocation/parameters/geolocationError.md b/docs/ja/1.8.1/cordova/geolocation/parameters/geolocationError.md
new file mode 100644
index 0000000..507669e
--- /dev/null
+++ b/docs/ja/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/cordova-docs/blob/e7168dd7/docs/ja/1.8.1/cordova/geolocation/parameters/geolocationSuccess.md
----------------------------------------------------------------------
diff --git a/docs/ja/1.8.1/cordova/geolocation/parameters/geolocationSuccess.md b/docs/ja/1.8.1/cordova/geolocation/parameters/geolocationSuccess.md
new file mode 100644
index 0000000..d519071
--- /dev/null
+++ b/docs/ja/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
+==================
+
+位置情報取得に成功したとき (`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/e7168dd7/docs/ja/1.8.1/cordova/media/MediaError/mediaError.md
----------------------------------------------------------------------
diff --git a/docs/ja/1.8.1/cordova/media/MediaError/mediaError.md b/docs/ja/1.8.1/cordova/media/MediaError/mediaError.md
new file mode 100644
index 0000000..e867eb8
--- /dev/null
+++ b/docs/ja/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/cordova-docs/blob/e7168dd7/docs/ja/1.8.1/cordova/media/Parameters/mediaError.md
----------------------------------------------------------------------
diff --git a/docs/ja/1.8.1/cordova/media/Parameters/mediaError.md b/docs/ja/1.8.1/cordova/media/Parameters/mediaError.md
new file mode 100644
index 0000000..9275667
--- /dev/null
+++ b/docs/ja/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/cordova-docs/blob/e7168dd7/docs/ja/1.8.1/cordova/media/capture/CaptureCB.md
----------------------------------------------------------------------
diff --git a/docs/ja/1.8.1/cordova/media/capture/CaptureCB.md b/docs/ja/1.8.1/cordova/media/capture/CaptureCB.md
new file mode 100644
index 0000000..d828045
--- /dev/null
+++ b/docs/ja/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/cordova-docs/blob/e7168dd7/docs/ja/1.8.1/cordova/media/capture/CaptureError.md
----------------------------------------------------------------------
diff --git a/docs/ja/1.8.1/cordova/media/capture/CaptureError.md b/docs/ja/1.8.1/cordova/media/capture/CaptureError.md
new file mode 100644
index 0000000..268f72c
--- /dev/null
+++ b/docs/ja/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/cordova-docs/blob/e7168dd7/docs/ja/1.8.1/cordova/media/capture/CaptureErrorCB.md
----------------------------------------------------------------------
diff --git a/docs/ja/1.8.1/cordova/media/capture/CaptureErrorCB.md b/docs/ja/1.8.1/cordova/media/capture/CaptureErrorCB.md
new file mode 100644
index 0000000..828fb56
--- /dev/null
+++ b/docs/ja/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');
+ };