情報

/osc/info API は、カメラと機能に関する基本情報を返します。 サポートしています。

入力

  • このコマンドは入力を受け取りません。

出力

名前 型 説明
manufacturer 文字列 カメラのメーカー。
model 文字列 カメラのモデル。
serialNumber 文字列 シリアル番号。
firmwareVersion 文字列 現在のファームウェア バージョン。
supportUrl 文字列 カメラのサポート ウェブページの URL。
gps ブール値 カメラに GPS が搭載されている場合は true です。
gyro ブール値 カメラにジャイロスコープがある場合は true。
uptime Integer カメラが起動してからの秒数。
api 文字列配列 サポートされている API のリスト。
endpoints オブジェクト カメラのエンドポイントに関する情報を含む JSON オブジェクト。次の表をご覧ください。
apiLevel 整数配列 このフィールドがない場合のデフォルトは [1] です。[1, 2] は API 1 と API 2 の両方がサポートされていることを示し、[2] は API 2 のみがサポートされていることを表します。デベロッパーは、この情報を取得し、値に応じて異なる実装を行う責任があります。このフィールドは API レベル 2 で追加されました。また、API 2.1 をサポートしている場合は 2 を使用してください。
cameraId 文字列 カメラを表す一意の ID。このフィールドは API レベル 2.1 で追加され、直接アップロードに関連するものです。
_vendorSpecific type カメラに関するベンダー固有の追加情報。名前空間の競合を避けるため、ベンダー固有のキーは先頭にアンダースコア（_）を付けてください。

endpoints オブジェクト

この JSON オブジェクトは、カメラがエンドポイントに使用するポートに関する情報を提供します。

注: HTTPS エンドポイントは省略可能です。

名前 型 説明
httpPort Integer HTTP サーバーのポート。（デフォルトは 80）。
httpUpdatesPort Integer HTTP 経由で更新を受信するポート
httpsPort Integer （省略可）HTTPS サーバーのポート。（デフォルトは 443）。
httpsUpdatesPort Integer （省略可）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"
        ]
}