オプション

次の表に、camera.setOptions と camera.getOptions で設定および取得できるすべてのオプションを示します。対応するサポートが空であるか、オプションが 1 つしかない場合、オプションは変更できません。

名前 型 説明 読み取りと書き込み
captureMode 文字列 現在のキャプチャ モード。デフォルトは image. です。 rw
captureModeSupport 文字列配列 現在利用可能なキャプチャ モードのリスト。API レベル 1 の最小要件は ["image"]、API レベル 2 の最小要件は ["image", "interval"] です。ここで、"interval" は一定の間隔で一連の画像をキャプチャするモードを表します。captureInterval と captureIntervalSupport もご覧ください。API レベル 2 では 2 つの追加モード ("video" and "walkaround") がサポートされているため、API レベル 2 でサポートされている完全なセットは ["image", "interval", "video", "walkaround"] です。"video" は動画キャプチャ モードを表し、"walkaround" は 2 つの画像を順番に撮影するモードを表します。1 つ目はユーザーがカメラに対して任意の位置に立っているモード、2 つ目はユーザーがカメラの反対側（最初の立ち位置に対して）に立っているモードです。これにより、カメラは 2 つの画像を合成して、最終的な画像からユーザーを除外できます。"walkaround" がカメラでサポートされ、現在のキャプチャ モードに設定されている場合、クライアントは 2 つの takePicture コマンドをカメラに送信する必要があります。最初のコマンドのレスポンス（終了時）は、カメラが 2 番目の画像を撮影する準備ができていることを示し、2 番目のコマンドは、終了時に最後の画像を返します。

まだサポートされていないキャプチャ モードを追加するには、ベンダー固有のモードの前にアンダースコア（_）を付けてください。

このオプションは API レベル 2 で変更されました。

 r
captureStatus 文字列 現在のキャプチャ ステータス。デフォルトは "idle" です。初めてアプリに接続したときにカメラのステータスを判断するのに役立ちます。カメラが動画の撮影途中でも、他の動作（また別の動画撮影で

このオプションは API レベル 2.1 で追加されました。

 rw
captureStatusSupport 文字列配列 現在利用可能なキャプチャ ステータスのリスト動画撮影がサポートされている場合は、デフォルトで ["idle", "shooting"] になります。その他の彫像も指定できます。例:"downloading"。

このオプションは API レベル 2.1 で追加されました。

 r
exposureProgram 数値 現在の露出プログラム。 rw
exposureProgramSupport 数値配列 現在利用可能な露出プログラムのリスト例: [0, 1, 2, 3, 4]各整数はそれぞれ異なる露出プログラムを表します。 <ph type="x-smartling-placeholder">
    </ph>
  • 0 = 定義なし
  • 1 = 手動
  • 2 = 通常のプログラム
  • 3 = 絞り優先
  • 4 = シャッター優先
で確認できます。 次のリンクを選択して、「ExposureProgram」の詳細情報をダウンロードしてください。 		r
iso 数値 現在の ISO 速度設定。 rw
isoSupport 数値配列

API レベル 1: 現在利用可能な ISO 設定のリスト。たとえば、auto モードの場合は [100, 200, 400, 800,1600] または [] です。

API レベル 2: 現在利用可能な ISO 設定のリスト。例: [0, 100, 200, 400, 800, 1600]。ここで 0 は auto モードを表します。

このオプションは API レベル 2 で変更されました。

 r
shutterSpeed 数値 現在のシャッター スピードの設定です。 rw
shutterSpeedSupport 数値配列

API レベル 1: 現在利用可能なシャッター スピードのリスト。たとえば、auto モードの場合は [0.067, 0.033, 0.017,0.008] または [] です。

API レベル 2: 現在利用可能なシャッター スピードのリスト。例: [0, 0.067, 0.033, 0.017, 0.008]。ここで 0 は auto モードを表します。

このオプションは API レベル 2 で変更されました。

 r
aperture 数値 現在の絞り設定（F ストップ）。 rw
apertureSupport 数値配列

