หน้านี้ได้รับการแปลโดย Cloud Translation API

ข้อมูล

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

อินพุต

คําสั่งนี้ไม่อินพุต

เอาต์พุต

ชื่อ	ประเภท	คำอธิบาย
`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 เป็นตัวเลือกที่ไม่บังคับ

ชื่อ	ประเภท	คำอธิบาย
`httpPort`	จำนวนเต็ม	พอร์ตสำหรับเซิร์ฟเวอร์ HTTP (ค่าเริ่มต้น 80)
`httpUpdatesPort`	จำนวนเต็ม	พอร์ตเพื่อรับการอัปเดตผ่าน HTTP
`httpsPort`	จำนวนเต็ม	(ไม่บังคับ) พอร์ตสำหรับเซิร์ฟเวอร์ HTTPs (ค่าเริ่มต้น 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" ] }

ตัวอย่าง

คำขอ

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"
        ]
}