Opcje

Poniższa tabela zawiera wszystkie opcje dostępne do ustawienia dla camera.setOptions i camera.getOptions. Nie można zmienić opcji, jeśli jej obsługa jest pusta lub zawiera tylko jedną opcję.

Nazwa Typ Opis Do odczytu i zapisu
captureMode Ciąg znaków Obecny tryb przechwytywania. Domyślna wartość: image. AW
captureModeSupport Tablica ciągów tekstowych Lista dostępnych trybów przechwytywania. Minimalny wymagany poziom interfejsu API poziomu 1 to ["image"], a minimalny – poziom 2. "interval" to tryb przechwytywania serii obrazów w określonych odstępach czasu – zobacz też captureInterval i captureIntervalSupport. Poziomy interfejsu API 2 obsługują ("video" and "walkaround") dodatkowe tryby, więc pełna obsługa ustawiona przez interfejs API 2 to ["image", "interval", "video", "walkaround"], gdzie "video" oznacza tryb przechwytywania obrazu, a "walkaround" oznacza tryb przechwytywania dwóch obrazów: jeden stojący w dowolnym miejscu obok aparatu, a drugi znajdujący się po przeciwnej stronie (w stosunku do pierwszego punktu widzenia) kamery. Dzięki temu aparat może usunąć użytkowników z końcowego obrazu, łącząc te 2 obrazy. Gdy aparat będzie obsługiwany przez "walkaround" i zostanie ustawiony jako bieżący tryb przechwytywania, klient powinien wysłać 2 polecenia robić zdjęcie do aparatu. Odpowiedź pierwszego polecenia (po zakończeniu) wskazuje, że aparat jest gotowy do zrobienia drugiego zdjęcia, a drugie powinien zwrócić ostatni obraz.

Aby dodać więcej trybów przechwytywania, które nie są jeszcze obsługiwane, poprzedź prefiksy trybów poszczególnych dostawców znakiem podkreślenia ( _ ).

Ta opcja została zmieniona w interfejsie API na poziomie 2.

R
captureStatus Ciąg znaków Obecny stan przechwytywania. Domyślna wartość to "idle". Ta funkcja przydaje się do określania stanu kamery po pierwszym podłączeniu do aplikacji. Jeśli kamera jest w trakcie nagrywania filmu, możliwe, że trzeba będzie ją zatrzymać, aby wykonać inne czynności, np. nagrać kolejny film.

Ta opcja została dodana na poziomie API 2.1.

AW
captureStatusSupport Tablica ciągów tekstowych Lista stanów przechwytywania obecnie dostępnych. Domyślnie powinna to być ["idle", "shooting"], jeśli nagrywanie wideo jest obsługiwane. Możesz też podać inne posągi, np. "downloading".

Ta opcja została dodana na poziomie API 2.1.

R
exposureProgram Liczba Bieżący program ekspozycji. AW
exposureProgramSupport Tablica liczb Lista obecnie dostępnych programów ekspozycji, na przykład [0, 1, 2, 3, 4]. Każda liczba całkowita reprezentuje inny program ekspozycji:
  • 0 = nie określono
  • 1 = ręcznie
  • 2 = Normalny program
  • 3 = priorytet przysłony
  • 4 = priorytet migawki
Kliknij poniższy link, by pobrać więcej informacji o ExposureProgram.
R
iso Liczba Aktualne ustawienie szybkości ISO. AW
isoSupport Tablica liczb

Poziom API 1: lista dostępnych ustawień ISO, np. [100, 200, 400, 800,1600] lub [], gdy jest włączona w trybie auto.

Poziom API 2: lista dostępnych ustawień ISO, np. [0, 100, 200, 400, 800, 1600] – gdzie 0 reprezentuje tryb auto.

Ta opcja została zmieniona w interfejsie API na poziomie 2.

R
shutterSpeed Liczba Obecne ustawienie szybkości migawki. AW
shutterSpeedSupport Tablica liczb

Poziom API 1: lista obecnie dostępnych wartości migawki, np. [0.067, 0.033, 0.017,0.008] lub [], gdy jest włączona w trybie auto.

Poziom API 2: lista obecnie obsługiwanych szybkości migawki, na przykład [0, 0.067, 0.033, 0.017, 0.008] (gdzie 0 odpowiada trybowi auto).

Ta opcja została zmieniona w interfejsie API na poziomie 2.