API レベル 1: 現在利用可能な絞り設定のリスト。f/number で表されます。 たとえば、auto モードの場合は [1.4, 2, 2.8, 4, 5.6, 8, 11] または [] です。

API レベル 2: 現在利用可能な絞り設定のリスト。f/number で表されます。例: [0, 1.4, 2, 2.8, 4, 5.6, 8, 11]。ここで、0 は auto モードを表します。

 r
whiteBalance 文字列 現在のホワイト バランス設定例: daylightデフォルトは auto です。 rw
whiteBalanceSupport 文字列配列 現在利用可能なホワイト バランス設定のリストは、事前定義されたリスト「[ "auto", "incandescent", "fluorescent", "daylight", "cloudy-daylight", "shade", "twilight"]」のサブセットにすることができます。それぞれの値: <ph type="x-smartling-placeholder">
    </ph>
  • incandescent、約 3,200,000
  • fluorescent、約 4,000,000
  • datalight、約 5,200,000
  • cloudy-daylight、約 6,000,000
  • shade、約 7,000,000
  • twilight、約 12,000,000
で確認できます。 ベンダー固有の設定名の前にアンダースコアを付けます。例: _vendor-setting		 r
exposureCompensation 数値 現在の露出補正。 rw
exposureCompensationSupport 数値配列 現在利用可能な露出補正のリスト（通常はステップ 0.33 または 0.5例: [-1, -0.67, -0.33, 0, 0.33, 0.67, 1] r
fileFormat オブジェクト

現在のファイル形式と解像度。形式に captureMode の現在の値を反映する必要があります。たとえば、captureMode が image の場合、適切なレスポンスは次のようになります。

{
    "type": "jpeg",
    "width": 2000,
    "height": 1000
}
captureMode が video の場合、適切なレスポンスは次のようになります。 
{
    "type": "mp4",
    "width": 1920,
    "height": 1080,
    "framerate": 30
}

このオプションは API レベル 2 で変更されました。

 rw
fileFormatSupport オブジェクト配列

現在利用可能なファイル形式のリスト次に例を示します。

[
    {
    "type": "jpeg",
    "width": 2000,
    "height": 1000
    },
    {
    "type": "jpeg",
    "width": 200,
    "height": 100
    },
    {
    "type": "mp4",
    "width": 1920,
    "height": 1080,
    "framerate": 24
    },
    {
    "type": "mp4",
    "width": 1280,
    "height": 720,
    "framerate": 30
    },
    ...
]
すべてのタイプについて詳しくは、以下のリンクを選択してご確認ください。

このオプションは API レベル 2 で変更されました。

 r
exposureDelay 数値 takePicture コマンドから曝露開始までの時間差（秒単位）。 rw
exposureDelaySupport 数値配列 現在利用可能な露出遅延のリスト（秒単位）例: [0, 1, 2, 5, 10, 30, 60] r
sleepDelay 数値 カメラがスリープ状態になるまでの現在の遅延（秒単位）。 rw
sleepDelaySupport 数値配列 現在利用可能な睡眠の遅延のリスト（秒単位）例: [30, 60, 120, 300, 600, 1800, 65535]。65535 はスリープモードを無効にする（カメラは電源がオフになるまでスリープしない）ため、サポートする必要があります。 r
offDelay 数値 カメラの電源がオフになるまでの時間（秒）。 rw
offDelaySupport 数値配列 電源オフ時の待機時間の一覧（秒）例: [1800, 3600, 7200, 65535]。65535 は電源オフモードを無効にする（バッテリーが消耗するか手動で電源を切るまで、カメラの電源はオフになりません）ため、この機能をサポートする必要があります。 r
totalSpace 数値 読み取り専用: ストレージの合計バイト数。 r
remainingSpace 数値 読み取り専用: 空きストレージのバイト数。 r
remainingPictures 数値 読み取り専用: 現在のキャプチャに基づく残りの画像の推定数 設定されます。 r
gpsInfo オブジェクト

