ข้อมูล

/osc/info API จะแสดงข้อมูลพื้นฐานเกี่ยวกับกล้องและฟังก์ชันที่รองรับ

อินพุต

  • คำสั่งนี้ไม่รับอินพุต

เอาต์พุต

ชื่อ Type คำอธิบาย
manufacturer สตริง ผู้ผลิตกล้อง
model สตริง รุ่นของกล้อง
serialNumber สตริง หมายเลขซีเรียล
firmwareVersion สตริง เฟิร์มแวร์เวอร์ชันปัจจุบัน
supportUrl สตริง URL ของหน้าเว็บสนับสนุนของกล้อง
gps บูลีน เป็นจริงหากกล้องมี GPS
gyro บูลีน เป็นจริงหากกล้องมีเครื่องวัดการหมุน
uptime จำนวนเต็ม จำนวนวินาทีตั้งแต่เปิดกล้อง
api อาร์เรย์สตริง รายการ API ที่รองรับ
endpoints ออบเจ็กต์ ออบเจ็กต์ JSON ที่มีข้อมูลเกี่ยวกับปลายทางของกล้อง ดูตารางถัดไป
apiLevel อาร์เรย์จำนวนเต็ม และจะเป็น [1] โดยค่าเริ่มต้น เมื่อไม่มีช่องนี้ [1, 2] แสดงถึงทั้ง API 1 และ 2 ได้รับการรองรับ ในขณะที่ [2] แสดงถึงการรองรับ API 2 เท่านั้น นักพัฒนาแอปมีหน้าที่รับผิดชอบในการดึงข้อมูลนี้และใช้งานที่แตกต่างออกไปตามค่า มีการเพิ่มช่องนี้ใน API ระดับ 2 โปรดใช้ 2 ด้วยหากคุณรองรับ API 2.1
cameraId สตริง รหัสที่ไม่ซ้ำกันซึ่งแสดงถึงกล้อง มีการเพิ่มช่องนี้ในระดับ API 2.1 และเกี่ยวข้องกับการอัปโหลดโดยตรง
_vendorSpecific ประเภท ข้อมูลเพิ่มเติมที่เจาะจงเกี่ยวกับกล้องของผู้ให้บริการ โปรดใส่เครื่องหมายขีดล่าง ( _ ) นำหน้าคีย์เฉพาะผู้ให้บริการ เพื่อไม่ให้เนมสเปซขัดแย้งกัน

วัตถุ endpoints รายการ

ออบเจ็กต์ JSON นี้ให้ข้อมูลเกี่ยวกับพอร์ตที่กล้องใช้สำหรับปลายทาง

หมายเหตุ: ปลายทาง HTTPS เป็นตัวเลือกที่ไม่บังคับ

ชื่อ Type คำอธิบาย
httpPort จำนวนเต็ม พอร์ตสำหรับเซิร์ฟเวอร์ HTTP (ค่าเริ่มต้น 80)
httpUpdatesPort จำนวนเต็ม พอร์ตเพื่อรับการอัปเดตผ่าน HTTP
httpsPort จำนวนเต็ม (ไม่บังคับ) พอร์ตสำหรับเซิร์ฟเวอร์ HTTP (ค่าเริ่มต้น 443)
httpsUpdatesPort จำนวนเต็ม (ไม่บังคับ) พอร์ตเพื่อรับการอัปเดตผ่าน HTTP

ข้อผิดพลาด

  • คำสั่งนี้ไม่แสดงข้อผิดพลาด

ตัวอย่าง
คำขอ 
GET /osc/info HTTP/1.1
Host: [camera ip address]:[httpPort]
Accept: application/json
X-XSRF-Protected: 1
การตอบกลับ (API 2) 
HTTP/1.1 200 OK
Content-Type: application/json;charset=utf-8
Content-Length: {CONTENT_LENGTH}
X-Content-Type-Options: nosniff

{
        "manufacturer": "AAA",
        "model": "BBB",
        "serialNumber": "CCC",
        "firmwareVersion": "DDD",
        "supportUrl": "EEE",
        "endpoints": {
            "httpPort": 80,
            "httpUpdatesPort": 10080,
            ...
        },
        "gps": true,
        "gyro": false,
        "uptime": 600,
        "api": [
            "/osc/info",
            "/osc/state",
            "/osc/checkForUpdates",
            "/osc/commands/execute",
            "/osc/commands/status"
        ],
        "apiLevel": [1, 2]
}
การตอบกลับ (API 1) 
HTTP/1.1 200 OK
Content-Type: application/json;charset=utf-8
Content-Length: {CONTENT_LENGTH}
X-Content-Type-Options: nosniff

{
        "manufacturer": "AAA",
        "model": "BBB",
        "serialNumber": "CCC",
        "firmwareVersion": "DDD",
        "supportUrl": "EEE",
        "endpoints": {
            "httpPort": 80,
            "httpUpdatesPort": 10080,
            ...
        },
        "gps": true,
        "gyro": false,
        "uptime": 600,
        "api": [
            "/osc/info",
            "/osc/state",
            "/osc/checkForUpdates",
            "/osc/commands/execute",
            "/osc/commands/status"
        ]
}