Opsi

Tabel berikut menampilkan semua opsi yang tersedia untuk ditetapkan dan didapatkan menurut camera.setOptions dan camera.getOptions. Opsi tidak dapat diubah jika dukungan yang sesuai kosong atau hanya berisi satu opsi.

Nama Jenis Deskripsi Baca/Tulis
captureMode String Mode pengambilan saat ini. Nilai default-nya adalah image. rw
captureModeSupport Array String Daftar mode pengambilan saat ini tersedia. Persyaratan minimum untuk level API 1 adalah ["image"], dan persyaratan minimum untuk level API 2 adalah ["image", "interval"], dengan "interval" mewakili mode pengambilan serangkaian gambar yang berjarak pada interval tertentu, lihat juga captureInterval dan captureIntervalSupport. Dua mode tambahan ("video" and "walkaround") didukung oleh API level 2, sehingga set lengkap yang didukung oleh API level 2 adalah ["image", "interval", "video", "walkaround"], dengan "video" mewakili mode perekaman video dan "walkaround" mewakili mode pengambilan dua gambar secara berurutan, yang pertama dengan pengguna berdiri di mana saja relatif terhadap kamera dan yang kedua dengan pengguna berdiri di sisi berlawanan (relatif terhadap titik berdiri pertama) kamera. Ini memungkinkan kamera untuk menghapus pengguna dari gambar akhir dengan menggabungkan dua gambar tersebut. Jika "walkaround" didukung oleh kamera dan disetel menjadi mode pengambilan saat ini, klien akan mengirim dua perintah TakePicture ke kamera, dengan respons perintah pertama (saat selesai) menunjukkan kamera siap mengambil gambar kedua, sementara perintah kedua akan menampilkan gambar akhir setelah selesai.

Untuk menambahkan lebih banyak mode pengambilan yang belum didukung, awali mode khusus vendor dengan garis bawah ( _ ).

Opsi ini diubah di API level 2.

 r
captureStatus String Status tangkapan saat ini. Nilai defaultnya adalah "idle". Hal ini berguna untuk menentukan status kamera saat pertama kali terhubung ke aplikasi. Jika kamera sedang merekam video, kamera mungkin perlu dihentikan sebelum diperintahkan untuk melakukan hal lain, misalnya perekaman video lainnya.

Opsi ini ditambahkan di API level 2.1.

 rw
captureStatusSupport Array String Daftar status pengambilan yang saat ini tersedia; Secara default, nilainya harus ["idle", "shooting"] jika perekaman video didukung. Patung lain juga dapat disediakan, misalnya "downloading".

Opsi ini ditambahkan di API level 2.1.

 r
exposureProgram Angka Program eksposur saat ini. rw
exposureProgramSupport Array Angka Daftar program eksposur yang saat ini tersedia; misalnya [0, 1, 2, 3, 4]. Setiap bilangan bulat mewakili program eksposur yang berbeda:
  • 0 = Tidak ditentukan
  • 1 = Manual
  • 2 = Program normal
  • 3 = Prioritas bukaan
  • 4 = Prioritas shutter
Pilih link berikut untuk mendownload detail lebih lanjut tentang ExposureProgram. 		r
iso Angka Setelan kecepatan ISO saat ini. rw
isoSupport Array Angka

API level 1: Daftar setelan ISO yang saat ini tersedia; misalnya, [100, 200, 400, 800,1600] atau [] saat berada dalam mode auto.

API level 2: Daftar setelan ISO yang tersedia saat ini; misalnya [0, 100, 200, 400, 800, 1600], dengan 0 merepresentasikan mode auto.

Opsi ini diubah di API level 2.

 r
shutterSpeed Angka Setelan kecepatan shutter saat ini. rw
shutterSpeedSupport Array Angka

API level 1: Daftar kecepatan shutter yang tersedia saat ini; misalnya, [0.067, 0.033, 0.017,0.008] atau [] saat berada dalam mode auto.

API level 2: Daftar kecepatan shutter yang tersedia saat ini; misalnya [0, 0.067, 0.033, 0.017, 0.008], dengan 0 merepresentasikan mode auto.

Opsi ini diubah di API level 2.

 r
