資訊

/osc/info API 會傳回相機和功能的基本資訊 Kubernetes 環境

輸入

  • 這個指令不接收任何輸入內容，

輸出

名稱 類型 說明
manufacturer 字串 相機製造商。
model 字串 相機模型。
serialNumber 字串 序號。
firmwareVersion 字串 目前韌體版本。
supportUrl 字串 攝影機支援網頁網址。
gps 布林值 如果相機有 GPS 功能，則為「true」。
gyro 布林值 如果相機有陀螺儀，則為「true」。
uptime 整數 相機開機後經過的秒數。
api 字串陣列 支援的 API 清單。
endpoints 物件 內含相機端點相關資訊的 JSON 物件。請參閱下一個表格。
apiLevel 整數陣列 缺少這個欄位時，系統預設會使用 [1]。[1, 2] 代表 API 1 和 2 兩者皆受支援，而 [2] 代表僅支援 API 2。開發人員有責任擷取這項資訊，並根據值以不同方式導入。這個欄位已新增至 API 級別 2。如果支援 API 2.1，請一併使用 2。
cameraId 字串 代表攝影機的專屬 ID。這個欄位已在 API 級別 2.1 中新增，與直接上傳相關。
_vendorSpecific 類型 供應商的特定相機資訊。請在供應商專屬鍵前面加上底線 ( _ )，以免命名空間發生衝突。

endpoints 個物件

這個 JSON 物件提供相機用於端點的通訊埠資訊。

注意：HTTPS 端點為選用項目。

名稱 類型 說明
httpPort 整數 HTTP 伺服器的通訊埠。(預設值為 80)。
httpUpdatesPort 整數 透過 HTTP 接收更新的通訊埠
httpsPort 整數 (選用) HTTPs 伺服器的通訊埠。(預設值為 443)。
httpsUpdatesPort 整數 (選用) 透過 HTTPS 接收更新的通訊埠。

錯誤

  • 這個指令未傳回任何錯誤。

範例
要求 
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"
        ]
}