ถ่ายภาพทรงกลม พร้อมบันทึกพิกัดละติจูด/ลองจิจูดลงใน EXIF (ถ้ากล้องของคุณเปิดใช้ GPS หรือ GPS ของตนเองบนโทรศัพท์มือถือที่เชื่อมต่อ) เรียก camera.setOptions
ก่อนเรียกใช้คำสั่งนี้หากจำเป็น มีการแก้ไขคำสั่งนี้ใน API ระดับ 2
พารามิเตอร์
- sessionId: ตัวระบุเซสชันที่ไม่ซ้ำกันซึ่งได้รับจากคำสั่ง
camera.startSession
ช่องนี้เลิกใช้งานแล้วใน API ระดับ 2
ผลลัพธ์
- API ระดับ 1
- fileUri: URI ของรูปภาพที่ถ่ายไว้ ผู้ผลิตจะตัดสินใจว่าจะใช้ URI แบบสัมบูรณ์หรือสัมพัทธ์ เช่น "http://android.com/robots.txt" เป็น URI ที่สมบูรณ์ ส่วน "robots.txt" จะเป็น URI แบบสัมพัทธ์ ไคลเอ็นต์อาจถือว่าข้อมูลนี้เป็นตัวระบุแบบทึบ
- API ระดับ 2
- fileUrl: URL ที่สมบูรณ์ของรูปภาพที่ถ่ายไว้ ซึ่งสามารถใช้เพื่อดาวน์โหลดจากเซิร์ฟเวอร์ HTTP ของกล้องได้โดยตรง โปรดทราบว่าคำสั่งนี้จะไม่แสดงผล
fileUrl
ทันทีเนื่องจากการจับภาพ (รวมถึงการต่อภาพในกล้อง) มักใช้เวลาสักครู่ (แตกต่างกันตั้งแต่วินาทีไปจนถึงนาที) ความคืบหน้าของคำสั่งจะได้รับมาจากการสำรวจกล้องเป็นระยะๆ โดยใช้ API /osc/commands/status และfileUrl
คือผลลัพธ์ที่แสดงเมื่อคำสั่งทำงานเสร็จสิ้น เมื่อdelayProcessing
เป็นจริง จะเป็น URL ที่สมบูรณ์ของรูปภาพตัวอย่างซึ่งสามารถใช้เป็นอินพุตใน processPicture เพื่อประมวลผลรูปภาพได้ ไม่เช่นนั้นก็จะเป็น URL ที่สมบูรณ์ของรูปภาพที่ประมวลผลสุดท้าย
- fileUrl: URL ที่สมบูรณ์ของรูปภาพที่ถ่ายไว้ ซึ่งสามารถใช้เพื่อดาวน์โหลดจากเซิร์ฟเวอร์ HTTP ของกล้องได้โดยตรง โปรดทราบว่าคำสั่งนี้จะไม่แสดงผล
ข้อผิดพลาด
- missingParameters:
sessionId
ขาดหายไป เราเลิกใช้งานรหัสข้อผิดพลาดนี้ใน API ระดับ 2 แล้ว - invalidparameterName: ไม่รู้จักชื่อพารามิเตอร์ เช่น ระบบไม่รู้จัก
sessionId
ใน API ระดับ 2 - invalidParametersValue: ระบบรู้จักชื่อพารามิเตอร์อินพุต แต่ค่าของพารามิเตอร์ไม่ถูกต้อง เช่น ไม่มี
sessionId
ไม่มีการใช้งานอีกต่อไป หรือประเภทข้อมูลไม่ถูกต้อง เราเลิกใช้งานรหัสข้อผิดพลาดนี้ใน API ระดับ 2 แล้ว - disableCommand: คําสั่งปิดใช้อยู่ เช่น กล้องอยู่ในโหมดถ่ายวิดีโอ มีการเพิ่มรหัสข้อผิดพลาดนี้ใน API ระดับ 2
คำสั่ง I/O | |
---|---|
การป้อนข้อมูลด้วยคำสั่ง (API ระดับ 1) | { "parameters": { "sessionId": "12ABC3" } } |
เอาต์พุตคำสั่ง (API ระดับ 1) | { "results": { "fileUri": "file URI" } } |
เอาต์พุตคำสั่ง (ข้อผิดพลาด) (API ระดับ 1) | { "error": { "code": "invalidParameterValue", "message": "Parameter sessionId doesn't exist." } } |
การป้อนข้อมูลด้วยคำสั่ง (API ระดับ 2) | none |
เอาต์พุตคำสั่ง (API ระดับ 2) | { "results": { "fileUrl": "Absolute file URL" } } |
เอาต์พุตคำสั่ง (ข้อผิดพลาด) (API ระดับ 2) | { "error": { "code": "disabledCommand", "message": "Command is currently disabled." } } |