現在の GPS 情報。スマートフォンの GPS を使用して setOptions を使用して設定:

{
    "lat": 23.532,
    "lng": -132.35
}
lat プロパティと lng プロパティは 10 進度で、lat が範囲内に、[-90, 90] が範囲に、lng が [-180, 180] 範囲にあります。電話による提供の場合、各 GPS 位置情報は有効であることに注意してください。 更新されません。アップデートのタイミングはスマートフォンが判断する必要がある GPS 位置情報たとえば、各 takePicture コマンドの直前などです。65535 は、現在の GPS 位置情報が無効であることをカメラに通知し、カメラ それを無視し、存在する場合は独自の GPS を使用する。たとえば setOptions({"gpsInfo": {"lat": 65535, "lng": 65535}}) は GPS 位置情報が 無効です。		 rw
dateTimeZone 文字列 現在の日付と時刻の情報。スマートフォンの日付、時刻、タイムゾーンを使用して setOptions によって設定されます。形式は YYYY:MM:DD HH:MM:SS+(-)HH:MM です。時刻は 24 時間形式です。日付と時刻は空白で区切られます。 time zone は UTC 時間からのオフセットです。たとえば、2014:05:18 01:04:29+8:00 は中国のタイムゾーン（UTC+8:00）です。 rw
hdr

API レベル 1: ブール値

API レベル 2: 文字列

API レベル 1: HDR キャプチャ モードを有効または無効にします。HDR を有効にする場合は値が true、無効にする場合は false です。デフォルト値は false です。hdrSupport も true の場合にのみ、設定を true にできます。

API レベル 2: 現在の文字列型の HDR モード。

このオプションは API レベル 2 で変更されました。

 rw
hdrSupport

API レベル 1: ブール値

API レベル 2: 文字列配列

API レベル 1: 値 true は、カメラが HDR をサポートしていることを示します。false 設定は HDR のないカメラを識別します。

API レベル 2: HDR モードをサポートしていない場合、 [“off”]、1 つの HDR モードをサポートしている場合は [“off”, “hdr”]、複数の HDR モード（異なるアルゴリズムベース）がサポートされている場合は [“off”, “hdr”, “hdr1”, “hdr2”, ...] です。

このオプションは API レベル 2 で変更されました。

 r
exposureBracket オブジェクト 現在の露出ブラケットの設定。hdrSupport == true（API レベル 1）または hdrSupport に 1 つ以上の HDR モード（API レベル 2）が含まれている場合にのみ使用できます。カメラで手動露出ブラケットを使用している場合、オブジェクトには次の 2 つのエントリが含まれます。 <ph type="x-smartling-placeholder">
    </ph>
  1. shots: 撮影するショットの数を含む整数。
  2. increment、ショット間の EV 増分を含む数値。
で確認できます。 例: 
{
    "shots": 3,
    "increment": 1.33
}
カメラで自動露出ブラケットを使用している場合、オブジェクトには次のものが含まれます。 
{
    "autoMode": true
}

API レベル 1: hdrSupport == false の場合、デフォルトで空の {} になります。hdr が true の場合、メーカーがデフォルト値（自動露出ブラケットなど）を決定します。

API レベル 2: hdrSupport に "off" のみが含まれている場合、デフォルトで空の {} になります。それ以外の場合は、メーカーがデフォルト値を決定します（自動露出ブラケットなど）。

このオプションは API レベル 2 で変更されました。

 rw
exposureBracketSupport オブジェクト

現在利用可能な露出ブラケット設定:次に例を示します。

{
    "autoMode": true,
    "shotsSupport": [1, 3, 5, 7],
    "incrementSupport": [0.33, 0.67, 1, 1.33, 1.67, 2]
}

API レベル 1: hdrSupport == false の場合、デフォルトで空の {} になります。hdrSupport == true の場合、自動露出ブラケットがサポートされていない場合、autoMode は false になります。

