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