Опции

В следующей таблице показаны все параметры, доступные для установки и получения с помощью camera.setOptions и camera.getOptions . Опция не может быть изменена, если соответствующая поддержка пуста или содержит только одну опцию.

Имя Тип Описание Читай пиши
captureMode Нить Текущий режим захвата. По умолчанию image. RW
captureModeSupport Массив строк Список режимов захвата, доступных в настоящее время. Минимальные требования для уровня API 1 – ["image"] , а минимальные требования для уровня API 2 – ["image", "interval"] , где "interval" представляет собой режим захвата серии изображений с определенным интервалом, см. также captureInterval и captureIntervalSupport . Два дополнительных режима ("video" and "walkaround") поддерживаются уровнем API 2, поэтому полный набор, поддерживаемый уровнем API 2, — это ["image", "interval", "video", "walkaround"] , где "video" представляет режим захвата видео, а "walkaround" представляет собой режим последовательного захвата двух изображений, первое из которых состоит из пользователей, стоящих в любом месте относительно камеры, а второе - из пользователей, стоящих на противоположной стороне (относительно первой точки стояния) камеры. Это позволяет камере удалить пользователей из конечного изображения, объединив два изображения. Когда "walkaround" поддерживается камерой и установлен в качестве текущего режима захвата, клиент должен ожидать отправки на камеру двух команд takePicture, где ответ первой команды (после ее завершения) указывает, что камера готова к съемке. второе изображение, в то время как вторая команда должна вернуть окончательное изображение после завершения.

Чтобы добавить дополнительные режимы захвата, которые еще не поддерживаются, добавьте к режимам, зависящим от поставщика, префикс подчеркивания ( _ ).

Эта опция была изменена на уровне API 2.

 р
captureStatus Нить Текущий статус захвата. По умолчанию "idle" . Это полезно для определения состояния камеры при первом подключении к приложению. Если камера находится в процессе съемки видео, может потребоваться ее остановка перед выполнением других действий, например другой видеосъемки.

Эта опция была добавлена ​​на уровне API 2.1.

 RW
captureStatusSupport Массив строк Список доступных на данный момент статусов захвата; По умолчанию должно быть ["idle", "shooting"] , если видеосъемка поддерживается. Могут быть предоставлены и другие статуи, например, "downloading" .

Эта опция была добавлена ​​на уровне API 2.1.

 р
exposureProgram Число Текущая программа экспозиции. RW
exposureProgramSupport Массив чисел Список программ воздействия, доступных в настоящее время; например, [0, 1, 2, 3, 4] . Каждое целое число представляет собой отдельную программу экспозиции:
  • 0 = не определено
  • 1 = ручной
  • 2 = обычная программа
  • 3 = приоритет диафрагмы
  • 4 = приоритет выдержки
Выберите следующую ссылку, чтобы загрузить дополнительную информацию об ExposureProgram .		 р
iso Число Текущая настройка чувствительности ISO. RW
isoSupport Массив чисел

Уровень API 1: список доступных в настоящее время настроек ISO; например, [100, 200, 400, 800,1600] или [] в auto режиме.

Уровень API 2: список доступных в настоящее время настроек ISO; например, [0, 100, 200, 400, 800, 1600] , где 0 представляет auto режим.

Эта опция была изменена на уровне API 2.

 р
shutterSpeed Число Текущая настройка скорости затвора. RW
shutterSpeedSupport Массив чисел

Уровень API 1: список доступных в настоящее время выдержек; например, [0.067, 0.033, 0.017,0.008] или [] , когда он находится в auto режиме.

Уровень API 2: Список доступных в настоящее время выдержек затвора; например, [0, 0.067, 0.033, 0.017, 0.008] , где 0 представляет auto режим.

Эта опция была изменена на уровне API 2.

 р
aperture Число Текущая настройка диафрагмы в диафрагменных ступенях. RW
apertureSupport Массив чисел

Уровень API 1: список доступных в настоящее время настроек диафрагмы, выраженный в f/number ; например, [1.4, 2, 2.8, 4, 5.6, 8, 11] или [] в auto режиме.

Уровень API 2: список доступных в настоящее время настроек диафрагмы, выраженный в f/number ; например, [0, 1.4, 2, 2.8, 4, 5.6, 8, 11] , где 0 представляет auto режим.

 р
whiteBalance Нить Текущая настройка баланса белого; например, daylight . По умолчанию auto . RW
whiteBalanceSupport Массив строк Список настроек баланса белого, доступных в настоящее время, может быть подмножеством предопределенного списка: [ "auto", "incandescent", "fluorescent", "daylight", "cloudy-daylight", "shade", "twilight"] . Значения для каждого:
  • incandescent , около 3200К
  • fluorescent , около 4000K
  • datalight , около 5200K
  • cloudy-daylight , около 6000K
  • shade , около 7000K
  • twilight , около 12000К