aperture Angka Setelan bukaan saat ini, dalam f-stop. rw
apertureSupport Array Angka

API level 1: Daftar setelan bukaan yang saat ini tersedia, yang dinyatakan dalam f/number; untuk misalnya, [1.4, 2, 2.8, 4, 5.6, 8, 11] atau [] saat dalam mode auto.

API level 2: Daftar setelan bukaan yang saat ini tersedia, yang dinyatakan dalam f/number; misalnya, [0, 1.4, 2, 2.8, 4, 5.6, 8, 11], dengan 0 mewakili mode auto.

 r
whiteBalance String Setelan white balance saat ini; misalnya daylight. Nilai defaultnya adalah auto. rw
whiteBalanceSupport Array String Daftar setelan white balance yang tersedia saat ini, dapat berupa bagian dari daftar standar:[ "auto", "incandescent", "fluorescent", "daylight", "cloudy-daylight", "shade", "twilight"]. Nilai untuk setiap panggilan:
  • incandescent, sekitar 3.200 ribu
  • fluorescent, sekitar 4.000 ribu
  • datalight, sekitar 5.200 ribu
  • cloudy-daylight, sekitar 6.000 ribu
  • shade, sekitar 7.000 ribu
  • twilight, sekitar 12.000 ribu
Memberi awalan pada nama setelan khusus vendor dengan garis bawah; misalnya: _vendor-setting		 r
exposureCompensation Angka Kompensasi eksposur saat ini. rw
exposureCompensationSupport Array Angka Daftar kompensasi eksposur yang saat ini tersedia, biasanya di langkah 0.33 atau 0,5; misalnya: [-1, -0.67, -0.33, 0, 0.33, 0.67, 1] r
fileFormat Objek

Jenis file dan resolusi saat ini. Format ini harus mencerminkan nilai captureMode saat ini. Misalnya, jika captureMode adalah image, respons yang sesuai dapat berupa:

{
    "type": "jpeg",
    "width": 2000,
    "height": 1000
}
Jika captureMode adalah video, respons yang sesuai dapat berupa: 
{
    "type": "mp4",
    "width": 1920,
    "height": 1080,
    "framerate": 30
}

Opsi ini diubah di API level 2.

 rw
fileFormatSupport Array Objek

Daftar format file yang saat ini tersedia; misalnya:

[
    {
    "type": "jpeg",
    "width": 2000,
    "height": 1000
    },
    {
    "type": "jpeg",
    "width": 200,
    "height": 100
    },
    {
    "type": "mp4",
    "width": 1920,
    "height": 1080,
    "framerate": 24
    },
    {
    "type": "mp4",
    "width": 1280,
    "height": 720,
    "framerate": 30
    },
    ...
]
Pilih link berikut untuk informasi selengkapnya tentang semua jenis.

Opsi ini diubah di API level 2.

 r
exposureDelay Angka Penundaan saat ini antara perintah takePicture dan saat eksposur dimulai, dalam detik. rw
exposureDelaySupport Array Angka Daftar penundaan eksposur yang saat ini tersedia, dalam detik; misalnya: [0, 1, 2, 5, 10, 30, 60] r
sleepDelay Angka Penundaan saat ini sebelum kamera beralih ke mode tidur, dalam detik. rw
sleepDelaySupport Array Angka Daftar penundaan tidur yang saat ini tersedia, dalam detik; misalnya, [30, 60, 120, 300, 600, 1800, 65535], jika 65535 menonaktifkan mode tidur (kamera tidak akan tidur hingga dimatikan) dan harus didukung. r
offDelay Angka Penundaan saat ini dalam detik sebelum kamera mati. rw
offDelaySupport Array Angka Daftar penundaan saat mematikan daya yang saat ini tersedia, dalam detik; misalnya, [1800, 3600, 7200, 65535], jika 65535 menonaktifkan mode matikan (kamera tidak akan dimatikan hingga baterai habis atau dimatikan secara manual) dan harus didukung. r
totalSpace Angka Hanya baca: Jumlah byte dari penyimpanan total. r
remainingSpace Angka Hanya baca: Jumlah byte penyimpanan gratis. r
remainingPictures Angka Hanya baca: Perkiraan jumlah gambar yang tersisa berdasarkan pengambilan saat ini deskripsi tempat. r
gpsInfo Objek

