Info

/osc/info API menampilkan informasi dasar tentang kamera dan fungsi yang didukungnya.

Input

  • Perintah ini tidak mengambil input.

Output

Nama Jenis Deskripsi
manufacturer String Produsen kamera.
model String Model kamera.
serialNumber String Nomor seri.
firmwareVersion String Versi firmware saat ini.
supportUrl String URL untuk halaman web dukungan kamera.
gps Boolean True jika kamera dilengkapi GPS.
gyro Boolean Benar jika kamera dilengkapi Giroskop.
uptime Bilangan Bulat Jumlah detik sejak kamera melakukan booting.
api Array String Daftar API yang didukung.
endpoints Objek Objek JSON yang berisi informasi tentang endpoint kamera. Lihat tabel berikutnya.
apiLevel Array Bilangan Bulat Nilainya [1] secara default jika kolom ini tidak ada. [1, 2] menyatakan API 1 dan 2 didukung sedangkan [2] menyatakan hanya API [2] yang didukung. Developer bertanggung jawab untuk mengambil informasi ini dan mengimplementasikannya secara berbeda berdasarkan nilai. Kolom ini ditambahkan di API level 2. Gunakan juga 2 jika Anda mendukung API 2.1.
cameraId String ID unik yang mewakili kamera. Kolom ini ditambahkan di API level 2.1 dan relevan dengan Upload Langsung.
_vendorSpecific jenis Info tambahan khusus vendor tentang kamera. Awali kunci khusus vendor dengan garis bawah ( _ ) untuk menghindari konflik namespace.

Objek endpoints

Objek JSON ini memberikan informasi tentang port yang digunakan kamera untuk endpoint.

Catatan: Endpoint HTTPS bersifat opsional.

Nama Jenis Deskripsi
httpPort Bilangan Bulat Porta untuk server HTTP. (Default 80)
httpUpdatesPort Bilangan Bulat Port untuk menerima update melalui HTTP
httpsPort Bilangan Bulat (Opsional) Port untuk server HTTP. (Default 443)
httpsUpdatesPort Bilangan Bulat (Opsional) Port untuk menerima update melalui HTTP.

Error

  • Perintah ini tidak menampilkan error.

Contoh
Permintaan 
GET /osc/info HTTP/1.1
Host: [camera ip address]:[httpPort]
Accept: application/json
X-XSRF-Protected: 1
Respons (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]
}
Respons (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"
        ]
}