Добавляйте в имена настроек, зависящих от поставщика, префикс подчеркивания; например: _vendor-setting		 р
exposureCompensation Число Текущая компенсация экспозиции. RW
exposureCompensationSupport Массив чисел Список компенсаций экспозиции, доступных в настоящее время, обычно на шаге 0,33 или 0,5; например: [-1, -0.67, -0.33, 0, 0.33, 0.67, 1] р
fileFormat Объект

Текущий тип файла и разрешение. Формат должен отражать текущее значение captureMode . Например, если captureMode используется image , соответствующий ответ может быть таким:

{
    "type": "jpeg",
    "width": 2000,
    "height": 1000
}
Если captureMode задано значение video , соответствующий ответ может быть следующим:
{
    "type": "mp4",
    "width": 1920,
    "height": 1080,
    "framerate": 30
}

Эта опция была изменена на уровне API 2.

 RW
fileFormatSupport Массив объектов

Список форматов файлов, доступных в настоящее время; Например:

[
    {
    "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
    },
    ...
]
Выберите следующую ссылку для получения дополнительной информации обо всех типах .

Эта опция была изменена на уровне API 2.

 р
exposureDelay Число Текущая задержка между командой takePicture и началом экспозиции в секундах. RW
exposureDelaySupport Массив чисел Список доступных в настоящее время задержек экспозиции в секундах; например: [0, 1, 2, 5, 10, 30, 60] р
sleepDelay Число Текущая задержка перед переходом камеры в спящий режим в секундах. RW
sleepDelaySupport Массив чисел Список доступных в настоящее время задержек сна в секундах; например, [30, 60, 120, 300, 600, 1800, 65535] , где 65535 отключает спящий режим (камера не спит, пока не выключится) и должно поддерживаться. р
offDelay Число Текущая задержка в секундах перед выключением камеры. RW
offDelaySupport Массив чисел Список доступных в настоящее время задержек отключения питания в секундах; например, [1800, 3600, 7200, 65535] , где 65535 отключает режим отключения питания (камера не выключается, пока батарея не разрядится или не выключится вручную) и должно поддерживаться. р
totalSpace Число Только для чтения: общее количество байтов хранилища. р
remainingSpace Число Только для чтения: количество байтов свободного хранилища. р
remainingPictures Число Только для чтения: расчетное количество оставшихся изображений на основе текущих настроек захвата. р
gpsInfo Объект

Текущая информация GPS. Установите с помощью setOptions с помощью GPS телефона:

{
    "lat": 23.532,
    "lng": -132.35
}
Свойства lat и lng представляют собой десятичные градусы, где lat находится в диапазоне [-90, 90] , а lng — в диапазоне [-180, 180] . Обратите внимание, что если данные предоставляются с телефона, каждое местоположение GPS действительно только до следующего обновления с телефона. Телефон должен определить, когда обновлять местоположение GPS; например, прямо перед каждой командой takePicture . 65535 уведомляет камеру о том, что текущее местоположение GPS является недействительным, и камера должна игнорировать его и использовать собственный GPS, если он существует; например, setOptions({"gpsInfo": {"lat": 65535, "lng": 65535}}) означает, что местоположение GPS недействительно.		 RW
dateTimeZone Нить Информация о текущей дате и времени. Устанавливается setOptions с использованием даты, времени и часового пояса телефона. Формат: YYYY:MM:DD HH:MM:SS+(-)HH:MM . Время указано в 24-часовом формате, дата и время разделены пробелом, а часовой пояс является смещением от времени UTC; например, 2014:05:18 01:04:29+8:00 — часовой пояс Китая (UTC+8:00). RW
hdr

Уровень API 1: логическое значение

Уровень API 2: Строка

Уровень API 1: включить/отключить режим захвата HDR. Значение true , чтобы включить HDR, или false , чтобы отключить его. Значение по умолчанию — false . Параметр может иметь значение true только тогда, когда hdrSupport также равно true .

Уровень API 2: Текущий режим HDR типа String.

Эта опция была изменена на уровне API 2.

 RW
hdrSupport

Уровень API 1: логическое значение

Уровень API 2: массив строк

Уровень API 1: значение true означает, что камера поддерживает HDR. false настройка идентифицирует камеру без HDR.