Informasi GPS saat ini. Setel menggunakan setOptions menggunakan GPS ponsel:

{
    "lat": 23.532,
    "lng": -132.35
}
Properti lat dan lng adalah derajat desimal, dengan lat dalam rentang, [-90, 90], dan lng dalam rentang, [-180, 180]. Jika disediakan oleh ponsel, perhatikan bahwa setiap lokasi GPS hanya valid sampai pembaruan berikutnya dari ponsel. Ponsel harus menentukan waktu untuk mengupdate lokasi GPS; misalnya, tepat sebelum setiap perintah takePicture. 65535 memberi tahu kamera bahwa lokasi GPS saat ini tidak valid dan kamera harus mengabaikannya dan menggunakan GPS-nya sendiri jika ada; misalnya, setOptions({"gpsInfo": {"lat": 65535, "lng": 65535}}) berarti lokasi GPS adalah tidak valid.		 rw
dateTimeZone String Informasi tanggal dan waktu saat ini. Ditetapkan oleh setOptions menggunakan tanggal, waktu, dan zona waktu ponsel. Formatnya adalah YYYY:MM:DD HH:MM:SS+(-)HH:MM. Waktu dalam format 24 jam, tanggal dan waktu dipisahkan oleh spasi kosong, zona waktu andtime adalah selisih dari waktu UTC; misalnya, 2014:05:18 01:04:29+8:00 adalah Zona Waktu China (UTC+8:00) rw
hdr

API level 1: Boolean

API level 2: String

API level 1: Mengaktifkan/menonaktifkan mode pengambilan HDR. Nilainya true untuk mengaktifkan HDR, atau false untuk menonaktifkannya. Nilai defaultnya adalah false. Setelan dapat berupa true hanya jika hdrSupport juga true.

API level 2: Mode HDR saat ini dari jenis String.

Opsi ini diubah di API level 2.

 rw
hdrSupport

API level 1: Boolean

API level 2: Array String

API level 1: Nilai true menunjukkan bahwa kamera mendukung HDR. Setelan false mengidentifikasi kamera tanpa HDR.

API level 2: Jika Anda tidak mendukung mode HDR, [“off”]; jika Anda mendukung satu mode HDR, nilainya adalah [“off”, “hdr”]. Jika beberapa mode HDR (berdasarkan algoritma yang berbeda-beda) didukung, mode tersebut adalah [“off”, “hdr”, “hdr1”, “hdr2”, ...]

Opsi ini diubah di API level 2.

 r
exposureBracket Objek Setelan kurung buka saat ini. Hanya tersedia jika hdrSupport == true (level API 1) atau hdrSupport berisi setidaknya satu mode HDR (level API 2). Jika kamera menggunakan Bracket eksposur manual, objek akan berisi dua entri:
  1. shots, bilangan bulat yang berisi jumlah foto yang akan diambil.
  2. increment, angka yang berisi pertambahan EV di antara pengambilan gambar.
Contoh: 
{
    "shots": 3,
    "increment": 1.33
}
Jika kamera menggunakan kurung eksposur otomatis, objek akan berisi: 
{
    "autoMode": true
}

API level 1: Default ke {} kosong saat hdrSupport == false. Produsen menentukan nilai default (misalnya, kurung eksposur otomatis), jika hdr adalah true.

API level 2: Default ke kosong {} jika hdrSupport hanya berisi "off". Jika tidak, produsen akan menentukan nilai default (misalnya, kurung eksposur otomatis).

Opsi ini diubah di API level 2.

 rw
exposureBracketSupport Objek

Setelan kurung eksposur saat ini tersedia; misalnya:

{
    "autoMode": true,
    "shotsSupport": [1, 3, 5, 7],
    "incrementSupport": [0.33, 0.67, 1, 1.33, 1.67, 2]
}

API level 1: Default ke {} kosong jika hdrSupport == false. Jika hdrSupport == true, tetapi kurung siku eksposur otomatis tidak didukung, autoMode akan menjadi false.

