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

จับภาพทรงกลม บันทึกพิกัดละติจูด/ลองจิจูด เป็น EXIF (หากกล้องของคุณใช้ GPS หรือ GPS ของตัวกล้องเองขณะเปิดใช้งาน โทรศัพท์มือถือ) โทรติดต่อ camera.setOptions ก่อนการเรียกคำสั่งนี้ หากจำเป็น มีการแก้ไขคำสั่งนี้ใน API ระดับ 2

พารามิเตอร์

  • sessionId: ตัวระบุเซสชันที่ไม่ซ้ำที่ได้จากพารามิเตอร์ camera.startSession เลิกใช้งานช่องนี้ใน API ระดับ 2 แล้ว

ผลลัพธ์

  • API ระดับ 1
    • fileUri: URI ของรูปภาพที่จับภาพไว้ ผู้ผลิต ตัดสินใจว่าจะใช้ URI แบบสัมบูรณ์หรือสัมพัทธ์ ตัวอย่างเช่น "http://android.com/robots.txt" เป็น Absolute URI ขณะที่ "robots.txt" เป็น URI แบบสัมพัทธ์ ลูกค้าอาจปฏิบัติต่อ เพราะเป็นตัวระบุแบบทึบ
  • API ระดับ 2
    • fileUrl: URL ที่สมบูรณ์ของรูปภาพที่จับภาพ ซึ่งสามารถ จะใช้เพื่อดาวน์โหลดจากเซิร์ฟเวอร์ HTTP ของกล้องโดยตรง โปรด โปรดทราบว่าคำสั่งนี้จะไม่แสดงผล fileUrl ในทันทีตั้งแต่ การถ่ายภาพ (รวมถึงการต่อภาพในกล้องถ่ายรูป) จะใช้เวลาสักครู่ (แตกต่างกันไปตาม วินาทีถึงนาที) จึงจะเสร็จสมบูรณ์ ระบบรวบรวมความคืบหน้าของคําสั่งได้โดย สำรวจกล้องเป็นระยะๆ โดยใช้ /osc/commands/status API และ fileUrl คือผลลัพธ์ที่แสดงเมื่อคำสั่งเสร็จสิ้น วันและเวลา delayProcessing เป็นจริง ซึ่งเป็น URL ที่สมบูรณ์ของตัวอย่าง รูปภาพ ซึ่งสามารถใช้เป็นอินพุตในรูปการประมวลผลเพื่อประมวลผลรูปภาพ ไม่เช่นนั้นก็จะเป็น URL ที่สมบูรณ์ของรูปภาพสุดท้ายที่ประมวลผล

ข้อผิดพลาด

  • missingParameters: sessionId ขาดหายไป เราเลิกใช้งานรหัสข้อผิดพลาดนี้ใน API ระดับ 2 แล้ว
  • invalidParametersName: ระบบไม่รู้จักชื่อพารามิเตอร์ เช่น ไม่รู้จัก sessionId ใน API ระดับ 2
  • invalidParameterValue: ระบบจดจำชื่อพารามิเตอร์ที่ป้อนได้ แต่ค่าของ URL ไม่ถูกต้อง ตัวอย่างเช่น sessionId ไม่มีอยู่ ไม่มีการใช้งานอีกต่อไป หรือประเภทข้อมูลไม่ถูกต้อง เราเลิกใช้งานรหัสข้อผิดพลาดนี้ใน API ระดับ 2 แล้ว
  • disableCommand: ปิดใช้คำสั่งอยู่ในขณะนี้ ตัวอย่างเช่น กล้องอยู่ในโหมดถ่ายวิดีโอ เพิ่มรหัสข้อผิดพลาดนี้ใน API ระดับ 2

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