You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cordova.apache.org by mw...@apache.org on 2012/07/12 23:04:38 UTC

[24/25] docs commit: Translate and update files related to camera

Translate and update files related to camera


Project: http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/commit/bdef2f2c
Tree: http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/tree/bdef2f2c
Diff: http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/diff/bdef2f2c

Branch: refs/heads/master
Commit: bdef2f2c7ff52c4e6ae78e7c58cb3c42761efdf0
Parents: 3d4dd46
Author: Keiko Oda <ke...@gmail.com>
Authored: Mon Jul 9 21:12:20 2012 -0700
Committer: Keiko Oda <ke...@gmail.com>
Committed: Wed Jul 11 17:33:14 2012 -0700

----------------------------------------------------------------------
 .../1.8.1/cordova/accelerometer/accelerometer.md   |    2 +-
 .../1.8.1/cordova/camera/CameraPopoverOptions.md   |   71 +++++++++++++++
 docs/jp/1.8.1/cordova/camera/camera.getPicture.md  |    9 ++-
 docs/jp/1.8.1/cordova/camera/camera.md             |   64 +++++++++++++
 .../cordova/camera/parameter/cameraOptions.md      |    9 +-
 5 files changed, 148 insertions(+), 7 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/bdef2f2c/docs/jp/1.8.1/cordova/accelerometer/accelerometer.md
----------------------------------------------------------------------
diff --git a/docs/jp/1.8.1/cordova/accelerometer/accelerometer.md b/docs/jp/1.8.1/cordova/accelerometer/accelerometer.md
index 33c5757..db4c4be 100644
--- a/docs/jp/1.8.1/cordova/accelerometer/accelerometer.md
+++ b/docs/jp/1.8.1/cordova/accelerometer/accelerometer.md
@@ -87,4 +87,4 @@ Accelerometer
         <Capability Name="ID_CAP_SENSORS" />
     </Capabilities>
 
