W tabeli poniżej znajdziesz wszystkie dostępne opcje, które możesz ustawić i pobrać według: camera.setOptions i camera.getOptions. Opcji nie można zmienić, jeśli jej obsługa jest pusta lub zawiera tylko jedną opcję.
| Nazwa | Typ | Opis | Odczyt/zapis |
|---|---|---|---|
captureMode |
Ciąg znaków | Bieżący tryb przechwytywania. Domyślna wartość: image. |
Rw |
captureModeSupport |
Tablica z ciągami znaków | Lista obecnie dostępnych trybów przechwytywania. Minimalnym wymaganiem dla interfejsu API poziomu 1 jest ["image"], a poziomu 2 to ["image", "interval"], gdzie "interval" oznacza tryb robienia serii zdjęć w określonych odstępach czasu. Zapoznaj się również z artykułami captureInterval i captureIntervalSupport. Interfejs API 2 obsługuje 2 dodatkowe tryby ("video" and "walkaround")dlatego cały interfejs API poziomu 2 to ["image", "interval", "video", "walkaround"], gdzie "video" oznacza tryb nagrywania filmu, a "walkaround" oznacza tryb nagrywania dwóch kolejnych zdjęć. Pierwszy to tryb z użytkownikami stojącymi w dowolnym miejscu względem kamery, a drugi z użytkownikami stojącymi po przeciwnej stronie (w stosunku do pierwszego punktu stojącego). Dzięki temu aparat może usunąć użytkowników z ostatecznego zdjęcia przez połączenie 2 obrazów. Gdy aparat "walkaround" jest obsługiwany przez aparat i ustawiony jako bieżący tryb przechwytywania, klient powinien wysłać do aparatu dwa polecenia TakePicture do aparatu, przy czym pierwsze polecenie (po zakończeniu) wskazuje, że aparat jest gotowy do zrobienia drugiego zdjęcia, a drugie powinno zwrócić ostateczne zdjęcie po zakończeniu tego procesu.
Aby dodać więcej trybów przechwytywania, które nie są jeszcze obsługiwane, poprzedź je prefiksem _ . Ta opcja została zmieniona na poziomie interfejsu API 2. |
R |
captureStatus |
Ciąg znaków | Bieżący stan przechwytywania. Domyślna wartość to "idle". Jest to przydatne do określania stanu kamery po jej pierwszym połączeniu z aplikacją. Jeśli kamera jest w trakcie nagrywania filmu, może być konieczne zatrzymanie odtwarzania przed poleceniem wykonania innych czynności, np. nakręcenie kolejnego filmu. Ta opcja została dodana na poziomie interfejsu API 2.1. |
Rw |
captureStatusSupport |
Tablica z ciągami znaków | Lista dostępnych obecnie stanów przechwytywania. Jeśli nagrywanie filmów jest obsługiwane, domyślna wartość to ["idle", "shooting"]. Można również podać inne posągi, np. "downloading" Ta opcja została dodana na poziomie interfejsu API 2.1. |
R |
exposureProgram |
Liczba | Aktualny program ekspozycji. | Rw |
exposureProgramSupport |
Tablica liczb | lista dostępnych obecnie programów narażenia na kontakt; na przykład [0, 1, 2, 3, 4]. Każda liczba całkowita oznacza inny program ekspozycji:
ExposureProgram.
|
R |
iso |
Liczba | Aktualne ustawienie szybkości ISO. | Rw |
isoSupport |
Tablica liczb | Poziom interfejsu API 1: lista dostępnych obecnie ustawień ISO. na przykład Poziom interfejsu API 2: lista dostępnych obecnie ustawień ISO. na przykład Ta opcja została zmieniona na poziomie interfejsu API 2. |
R |
shutterSpeed |
Liczba | Aktualne ustawienie szybkości migawki. | Rw |
shutterSpeedSupport |
Tablica liczb | Poziom interfejsu API 1: lista dostępnych obecnie szybkości migawki. na przykład Poziom interfejsu API 2: lista obecnie dostępnych szybkości migawki. na przykład Ta opcja została zmieniona na poziomie interfejsu API 2. |
R |
aperture |
Liczba | Aktualne ustawienie przysłony w przysłonach. | Rw |
apertureSupport |
Tablica liczb | Poziom interfejsu API 1: lista dostępnych obecnie ustawień przysłony wyrażonych w języku Poziom interfejsu API 2: lista obecnie dostępnych ustawień przysłony wyrażonych w języku |
R |
whiteBalance |
Ciąg znaków | Bieżące ustawienie balansu bieli na przykład daylight. Domyślna wartość to auto. |
Rw |
whiteBalanceSupport |
Tablica z ciągami znaków | Lista obecnie dostępnych ustawień balansu bieli może być podzbiorem wstępnie zdefiniowanej listy:[ "auto", "incandescent", "fluorescent", "daylight", "cloudy-daylight", "shade", "twilight"]. Wartości dla poszczególnych elementów:
_vendor-setting |
R |
exposureCompensation |
Liczba | Aktualna kompensacja ekspozycji. | Rw |
exposureCompensationSupport |
Tablica liczb | Lista obecnie dostępnych kompensacji ekspozycji, zwykle w kroku 0.33 lub
0,5; na przykład: [-1, -0.67, -0.33, 0, 0.33, 0.67, 1] |
R |
fileFormat |
Obiekt | Aktualny typ pliku i rozdzielczość. Format powinien odzwierciedlać bieżącą wartość {
"type": "jpeg",
"width": 2000,
"height": 1000
}
Jeśli captureMode to video, odpowiednia odpowiedź może wyglądać tak:
{
"type": "mp4",
"width": 1920,
"height": 1080,
"framerate": 30
}Ta opcja została zmieniona na poziomie interfejsu API 2. |
Rw |
fileFormatSupport |
Tablica obiektów | Lista obecnie dostępnych formatów plików. np.: [
{
"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
},
...
]
Aby dowiedzieć się więcej o wszystkich typach, kliknij ten link.
Ta opcja została zmieniona na poziomie interfejsu API 2. |
R |
exposureDelay |
Liczba | Aktualne opóźnienie (w sekundach) między poleceniem takePicture a rozpoczęciem ekspozycji na koronawirusa. |
Rw |
exposureDelaySupport |
Tablica liczb | Lista obecnie dostępnych opóźnień ekspozycji w sekundach; na przykład: [0, 1, 2, 5, 10, 30, 60] |
R |
sleepDelay |
Liczba | Aktualne opóźnienie (w sekundach) przed uśpieniem kamery. | Rw |
sleepDelaySupport |
Tablica liczb | Lista obecnie dostępnych opóźnień snu (w sekundach). na przykład [30, 60, 120, 300, 600, 1800, 65535], gdzie 65535 wyłącza tryb uśpienia (kamera nie przechodzi w tryb uśpienia, dopóki nie zostanie wyłączony) i musi być obsługiwana. |
R |
offDelay |
Liczba | Aktualne opóźnienie (w sekundach) przed wyłączeniem kamery. | Rw |
offDelaySupport |
Tablica liczb | Lista obecnie dostępnych opóźnień wyłączania zasilania (w sekundach); na przykład [1800, 3600, 7200, 65535], gdzie 65535 wyłącza tryb wyłączania (kamera nie wyłącza się, dopóki bateria się nie wyczerpuje lub nie wyłącza ręcznie) i musi być obsługiwana. |
R |
totalSpace |
Liczba | Tylko do odczytu: liczba bajtów łącznej pamięci. | R |
remainingSpace |
Liczba | Tylko do odczytu: liczba bajtów bezpłatnej przestrzeni dyskowej. | R |
remainingPictures |
Liczba | Tylko do odczytu: szacowana liczba pozostałych zdjęć na podstawie bieżącego zdjęcia. . | R |
gpsInfo |
Obiekt | Aktualne informacje GPS. Ustaw w {
"lat": 23.532,
"lng": -132.35
}
Właściwości lat i lng są stopniami dziesiętnymi, przy czym lat należy do zakresu, a [-90, 90] i lng w zakresie ([-180, 180]). Jeśli informacje o lokalizacji GPS zostały podane przez telefon, należy pamiętać, że każda lokalizacja GPS jest ważna tylko
aż do następnej aktualizacji z telefonu. Telefon musi określić, kiedy przeprowadzić aktualizację
lokalizację GPS; na przykład tuż przed każdym poleceniem takePicture. 65535 powiadamia aparat, że bieżąca lokalizacja GPS jest nieprawidłowa
powinien ją zignorować i użyć własnego odbiornika GPS, jeśli jest dostępny; np.
setOptions({"gpsInfo": {"lat": 65535, "lng": 65535}}) oznacza, że lokalizacja GPS jest
jest nieprawidłowa. |
Rw |
dateTimeZone |
Ciąg znaków | Aktualne informacje o dacie i godzinie. Ustawione przez setOptions na podstawie daty, godziny i strefy czasowej telefonu. Format to YYYY:MM:DD HH:MM:SS+(-)HH:MM. Czas jest w formacie 24-godzinnym, a data i godzina są oddzielone spacją
a strefa czasowa to przesunięcie względem czasu UTC. np. 2014:05:18 01:04:29+8:00 to strefa czasowa chińska (UTC+8:00) |
Rw |
hdr |
Poziom interfejsu API 1: wartość logiczna Poziom interfejsu API 2: ciąg znaków |
Poziom API 1: włącz lub wyłącz tryb nagrywania HDR. Wartość to Poziom interfejsu API 2: obecny tryb HDR typu ciąg znaków. Ta opcja została zmieniona na poziomie interfejsu API 2. |
Rw |
hdrSupport |
Poziom interfejsu API 1: wartość logiczna Poziom interfejsu API 2: tablica ciągów |
Poziom interfejsu API 1: wartość Poziom API 2: jeśli nie obsługujesz trybu HDR,
Ta opcja została zmieniona na poziomie interfejsu API 2. |
R |
exposureBracket |
Obiekt | Aktualne ustawienie przedziału ekspozycji. Dostępne tylko wtedy, gdy hdrSupport == true (poziom interfejsu API 1) lub hdrSupport zawiera co najmniej 1 tryb HDR (poziom interfejsu API 2). Jeśli aparat korzysta z ręcznej braketingu ekspozycji, obiekt zawiera 2 wpisy:
{
"shots": 3,
"increment": 1.33
}
Jeśli aparat korzysta z braketingu ekspozycji, obiekt zawiera:
{
"autoMode": true
}
Poziom interfejsu API 1: domyślnie puste jest Poziom interfejsu API 2: domyślnie puste jest {}, gdy Ta opcja została zmieniona na poziomie interfejsu API 2. |
Rw |
exposureBracketSupport |
Obiekt | Dostępne są obecnie ustawienia nawiasów ekspozycji. np.: {
"autoMode": true,
"shotsSupport": [1, 3, 5, 7],
"incrementSupport": [0.33, 0.67, 1, 1.33, 1.67, 2]
}
Poziom interfejsu API 1: domyślnie puste jest Poziom interfejsu API 2: domyślnie puste jest Ta opcja została zmieniona na poziomie interfejsu API 2. |
R |
gyro |
Wartość logiczna | Ustaw na true, aby włączyć moduł żyroskopu aparatu, lub false, aby wyłączyć tę funkcję. Domyślna wartość to true, jeśli aparat obsługuje tę funkcję. W przeciwnym razie false. To ustawienie może mieć wartość true tylko wtedy, gdy gyroSupport == true. |
Rw |
gyroSupport |
Wartość logiczna | Jeśli kamera jest wyposażona w żyroskop, ta wartość powinna wynosić true. W przeciwnym razie – false. |
R |
gps |
Wartość logiczna | Włącza/wyłącza moduł GPS aparatu. Aby można było włączyć tę funkcję, musisz podać wartość true lub false, aby ją wyłączyć. Wartość domyślna to true, jeśli aparat obsługuje tę funkcję. W przeciwnym razie – false. Ustawienie ma wartość true tylko wtedy, gdy gpsSupport == true. |
Rw |
gpsSupport |
Wartość logiczna | Jeśli aparat ma własny moduł GPS, ta wartość powinna wynosić true. W przeciwnym razie false. |
R |
imageStabilization |
Ciąg znaków | bieżąca operacja stabilizacji obrazu; na przykład off. |
Rw |
imageStabilizationSupport |
Tablica z ciągami znaków | Dostępne są obecnie opcje stabilizacji obrazu. Wstępnie zdefiniowana lista to ["off", "on"]. Jeśli aparat nie obsługuje stabilizacji obrazu, zwraca wartość ["off"]. W przeciwnym razie zwraca wartość ["off", "on"]. Poprzedź ciągi tekstowe związane z dostawcą znakiem podkreślenia ( _ ). na przykład [ "off", "_horizontal_stabilization", "_vibration_correction" ]. |
R |
wifiPassword |
Ciąg znaków | Co najmniej 8 znaków, w tym litery, cyfry, symbole, ale bez spacji. Można go zmienić tylko po podłączeniu kamery do urządzenia klienckiego. Po wprowadzeniu zmian kamera musi się odłączyć, aby użytkownik musiał ponownie połączyć się za pomocą nowego urządzenia
wifiPassword.Kamera musi udostępniać mechanizm resetowania hasła na wypadek zapomnienia hasła. np. przycisku resetowania. |
tydz. |
previewFormat |
Obiekt | Bieżąca rozdzielczość podglądu na żywo; np.: {
"width": 640,
"height": 320,
"framerate": 24
}Ta opcja została dodana na poziomie interfejsu API 2. |
Rw |
previewFormatSupport |
Tablica obiektów | obecnie obsługiwane formaty podglądu na żywo; np.: [
{
"width": 640,
"height": 320,
"framerate": 24
},
...
{
"width": 1280,
"height": 720,
"framerate": 24
}
]
Ta opcja została dodana na poziomie interfejsu API 2. |
R |
captureInterval |
Liczba | Bieżący odstęp między zrobieniem 2 kolejnych zdjęć: seconds.
Ta opcja została dodana na poziomie interfejsu API 2. |
Rw |
captureIntervalSupport |
Obiekt | Minimalne i maksymalne dozwolone odstępy między kolejnymi zdjęciami 2 kolejnych zdjęć (w sekundach); np.: {
"minInterval": 10,
"maxInterval": 60
}Może się różnić w zależności od: fileFormat.
Ta opcja została dodana na poziomie interfejsu API 2. |
R |
captureNumber |
Liczba | Liczba zdjęć do zrobienia w ramach 1 sesji przechwytywania z interwałem. Domyślna wartość to 0, co oznacza, że przechwytywanie musi zostać bezpośrednio zakończone poleceniem stopCapture. W przeciwnym razie przechwytywanie zatrzymuje się automatycznie po zrobieniu zdjęć o określonej liczbie. Nagrywanie może też zostać przerwane, gdy kamera się rozładuje lub gdy zostanie wyłączona celowo.
Ta opcja została dodana na poziomie interfejsu API 2. |
Rw |
captureNumberSupport |
Obiekt | minimalna i maksymalna liczba zdjęć, które można zrobić podczas robienia zdjęć z interwałami; np.: {
"minNumber": 2,
"maxNumber": 50
}Ta opcja może się zmienić w zależności od pozostałego wolnego miejsca.
Ta opcja została dodana na poziomie interfejsu API 2. |
R |
remainingVideoSeconds |
Liczba | Szacunkowa liczba pozostałych filmów (seconds) na podstawie bieżących ustawień nagrywania.
Ta opcja została dodana na poziomie interfejsu API 2. |
R |
pollingDelay |
Liczba | Minimalny odstęp czasu w sekundach między 2 kolejnymi żądaniami odpytywania stanu. Klienci powinni korzystać z tego pola, aby kształtować swoją ankietę na temat stanu. Na przykład podczas zszywania obrazu klienty mogą co jakiś czas przeprowadzać sondowanie z kamery, aby sprawdzić, czy udało się zakończyć zszywanie. Różne aparaty obsługują różne funkcje. na przykład niektóre kamery obsługują sondowanie stanu co sekundę, podczas gdy inne obsługują dłuższe odstępy.
Ta opcja została dodana na poziomie interfejsu API 2. |
R |
delayProcessing |
Wartość logiczna | Ustawienie True podczas przetwarzania (np. zszywania) ma niższy priorytet niż rejestrowanie, czyli przed zakończeniem przetwarzania poprzedniego zdjęcia dozwolone jest kolejne przechwycenie. Jest to zdecydowanie zalecane zwłaszcza w przypadku aparatów, które wymagają długiego czasu przetwarzania.
Ta opcja została dodana na poziomie interfejsu API 2. |
Rw |
delayProcessingSupport |
Tablica logiczna |
Ta opcja została dodana na poziomie interfejsu API 2. |
R |
clientVersion |
Liczba | Poziom interfejsu API, którego chce użyć klient. Wartość domyślna to 1, jeśli
kamera obsługuje zarówno interfejs API poziomu 1, jak i 2, dzięki czemu klienty napisane dla
Interfejs API poziomu 1 nadal działa z kamerą bez żadnych zmian. domyślna
na 2, jeśli kamera obsługuje tylko interfejs API poziomu 2, który nie jest
zalecane przed migracją klientów do interfejsu API poziomu 2. Jeśli kamera
obsługuje wyłącznie interfejs API poziomu 2, żądanie ustawienia go na poziomie 1 powinno
niepowodzenie. Jeśli Ta opcja została dodana na poziomie interfejsu API 2. |
Rw |
photoStitchingSupport |
Tablica z ciągami znaków | Lista opcji łączenia zdjęć. Powrót
Ta opcja została dodana na poziomie interfejsu API 2.1. |
R |
photoStitching |
Ciąg znaków | Bieżąca opcja zszywania zdjęć, np.
Ta opcja została dodana na poziomie interfejsu API 2.1. |
Rw |
videoStitchingSupport |
Tablica z ciągami znaków | Lista opcji łączenia filmów. Powrót
Ta opcja została dodana na poziomie interfejsu API 2.1. |
R |
videoStitching |
Ciąg znaków | Bieżąca opcja łączenia filmów, np.
Ta opcja została dodana na poziomie interfejsu API 2.1. |
Rw |
videoGPSSupport |
Tablica z ciągami znaków | Lista opcji GPS podczas nagrywania filmu. Powrót
Ta opcja została dodana na poziomie interfejsu API 2.1. |
R |
videoGPS |
Ciąg znaków | Obecna opcja obsługi GPS podczas nagrywania filmu, np.
Ta opcja została dodana na poziomie interfejsu API 2.1. |
Rw |
_vendorSpecific |
[typ] (opcjonalny) | Dodatkowe opcje kamer zależne od dostawcy. Przed ciągami znaków konkretnego dostawcy poprzedź prefiksem podkreślenie ( _ ). |