API レベル 2: hdrSupport に "off" のみが含まれる場合、デフォルトで空の {} になります。hdrSupport に HDR モードが含まれていて、自動露出ブラケットがサポートされていない場合、autoMode は false になります。

このオプションは API レベル 2 で変更されました。

 r
gyro ブール値 カメラのジャイロスコープ モジュールを有効にするには true に設定し、この機能を無効にするには false に設定します。デフォルトは、カメラでサポートされている場合は true、それ以外の場合は false です。この設定は、gyroSupport == true の場合にのみ true にできます。 rw
gyroSupport ブール値 カメラにジャイロスコープがある場合は、この値は true になります。それ以外の場合は、false になります。 r
gps ブール値 カメラの GPS モジュールを有効または無効にします。有効にするには値を true、無効にするには false にする必要があります。デフォルト値は、カメラでサポートされている場合は true、それ以外の場合は false です。gpsSupport == true の場合のみ、設定が true になります。 rw
gpsSupport ブール値 カメラに独自の GPS モジュールがある場合は、この値は true になります。そうでない場合は、false になります。 r
imageStabilization 文字列 現在の手ぶれ補正オペレーション例: off rw
imageStabilizationSupport 文字列配列 現在利用可能な手ぶれ補正機能。事前定義済みのリストは ["off", "on"] です。カメラが手ぶれ補正をサポートしていない場合は ["off"] を返し、サポートしていない場合は ["off", "on"] を返します。ベンダー固有の文字列の前にはアンダースコア（_）を付けます。例: [ "off", "_horizontal_stabilization", "_vibration_correction" ] r
wifiPassword 文字列
文字、数字、記号を含み、スペースを含まない 8 文字以上で指定してください。この設定は、カメラがクライアント デバイスに接続されている場合にのみ変更できます。変更後はカメラの接続が解除されるため、ユーザーは新しい wifiPassword を使用して再接続する必要があります。
パスワードを忘れた場合に備え、カメラにリセット機能を搭載していなければなりません。出荷時のデフォルトのパスワードに戻すためのリセットボタンなどが含まれます。
 w
previewFormat オブジェクト

現在のライブ プレビューの解像度次に例を示します。

{
    "width": 640,
    "height": 320,
    "framerate": 24
}

このオプションは API レベル 2 で追加されました。

 rw
previewFormatSupport オブジェクト配列

現在サポートされているライブ プレビュー形式次に例を示します。

[
    {
    "width": 640,
    "height": 320,
    "framerate": 24
    },
    ...
    {
    "width": 1280,
    "height": 720,
    "framerate": 24
    }
]

このオプションは API レベル 2 で追加されました。

 r
captureInterval 数値 連続する 2 つの画像をキャプチャする現在の間隔（seconds）。

このオプションは API レベル 2 で追加されました。

 rw
captureIntervalSupport オブジェクト

連続する 2 つの画像のキャプチャの間に許容される最小間隔と最大間隔（秒単位）。次に例を示します。

{
    "minInterval": 10,
    "maxInterval": 60
}
fileFormat によって異なる場合があります。

このオプションは API レベル 2 で追加されました。

 r
captureNumber 数値 1 回のインターバル キャプチャ セッションでキャプチャされる画像の数。デフォルトは 0 です。この場合、stopCapture コマンドでキャプチャを明示的に終了する必要があります。それ以外の場合は、指定された数の画像がキャプチャされると、キャプチャが自動的に停止します。カメラのバッテリーが切れた場合や、意図的にカメラをオフにした場合も、キャプチャが中断されることがあります。

このオプションは API レベル 2 で追加されました。

 rw
captureNumberSupport オブジェクト

インターバル キャプチャ中にキャプチャできる画像の最小数と最大数。次に例を示します。

{
    "minNumber": 2,
    "maxNumber": 50
}
空き容量によって変わる場合があります。

このオプションは API レベル 2 で追加されました。

 r
remainingVideoSeconds 数値 現在のキャプチャ設定に基づく、残りの動画の推定 seconds 数。