Уровень API 2: если вы не поддерживаете режим HDR, он [“off”] ; если вы поддерживаете один режим HDR, это [“off”, “hdr”] , если поддерживаются несколько режимов HDR (на основе разных алгоритмов), то это [“off”, “hdr”, “hdr1”, “hdr2”, ...]

Эта опция была изменена на уровне API 2.

 р
exposureBracket Объект Текущая настройка брекетинга экспозиции. Доступно, только если hdrSupport == true (уровень API 1) или hdrSupport содержит хотя бы один режим HDR (уровень API 2) . Если камера использует ручной брекетинг экспозиции, объект содержит две записи:
  1. shots , целое число, содержащее количество снимков, которые необходимо сделать.
  2. increment , число, содержащее приращение EV между выстрелами.
Например: 
{
    "shots": 3,
    "increment": 1.33
}
Если в камере используется автоматический брекетинг экспозиции, объект содержит: 
{
    "autoMode": true
}

Уровень API 1: по умолчанию пусто {} , когда hdrSupport == false . Производители выбирают значения по умолчанию (например, автоматический брекетинг экспозиции), когда для hdr установлено значение true .

Уровень API 2: по умолчанию пусто {}, когда hdrSupport содержит только "off" . В противном случае производители выбирают значения по умолчанию (например, автоматический брекетинг экспозиции).

Эта опция была изменена на уровне API 2.

 RW
exposureBracketSupport Объект

В настоящее время доступны настройки брекетинга экспозиции; Например:

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

Уровень API 1: по умолчанию пусто {} , если hdrSupport == false . Когда hdrSupport == true , но автоматический брекетинг экспозиции не поддерживается, тогда autoMode будет false .

Уровень API 2: по умолчанию пустой {} , если hdrSupport содержит только "off" . Когда hdrSupport содержит какой-либо режим HDR, но автоматический брекетинг экспозиции не поддерживается, тогда autoMode будет иметь значение false .

Эта опция была изменена на уровне API 2.

 р
gyro логический Установите значение true , чтобы включить модуль гироскопа камеры, или значение false , чтобы отключить эту функцию. По умолчанию true , если камера это поддерживает, иначе false . Этот параметр может быть true , только если gyroSupport == true . RW
gyroSupport логический Если у камеры есть гироскоп, это значение должно быть true , иначе — false . р
gps логический Включает/отключает модуль GPS камеры. Значение должно быть true , чтобы включить, или false , чтобы отключить. Значение по умолчанию — true , если камера его поддерживает, в противном случае — false . Параметр true только тогда, когда gpsSupport == true . RW
gpsSupport логический Это значение должно быть true , если у камеры есть собственный модуль GPS, в противном случае — false . р
imageStabilization Нить Текущая операция стабилизации изображения; например off . RW
imageStabilizationSupport Массив строк В настоящее время доступны варианты стабилизации изображения. Предопределенный список: ["off", "on"] . Если камера не поддерживает стабилизацию изображения, верните ["off"] , в противном случае верните ["off", "on"] . Ставьте перед строками, специфичными для поставщика, символ подчеркивания ( _ ); например, [ "off", "_horizontal_stabilization", "_vibration_correction" ] . р
wifiPassword Нить
Не менее 8 символов, содержащих буквы, цифры, символы, но без пробелов. Его можно изменить, только когда камера подключена к клиентскому устройству. После изменения камера должна отключиться, поэтому пользователь должен повторно подключиться, используя новый wifiPassword .
В камере должен быть предусмотрен механизм сброса на случай, если пароль будет забыт; например, кнопка сброса для восстановления заводского пароля по умолчанию.
 ж
previewFormat Объект

Текущее разрешение предварительного просмотра в реальном времени; Например:

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

Эта опция была добавлена ​​на уровне API 2.

 RW
previewFormatSupport Массив объектов

В настоящее время поддерживаются форматы предварительного просмотра в реальном времени; Например:

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

Эта опция была добавлена ​​на уровне API 2.

 р
captureInterval Число Текущий интервал между захватом двух последовательных изображений в seconds .

Эта опция была добавлена ​​на уровне API 2.

 RW
captureIntervalSupport Объект

Минимальные и максимальные интервалы между захватом двух последовательных изображений в секундах; Например:

{
    "minInterval": 10,
    "maxInterval": 60
}
Может варьироваться в зависимости от fileFormat .

Эта опция была добавлена ​​на уровне API 2.

 р
captureNumber Число Количество изображений, которые необходимо захватить за один сеанс захвата с интервалом. По умолчанию 0 , что означает, что захват должен быть прекращен явным образом командой stopCapture ; в противном случае захват останавливается автоматически после захвата изображений с указанным номером. Съемка также может быть прервана, когда в камере разрядился аккумулятор или она была намеренно выключена.

