Opsi

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

Name Jenis Deskripsi Baca/Tulis
captureMode String Mode pengambilan gambar saat ini. Default ke image. RW
captureModeSupport Array String Daftar mode pengambilan yang saat ini tersedia. Persyaratan minimum untuk API level 1 adalah ["image"], dan persyaratan minimum untuk API level 2 adalah ["image", "interval"], dengan "interval" mewakili mode pengambilan serangkaian gambar yang diberi jarak 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 secara relatif terhadap kamera dan yang kedua dengan pengguna yang berdiri di sisi yang berlawanan (relatif terhadap titik berdiri pertama) kamera. Tindakan ini memungkinkan kamera menghapus pengguna dari gambar akhir dengan menggabungkan kedua gambar tersebut. Jika "walkaround" didukung oleh kamera dan ditetapkan ke mode pengambilan saat ini, klien akan menerima pengiriman dua perintah takePicture ke kamera, dengan respons perintah pertama (saat selesai) menunjukkan bahwa kamera siap mengambil gambar kedua, sedangkan perintah kedua harus menampilkan gambar akhir saat selesai.

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

Opsi ini diubah di API level 2.

 r
captureStatus String Status perekaman saat ini. Default-nya adalah "idle". Hal ini berguna untuk menentukan status kamera saat pertama kali terhubung ke aplikasi. Jika kamera berada di tengah-tengah pengambilan gambar, video mungkin perlu dihentikan sebelum diperintahkan untuk melakukan hal-hal lain, misalnya pengambilan gambar video lainnya.

Opsi ini ditambahkan di API level 2.1.

 RW
captureStatusSupport Array String Daftar status pengambilan gambar yang saat ini tersedia; Secara default, status seharusnya ["idle", "shooting"] jika perekaman video didukung. Patung-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 Nomor 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 Nomor

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

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

Opsi ini diubah di API level 2.

 r
shutterSpeed Angka Setelan kecepatan shutter saat ini. RW
shutterSpeedSupport Array Nomor

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

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

Opsi ini diubah di API level 2.

 r
aperture Angka Setelan aperture saat ini, dalam f-stop. RW
apertureSupport Array Nomor

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

API level 2: Daftar setelan apertur yang saat ini tersedia, 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. Default-nya adalah auto. RW
whiteBalanceSupport Array String Daftar setelan white balance yang saat ini tersedia, dapat menjadi subset dari daftar yang telah ditetapkan:[ "auto", "incandescent", "fluorescent", "daylight", "cloudy-daylight", "shade", "twilight"]. Nilai untuk masing-masing:
  • incandescent, sekitar 3200 ribu
  • fluorescent, sekitar 4000 ribu
  • datalight, sekitar 5200K
  • cloudy-daylight, sekitar 6000 ribu
  • shade, sekitar 7000 ribu
  • twilight, sekitar 12.000 ribu
Awali nama setelan khusus vendor dengan garis bawah; misalnya: _vendor-setting		 r
exposureCompensation Angka Kompensasi eksposur saat ini. RW
exposureCompensationSupport Array Nomor Daftar kompensasi eksposur yang saat ini tersedia, biasanya pada langkah 0.33 atau 0.5; misalnya: [-1, -0.67, -0.33, 0, 0.33, 0.67, 1] r
fileFormat Objek

Jenis dan resolusi file saat ini. Format 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 mengetahui 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 Nomor 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 tidur, dalam hitungan detik. RW
sleepDelaySupport Array Nomor Daftar penundaan tidur yang tersedia saat ini, dalam detik; misalnya, [30, 60, 120, 300, 600, 1800, 65535], saat 65535 menonaktifkan mode tidur (kamera tidak tidur hingga dimatikan) dan harus didukung. r
offDelay Angka Penundaan dalam detik, sebelum kamera mati. RW
offDelaySupport Array Nomor Daftar penundaan daya mati yang tersedia saat ini, dalam hitungan detik; misalnya, [1800, 3600, 7200, 65535], ketika 65535 menonaktifkan mode mati daya (kamera tidak mematikan hingga baterai habis atau mati secara manual) dan harus didukung. r
totalSpace Angka Hanya baca: Jumlah byte total penyimpanan. r
remainingSpace Angka Hanya baca: Jumlah byte penyimpanan gratis. r
remainingPictures Angka Hanya baca: Estimasi jumlah gambar yang tersisa berdasarkan setelan pengambilan saat ini. 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, harap perhatikan bahwa setiap lokasi GPS hanya valid sampai pembaruan berikutnya dari ponsel tersebut. Ponsel harus menentukan kapan untuk memperbarui lokasi GPS; misalnya, tepat sebelum setiap perintah takePicture. 65535 memberi tahu kamera bahwa lokasi GPS saat ini tidak valid dan kamera harus mengabaikannya serta menggunakan GPS sendiri jika ada; misalnya, setOptions({"gpsInfo": {"lat": 65535, "lng": 65535}}) berarti lokasi GPS tidak valid.		 RW
dateTimeZone String Informasi tanggal dan waktu saat ini. Setel berdasarkan setOptions menggunakan tanggal, waktu, dan zona waktu ponsel. Formatnya adalah, YYYY:MM:DD HH:MM:SS+(-)HH:MM. Waktu menggunakan format 24 jam, tanggal dan waktu dipisahkan dengan spasi, dan zona waktu diimbangi dengan 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: Aktifkan/nonaktifkan mode pengambilan HDR. Nilainya adalah 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, API tersebut akan [“off”]; jika Anda mendukung satu mode HDR, [“off”, “hdr”] adalah mode tersebut, jika beberapa mode HDR (berbasis algoritme yang berbeda) didukung, maka modenya adalah [“off”, “hdr”, “hdr1”, “hdr2”, ...]