このオプションは API レベル 2 で追加されました。

 r
pollingDelay 数値 連続する 2 つのステータス ポーリング リクエスト間の最小間隔（秒）。クライアントはこのフィールドを使用して、ステータス ポーリングの動作をガイドする必要があります。たとえば、画像を合成する際、クライアントは定期的にカメラにポーリングし、合成が完了したかどうかを確認する必要があります。カメラによってサポートは異なります。たとえば、1 秒ごとにステータス ポーリングを処理できるカメラもあれば、より長い間隔をサポートするカメラもあります。

このオプションは API レベル 2 で追加されました。

 r
delayProcessing ブール値 True: 処理（合成など）の優先度がキャプチャよりも低い場合、つまり、以前にキャプチャした画像の処理が完了する前に別のキャプチャが許可されている場合。特に、処理に時間がかかるカメラでは、この方法を強くおすすめします。

このオプションは API レベル 2 で追加されました。

 rw
delayProcessingSupport ブール値配列

[true] は、処理（合成など）がキャプチャよりも優先度が低く、デフォルトで常に遅延することを意味します。

[false] は、キャプチャ直後に処理が行われることを意味します。

[true, false] は、この 2 つのモードのうちいずれかを選択できることを意味します。

このオプションは API レベル 2 で追加されました。

 r
clientVersion 数値

クライアントが使用する API レベル。値が 0 または 1 の場合は API レベル 1 と 2 の両方をサポートしているため、 API レベル 1 でも、特に変更はありません。デフォルト カメラが API レベル 2 のみをサポートし、 推奨されています。カメラ API レベル 2 のみをサポートしているため、API レベルを 1 に設定しようとしたリクエストは、 失敗します。clientVersion が 2 に正常に設定され、 使用された場合、そのリクエストは エラーコード unknownCommand が返されます。

このオプションは API レベル 2 で追加されました。

 rw
photoStitchingSupport 文字列配列

写真の合成オプションのリスト。返却 写真が常にカメラに合成されている場合は [ondevice]。 カメラが写真を合成できない場合は [none]。 合成がユーザー構成可能な場合は [none,ondevice]。 ベンダー固有の設定名の前にはアンダースコアを付けます（例: _vendor-setting。

このオプションは API レベル 2.1 で追加されました。

 r
photoStitching 文字列

写真の現在の合成オプション。例: ondevice。次の場合のデフォルトは ondevice です。 サポートされません。

このオプションは API レベル 2.1 で追加されました。

 rw
videoStitchingSupport 文字列配列

動画の合成オプションのリスト。返却 動画が常にカメラで合成されている場合は [ondevice]。 カメラが動画を合成できない場合は [none]。 合成がユーザー構成可能な場合は [none,ondevice]。 ベンダー固有の設定名の前にはアンダースコアを付けます（例: _vendor-setting。

このオプションは API レベル 2.1 で追加されました。

 r
videoStitching 文字列

動画の現在の合成オプション（例: ondevice。次の場合のデフォルトは ondevice です。 サポートされません。

このオプションは API レベル 2.1 で追加されました。

 rw
videoGPSSupport 文字列配列

動画キャプチャ時の GPS オプションのリスト。返却 カメラが GPS を連続してキャプチャできる場合は [continuous] 位置を動画内に埋め込むことができます。返却 できない場合は [none]、[none,continuous] 動画の GPS サポートがユーザー設定可能な場合。接頭辞ベンダー固有の名前 アンダースコアを使用して名前を設定する_vendor-setting。

このオプションは API レベル 2.1 で追加されました。

 r
videoGPS 文字列

動画キャプチャ中の GPS サポートの現在のオプション（例: continuous。次の場合のデフォルトは continuous です。 サポートされません。

このオプションは API レベル 2.1 で追加されました。

 rw
_vendorSpecific [type]（省略可） ベンダー固有の追加カメラ オプション。ベンダー固有の文字列の先頭には アンダースコア（_）を使用できます。