選項

下表列出 camera.setOptionscamera.getOptions 可設定和取得的所有選項。如果相應的支援項目空白或只包含一個選項,您就無法變更選項。

名稱 類型 說明 讀取/寫入
captureMode 字串 目前的擷取模式。預設為 image. rw
captureModeSupport 字串陣列 目前可用的擷取模式清單。API 級別 1 的最低需求為 ["image"],API 級別 2 的最低需求為 ["image", "interval"],其中 "interval" 代表以特定時間間隔擷取一系列圖片的模式,另請參閱 captureIntervalcaptureIntervalSupport。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 設定清單,例如在 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-stop)。 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,約 3200K
  • fluorescent,約 4000K
  • datalight,約 5200K
  • cloudy-daylight,約 6000K
  • shade,約 7000K
  • twilight,約 12000K
請在廠商專用設定名稱前方加上底線;例如:_vendor-setting
r
exposureCompensation 數量 目前的曝光補償。 rw
exposureCompensationSupport 數字陣列 目前可用的曝光補償清單,通常為步驟 0.33 或 0.5;例如:[-1, -0.67, -0.33, 0, 0.33, 0.67, 1] r
fileFormat 物件

目前的檔案類型和解析度。格式必須反映 captureMode 目前的值。舉例來說,如果 captureModeimage,則適當的回應如下:

{
    "type": "jpeg",
    "width": 2000,
    "height": 1000
}
如果 captureModevideo,則適當的回應如下:
{
    "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

{
    "lat": 23.532,
    "lng": -132.35
}
latlng 屬性是小數度,範圍中的 lat[-90, 90]lng 則是 [-180, 180]。請注意,如果手機是由手機提供,每個 GPS 定位都只會在手機的下一次更新之前仍然有效。手機必須判斷更新 GPS 位置的時機,例如在每一個 takePicture 指令之前。65535 會通知相機目前的全球衛星定位系統無效,且相機應忽略該位置,並使用自己的全球衛星定位系統 (如果有的話)。例如,setOptions({"gpsInfo": {"lat": 65535, "lng": 65535}}) 表示全球衛星定位系統定位資訊無效。
rw
dateTimeZone 字串 目前的日期和時間資訊。根據setOptions設定手機的日期、時間和時區。格式為 YYYY:MM:DD HH:MM:SS+(-)HH:MM。時間採 24 小時制,日期和時間會以空白區域分隔,時區則以世界標準時間為準,例如 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”];如果支援一種 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時預設為 {}。當 hdrtrue 時,製造商可決定預設值 (例如自動曝光包圍曝光)。

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,因此預設為 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 字串

相片目前的拼接選項,例如 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 選項清單。如果相機能在錄影期間持續擷取全球衛星定位系統並嵌入影片中的位置,請傳回 [continuous]。如果無法設定,請使用 [none] ;如果可設定影片 GPS 支援,則傳回 [none,continuous]。請在廠商專屬設定名稱的前面加上底線,例如 _vendor-setting

這個選項已新增至 API 級別 2.1。

r
videoGPS 字串

擷取影片期間 GPS 支援的目前選項,例如 continuous。如果受支援,則預設為 continuous

這個選項已新增至 API 級別 2.1。

rw
_vendorSpecific [類型] (選填) 供應商專屬的其他相機選項。請在廠商專屬字串前面加上底線 ( _)。