camera.takePicture

Mengambil gambar equirectangular, menyimpan koordinat lintang/bujur ke EXIF (jika kamera Anda memiliki fitur GPS atau GPS sendiri yang diaktifkan saat ponsel). Telepon camera.setOptions sebelum panggilan perintah ini jika diperlukan. Perintah ini diubah di API level 2.

Parameter

  • sessionId: ID sesi unik yang diperoleh dari camera.startSession . Kolom ini tidak digunakan lagi di API level 2.

Hasil

  • Level API 1
    • fileUri: URI gambar yang diambil. Produsen memutuskan apakah akan menggunakan URI absolut atau relatif; misalnya, "http://android.com/robots.txt" adalah URI absolut jika "robots.txt" adalah URI relatif. Klien dapat menangani sebagai ID buram.
  • Level API 2
    • fileUrl: URL absolut dari gambar yang diambil, yang dapat digunakan untuk mengunduh secara langsung dari server HTTP kamera. Memohon perhatikan bahwa perintah ini tidak segera menampilkan fileUrl karena pengambilan gambar (termasuk penggabungan dalam kamera) biasanya memerlukan waktu (bervariasi dari detik hingga menit) untuk menyelesaikan prosesnya. Progres perintah diperoleh dengan lakukan polling kamera secara berkala menggunakan API /osc/commands/status dan fileUrl adalah hasil yang ditampilkan saat perintah selesai. Kapan delayProcessing benar, ini adalah URL absolut pratinjau gambar, yang dapat digunakan sebagai input dalam processPicture untuk memproses gambar, jika tidak, gambar tersebut adalah URL absolut dari gambar akhir yang diproses.

Error

  • missingParameter: sessionId tidak ada. Kode error ini sudah tidak digunakan lagi di API level 2.
  • invalidParameterName: Nama parameter tidak dikenal, misalnya sessionId tidak dikenali di API level 2.
  • invalidParameterValue: Nama parameter input dikenali, tetapi nilainya tidak valid; misalnya, sessionId tidak ada, tidak lagi aktif, atau tipe datanya salah. Kode error ini sudah tidak digunakan lagi di API level 2.
  • dinonaktifkanCommand: Perintah saat ini dinonaktifkan; misalnya, kamera dalam mode perekaman video. Kode error ini ditambahkan di API level 2.

I/O Perintah
Input Perintah (API level 1) 
{
    "parameters": {
        "sessionId": "12ABC3"
    }
}
Output Perintah (API level 1) 
{
    "results": {
        "fileUri": "file URI"
    }
}
Output Perintah (Error) (API level 1) 
{
    "error": {
        "code": "invalidParameterValue",
        "message": "Parameter sessionId doesn't exist."
    }
}
Input Perintah (API level 2) 
none
Output Perintah (API level 2) 
{
    "results": {
        "fileUrl": "Absolute file URL"
    }
}
Output Perintah (Error) (API level 2) 
{
    "error": {
        "code": "disabledCommand",
        "message": "Command is currently disabled."
    }
}