ตารางต่อไปนี้แสดงตัวเลือกทั้งหมดที่ตั้งค่าและรับภายในวันที่ camera.setOptions
และ camera.getOptions
เปลี่ยนแปลงตัวเลือกไม่ได้เมื่อการสนับสนุนที่เกี่ยวข้องว่างเปล่าหรือมีเพียงตัวเลือกเดียว
ชื่อ | ประเภท | คำอธิบาย | อ่าน/เขียน |
---|---|---|---|
captureMode |
สตริง | โหมดจับภาพปัจจุบัน ค่าเริ่มต้นคือ image. |
Rw |
captureModeSupport |
อาร์เรย์สตริง | รายการโหมดจับภาพที่พร้อมใช้งานในขณะนี้ ข้อกำหนดขั้นต่ำสำหรับ API ระดับ 1 คือ ["image"] และข้อกำหนดขั้นต่ำสำหรับ API ระดับ 2 คือ ["image", "interval"] โดยที่ "interval" คือโหมดของการถ่ายภาพชุดรูปภาพโดยเว้นระยะห่างในช่วงเวลาหนึ่งๆ โปรดดู captureInterval และ captureIntervalSupport เพิ่มเติมด้วย API ระดับที่ 2 รองรับอีก 2 โหมด ("video" and "walkaround") ดังนั้น API ระดับที่ 2 จะรองรับการตั้งค่าทั้งหมดที่รองรับคือ ["image", "interval", "video", "walkaround"] โดยที่ "video" คือโหมดจับภาพวิดีโอ และ "walkaround" แสดงโหมดจับภาพ 2 ภาพตามลำดับ โดยโหมดแรกมีผู้ใช้ยืนในที่ใดก็ตามเมื่อเทียบกับกล้อง และโหมดที่ 2 มีผู้ใช้ยืนอยู่ฝั่งตรงข้าม (สัมพันธ์กับจุดยืนแรก) ของกล้อง วิธีนี้ช่วยให้กล้องนำผู้ใช้ออกจากรูปภาพสุดท้ายโดยการรวมรูปภาพ 2 รูปเข้าด้วยกัน เมื่อกล้องรองรับ "walkaround" และตั้งค่าเป็นโหมดจับภาพปัจจุบัน ไคลเอ็นต์ควรส่งคำสั่ง TakePicture 2 คำสั่งไปยังกล้อง ซึ่งการตอบสนองของคำสั่งแรก (เมื่อเสร็จแล้ว) บ่งบอกว่ากล้องพร้อมถ่ายภาพที่ 2 แล้ว ขณะที่คำสั่งที่ 2 ควรแสดงรูปภาพสุดท้ายเมื่อเสร็จสิ้น
หากต้องการเพิ่มโหมดจับภาพอื่นๆ ที่ยังไม่รองรับ โปรดใช้ขีดล่าง ( _ ) ด้านหน้าโหมดเฉพาะผู้ให้บริการ ตัวเลือกนี้ได้รับการแก้ไขใน 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 แจ้งกล้องว่าตำแหน่ง 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 ค่าคือ 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 อย่างน้อย 1 โหมด (API ระดับ 2) หากกล้องใช้การถ่ายคร่อมแสงด้วยตนเอง วัตถุจะมี 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 การตั้งค่านี้จะtrue ได้เฉพาะเมื่อgyroSupport == true เท่านั้น |
Rw |
gyroSupport |
บูลีน | หากกล้องมีเครื่องวัดการหมุน ค่านี้ควรเป็น true หากไม่ใช่ false |
r |
gps |
บูลีน | เปิด/ปิดใช้โมดูล GPS ของกล้อง ค่าต้องเป็น true เพื่อเปิดใช้ หรือ false เพื่อปิดใช้ ค่าเริ่มต้นคือ true หากกล้องรองรับ มิเช่นนั้น false ระบบจะตั้งค่าเป็นtrue เฉพาะเมื่อgpsSupport == true |
Rw |
gpsSupport |
บูลีน | ค่านี้ควรเป็น true หากกล้องมีโมดูล GPS ของตนเอง มิเช่นนั้น 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 |
ตัวเลข | ช่วงเวลาปัจจุบันระหว่างการจับภาพ 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 |
อาร์เรย์บูลีน |
เพิ่มตัวเลือกนี้ใน API ระดับ 2 |
r |
clientVersion |
ตัวเลข | ระดับ API ที่ไคลเอ็นต์ต้องการใช้ ค่าเริ่มต้นคือ 1 หาก
กล้องรองรับ API ทั้งระดับ 1 และ 2 เพื่อให้ลูกค้าเขียนขึ้น
API ระดับ 1 ยังคงใช้งานกับกล้องโดยไม่มีการเปลี่ยนแปลงใดๆ ค่าเริ่มต้น
เป็น 2 ถ้ากล้องรองรับเฉพาะ API ระดับ 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 |
[type] (ไม่บังคับ) | ตัวเลือกกล้องเพิ่มเติมเฉพาะผู้ขาย ใส่คำนำหน้าสตริงเฉพาะผู้ให้บริการด้วย เครื่องหมายขีดล่าง ( _ ) |