openEventsPlatformApp/plugins/cordova-plugin-camera/doc/ja/README.md
plugins/cordova-plugin-camera/doc/ja/README.mdRaw
1<!---
2# license: Licensed to the Apache Software Foundation (ASF) under one
3# or more contributor license agreements. See the NOTICE file
4# distributed with this work for additional information
5# regarding copyright ownership. The ASF licenses this file
6# to you under the Apache License, Version 2.0 (the
7# "License"); you may not use this file except in compliance
8# with the License. You may obtain a copy of the License at
9#
10# http://www.apache.org/licenses/LICENSE-2.0
11#
12# Unless required by applicable law or agreed to in writing,
13# software distributed under the License is distributed on an
14# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
15# KIND, either express or implied. See the License for the
16# specific language governing permissions and limitations
17# under the License.
18-->
19
20# cordova-plugin-camera
21
22[](https://travis-ci.org/apache/cordova-plugin-camera)
23
24このプラグインは、写真を撮るため、システムのイメージ ライブラリからイメージを選択するために API を提供します、グローバル `navigator.camera` オブジェクトを定義します。
25
26オブジェクトは、グローバル スコープの `ナビゲーター` に添付、それがないまで `deviceready` イベントの後。
27
28 document.addEventListener("deviceready", onDeviceReady, false);
29 function onDeviceReady() {
30 console.log(navigator.camera);
31 }
32
33
34## インストール
35
36 cordova plugin add cordova-plugin-camera
37
38
39## API
40
41 * カメラ
42 * navigator.camera.getPicture(success, fail, options)
43 * CameraOptions
44 * CameraPopoverHandle
45 * CameraPopoverOptions
46 * navigator.camera.cleanup
47
48## navigator.camera.getPicture
49
50カメラを使用して写真を取るか、デバイスの画像ギャラリーから写真を取得します。 イメージが渡されます成功時のコールバックを base64 エンコードされた `文字列`、または、URI としてイメージ ファイル。 メソッド自体はファイル選択ポップ オーバーの位置を変更するために使用できる `CameraPopoverHandle` オブジェクトを返します。
51
52 navigator.camera.getPicture(cameraSuccess, cameraError, cameraOptions);
53
54
55#### 解説
56
57`camera.getPicture` 関数は、ユーザーの写真をスナップすることができますデバイスのデフォルト カメラ アプリケーションを開きます。 `Camera.sourceType` が `Camera.PictureSourceType.CAMERA` と等しい場合既定では、この現象が発生します。 ユーザーは写真をスナップ、カメラ アプリケーションを閉じるし、アプリケーションが復元されます。
58
59`Camera.sourceType` `Camera.PictureSourceType.PHOTOLIBRARY` または `Camera.PictureSourceType.SAVEDPHOTOALBUM` の場合、ダイアログ ボックスはユーザーを既存のイメージを選択することができますが表示されます。 `camera.getPicture` 関数は、デバイスの向きが変更されたとき、たとえば、イメージの選択ダイアログには、位置を変更するために使用することができます、`CameraPopoverHandle` オブジェクトを返します。
60
61戻り値が `cameraSuccess` コールバック関数の指定 `cameraOptions` に応じて、次の形式のいずれかに送信されます。
62
63 * A `String` 写真の base64 でエンコードされたイメージを含んでいます。
64
65 * A `String` (既定値) のローカル記憶域上のイメージ ファイルの場所を表します。
66
67自由に変更、エンコードされたイメージ、または URI などを行うことができます。
68
69 * イメージをレンダリングする `<img>` 以下の例のように、タグ
70
71 * ローカル データの保存 ( `LocalStorage` 、 [Lawnchair](http://brianleroux.github.com/lawnchair/)など)。
72
73 * リモート サーバーにデータを投稿します。
74
75**注**: 新しいデバイス上の写真の解像度はかなり良いです。 デバイスのギャラリーから選択した写真は `quality` パラメーターが指定されて場合でも下方の品質に縮小されません。 一般的なメモリの問題を避けるために `DATA_URL` ではなく `FILE_URI` に `Camera.destinationType` を設定します。.
76
77#### サポートされているプラットフォーム
78
79        
80
81#### 例
82
83写真を撮るし、base64 エンコード イメージとして取得します。
84
85 navigator.camera.getPicture(onSuccess, onFail, { quality: 50,
86 destinationType: Camera.DestinationType.DATA_URL
87 });
88
89 function onSuccess(imageData) {
90 var image = document.getElementById('myImage');
91 image.src = "data:image/jpeg;base64," + imageData;
92 }
93
94 function onFail(message) {
95 alert('Failed because: ' + message);
96 }
97
98
99写真を撮るし、イメージのファイルの場所を取得します。
100
101 navigator.camera.getPicture(onSuccess, onFail, { quality: 50,
102 destinationType: Camera.DestinationType.FILE_URI });
103
104 function onSuccess(imageURI) {
105 var image = document.getElementById('myImage');
106 image.src = imageURI;
107 }
108
109 function onFail(message) {
110 alert('Failed because: ' + message);
111 }
112
113
114#### 環境設定 （iOS）
115
116 * **CameraUsesGeolocation**(ブール値、デフォルトは false)。 Jpeg 画像をキャプチャするため EXIF ヘッダーで地理位置情報データを取得する場合は true に設定します。 これは、場合地理位置情報のアクセス許可に対する要求をトリガーする true に設定します。
117
118 <preference name="CameraUsesGeolocation" value="false" />
119
120
121#### アマゾン火 OS 癖
122
123アマゾン火 OS イメージをキャプチャするデバイス上のカメラの活動を開始する意図を使用して、メモリの少ない携帯電話、コルドバ活動が殺されるかもしれない。 このシナリオではコルドバ活動が復元されると、イメージが表示されません。
124
125#### Android の癖
126
127アンドロイド、イメージをキャプチャするデバイス上でカメラのアクティビティを開始する意図を使用し、メモリの少ない携帯電話、コルドバ活動が殺されるかもしれない。 このシナリオではコルドバ活動が復元されると、イメージが表示されません。
128
129#### ブラウザーの癖
130
131Base64 エンコード イメージとして写真を返すのみことができます。
132
133#### Firefox OS 癖
134
135カメラのプラグインは現在、[Web アクティビティ](https://hacks.mozilla.org/2013/01/introducing-web-activities/) を使用して実装されていた.
136
137#### iOS の癖
138
139コールバック関数のいずれかの JavaScript `alert()` を含む問題が発生することができます。 IOS イメージ ピッカーまたは完全が終了するまで、警告が表示されますポップ オーバーを許可する `setTimeout()` 内でアラートをラップします。
140
141 setTimeout(function() {
142 // do your thing here!
143 }, 0);
144
145
146#### Windows Phone 7 の癖
147
148ネイティブ カメラ アプリケーションを呼び出すと、デバイスが Zune を介して接続されている動作しませんし、エラー コールバックをトリガーします。
149
150#### Tizen の癖
151
152Tizen のみ `Camera.DestinationType.FILE_URI` の `destinationType` と `Camera.PictureSourceType.PHOTOLIBRARY` の `sourceType` をサポートしています.
153
154## CameraOptions
155
156カメラの設定をカスタマイズするオプションのパラメーター。
157
158 { quality : 75,
159 destinationType : Camera.DestinationType.DATA_URL,
160 sourceType : Camera.PictureSourceType.CAMERA,
161 allowEdit : true,
162 encodingType: Camera.EncodingType.JPEG,
163 targetWidth: 100,
164 targetHeight: 100,
165 popoverOptions: CameraPopoverOptions,
166 saveToPhotoAlbum: false };
167
168
169 * **quality**： 0-100、100 がファイルの圧縮から損失なしで通常のフル解像度の範囲で表される、保存されたイメージの品質。 既定値は 50 です。 *(数)*（カメラの解像度についての情報が利用できないことに注意してください)。
170
171 * **destinationType**: 戻り値の形式を選択します。既定値は FILE_URI です。定義されている `navigator.camera.DestinationType` *（番号）*
172
173 Camera.DestinationType = {
174 DATA_URL : 0, // Return image as base64-encoded string
175 FILE_URI : 1, // Return image file URI
176 NATIVE_URI : 2 // Return image native URI (e.g., assets-library:// on iOS or content:// on Android)
177 };
178
179
180 * **sourceType**: 画像のソースを設定します。既定値は、カメラです。定義されている `navigator.camera.PictureSourceType` *（番号）*
181
182 Camera.PictureSourceType = {
183 PHOTOLIBRARY : 0,
184 CAMERA : 1,
185 SAVEDPHOTOALBUM : 2
186 };
187
188
189 * **allowEdit**: 単純な選択の前に画像の編集を許可します。*(ブール値)*
190
191 * **encodingType**: 返されるイメージ ファイルのエンコーディングを選択します。デフォルトは JPEG です。定義されている `navigator.camera.EncodingType` *（番号）*
192
193 Camera.EncodingType = {
194 JPEG : 0, // Return JPEG encoded image
195 PNG : 1 // Return PNG encoded image
196 };
197
198
199 * **targetWidth**: スケール イメージにピクセル単位の幅。**TargetHeight**を使用する必要があります。縦横比は変わりません。*(数)*
200
201 * **targetHeight**: スケール イメージにピクセル単位の高さ。**TargetWidth**を使用する必要があります。縦横比は変わりません。*(数)*
202
203 * **mediaType**： から選択するメディアの種類を設定します。 場合にのみ働きます `PictureSourceType` は `PHOTOLIBRARY` または `SAVEDPHOTOALBUM` 。 定義されている `nagivator.camera.MediaType` *（番号）*
204
205 Camera.MediaType = {
206 PICTURE: 0, // allow selection of still pictures only. DEFAULT. Will return format specified via DestinationType
207 VIDEO: 1, // allow selection of video only, WILL ALWAYS RETURN FILE_URI
208 ALLMEDIA : 2 // allow selection from all media types
209 };
210
211
212 * **correctOrientation**: キャプチャ中に、デバイスの向きを修正する画像を回転させます。*(ブール値)*
213
214 * **saveToPhotoAlbum**: キャプチャ後、デバイス上のフォト アルバムに画像を保存します。*(ブール値)*
215
216 * **popoverOptions**: iPad のポップ オーバーの場所を指定する iOS のみのオプションです。定義されています。`CameraPopoverOptions`.
217
218 * **cameraDirection**： （前面または背面側） を使用するカメラを選択します。既定値は戻るです。定義されている `navigator.camera.Direction` *（番号）*
219
220 Camera.Direction = {
221 BACK : 0, // Use the back-facing camera
222 FRONT : 1 // Use the front-facing camera
223 };
224
225
226#### アマゾン火 OS 癖
227
228 * 任意 `cameraDirection` 背面写真で結果の値します。
229
230 * 無視、 `allowEdit` パラメーター。
231
232 * `Camera.PictureSourceType.PHOTOLIBRARY``Camera.PictureSourceType.SAVEDPHOTOALBUM`両方のアルバムが表示されます同じ写真。
233
234#### Android の癖
235
236 * 任意 `cameraDirection` 背面写真で結果の値します。
237
238 * アンドロイドも使用しています作物活性、allowEdit もトリミングする必要があります動作し、実際にトリミングされた画像をコルドバで 1 つだけの作品一貫して Google プラス写真アプリケーションにバンドルされているものであることに渡します。 他の作物が機能しません。
239
240 * `Camera.PictureSourceType.PHOTOLIBRARY``Camera.PictureSourceType.SAVEDPHOTOALBUM`両方のアルバムが表示されます同じ写真。
241
242#### ブラックベリー 10 癖
243
244 * 無視、 `quality` パラメーター。
245
246 * 無視、 `allowEdit` パラメーター。
247
248 * `Camera.MediaType`サポートされていません。
249
250 * 無視、 `correctOrientation` パラメーター。
251
252 * 無視、 `cameraDirection` パラメーター。
253
254#### Firefox OS 癖
255
256 * 無視、 `quality` パラメーター。
257
258 * `Camera.DestinationType`無視され、等しい `1` (イメージ ファイル URI)
259
260 * 無視、 `allowEdit` パラメーター。
261
262 * 無視、 `PictureSourceType` パラメーター (ユーザーが選択ダイアログ ウィンドウに)
263
264 * 無視します、`encodingType`
265
266 * 無視、 `targetWidth` と`targetHeight`
267
268 * `Camera.MediaType`サポートされていません。
269
270 * 無視、 `correctOrientation` パラメーター。
271
272 * 無視、 `cameraDirection` パラメーター。
273
274#### iOS の癖
275
276 * 設定 `quality` 一部のデバイスでメモリ不足エラーを避けるために 50 の下。
277
278 * 使用する場合 `destinationType.FILE_URI` 、写真、アプリケーションの一時ディレクトリに保存されます。アプリケーションの一時ディレクトリの内容は、アプリケーションの終了時に削除されます。
279
280#### Tizen の癖
281
282 * サポートされていないオプション
283
284 * 常にファイルの URI を返す
285
286#### Windows Phone 7 と 8 癖
287
288 * 無視、 `allowEdit` パラメーター。
289
290 * 無視、 `correctOrientation` パラメーター。
291
292 * 無視、 `cameraDirection` パラメーター。
293
294 * 無視、 `saveToPhotoAlbum` パラメーター。 重要: wp7/8 コルドバ カメラ API で撮影したすべての画像は携帯電話のカメラ巻き物に常にコピーします。 ユーザーの設定に応じて、これも、画像はその OneDrive に自動アップロードを意味できます。 イメージは意図したアプリより広い聴衆に利用できる可能性があります可能性があります。 場合は、このアプリケーションのブロッカー、msdn で説明されているように、CameraCaptureTask を実装する必要があります: <http://msdn.microsoft.com/en-us/library/windowsphone/develop/hh394006.aspx>コメントにすることがありますもかアップ投票関連の問題を[課題追跡システム](https://issues.apache.org/jira/browse/CB-2083)で
295
296 * 無視、 `mediaType` のプロパティ `cameraOptions` として Windows Phone SDK には、フォト ライブラリからビデオを選択する方法は行いません。
297
298## CameraError
299
300エラー メッセージを提供する onError コールバック関数。
301
302 function(message) {
303 // Show a helpful message
304 }
305
306
307#### 解説
308
309 * **message**: メッセージは、デバイスのネイティブ コードによって提供されます。*(文字列)*
310
311## cameraSuccess
312
313画像データを提供する onSuccess コールバック関数。
314
315 function(imageData) {
316 // Do something with the image
317 }
318
319
320#### 解説
321
322 * **imagedata を扱う**: Base64 エンコード イメージのデータ、*または*画像ファイルによって URI の `cameraOptions` 効果。*(文字列)*
323
324#### 例
325
326 // Show image
327 //
328 function cameraCallback(imageData) {
329 var image = document.getElementById('myImage');
330 image.src = "data:image/jpeg;base64," + imageData;
331 }
332
333
334## CameraPopoverHandle
335
336`Navigator.camera.getPicture` によって作成されたポップオーバーパン ダイアログ ボックスへのハンドル.
337
338#### 解説
339
340 * **setPosition**: Set the position of the popover. Takes the `CameraPopoverOptions` that specify the new position.
341
342#### サポートされているプラットフォーム
343
344        
345
346#### 例
347
348 var cameraPopoverHandle = navigator.camera.getPicture(onSuccess, onFail,
349 { destinationType: Camera.DestinationType.FILE_URI,
350 sourceType: Camera.PictureSourceType.PHOTOLIBRARY,
351 popoverOptions: new CameraPopoverOptions(300, 300, 100, 100, Camera.PopoverArrowDirection.ARROW_ANY)
352 });
353
354 // Reposition the popover if the orientation changes.
355 window.onorientationchange = function() {
356 var cameraPopoverOptions = new CameraPopoverOptions(0, 0, 100, 100, Camera.PopoverArrowDirection.ARROW_ANY);
357 cameraPopoverHandle.setPosition(cameraPopoverOptions);
358 }
359
360
361## CameraPopoverOptions
362
363iOS だけ指定パラメーターをポップ オーバーのアンカー要素の場所および矢印方向計算されたライブラリまたはアルバムから画像を選択するとき。
364
365 { x : 0,
366 y : 32,
367 width : 320,
368 height : 480,
369 arrowDir : Camera.PopoverArrowDirection.ARROW_ANY
370 };
371
372
373#### 解説
374
375 * **x**: ピクセルの x 座標画面要素にポップ オーバーのアンカーになります。*(数)*
376
377 * **y**: y ピクセル座標の画面要素にポップ オーバーのアンカーになります。*(数)*
378
379 * **width**: ポップ オーバーのアンカーになる上の画面要素のピクセル単位の幅。*(数)*
380
381 * **height**: ポップ オーバーのアンカーになる上の画面要素のピクセル単位の高さ。*(数)*
382
383 * **arrowDir**: 方向のポップ オーバーで矢印をポイントする必要があります。定義されている `Camera.PopoverArrowDirection` *（番号）*
384
385 Camera.PopoverArrowDirection = {
386 ARROW_UP : 1, // matches iOS UIPopoverArrowDirection constants
387 ARROW_DOWN : 2,
388 ARROW_LEFT : 4,
389 ARROW_RIGHT : 8,
390 ARROW_ANY : 15
391 };
392
393
394矢印の方向と、画面の向きを調整するポップ オーバーのサイズを変更可能性がありますに注意してください。 アンカー要素の位置を指定するときの方向の変化を考慮することを確認します。
395
396## navigator.camera.cleanup
397
398削除中間一時ストレージからカメラで撮影した写真。
399
400 navigator.camera.cleanup( cameraSuccess, cameraError );
401
402
403#### 解説
404
405`camera.getPicture` を呼び出した後一時記憶域に保存されている中間画像ファイルを削除します。 `Camera.sourceType` の値が `Camera.PictureSourceType.CAMERA` に等しい、`Camera.destinationType` が `Camera.DestinationType.FILE_URI` と等しいの場合にのみ適用されます。.
406
407#### サポートされているプラットフォーム
408
409        
410
411#### 例
412
413 navigator.camera.cleanup(onSuccess, onFail);
414
415 function onSuccess() {
416 console.log("Camera cleanup success.")
417 }
418
419 function onFail(message) {
420 alert('Failed because: ' + message);
421 }