R
aperture Liczba Aktualne ustawienie przysłony: przysłona. AW
apertureSupport Tablica liczb

API na poziomie 1: lista ustawień przesłony, które są obecnie wyrażone w f/number (np. [1.4, 2, 2.8, 4, 5.6, 8, 11] lub [] w trybie auto).

Poziom API 2: lista ustawień przysłony dostępnych obecnie w f/number, na przykład [0, 1.4, 2, 2.8, 4, 5.6, 8, 11], gdzie 0 reprezentuje tryb auto.

R
whiteBalance Ciąg znaków Obecne ustawienie balansu bieli, np. daylight. Domyślna wartość to auto. AW
whiteBalanceSupport Tablica ciągów tekstowych Lista obecnych ustawień balansu bieli. Może być podzbiorem wstępnie zdefiniowanej listy: [ "auto", "incandescent", "fluorescent", "daylight", "cloudy-daylight", "shade", "twilight"]. Wartości dla:
  • incandescent, około 3200 tys.
  • fluorescent, około 4000 tys.
  • datalight, około 5200 tys.
  • cloudy-daylight, około 6000 tys.
  • shade, około 7000 tys.
  • twilight, około 12 000 tys.
Poprzedź nazwy podkreśleń specyficznych dla dostawcy, na przykład: _vendor-setting
R
exposureCompensation Liczba Aktualna kompensacja ekspozycji. AW
exposureCompensationSupport Tablica liczb Lista dostępnych kompensacji narażenia na kontakt, obecnie 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ść captureMode. Jeśli na przykład captureMode to image, odpowiednia odpowiedź może wyglądać tak:

{
    "type": "jpeg",
    "width": 2000,
    "height": 1000
}
Jeśli captureMode ma wartość video, odpowiednia odpowiedź może wyglądać tak:
{
    "type": "mp4",
    "width": 1920,
    "height": 1080,
    "framerate": 30
}

Ta opcja została zmieniona w interfejsie API na poziomie 2.

AW
fileFormatSupport Tablica obiektów

Lista obecnie dostępnych formatów plików, na przykład:

[
    {
    "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
    },
    ...
]
Kliknij ten link, aby dowiedzieć się więcej o wszystkich typach.

Ta opcja została zmieniona w interfejsie API na poziomie 2.

R
exposureDelay Liczba Aktualne opóźnienie między poleceniem takePicture a rozpoczęciem ekspozycji (w sekundach). AW
exposureDelaySupport Tablica liczb Lista opóźnień ekspozycji, które są obecnie dostępne (w sekundach), na przykład: [0, 1, 2, 5, 10, 30, 60] R
sleepDelay Liczba Obecne opóźnienie w czasie uśpienia aparatu (w sekundach). AW
sleepDelaySupport Tablica liczb Lista dostępnych opóźnień snu (w sekundach), np. [30, 60, 120, 300, 600, 1800, 65535], gdzie 65535 wyłącza tryb uśpienia (kamera nie wyłącza się, dopóki nie jest wyłączona) i musi być obsługiwana. R
offDelay Liczba Aktualne opóźnienie w sekundach przed wyłączeniem kamery. AW
offDelaySupport Tablica liczb Lista opóźnień wyłączenia (w sekundach), na przykład [1800, 3600, 7200, 65535], gdzie 65535 wyłącza tryb wyłączenia (kamera nie wyłącza się do momentu wyczerpania lub wyłączenia baterii) i musi być obsługiwana. R
totalSpace Liczba Tylko do odczytu: liczba bajtów całkowitej pamięci. R
remainingSpace Liczba Tylko do odczytu: liczba bajtów bezpłatnego miejsca. R
remainingPictures Liczba Tylko do odczytu: szacowana liczba pozostałych zdjęć określona na podstawie bieżącego ustawienia przechwytywania. R
gpsInfo Obiekt

Aktualne informacje GPS. Ustaw za pomocą setOptions na GPS-u telefonu:

{
    "lat": 23.532,
    "lng": -132.35
}
Właściwości lat i lng to wartości dziesiętne, z zakresu lat, lng i [-180, 180]. Jeśli telefon udostępnia taką informację, pamiętaj, że każda lokalizacja GPS jest ważna tylko do następnej aktualizacji telefonu. Telefon musi określić, kiedy chcesz zaktualizować lokalizację GPS, np. tuż przed poleceniem takePicture. Kamera 65535 powiadomi aparat, że bieżąca lokalizacja GPS jest nieprawidłowa, a kamera powinna ją zignorować i użyć własnego GPS, jeśli istnieje, np. setOptions({"gpsInfo": {"lat": 65535, "lng": 65535}}) oznacza, że lokalizacja GPS jest nieprawidłowa.
AW
dateTimeZone Ciąg znaków Aktualna data i godzina. Ustawiono przez setOptions datę, godzinę i strefę czasową telefonu. Format to YYYY:MM:DD HH:MM:SS+(-)HH:MM. Czas w formacie 24-godzinnym jest oddzielony spacją, a strefa czasowa jest odsunięta od czasu UTC, np. 2014:05:18 01:04:29+8:00 to strefa czasowa w Chinach (UTC+8:00). AW
hdr

Poziom API 1: wartość logiczna

Poziom API 2: ciąg znaków.

Poziom API 1: włącz lub wyłącz tryb przechwytywania HDR. Wartość to true, aby włączyć HDR, lub false, aby ją wyłączyć. Wartość domyślna to false. Ustawienie true może mieć wartość tylko wtedy, gdy hdrSupport to także true.

Poziom API 2: bieżący tryb HDR typu Ciąg znaków.

Ta opcja została zmieniona w interfejsie API na poziomie 2.

AW
hdrSupport

Poziom API 1: wartość logiczna

Poziom API 2: Ciąg znaków

Poziom API 1: wartość true oznacza, że aparat obsługuje technologię HDR. Ustawienie false identyfikuje aparat bez HDR.

Poziom API 2: jeśli nie obsługujesz trybu HDR, to [“off”], a jeśli obsługujesz jeden z nich, to [“off”, “hdr”], a obsługiwane jest wiele trybów HDR (różnych algorytmów), wtedy [“off”, “hdr”, “hdr1”, “hdr2”, ...]

Ta opcja została zmieniona w interfejsie API na poziomie 2.

R
exposureBracket Obiekt Obecne ustawienie nawiasu ekspozycji. Dostępne tylko wtedy, gdy hdrSupport == true (poziom API 1) lub hdrSupport zawiera co najmniej jeden tryb HDR (poziom API 2). Jeśli aparat korzysta z ręcznego poprawiania ekspozycji, obiekt zawiera 2 wpisy:
  1. shots – liczba całkowita z liczbą ujęć.
  2. increment – numer z przyrostem EV między ujęciami.
Na przykład:
{
    "shots": 3,
    "increment": 1.33
}
Jeśli aparat korzysta z automatycznego nawiasowania, obiekt zawiera:
{
    "autoMode": true
}

Poziom API 1: Domyślnie ustawiony na {} pusty, gdy hdrSupport == false. Producenci określają wartości domyślne (np. automatyczne narażanie ekspozycji), gdy hdr to true.

Poziom API 2: ustaw wartość domyślną na {}, jeśli hdrSupport zawiera tylko "off". W przeciwnym razie producenci określają wartości domyślne (np. nawiasy samochodowe).

Ta opcja została zmieniona w interfejsie API na poziomie 2.

AW
exposureBracketSupport Obiekt

Dostępne są obecnie ustawienia zakresu ekspozycji, na przykład:

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

Poziom API 1: Domyślnie ustawiony na {} pusty, jeśli hdrSupport == false. Gdy hdrSupport == true, ale brak ekspozycji w ramach automatycznej ekspozycji, funkcja autoMode będzie mieć wartość false.

Poziom API 2: ustaw wartość domyślną na pustą ({}), jeśli hdrSupport zawiera tylko "off". Gdy hdrSupport zawiera dowolny tryb HDR, ale automatyczne nawiasy nie są obsługiwane, autoMode będzie mieć wartość false.

Ta opcja została zmieniona w interfejsie API na poziomie 2.

