下表列出 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] 。每個整數都代表不同的曝光程式:
ExposureProgram 的詳細資料。 |
r |
iso |
數量 | 目前的 ISO 速度設定。 | rw |
isoSupport |
數字陣列 | API 級別 1:目前可用的 ISO 設定清單,例如在 API 級別 2:目前可用的 ISO 設定清單,例如 API 級別 2 已修改這個選項。 |
r |
shutterSpeed |
數量 | 目前快門速度設定。 | rw |
shutterSpeedSupport |
數字陣列 | API 級別 1:目前可用的快門速度清單,例如在 API 級別 2:目前可用的快門速度清單;例如 API 級別 2 已修改這個選項。 |
r |
aperture |
數量 | 目前光圈設定 (單位為 f-stop)。 | rw |
apertureSupport |
數字陣列 | API 級別 1:目前可用的光圈設定清單,以 API 級別 2:目前可用的光圈設定清單,以 |
r |
whiteBalance |
字串 | 目前的白平衡設定;例如 daylight 。預設為 auto 。 |
rw |
whiteBalanceSupport |
字串陣列 | 目前可使用的白平衡設定清單為預先定義的清單子集:[ "auto", "incandescent", "fluorescent", "daylight", "cloudy-daylight", "shade", "twilight"] 。每個值的值:
_vendor-setting |
r |
exposureCompensation |
數量 | 目前的曝光補償。 | rw |
exposureCompensationSupport |
數字陣列 | 目前可用的曝光補償清單,通常為步驟 0.33 或 0.5;例如:[-1, -0.67, -0.33, 0, 0.33, 0.67, 1] |
r |
fileFormat |
物件 | 目前的檔案類型和解析度。格式必須反映 { "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 設定 { "lat": 23.532, "lng": -132.35 } lat 和 lng 屬性是小數度,範圍中的 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 值,值為 API 級別 2:字串類型的目前 HDR 模式。 API 級別 2 已修改這個選項。 |
rw |
hdrSupport |
API 級別 1:布林值 API 級別 2:字串陣列 |
API 級別 1: API 級別 2:如果不支援 HDR 模式,則為 API 級別 2 已修改這個選項。 |
r |
exposureBracket |
物件 | 目前的曝光括號設定。僅適用於 hdrSupport == true (API 級別 1) 或 hdrSupport 包含至少一個 HDR 模式 (API 級別 2)。如果相機採用手動包圍曝光模式,則物體包含兩個項目:
{ "shots": 3, "increment": 1.33 }如果相機使用自動包圍曝光功能,則物體包含: { "autoMode": true } API 級別 1: API 級別 2:如果 API 級別 2 已修改這個選項。 |
rw |
exposureBracketSupport |
物件 | 曝光公開設定目前可供使用,例如: { "autoMode": true, "shotsSupport": [1, 3, 5, 7], "incrementSupport": [0.33, 0.67, 1, 1.33, 1.67, 2] } API 級別 1:如果 API 級別 2:如果 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 |
布林值陣列 |
這個選項已新增至 API 級別 2。 |
r |
clientVersion |
數量 | 用戶端決定使用的 API 級別。如果相機同時支援 API 級別 1 和 2,因此預設為 1;這樣一來,寫入 API 級別 1 的用戶端仍可以正常使用相機,且無須進行任何變更;如果相機僅支援 API 級別 2,建議預設為 2;除非用戶端遷移至 API 級別 2,不建議採用這種做法。如果相機僅支援 API 級別 2,嘗試設為 1 的要求應會失敗。如果 這個選項已新增至 API 級別 2。 |
rw |
photoStitchingSupport |
字串陣列 | 相片拼接選項清單。如果相片無法拼接相機,則傳回 這個選項已新增至 API 級別 2.1。 |
r |
photoStitching |
字串 | 相片目前的拼接選項,例如 這個選項已新增至 API 級別 2.1。 |
rw |
videoStitchingSupport |
字串陣列 | 影片拼接選項清單。如果影片一律拼接在相機中,請傳回 這個選項已新增至 API 級別 2.1。 |
r |
videoStitching |
字串 | 影片目前的拼接選項,例如 這個選項已新增至 API 級別 2.1。 |
rw |
videoGPSSupport |
字串陣列 | 影片拍攝期間的 GPS 選項清單。如果相機能在錄影期間持續擷取全球衛星定位系統並嵌入影片中的位置,請傳回 這個選項已新增至 API 級別 2.1。 |
r |
videoGPS |
字串 | 擷取影片期間 GPS 支援的目前選項,例如 這個選項已新增至 API 級別 2.1。 |
rw |
_vendorSpecific |
[類型] (選填) | 供應商專屬的其他相機選項。請在廠商專屬字串前面加上底線 ( _)。 |