Opsi ini diubah di API level 2.

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

API level 1: Default ke {} kosong ketika 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 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 kurung eksposur otomatis tidak didukung, maka autoMode akan menjadi false.

Opsi ini diubah di API level 2.

 r
gyro Boolean Setel ke true untuk mengaktifkan modul giroskop kamera, atau false untuk menonaktifkan fitur ini. Tetapkan setelan default ke true jika kamera mendukungnya, jika tidak, false. Setelan ini dapat bersifat true hanya 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, atau false. r
imageStabilization String Operasi stabilisasi gambar saat ini; misalnya, off. RW
imageStabilizationSupport Array String Opsi stabilisasi gambar saat ini tersedia. Daftar yang telah ditentukan sebelumnya adalah, ["off", "on"]. Jika kamera tidak mendukung stabilisasi gambar, tampilkan ["off"], jika tidak, tampilkan ["off", "on"]. Awali string khusus vendor dengan garis bawah ( _ ); misalnya, [ "off", "_horizontal_stabilization", "_vibration_correction" ]. r
wifiPassword String
Minimum 8 karakter, berisi huruf, angka, simbol, tetapi tidak ada spasi. Hanya dapat diubah jika kamera terhubung ke perangkat klien. Setelah diubah, kamera harus memutuskan hubungan sehingga pengguna harus terhubung kembali menggunakan wifiPassword yang baru.
Kamera harus menyediakan mekanisme reset jika lupa sandi; misalnya, tombol reset untuk memulihkan sandi default 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
}
Nilai 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. Defaultnya adalah 0, yang berarti pengambilan gambar harus dihentikan secara eksplisit oleh perintah stopCapture; jika tidak, pengambilan akan otomatis berhenti setelah mengambil gambar angka yang ditentukan. Pengambilan gambar juga dapat terganggu saat daya baterai kamera habis atau dinonaktifkan secara sengaja.

Opsi ini ditambahkan di API level 2.

 RW
captureNumberSupport Objek

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

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

Opsi ini ditambahkan di API level 2.

 r
remainingVideoSeconds Angka Estimasi 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; misalnya, saat menggabungkan gambar, klien mungkin perlu melakukan polling pada kamera secara berkala untuk melihat apakah kamera selesai digabungkan. Setiap kamera memiliki dukungan yang berbeda; misalnya, beberapa kamera dapat menangani polling status setiap satu detik, sementara kamera lainnya mendukung interval yang lebih lama.

Opsi ini ditambahkan di API level 2.

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

Opsi ini ditambahkan di API level 2.

 RW
delayProcessingSupport Array Boolean

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

[false] berarti pemrosesan terjadi tepat setelah pengambilan.

[true, false] berarti ada pilihan di antara kedua mode tersebut.

Opsi ini ditambahkan di API level 2.

 r
clientVersion Angka

API level yang dipilih klien untuk digunakan. Defaultnya adalah 1 jika kamera mendukung API level 1 dan 2 sehingga klien yang ditulis untuk API level 1 masih berfungsi dengan kamera tanpa perubahan apa pun; default ke 2 jika kamera hanya mendukung API level 2, yang tidak direkomendasikan sebelum klien bermigrasi ke API level 2. Jika kamera hanya mendukung API level 2, permintaan yang mencoba menyetelnya ke 1 akan gagal. Jika clientVersion ditetapkan ke 2 dengan sukses dan perintah yang tidak digunakan lagi dari API level 1 diminta, permintaan tersebut akan gagal dengan kode error unknownCommand.

Opsi ini ditambahkan di API level 2.

 RW
photoStitchingSupport Array String

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

Opsi ini ditambahkan di API level 2.1.

 r
photoStitching String

Opsi penggabungan saat ini untuk foto, misalnya ondevice. Tetapkan setelan default ke ondevice jika didukung.

Opsi ini ditambahkan di API level 2.1.

 RW
videoStitchingSupport Array String

Daftar opsi penggabungan untuk video. Menampilkan [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, misalnya _vendor-setting.

Opsi ini ditambahkan di API level 2.1.

 r
videoStitching String

Opsi penggabungan saat ini untuk video, misalnya ondevice. Tetapkan setelan default ke ondevice jika didukung.

Opsi ini ditambahkan di API level 2.1.

 RW
videoGPSSupport Array String

Daftar opsi GPS selama perekaman video. Tampilkan [continuous] jika kamera dapat terus menangkap GPS selama perekaman video dan menyematkan lokasi dalam video. Tampilkan [none] jika tidak dapat dilakukan, dan [none,continuous] jika dukungan GPS video dapat dikonfigurasi oleh pengguna. Awali nama setelan khusus vendor dengan garis bawah, misalnya _vendor-setting.

Opsi ini ditambahkan di API level 2.1.

 r
videoGPS String

Opsi saat ini untuk dukungan GPS selama perekaman video, misalnya continuous. Tetapkan setelan default ke continuous jika didukung.

Opsi ini ditambahkan di API level 2.1.

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