camera.processPicture

Memproses gambar yang sebelumnya diambil, tetapi belum diproses. Perintah ini hanya relevan jika Anda mendukung delayProcessing karena dan pemrosesannya memakan waktu lama. Jika Anda tidak mendukung delayProcessing, permintaan untuk perintah ini akan gagal dengan kode error disabledCommand. Perintah ini ditambahkan di API level 2.

Parameter

  • previewFileUrls: Daftar URL gambar yang belum diproses. Jika Anda ingin memproses semua gambar yang belum diproses di kamera, prosesnya adalah [“semua”]. Wajib diisi. Jika kamera mengalami masalah saat memproses gambar, kamera tidak merespons dengan pesan error, melainkan harus mengabaikan URL tersebut dan melanjutkan dengan lainnya, dan kasus ekstremnya adalah previewToFinalFileUrls adalah ditampilkan sebagai JSONObject kosong.

Hasil

  • previewToFinalFileUrls: JSONObject dari JSON <key, value=""> pasangannya, dengan setiap kunci adalah URL absolut gambar pratinjau, dan setiap kunci adalah gambar akhir yang diproses dan dapat digunakan untuk mengunduh langsung dari kamera. Perhatikan bahwa perintah ini mirip dengan camera.takePicture, dan tidak menampilkan previewToFinalFileUrls (kecuali untuk kasus sudut yang dijelaskan nanti dalam paragraf ini) karena pemrosesan (termasuk penggabungan dalam kamera) biasanya memerlukan waktu beberapa saat (bervariasi dari detik ke menit) hingga selesai. Mengetahui progres perintah dengan melakukan polling kamera secara berkala menggunakan API /osc/commands/status dan previewToFinalFileUrls adalah hasil yang ditampilkan saat perintah hingga akhir. Jika koneksi ke kamera terputus sebelum perintah selesai, klien dapat menggunakan listFiles untuk mendapatkan URL gambar akhir saat terhubung ke kamera lagi atau mengeluarkan perintah processPicture lain, yang akan mengembalikan previewToFinalFileUrls segera jika gambar sudah diproses sebelum penyambungan kembali.</key,>

Error

  • disableCommand: Jika Anda tidak mendukung pemrosesan penundaan.
  • invalidParameterName: Nama parameter input adalah tidak dikenal.
  • invalidParameterValue: Nama parameter input adalah dikenali, tetapi nilainya tidak valid; misalnya, setiap URL di previewFileUrls tidak valid.

I/O Perintah
Input Perintah 
{
    "parameters": {
        "previewFileUrls": [
            "previewFileUrl1",
            "previewFileUrl2",
            "previewFileUrl3",
            ...
            "previewFileUrln"
        ]
    }
}
Output Perintah 
{
    "results": {
        "previewToFinalFileUrls":{
            "previewFileUrl1": "finalFileUrl1",
            "previewFileUrl2": "finalFileUrl2",
            "previewFileUrl3": "finalFileUrl3",
            ...
            "previewFileUrln": "finalFileUrln"
        }
    }
}
Output Perintah (Error) 
{
    "error": {
        "code": "disabledCommand",
        "message": "Command is currently disabled."
    }
}