選項

下表列出在 camera.setOptions 和 camera.getOptions 前可設定及取得的所有選項。如果對應支援服務為空白或只有一個選項，就無法變更選項。

名稱 類型 說明 讀取/寫入
captureMode 字串 目前擷取模式。預設為 image. rw
captureModeSupport 字串陣列 目前可用的拍攝模式清單。API 級別 1 的最低需求為 ["image"]，API 級別 2 的最低需求為 ["image", "interval"]，其中 "interval" 代表擷取以特定間隔間隔拍攝的一系列圖片的模式，請一併參閱 captureInterval 和 captureIntervalSupport。API 級別 2 支援兩種 ("video" and "walkaround") 模式，因此 API 級別 2 支援的完整模式為 ["image", "interval", "video", "walkaround"]，其中 "video" 代表影片拍攝模式，"walkaround" 代表連續拍攝兩張圖片的模式，第一個使用者站在相對於相機的位置，第二個則與使用者站在相機的反面 (相對於第一個站立點)。這項功能可讓相機合併兩張圖片，將使用者從最終圖片中移除。當相機支援 "walkaround" 且設為目前的拍攝模式時，用戶端應傳送兩個 TakePicture 指令到相機，第一個指令的回應 (完成後) 表示相機已準備好擷取第二張圖片，而第二個指令應在完成時傳回最終圖片。

如要新增更多目前不支援的擷取模式，請在供應商專屬模式前面加上底線 ( _ )。

這個選項已在 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]。每個整數都代表不同的暴露計畫：
  • 0 = 未定義
  • 1 = 手動
  • 2 = 正常計劃
  • 3 = 光圈優先
  • 4 = 快門優先度
，瞭解如何調查及移除這項存取權。 點選下方連結即可下載ExposureProgram的相關詳細資料。 		r
iso 數字 目前的 ISO 速度設定。 rw
isoSupport 數字陣列

API 級別 1：目前可用的 ISO 設定清單。例如 [100, 200, 400, 800,1600] 或 [] 在 auto 模式下。

API 級別 2：目前可用的 ISO 設定清單。例如 [0, 100, 200, 400, 800, 1600]，其中 0 代表 auto 模式。

這個選項已在 API 級別 2 中修改。

 r
shutterSpeed 數字 目前快門速度設定。 rw
shutterSpeedSupport 數字陣列

API 級別 1：目前可用的快門速度清單；例如 [0.067, 0.033, 0.017,0.008] 或 [] 在 auto 模式下。

API 級別 2：目前可用的快門速度清單；例如 [0, 0.067, 0.033, 0.017, 0.008]，其中 0 代表 auto 模式。

這個選項已在 API 級別 2 中修改。

 r
aperture 數字 目前的光圈設定 (以光圈為單位)。 rw
apertureSupport 數字陣列

API 級別 1：目前可用的光圈設定清單，以 f/number 表示；的 例如 [1.4, 2, 2.8, 4, 5.6, 8, 11] 或 [] (如果為 auto 模式)。

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"]。每個項目的值：
  • incandescent，約 320 萬
  • fluorescent，約 400 萬
  • datalight，約 520 萬
  • cloudy-daylight，約 600 萬
  • shade，約 700 萬
  • twilight，約 1200 萬
，瞭解如何調查及移除這項存取權。 並在供應商專屬設定名稱前面加上底線；例如：_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 屬性是十進位度數，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 小時制，日期和時間會以空格分隔 時區則是 UTC 時間的偏差；例如，2014:05:18 01:04:29+8:00 是中國時區 (UTC+8:00) rw
hdr

API 級別 1：布林值

API 級別 2：字串

API 級別 1：啟用/停用 HDR 拍攝模式。輸入 true 即可啟用 HDR；輸入 false 即可停用 HDR。預設值為 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”]；如果支援一種 HDR 模式，該模式就會設為 [“off”, “hdr”]。如果支援多種 HDR 模式 (以不同演算法為基礎)，就是 [“off”, “hdr”, “hdr1”, “hdr2”, ...]

這個選項已在 API 級別 2 中修改。

 r
exposureBracket 物件 目前的曝光支架設定。只有在 hdrSupport == true (API 級別 1) 或 hdrSupport 包含至少一個 HDR 模式 (API 級別 2) 時，才能使用這個值。如果相機使用手動曝光包圍效果，則物件會包含兩個項目：
  1. shots，這是一個包含要拍攝的照片數的整數。
  2. increment，這個數字包含各張電動車充電增量。
，瞭解如何調查及移除這項存取權。 例如： 
{
    "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 數字 拍攝兩張連續圖像之間的目前間隔，以 seconds 為準。

這個選項已在 API 級別 2 中新增。

 rw
captureIntervalSupport 物件

連續拍攝兩張圖像之間的最短和最長間隔，以秒為單位；例如：

{
    "minInterval": 10,
    "maxInterval": 60
}
可能會因fileFormat而異。

這個選項已在 API 級別 2 中新增。

 r
captureNumber 數字 單一間隔擷取工作階段要擷取的圖片數量。預設為 0，這表示必須透過 stopCapture 指令明確終止擷取。否則擷取作業會在擷取指定數字的圖片後自動停止。相機沒電或刻意關閉時，也可能會中斷拍攝。

這個選項已在 API 級別 2 中新增。

 rw
captureNumberSupport 物件

每次拍攝時可擷取的最小和最大圖片數量；例如：

{
    "minNumber": 2,
    "maxNumber": 50
}
儲存空間可能取決於剩餘的儲存空間。

這個選項已在 API 級別 2 中新增。

 r
remainingVideoSeconds 數字 根據目前的擷取設定，剩餘的影片預估可觀看 seconds 部影片。

這個選項已在 API 級別 2 中新增。

 r
pollingDelay 數字 兩個連續狀態輪詢要求之間的最短間隔秒數。客戶應使用這個欄位來引導其狀態輪詢行為。例如，在拼接圖像時，客戶可能需要定期輪詢攝影機，看看相機是否完成拼接。每款攝影機可提供的支援功能各不相同；例如，某些攝影機可以每秒處理狀態輪詢作業，有些攝影機則支援更長的間隔。

這個選項已在 API 級別 2 中新增。

 r
delayProcessing 布林值 True 是指進行處理 (例如拼接) 時，優先順序低於拍攝作業。也就是說，系統允許其他拍攝作業，然後再處理先前的拍攝影像。強烈建議使用這個選項，特別是在需要較長處理時間的相機上。

這個選項已在 API 級別 2 中新增。

 rw
delayProcessingSupport 布林陣列

[true] 表示處理 (例如拼接) 的優先順序低於擷取，而且會預設為延遲。

[false] 是指擷取後立即進行處理。

[true, false] 表示可選擇兩種模式。

這個選項已在 API 級別 2 中新增。

 r
clientVersion 數字

用戶端決定使用的 API 級別。如果 相機同時支援 API 級別 1 和 2，因此針對 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 字串

目前的相片拼接選項，例如 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 [類型] (選填) 供應商專屬的其他相機選項。在供應商專屬字串前面加上 一個底線 ( _ )。