Параметры

В следующей таблице показаны все параметры, доступные для установки и получения с помощью 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 , около 4000К
  • datalight , около 5200К
  • cloudy-daylight , около 6000К
  • shade , около 7000К
  • 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, запрос должен завершиться неудачно с кодом ошибкиknownCommand .

Эта опция была добавлена ​​на уровне 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 [тип] (необязательно) Дополнительные опции камеры, зависящие от производителя. Строки, специфичные для конкретного поставщика, префикс с подчеркиванием ( _ ).