กล้องถ่ายภาพ

ถ่ายภาพทรงกลม พร้อมบันทึกพิกัดละติจูด/ลองจิจูดลงใน 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 ที่สมบูรณ์ของรูปภาพที่ประมวลผลสุดท้าย

ข้อผิดพลาด

  • 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."
    }
}