Эта опция была добавлена ​​на уровне API 2.

 RW
captureNumberSupport Объект

Минимальное и максимальное количество изображений, которые могут быть захвачены во время захвата интервала; Например:

{
    "minNumber": 2,
    "maxNumber": 50
}
Может измениться в зависимости от оставшегося места на диске.

Эта опция была добавлена ​​на уровне API 2.

 р
remainingVideoSeconds Число Расчетное количество seconds для оставшегося видео на основе текущих настроек захвата.

Эта опция была добавлена ​​на уровне API 2.

 р
pollingDelay Число Минимальный интервал в секундах между двумя последовательными запросами на опрос состояния. Клиенты должны использовать это поле для управления своим поведением при опросе состояния; например, когда он сшивает изображение, клиентам может потребоваться периодически опрашивать камеру, чтобы узнать, заканчивает ли она сшивку. Разные камеры имеют разную поддержку; например, некоторые камеры могут обрабатывать опрос состояния каждую секунду, в то время как другие поддерживают более длительный интервал.

Эта опция была добавлена ​​на уровне API 2.

 р
delayProcessing логический True , если обработка (например, сшивание) имеет более низкий приоритет, чем захват, или, другими словами, другой захват разрешен до завершения обработки предыдущего захваченного изображения. Это настоятельно рекомендуется, особенно для камер, требующих длительного времени обработки.

Эта опция была добавлена ​​на уровне API 2.

 RW
delayProcessingSupport Логический массив

[true] означает, что обработка (например, сшивание) имеет более низкий приоритет, чем захват, и всегда откладывается по умолчанию.

[false] означает, что обработка происходит сразу после захвата.

[true, false] означает, что есть выбор между этими двумя режимами.

Эта опция была добавлена ​​на уровне API 2.

 р
clientVersion Число

Уровень API, который клиент решает использовать. Значение по умолчанию 1, если камера поддерживает оба API уровня 1 и 2, чтобы клиенты, написанные для API уровня 1, по-прежнему работали с камерой без каких-либо изменений; по умолчанию — 2, если камера поддерживает только уровень API 2, что не рекомендуется делать до перехода клиентов на уровень API 2. Если камера поддерживает только уровень API 2, запрос, пытающийся установить для него значение 1, должен завершиться ошибкой. Если clientVersion успешно установлен на 2 и запрашивается устаревшая команда из уровня API 1, запрос должен завершаться ошибкой с кодом unknownCommand .

Эта опция была добавлена ​​на уровне API 2.

 RW
photoStitchingSupport Массив строк

Список вариантов сшивания фотографий. Возвратите [ondevice] , если фотографии всегда сшиваются на камере, [none] , если камера не может сшивать фотографии, и [none,ondevice] если сшивание настраивается пользователем. Добавляйте в имена настроек, специфичных для производителя, префикс подчеркивания, например, _vendor-setting .

Эта опция была добавлена ​​на уровне API 2.1.

 р
photoStitching Нить

Текущий вариант сшивания фотографий, например ondevice . По умолчанию на ondevice , если оно поддерживается.

Эта опция была добавлена ​​на уровне API 2.1.

 RW
videoStitchingSupport Массив строк

Список вариантов сшивания видео. Возвратите [ondevice] , если видео всегда сшиваются на камере, [none] , если камера не может сшивать видео, и [none,ondevice] если сшивание настраивается пользователем. Добавляйте в имена настроек, специфичных для производителя, префикс подчеркивания, например, _vendor-setting .

Эта опция была добавлена ​​на уровне API 2.1.

 р
videoStitching Нить

Текущий вариант сшивания видео, например ondevice . По умолчанию на ondevice , если оно поддерживается.

Эта опция была добавлена ​​на уровне API 2.1.

 RW
videoGPSSupport Массив строк

Список опций GPS во время захвата видео. Возвратите [continuous] , если камера может непрерывно захватывать GPS во время захвата видео и вставлять местоположения в видео. Возвратите [none] , если это невозможно, и [none,continuous] если поддержка видео GPS настраивается пользователем. Добавляйте в имена настроек, специфичных для производителя, префикс подчеркивания, например, _vendor-setting .

Эта опция была добавлена ​​на уровне API 2.1.

 р
videoGPS Нить

Текущий вариант поддержки GPS во время захвата видео, например, continuous . По умолчанию continuous , если он поддерживается.

Эта опция была добавлена ​​на уровне API 2.1.

 RW
_vendorSpecific [тип] (необязательно) Дополнительные параметры камеры, зависящие от производителя. Строки, зависящие от поставщика, снабжаются префиксом подчеркивания ( _ ).