API level 2: Default ke {} kosong jika hdrSupport hanya berisi "off". Jika hdrSupport berisi mode HDR, tetapi kurungan eksposur otomatis tidak didukung, autoMode akan menjadi false.

Opsi ini diubah di API level 2.

 r
gyro Boolean Tetapkan ke true untuk mengaktifkan modul giroskop kamera, atau false untuk menonaktifkan fitur ini. Nilai default-nya adalah true jika kamera mendukungnya, atau false jika tidak. Setelan ini hanya dapat true jika gyroSupport == true. rw
gyroSupport Boolean Jika kamera memiliki giroskop, nilai ini harus true, jika tidak, false. r
gps Boolean Mengaktifkan/menonaktifkan modul GPS kamera. Nilai harus true untuk mengaktifkan, atau false untuk menonaktifkan. Nilai defaultnya adalah true jika kamera mendukungnya, jika tidak, false. Setelan true hanya jika gpsSupport == true. rw
gpsSupport Boolean Nilai ini harus true jika kamera memiliki modul GPS sendiri, jika tidak, false. r
imageStabilization String Operasi stabilisasi gambar saat ini; misalnya off. rw
imageStabilizationSupport Array String Opsi stabilisasi gambar saat ini tersedia. Daftar yang ditentukan sebelumnya adalah ["off", "on"].Jika kamera tidak mendukung stabilisasi gambar, tampilkan ["off"], atau tampilkan ["off", "on"]. Awali string khusus vendor dengan garis bawah ( _ ); misalnya [ "off", "_horizontal_stabilization", "_vibration_correction" ]. r
wifiPassword String
Panjangnya minimal 8 karakter, berisi huruf, angka, simbol, tetapi tanpa spasi. Itu hanya dapat diubah saat kamera terhubung ke perangkat klien. Setelah diubah, koneksi kamera harus terputus sehingga pengguna harus terhubung kembali menggunakan wifiPassword baru.
Kamera harus menyediakan mekanisme reset untuk berjaga-jaga jika sandi terlupakan; misalnya, tombol {i>reset<i} untuk memulihkan {i>password<i} ke setelan pabrik.
 w
previewFormat Objek

Resolusi pratinjau langsung saat ini; misalnya:

{
    "width": 640,
    "height": 320,
    "framerate": 24
}

Opsi ini ditambahkan di API level 2.

 rw
previewFormatSupport Array Objek

Format pratinjau langsung yang saat ini didukung; misalnya:

[
    {
    "width": 640,
    "height": 320,
    "framerate": 24
    },
    ...
    {
    "width": 1280,
    "height": 720,
    "framerate": 24
    }
]

Opsi ini ditambahkan di API level 2.

 r
captureInterval Angka Interval saat ini antara pengambilan dua gambar berturut-turut, dalam seconds.

Opsi ini ditambahkan di API level 2.

 rw
captureIntervalSupport Objek

Interval minimum dan maksimum yang diizinkan antara pengambilan dua gambar berturut-turut, dalam detik; misalnya:

{
    "minInterval": 10,
    "maxInterval": 60
}
Ini dapat bervariasi bergantung pada fileFormat.

Opsi ini ditambahkan di API level 2.

 r
captureNumber Angka Jumlah gambar yang akan diambil untuk satu sesi pengambilan interval. Default-nya adalah 0, yang berarti perekaman harus dihentikan secara eksplisit oleh perintah stopCapture; jika tidak, pengambilan gambar akan berhenti secara otomatis setelah mengambil gambar dari angka yang ditentukan. Pengambilan gambar juga dapat terganggu saat kamera kehabisan baterai atau saat sengaja dimatikan.

Opsi ini ditambahkan di API level 2.

 rw
captureNumberSupport Objek

Jumlah minimum dan maksimum gambar yang dapat diambil selama pengambilan interval; misalnya:

{
    "minNumber": 2,
    "maxNumber": 50
}
Mungkin berubah bergantung pada penyimpanan yang tersisa.

Opsi ini ditambahkan di API level 2.

 r
remainingVideoSeconds Angka Perkiraan jumlah seconds untuk video yang tersisa berdasarkan setelan perekaman saat ini.

Opsi ini ditambahkan di API level 2.

 r