-Reference: [Application Manifest for Windows Phone](http://msdn.microsoft.com/en-us/library/ff769509%28v=vs.92%29.aspx)
+参照: [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/incubator-cordova-docs/blob/bdef2f2c/docs/jp/1.8.1/cordova/camera/CameraPopoverOptions.md
----------------------------------------------------------------------
diff --git a/docs/jp/1.8.1/cordova/camera/CameraPopoverOptions.md b/docs/jp/1.8.1/cordova/camera/CameraPopoverOptions.md
new file mode 100644
index 0000000..6a329d5
--- /dev/null
+++ b/docs/jp/1.8.1/cordova/camera/CameraPopoverOptions.md
@@ -0,0 +1,71 @@
+---
+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.
+---
+
+CameraPopoverOptions
+====================
+
+画像をライブラリーもしくはアルバムから選択する際の、 iPad でのポップオーバーの位置や矢印の向きを指定するためのパラメーターです。 iOS のみのオプションです。
+
+    { x : 0,
+      y :  32,
+      width : 320,
+      height : 480,
+      arrowDir : Camera.PopoverArrowDirection.ARROW_ANY
+    };
+
+CameraPopoverOptions
+--------------------
+
+- __x:__ ポップオーバーの x 座標をピクセルで表します。 (`Number`)
+
+- __y:__ ポップオーバーの y 座標をピクセルで表します。 (`Number`)
+
+- __width:__ ポップオーバーの幅をピクセルで表します。 (`Number`)
+
+- __height:__ ポップオーバーの高さをピクセルで表します。 (`Number`)
+
+- __arrowDir:__ ポップオーバーの矢印の向きを表します。 Camera.PopoverArrowDirection で定義されます。 (`Number`)
+
+            Camera.PopoverArrowDirection = {
+                ARROW_UP : 1,        // iOS の UIPopoverArrowDirection 定数に同じ
+                ARROW_DOWN : 2,
+                ARROW_LEFT : 4,
+                ARROW_RIGHT : 8,
+                ARROW_ANY : 15
+            };
+
+ポップオーバーのサイズは矢印の方向や画面の向きによって調節され、変わる可能性があることについて注意してください。アンカー要素の位置を特定するとき、画面の向きの変化を考慮に入れることを忘れないで下さい。
+
+使用例
+-------------
+
+    var popover = new CameraPopoverOptions(300,300,100,100,Camera.PopoverArrowDirection.ARROW_ANY);
+    var options = { quality: 50, destinationType: Camera.DestinationType.DATA_URL,sourceType: Camera.PictureSource.SAVEDPHOTOALBUM, popoverOptions : popover };
+
+    navigator.camera.getPicture(onSuccess, onFail, options);
+
+    function onSuccess(imageData) {
+        var image = document.getElementById('myImage');
+        image.src = "data:image/jpeg;base64," + imageData;
+    }
+
+    function onFail(message) {
+        alert('Failed because: ' + message);
+    }
+

http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/bdef2f2c/docs/jp/1.8.1/cordova/camera/camera.getPicture.md
----------------------------------------------------------------------
diff --git a/docs/jp/1.8.1/cordova/camera/camera.getPicture.md b/docs/jp/1.8.1/cordova/camera/camera.getPicture.md
index e387eed..1e5cd21 100644
--- a/docs/jp/1.8.1/cordova/camera/camera.getPicture.md
+++ b/docs/jp/1.8.1/cordova/camera/camera.getPicture.md
@@ -49,10 +49,15 @@ camera.getPicture
 
 - Android
 - BlackBerry WebWorks (OS 5.0 以上) 
-- iPhone
+- iOS
 - Windows Phone 7 (Mango)
 - Bada 1.2
 
+iOS に関する注意点
+----------
+
+JavaScript の alert() をコールバック関数に含めると、問題が生じる可能性があります。 alert を setTimeout() でラップすることで、 alert が表示される前に iOS の image picker または popover が完全に閉じるようにします: setTimeout("alert('message');", 0);
+
 
 Windows Phone 7 に関する注意点
 ----------------------
@@ -101,7 +106,7 @@ Zune とデバイスが接続している間は、ネイティブカメラアプ
       <head>
         <title>写真を撮ってみよう</title>
 
-        <script type="text/javascript" charset="utf-8" src="cordova-1.7.0.js"></script>
+        <script type="text/javascript" charset="utf-8" src="cordova-1.8.1.js"></script>
         <script type="text/javascript" charset="utf-8">
 
         var pictureSource;   // 写真ソース

http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/bdef2f2c/docs/jp/1.8.1/cordova/camera/camera.md
----------------------------------------------------------------------
diff --git a/docs/jp/1.8.1/cordova/camera/camera.md b/docs/jp/1.8.1/cordova/camera/camera.md
index 3f81d3e..a35c707 100644
--- a/docs/jp/1.8.1/cordova/camera/camera.md
+++ b/docs/jp/1.8.1/cordova/camera/camera.md
@@ -26,3 +26,67 @@ Camera
 -------
 
 - camera.getPicture
+
+パーミッション
+-----------
+
+### Android
+
+#### app/res/xml/plugins.xml
+
+    <plugin name="Camera" value="org.apache.cordova.CameraLauncher" />
+
+#### app/AndroidManifest
+
+    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
+
+### Bada
+
+#### manifest.xml
+
+    <Privilege>
+        <Name>CAMERA</Name>
+    </Privilege>
+    <Privilege>
+        <Name>RECORDING</Name>
+    </Privilege>
+
+### BlackBerry WebWorks
+
+#### www/plugins.xml
+
+    <plugin name="Camera" value="org.apache.cordova.camera.Camera" />
+
+#### www/config.xml
+
+    <feature id="blackberry.media.camera" />
+
+    <rim:permissions>
+        <rim:permit>use_camera</rim:permit>
+    </rim:permissions>
+
+### iOS
+
+#### App/Supporting Files/Cordova.plist
+
+    <key>Plugins</key>
+    <dict>
+        <key>Camera</key>
+        <string>CDVCamera</string>
+    </dict>
+
+### webOS
+
+    パーミッションの設定は必要ありません。
+
+### Windows Phone
+
+#### Properties/WPAppManifest.xml
+
+    <Capabilities>
+        <Capability Name="ID_CAP_CAMERA" />
+        <Capability Name="ID_CAP_ISV_CAMERA" />
+        <Capability Name="ID_HW_FRONTCAMERA" />
+    </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/incubator-cordova-docs/blob/bdef2f2c/docs/jp/1.8.1/cordova/camera/parameter/cameraOptions.md
----------------------------------------------------------------------
diff --git a/docs/jp/1.8.1/cordova/camera/parameter/cameraOptions.md b/docs/jp/1.8.1/cordova/camera/parameter/cameraOptions.md
index 4d67e09..bd59a0e 100644
--- a/docs/jp/1.8.1/cordova/camera/parameter/cameraOptions.md
+++ b/docs/jp/1.8.1/cordova/camera/parameter/cameraOptions.md
@@ -28,7 +28,8 @@ cameraOptions
       allowEdit : true,
       encodingType: Camera.EncodingType.JPEG,
       targetWidth: 100,
-      targetHeight: 100 };
+      targetHeight: 100,
+      popoverOptions: CameraPopoverOptions };
 
 オプション
 -------
@@ -72,6 +73,7 @@ cameraOptions
 
 - __correctOrientation:__ 写真が撮影されたときと同じ向きになるよう写真を回転させます。 (`Boolean`)
 - __saveToPhotoAlbum:__ 写真が撮影された後、デバイスのフォトアルバムに画像を保存します。 (`Boolean`)
+- __popoverOptions:__ iPad でのポップオーバーの位置を指定します。iOS のみのオプションです。 CameraPopoverOptions で定義されます。
 
 Android に関する注意点
 --------------
@@ -94,7 +96,7 @@ BlackBerry に関する注意点
 - `correctOrientation` パラメーターは無視されます。
 - `saveToPhotoAlbum` パラメーターは無視されます。
 
-Palm に関する注意点
+WebOS に関する注意点
 -----------
 
 - `quality` パラメーターは無視されます。
@@ -108,8 +110,7 @@ iOS に関する注意点
 --------------
 
 - メモリエラーを防ぐには、 `quality` パラメーターを50以下に設定してください。
-- `destinationType.FILE_URI` が使用された場合、撮影された写真や編集された写真はアプリケーションの temporary ディレクトリに保存されます。
-- アプリケーションの temporary ディレクトリの中身はアプリケーション終了とともに消去されます。もしストレージの空きが少ない場合、このディレクトリは navigator.fileMgr API を使って消去できます。
+- `destinationType.FILE_URI` が使用された場合、撮影された写真や編集された写真はアプリケーションの temporary ディレクトリに保存されます。もしストレージの空きが少ない場合、このディレクトリは navigator.fileMgr API を使って消去できます。
 
 Windows Phone 7 に関する注意点
 --------------