R
gyro Wartość logiczna Ustaw true, aby włączyć moduł żyroskopowy, lub false, aby wyłączyć tę funkcję. Domyślnie jest to true, jeśli aparat obsługuje tę funkcję. W innych przypadkach false występuje. Ustawienie tego ustawienia może wynosić true tylko wtedy, gdy gyroSupport == true. AW
gyroSupport Wartość logiczna Jeśli kamera ma żyroskop, wartość powinna wynosić true, w przeciwnym razie będzie false. R
gps Wartość logiczna Włącza lub wyłącza moduł GPS aparatu. Wartość musi być włączona (true) lub false, aby wyłączyć. Wartość domyślna to true, jeśli aparat obsługuje tę wartość. W przeciwnym razie wartość to false. Ustawienie ma wartość true tylko wtedy, gdy gpsSupport == true. AW
gpsSupport Wartość logiczna Powinna to być wartość true, jeśli kamera ma własny moduł GPS. W przeciwnym razie powinna ona mieć wartość false. R
imageStabilization Ciąg znaków Obecna operacja stabilizacji obrazu, na przykład off. AW
imageStabilizationSupport Tablica ciągów tekstowych Dostępne są obecnie opcje stabilizacji obrazu. Wstępnie zdefiniowana lista to ["off", "on"].Jeśli aparat nie obsługuje stabilizacji obrazu, zwróć wartość ["off"], a w przeciwnym razie wybierz ["off", "on"]. Prefiksy ciągów dostawców znajdziesz przed znakiem podkreślenia ( _ ), na przykład [ "off", "_horizontal_stabilization", "_vibration_correction" ]. R
wifiPassword Ciąg znaków
Co najmniej 8 znaków zawierających litery, cyfry, symbole, ale nie spacje. To ustawienie można zmienić tylko wtedy, gdy kamera jest podłączona do urządzenia klienckiego. Po zmianie kamery musi się rozłączyć, aby użytkownik mógł połączyć się ponownie za pomocą nowego wifiPassword.
Kamera musi udostępniać mechanizm resetowania na wypadek, gdyby użytkownik zapomniał hasła, na przykład przycisk przywracania ustawień fabrycznych.
W
previewFormat Obiekt

Aktualna rozdzielczość podglądu na żywo, na przykład:

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

Ta opcja została dodana na poziomie 2 interfejsu API.

AW
previewFormatSupport Tablica obiektów

Aktualnie obsługiwane formaty podglądu na żywo, na przykład:

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

Ta opcja została dodana na poziomie 2 interfejsu API.

R
captureInterval Liczba Bieżący odstęp między 2 kolejnymi obrazami w seconds.

Ta opcja została dodana na poziomie 2 interfejsu API.

AW
captureIntervalSupport Obiekt

Dozwolone są minimalne i maksymalne odstępy między kolejnymi obrazami w sekundach. Na przykład:

{
    "minInterval": 10,
    "maxInterval": 60
}
Może się różnić w zależności od usługi fileFormat.

Ta opcja została dodana na poziomie 2 interfejsu API.

R
captureNumber Liczba Liczba zdjęć, które mają zostać zrobione podczas jednej sesji przechwytywania sesji. Wartość domyślna to 0. Oznacza to, że przechwytywanie musi zostać wyraźnie zakończone za pomocą polecenia stopCapture. W przeciwnym razie robi to automatycznie po zrobieniu zdjęć o podanej liczbie. Przechwytywanie może zostać przerwane również wtedy, gdy bateria kamery się wyczerpie, lub gdy zostanie ona celowo wyłączona.

Ta opcja została dodana na poziomie 2 interfejsu API.

AW
captureNumberSupport Obiekt

Minimalna i maksymalna liczba zdjęć, które można zarejestrować w ramach interwału, na przykład:

{
    "minNumber": 2,
    "maxNumber": 50
}
Może się zmienić w zależności od pozostałego miejsca na dane.

Ta opcja została dodana na poziomie 2 interfejsu API.

R
remainingVideoSeconds Liczba Szacowana liczba seconds pozostałych filmów na podstawie bieżącego ustawienia przechwytywania.

Ta opcja została dodana na poziomie 2 interfejsu API.

R
pollingDelay Liczba Minimalny odstęp w sekundach między dwoma kolejnymi żądaniami sondowania. Klienty powinni korzystać z tego pola, aby zarządzać ankietowaniem stanu, na przykład podczas zszywania zdjęcia klient może okresowo przeprowadzać ankietę, aby sprawdzić, czy dokończenie łączenia. Różne aparaty obsługują różne funkcje. Na przykład niektóre aparaty obsługują ankietę, która obsługuje co sekundę, podczas gdy inne obsługują dłuższe odstępy czasu.

Ta opcja została dodana na poziomie 2 interfejsu API.

