ตารางต่อไปนี้แสดงตัวเลือกทั้งหมดที่ตั้งค่าและรับได้ในวันที่ camera.setOptions
และ camera.getOptions
ไม่สามารถเปลี่ยนตัวเลือกเมื่อการสนับสนุนที่เกี่ยวข้องว่างเปล่าหรือมีเพียงตัวเลือกเดียว
ชื่อ | ประเภท | คำอธิบาย | อ่าน/เขียน |
---|---|---|---|
captureMode |
สตริง | โหมดจับภาพปัจจุบัน ค่าเริ่มต้นคือ image. |
แถว |
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 ภาพตามลําดับ โหมดแรกกับผู้ใช้ที่ยืนอยู่ข้าง 2 บริเวณที่สัมพันธ์กับเลนส์ วิธีนี้ช่วยให้กล้องนําผู้ใช้ออกจากรูปภาพสุดท้ายได้โดยการรวมรูปภาพ 2 รูปเข้าด้วยกัน เมื่อกล้องรองรับ "walkaround" และตั้งค่าเป็นโหมดจับภาพปัจจุบัน ไคลเอ็นต์ควรส่งคําสั่ง TakePicture จํานวน 2 ตัวไปยังกล้อง โดยการตอบสนองของคําสั่งแรก (เมื่อถ่ายเสร็จ) บ่งชี้ว่ากล้องพร้อมจะถ่ายภาพที่ 2 ขณะที่คําสั่งที่ 2 ควรจะแสดงรูปภาพสุดท้ายเมื่อเสร็จ
หากต้องการเพิ่มโหมดจับภาพที่ยังไม่รองรับ โปรดเพิ่มโหมดเฉพาะของผู้ให้บริการด้วยเครื่องหมายขีดล่าง ( _ ) ตัวเลือกนี้ได้รับการแก้ไขใน API ระดับ 2 |
r |
captureStatus |
สตริง | สถานะการจับภาพปัจจุบัน ค่าเริ่มต้นคือ "idle" วิธีนี้เป็นประโยชน์ในการพิจารณาสถานะของกล้องเมื่อเชื่อมต่อกับแอปครั้งแรก หากกล้องอยู่ระหว่างการถ่ายทํา อาจต้องหยุดก่อนที่จะทําอย่างอื่น เช่น ถ่ายวิดีโอครั้งใหม่ มีการเพิ่มตัวเลือกนี้ใน API ระดับ 2.1 |
แถว |
captureStatusSupport |
อาร์เรย์สตริง | รายการสถานะการจับภาพที่พร้อมใช้งานในขณะนี้ ตามค่าเริ่มต้นควรเป็น ["idle", "shooting"] หากรองรับการถ่ายวิดีโอ และยังระบุรูปปั้นอื่นๆ ได้ด้วย เช่น "downloading" มีการเพิ่มตัวเลือกนี้ใน API ระดับ 2.1 |
r |
exposureProgram |
ตัวเลข | โปรแกรมการรับแสงปัจจุบัน | แถว |
exposureProgramSupport |
อาร์เรย์ตัวเลข | รายชื่อโปรแกรมความเสี่ยงต่อการติดเชื้อที่มีอยู่ในขณะนี้ เช่น [0, 1, 2, 3, 4] จํานวนเต็มแต่ละรายการแสดงถึงโปรแกรมความเสี่ยงต่อการติดเชื้อที่แตกต่างกัน ดังนี้
ExposureProgram
|
r |
iso |
ตัวเลข | การตั้งค่าความเร็ว ISO ปัจจุบัน | แถว |
isoSupport |
อาร์เรย์ตัวเลข | API ระดับ 1: รายการการตั้งค่า ISO ที่ใช้ได้ในปัจจุบัน เช่น API ระดับ 2: รายการการตั้งค่า ISO ที่ใช้ได้ในปัจจุบัน เช่น ตัวเลือกนี้ได้รับการแก้ไขใน API ระดับ 2 |
r |
shutterSpeed |
ตัวเลข | การตั้งค่าความเร็วชัตเตอร์ปัจจุบัน | แถว |
shutterSpeedSupport |
อาร์เรย์ตัวเลข | API ระดับ 1: รายการความเร็วชัตเตอร์ในปัจจุบัน เช่น API ระดับ 2: รายการความเร็วชัตเตอร์ในปัจจุบัน เช่น ตัวเลือกนี้ได้รับการแก้ไขใน API ระดับ 2 |
r |
aperture |
ตัวเลข | การตั้งค่ารูรับแสงปัจจุบัน รูรับแสง | แถว |
apertureSupport |
อาร์เรย์ตัวเลข | API ระดับ 1: รายการการตั้งค่ารูรับแสงที่พร้อมใช้งานอยู่ในขณะนี้ซึ่งแสดงใน API ระดับ 2: รายการการตั้งค่ารูรับแสงที่พร้อมใช้งานในปัจจุบันซึ่งแสดงใน |
r |
whiteBalance |
สตริง | การตั้งค่าไวท์บาลานซ์ปัจจุบัน เช่น daylight ค่าเริ่มต้นคือ auto |
แถว |
whiteBalanceSupport |
อาร์เรย์สตริง | รายการการตั้งค่าไวท์บาลานซ์ที่พร้อมใช้งานในปัจจุบัน เป็นชุดย่อยของรายการที่กําหนดไว้ล่วงหน้าต่อไปนี้ [ "auto", "incandescent", "fluorescent", "daylight", "cloudy-daylight", "shade", "twilight"] มูลค่าสําหรับรายการต่อไปนี้
_vendor-setting |
r |
exposureCompensation |
ตัวเลข | ชดเชยการรับแสงปัจจุบัน | แถว |
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 |
แถว |
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 และเมื่อเริ่มรับแสง หน่วยเป็นวินาที |
แถว |
exposureDelaySupport |
อาร์เรย์ตัวเลข | รายการความล่าช้าของความเสี่ยงต่อการติดเชื้อในปัจจุบันในหน่วยวินาที เช่น [0, 1, 2, 5, 10, 30, 60] |
r |
sleepDelay |
ตัวเลข | การหน่วงเวลาปัจจุบันก่อนที่กล้องจะเข้าสู่โหมดสลีป มีหน่วยเป็นวินาที | แถว |
sleepDelaySupport |
อาร์เรย์ตัวเลข | ข้อมูลการหน่วงเวลาการนอนหลับที่มีอยู่ในหน่วยวินาที ตัวอย่างเช่น [30, 60, 120, 300, 600, 1800, 65535] ที่ 65535 ปิดใช้โหมดสลีป (กล้องไม่ได้เข้าสู่โหมดสลีปจนกว่าจะปิดเครื่อง) และต้องรองรับโหมดนี้ |
r |
offDelay |
ตัวเลข | การหน่วงเวลาปัจจุบันเป็นวินาทีก่อนที่กล้องจะปิด | แถว |
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 จะแจ้งเตือนกล้องว่าตําแหน่ง GPS ปัจจุบันไม่ถูกต้อง และ
กล้องจะต้องเพิกเฉยต่อตําแหน่งนั้นและใช้ GPS ของตัวกล้องเอง (หากมี) เช่น
setOptions({"gpsInfo": {"lat": 65535, "lng": 65535}}) หมายความว่าตําแหน่ง GPS ไม่ถูกต้อง |
แถว |
dateTimeZone |
สตริง | ข้อมูลวันที่และเวลาปัจจุบัน ตั้งตาม setOptions โดยใช้วันที่ เวลา และเขตเวลาของโทรศัพท์ รูปแบบคือ YYYY:MM:DD HH:MM:SS+(-)HH:MM เวลาอยู่ในรูปแบบ 24 ชั่วโมง วันที่และเวลาจะคั่นด้วยช่องว่าง
และเขตเวลาเป็นค่าชดเชยเวลา UTC ตัวอย่างเช่น 2014:05:18 01:04:29+8:00 คือเขตเวลาในจีน (UTC+8:00) |
แถว |
hdr |
API ระดับ 1: บูลีน API ระดับ 2: สตริง |
API ระดับ 1: เปิดใช้/ปิดใช้โหมดจับภาพ HDR ค่าคือ API ระดับ 2: โหมด HDR ปัจจุบันของประเภทสตริง ตัวเลือกนี้ได้รับการแก้ไขใน API ระดับ 2 |
แถว |
hdrSupport |
API ระดับ 1: บูลีน API ระดับ 2: อาร์เรย์สตริง |
API ระดับ 1: ค่า API ระดับ 2: หากคุณไม่รองรับโหมด HDR ระบบจะตั้งเป็น ตัวเลือกนี้ได้รับการแก้ไขใน API ระดับ 2 |
r |
exposureBracket |
วัตถุ | การตั้งค่าวงเล็บเปิดรับแสงในปัจจุบัน ใช้ได้เฉพาะเมื่อ hdrSupport == true (API ระดับ 1) หรือ hdrSupport มีโหมด HDR อย่างน้อย 1 โหมด (API ระดับ 2) หากกล้องใช้คร่อมแสงด้วยตัวเอง วัตถุดังกล่าวจะมีรายการ 2 รายการต่อไปนี้
{ "shots": 3, "increment": 1.33 }หากกล้องใช้คร่อมแสงอัตโนมัติ วัตถุจะมีข้อมูลต่อไปนี้ { "autoMode": true } API ระดับ 1: ค่าเริ่มต้นคือ API ระดับ 2: ค่าเริ่มต้นจะว่างเปล่า {} เมื่อ ตัวเลือกนี้ได้รับการแก้ไขใน API ระดับ 2 |
แถว |
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 การตั้งค่านี้เป็น true ได้เมื่อ gyroSupport == true เท่านั้น |
แถว |
gyroSupport |
บูลีน | หากกล้องมีเครื่องวัดการหมุน ค่านี้ควรเป็น true มิเช่นนั้นให้ระบุ false |
r |
gps |
บูลีน | เปิด/ปิดใช้โมดูล GPS ของกล้อง ค่าต้องเป็น true จึงจะเปิดใช้ได้ หรือ false จึงจะปิดใช้ได้ ค่าเริ่มต้นคือ true หากกล้องรองรับ มิเช่นนั้น จะเป็น false การตั้งค่าคือ true เมื่อ gpsSupport == true เท่านั้น |
แถว |
gpsSupport |
บูลีน | ค่านี้ควรเป็น true หากกล้องมีโมดูล GPS ของตนเอง ไม่เช่นนั้นจะเป็น false |
r |
imageStabilization |
สตริง | ระบบป้องกันภาพสั่นไหวในปัจจุบัน เช่น off |
แถว |
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 |
แถว |
previewFormatSupport |
อาร์เรย์ออบเจ็กต์ | รูปแบบตัวอย่างแบบเรียลไทม์ที่รองรับในปัจจุบัน เช่น [ { "width": 640, "height": 320, "framerate": 24 }, ... { "width": 1280, "height": 720, "framerate": 24 } ] มีการเพิ่มตัวเลือกนี้ใน API ระดับ 2 |
r |
captureInterval |
ตัวเลข | ช่วงปัจจุบันระหว่างการบันทึกภาพ 2 ภาพติดกันใน seconds
มีการเพิ่มตัวเลือกนี้ใน API ระดับ 2 |
แถว |
captureIntervalSupport |
วัตถุ | ช่วงเวลาต่ําสุดและสูงสุดที่ใช้ได้ระหว่างการจับภาพต่อเนื่องกัน 2 ภาพ หน่วยเป็นวินาที เช่น { "minInterval": 10, "maxInterval": 60 }อาจแตกต่างกันไปตาม fileFormat
มีการเพิ่มตัวเลือกนี้ใน API ระดับ 2 |
r |
captureNumber |
ตัวเลข | จํานวนรูปภาพที่จะบันทึกสําหรับเซสชันการจับภาพตามช่วงเวลา 1 เซสชัน ใช้ค่าเริ่มต้นเป็น 0 ซึ่งหมายความว่าการจับภาพจะต้องสิ้นสุดด้วยคําสั่ง stopCapture อย่างชัดแจ้ง มิเช่นนั้น การจับภาพจะหยุดโดยอัตโนมัติหลังจากที่จับภาพรูปภาพตัวเลขที่ระบุ การจับภาพอาจหยุดชะงักเมื่อกล้องแบตเตอรี่หมดหรือเมื่อกล้องปิดโดยไม่เจตนา
มีการเพิ่มตัวเลือกนี้ใน API ระดับ 2 |
แถว |
captureNumberSupport |
วัตถุ | จํานวนรูปภาพขั้นต่ําและสูงสุดที่สามารถจับภาพได้ในระหว่างการจับภาพตามช่วงเวลา เช่น { "minNumber": 2, "maxNumber": 50 }อาจมีการเปลี่ยนแปลงโดยขึ้นอยู่กับพื้นที่เก็บข้อมูลที่เหลือ มีการเพิ่มตัวเลือกนี้ใน API ระดับ 2 |
r |
remainingVideoSeconds |
ตัวเลข | จํานวนโดยประมาณของวิดีโอ seconds รายการตามการตั้งค่าการบันทึกปัจจุบัน
มีการเพิ่มตัวเลือกนี้ใน API ระดับ 2 |
r |
pollingDelay |
ตัวเลข | ช่วงเวลาต่ําสุดเป็นวินาทีระหว่างคําขอแบบสํารวจสถานะ 2 รายการติดต่อกัน ลูกค้าควรใช้ช่องนี้เป็นแนวทางในการตรวจสอบสถานะแบบสํารวจ เช่น เมื่อเย็บภาพ ลูกค้าอาจต้องสํารวจกล้องเป็นระยะๆ จึงจะต่อภาพสําเร็จ กล้องแต่ละตัวจะมีการรองรับที่ต่างกัน เช่น กล้องบางตัวรองรับการตรวจสอบสถานะแบบสํารวจทุกๆ 1 วินาทีได้ และกล้องอื่นๆ อาจรองรับระยะเวลาที่นานขึ้น
มีการเพิ่มตัวเลือกนี้ใน API ระดับ 2 |
r |
delayProcessing |
บูลีน | True เมื่อประมวลผล (เช่น การต่อภาพ) มีลําดับความสําคัญต่ํากว่าการจับภาพ หรือพูดได้อีกอย่างก็คือ การจับภาพอื่นสามารถทําได้ก่อนที่การประมวลผลรูปภาพที่จับภาพก่อนหน้านี้จะเสร็จสิ้น เราขอแนะนําอย่างยิ่งโดยเฉพาะอย่างยิ่งสําหรับกล้องที่ใช้เวลาประมวลผลนาน
มีการเพิ่มตัวเลือกนี้ใน API ระดับ 2 |
แถว |
delayProcessingSupport |
อาร์เรย์แบบบูลีน |
มีการเพิ่มตัวเลือกนี้ใน API ระดับ 2 |
r |
clientVersion |
ตัวเลข | ระดับ API ที่ไคลเอ็นต์ตัดสินใจใช้ ค่าเริ่มต้นจะเป็น 1 หากกล้องรองรับทั้ง API ระดับ 1 และ 2 เพื่อให้ไคลเอ็นต์ที่เขียนสําหรับ API ระดับ 1 ยังคงใช้งานได้กับกล้องโดยไม่มีการเปลี่ยนแปลง ค่าเริ่มต้นจะเป็น 2 หากกล้องรองรับ API ระดับ 2 เท่านั้น ซึ่งไม่แนะนําก่อนที่จะย้ายข้อมูลผู้ใช้ไปยัง API ระดับ 2 หากกล้องรองรับ API ระดับ 2 เท่านั้น คําขอที่ตั้งค่าเป็น 1 ควรไม่สําเร็จ หากตั้งค่า มีการเพิ่มตัวเลือกนี้ใน API ระดับ 2 |
แถว |
photoStitchingSupport |
อาร์เรย์สตริง | รายการตัวเลือกการต่อภาพ แสดง มีการเพิ่มตัวเลือกนี้ใน API ระดับ 2.1 |
r |
photoStitching |
สตริง | บริการเย็บต่อรูปภาพปัจจุบัน เช่น มีการเพิ่มตัวเลือกนี้ใน API ระดับ 2.1 |
แถว |
videoStitchingSupport |
อาร์เรย์สตริง | รายการตัวเลือกการต่อวิดีโอ แสดง มีการเพิ่มตัวเลือกนี้ใน API ระดับ 2.1 |
r |
videoStitching |
สตริง | ตัวเลือกการต่อวิดีโอปัจจุบัน เช่น มีการเพิ่มตัวเลือกนี้ใน API ระดับ 2.1 |
แถว |
videoGPSSupport |
อาร์เรย์สตริง | รายการตัวเลือก GPS ระหว่างการจับภาพวิดีโอ แสดงผล มีการเพิ่มตัวเลือกนี้ใน API ระดับ 2.1 |
r |
videoGPS |
สตริง | ตัวเลือกปัจจุบันสําหรับการรองรับ GPS ระหว่างการบันทึกวิดีโอ เช่น มีการเพิ่มตัวเลือกนี้ใน API ระดับ 2.1 |
แถว |
_vendorSpecific |
[type] (ไม่บังคับ) | ตัวเลือกกล้องเพิ่มเติมเฉพาะของผู้ให้บริการ ใช้สตริงขีดล่าง ( _) นําหน้าผู้ให้บริการที่เจาะจง |