オプション

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

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

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

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

 r
captureStatus String 現在のキャプチャ ステータス。デフォルトは "idle" です。これは、カメラを最初にアプリに接続したときにカメラのステータスを確認するのに役立ちます。カメラが動画の撮影の途中である場合は、他の動画撮影などを実行する前に、停止する必要がある場合があります。

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

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

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

 r
exposureProgram 数値 現在の露出プログラム rw
exposureProgramSupport 数値配列 現在利用可能な露出プログラムのリスト（例: [0, 1, 2, 3, 4]）。各整数は、それぞれ異なる露出プログラムを表します。
  • 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 String 現在のホワイト バランス設定（例: daylight）。デフォルトは auto です。 rw
whiteBalanceSupport 文字列配列 現在利用可能なホワイト バランス設定のリストは、事前定義されたリストのサブセット（[ "auto", "incandescent", "fluorescent", "daylight", "cloudy-daylight", "shade", "twilight"]）にすることができます。それぞれの値。
  • 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 情報。setOptions を使用してスマートフォンの GPS を使用して設定するには:

{
    "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 String 現在の日付と時刻の情報。setOptions がスマートフォンの日付、時刻、タイムゾーンを使用して設定します。形式は YYYY:MM:DD HH:MM:SS+(-)HH:MM です。時刻は 24 時間形式で、日付と時刻は空白スペースで区切られ、タイムゾーンは 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 つのエントリが含まれます。
  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 String 現在の画像手ぶれ補正オペレーション（例: off）。 rw
imageStabilizationSupport 文字列配列 手ぶれ補正機能は現在ご利用いただけます。既定のリストは ["off", "on"] です。カメラが手ぶれ補正をサポートしていない場合は ["off"] を返し、それ以外の場合は ["off", "on"] を返します。ベンダー固有の文字列の先頭にアンダースコア（_）を付けます（例: [ "off", "_horizontal_stabilization", "_vibration_correction" ]）。 r
wifiPassword String
文字、数字、記号を含む 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 レベル。カメラが API レベル 1 と 2 の両方をサポートしている場合はデフォルトの 1 となり、API レベル 1 用に作成されたクライアントが変更せずにカメラでも機能するようにできます。カメラが API レベル 2 のみをサポートする場合はデフォルトの 2 になります（クライアントが API レベル 2 に移行するまでは推奨されません）。カメラが API レベル 2 のみをサポートしている場合、カメラを 1 に設定しようとするリクエストは失敗します。clientVersion が正常に 2 に設定され、API レベル 1 の非推奨のコマンドがリクエストされた場合、リクエストは失敗し、エラーコード unknownCommand が返されます。

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

 rw
photoStitchingSupport 文字列配列

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

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

 r
photoStitching String

写真の現在の合成オプション（ondevice など）サポートされている場合は、デフォルトで ondevice になります。

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

 rw
videoStitchingSupport 文字列配列

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

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

 r
videoStitching String

動画の現在の合成オプション（ondevice など）。サポートされている場合は、デフォルトで ondevice になります。

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

 rw
videoGPSSupport 文字列配列

動画キャプチャ中の GPS オプションのリスト動画キャプチャ中にカメラが継続的に GPS をキャプチャし、動画内の場所を埋め込める場合は、[continuous] を返します。それができない場合は [none] を返し、動画 GPS サポートが構成可能な場合は [none,continuous] を返します。ベンダー固有の設定名の前にアンダースコアを付けます（例: _vendor-setting）。

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

 r
videoGPS String

動画キャプチャ中の GPS サポートの現在のオプション（例: continuous）。サポートされている場合は、デフォルトで continuous になります。

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

 rw
_vendorSpecific [タイプ]（省略可） カメラ固有のベンダー固有の追加オプション。ベンダー固有の文字列にはアンダースコア（_）を付けます。