pollingDelay Angka Interval minimum dalam detik antara dua permintaan polling status berturut-turut. Klien harus menggunakan kolom ini untuk memandu perilaku polling status mereka; misalnya, saat sedang menjahit gambar, klien mungkin perlu melakukan polling pada kamera secara berkala untuk melihat apakah sudah selesai digabungkan. Kamera yang berbeda memiliki dukungan yang berbeda; misalnya, beberapa kamera dapat menangani polling status setiap satu detik sementara yang lain mendukung interval yang lebih panjang.

Opsi ini ditambahkan di API level 2.

 r
delayProcessing Boolean True saat pemrosesan (misalnya penggabungan) memiliki prioritas yang lebih rendah daripada pengambilan, atau dengan kata lain, pengambilan lain diizinkan sebelum pemrosesan gambar yang diambil sebelumnya selesai. Hal ini sangat disarankan, terutama untuk kamera yang memerlukan waktu pemrosesan lama.

Opsi ini ditambahkan di API level 2.

 rw
delayProcessingSupport Array Boolean

[true] berarti pemrosesan (misalnya penggabungan) memiliki prioritas yang lebih rendah daripada pengambilan, dan selalu tertunda secara default.

[false] berarti pemrosesan terjadi langsung setelah pengambilan gambar.

[true, false] berarti ada pilihan di antara dua mode ini.

Opsi ini ditambahkan di API level 2.

 r
clientVersion Angka

Level API yang diputuskan untuk digunakan klien. Nilai defaultnya adalah 1 jika kamera mendukung API level 1 dan 2 sehingga klien yang menulis API level 1 masih berfungsi dengan kamera tanpa perubahan apa pun; bawaan ke 2 jika kamera hanya mendukung level API 2, sebelum klien bermigrasi ke level API 2. Jika kamera hanya mendukung API level 2, permintaan yang mencoba mengaturnya ke 1 harus gagal. Jika clientVersion berhasil disetel ke 2 dan a yang tidak digunakan lagi dari API level 1 diminta, permintaan ini akan gagal dengan kode error unknownCommand.

Opsi ini ditambahkan di API level 2.

 rw
photoStitchingSupport Array String

Daftar opsi penggabungan foto. Kembali [ondevice] jika foto selalu dijahit di kamera, [none] jika kamera tidak dapat menggabungkan foto, dan [none,ondevice] jika penggabungan dapat dikonfigurasi pengguna. Awali nama setelan khusus vendor dengan garis bawah, mis. _vendor-setting.

Opsi ini ditambahkan di API level 2.1.

 r
photoStitching String

Opsi penggabungan saat ini untuk foto, misalnya ondevice. Nilai default-nya adalah ondevice jika didukung.

Opsi ini ditambahkan di API level 2.1.

 rw
videoStitchingSupport Array String

Daftar opsi penggabungan untuk video. Kembali [ondevice] jika video selalu digabungkan di kamera, [none] jika kamera tidak dapat menggabungkan video, dan [none,ondevice] jika penggabungan dapat dikonfigurasi pengguna. Awali nama setelan khusus vendor dengan garis bawah, mis. _vendor-setting.

Opsi ini ditambahkan di API level 2.1.

 r
videoStitching String

Opsi penggabungan saat ini untuk video, misalnya ondevice. Nilai default-nya adalah ondevice jika didukung.

Opsi ini ditambahkan di API level 2.1.

 rw
videoGPSSupport Array String

Daftar opsi GPS selama perekaman video. Kembali [continuous] jika kamera dapat terus merekam GPS selama perekaman video dan menyematkan lokasi dalam video. Kembali [none] jika tidak bisa dan [none,continuous] jika dukungan GPS video dapat dikonfigurasi oleh pengguna. Awalan khusus vendor mengatur nama dengan garis bawah, mis. _vendor-setting.

Opsi ini ditambahkan di API level 2.1.

 r
videoGPS String

Opsi saat ini untuk dukungan GPS selama perekaman video, mis. continuous. Nilai default-nya adalah continuous jika didukung.

Opsi ini ditambahkan di API level 2.1.

 rw
_vendorSpecific [jenis] (opsional) Opsi kamera tambahan khusus vendor. Awali string khusus vendor dengan garis bawah ( _ ).