R
delayProcessing Wartość logiczna True podczas przetwarzania (np. zszywanie) ma niższy priorytet niż przechwytywanie, czyli inne nagrywanie jest dozwolone przed zakończeniem przetwarzania poprzedniego zdjęcia. Zalecamy takie rozwiązanie, szczególnie w przypadku aparatów, które wymagają długiego czasu przetwarzania.

Ta opcja została dodana na poziomie 2 interfejsu API.

AW
delayProcessingSupport Tablica logiczna

[true] oznacza, że przetwarzanie (np. łączenie) ma niższy priorytet niż przechwytywanie i zawsze jest opóźnione domyślnie.

[false] oznacza, że przetwarzanie odbywa się natychmiast po przechwyceniu.

[true, false] oznacza, że możesz wybrać między tymi 2 trybami.

Ta opcja została dodana na poziomie 2 interfejsu API.

R
clientVersion Liczba

Poziom interfejsu API wybranego przez klienta. Ustaw wartość domyślną 1, jeśli kamera obsługuje zarówno poziom API 1, jak i 2. Dzięki temu klienty zapisane na poziomie 1 interfejsu API będą nadal działać bez żadnych zmian. Jeśli kamera obsługuje tylko interfejs API 2, to nie jest to zalecane, zanim klienci przejdą na poziom 2. Jeśli kamera obsługuje tylko poziom 2 interfejsu API, żądanie ustawione na 1 nie powinno zakończyć się niepowodzeniem. Jeśli clientVersion ma wartość 2 i zostanie wysłane żądanie wycofanego z poziomu interfejsu API 1, żądanie powinno zakończyć się błędem z kodem błędu unknownCommand.

Ta opcja została dodana na poziomie 2 interfejsu API.

AW
photoStitchingSupport Tablica ciągów tekstowych

Lista opcji łączenia zdjęć. Zwraca wartość [ondevice], jeśli zdjęcia są zawsze zszywane w aparacie, [none], jeśli aparat nie może zszyć zdjęć, oraz [none,ondevice], jeśli połączenie jest konfigurowane przez użytkownika. Prefiksy nazw poszczególnych dostawców należy zakreślać znakiem podkreślenia, np. _vendor-setting.

Ta opcja została dodana na poziomie API 2.1.

R
photoStitching Ciąg znaków

Obecna opcja zszywania zdjęć, np. ondevice. Domyślnie jest on ustawiony na ondevice, jeśli jest obsługiwany.

Ta opcja została dodana na poziomie API 2.1.

AW
videoStitchingSupport Tablica ciągów tekstowych

Lista opcji łączenia filmów. Zwróć wartość [ondevice], jeśli film jest zawsze zszyty w aparacie, [none], jeśli kamera nie może zszyć filmów, oraz [none,ondevice], jeśli połączenie jest konfigurowane przez użytkownika. Prefiksy nazw poszczególnych dostawców należy zakreślać znakiem podkreślenia, np. _vendor-setting.

Ta opcja została dodana na poziomie API 2.1.

R
videoStitching Ciąg znaków

Obecna opcja zszywania filmów, np. ondevice. Domyślnie jest on ustawiony na ondevice, jeśli jest obsługiwany.

Ta opcja została dodana na poziomie API 2.1.

AW
videoGPSSupport Tablica ciągów tekstowych

Lista opcji GPS podczas nagrywania filmu. Zwraca wartość [continuous], jeśli kamera może regularnie rejestrować GPS podczas nagrywania filmu i umieszczać w nim lokalizacje. Zwraca wartość [none], jeśli nie może, i [none,continuous], jeśli obsługa GPS wideo jest konfigurowana przez użytkownika. Prefiksy nazw poszczególnych dostawców należy zakreślać znakiem podkreślenia, np. _vendor-setting.

Ta opcja została dodana na poziomie API 2.1.

R
videoGPS Ciąg znaków

Obecna opcja obsługi GPS podczas nagrywania filmu, np. continuous. Domyślnie jest on ustawiony na continuous, jeśli jest obsługiwany.

Ta opcja została dodana na poziomie API 2.1.

AW
_vendorSpecific [typ] (opcjonalnie) Dodatkowe opcje aparatu dotyczące poszczególnych dostawców. Prefiksy poszczególnych dostawców należy poprzedzać znakiem podkreślenia ( _ ).