Opciones

En la siguiente tabla, se muestran todas las opciones disponibles para establecer y obtener según camera.setOptions y camera.getOptions. No se puede cambiar una opción cuando la asistencia correspondiente está vacía o contiene solo una opción.

Nombre Tipo Descripción Lectura/escritura
captureMode String Modo de captura actual. La configuración predeterminada es image. rw
captureModeSupport Arreglo de strings Lista de modos de captura disponibles actualmente. El requisito mínimo para el nivel de API 1 es ["image"] y el mínimo para el nivel de API 2 es ["image", "interval"], en el que "interval" representa el modo de capturar una serie de imágenes a un intervalo determinado; consulta también captureInterval y captureIntervalSupport. Dos modos adicionales ("video" and "walkaround")son compatibles con el nivel de API 2; por lo tanto, el conjunto completo admitido por el nivel de API 2 es ["image", "interval", "video", "walkaround"], en el que "video" representa el modo de captura de video y "walkaround" representa el modo de captura de dos imágenes en secuencia. La primera es cuando los usuarios se encuentran en cualquier lugar relativo a la cámara y el segundo, con los usuarios de pie en el lado opuesto (relativo al primer punto de pie) de la cámara. Esto permite que la cámara quite a los usuarios de la imagen final combinando las dos imágenes. Cuando la cámara admita "walkaround" y esté configurado como el modo de captura actual, el cliente debería enviar dos comandos TakePicture a la cámara, en los que la respuesta del primer comando (cuando finalice) indicará que la cámara está lista para tomar la segunda imagen, mientras que el segundo comando debería mostrar la imagen final cuando finalice.

Para agregar más modos de captura que aún no se admiten, agrega un guion bajo para indicar los modos específicos de proveedores ( _ ).

Esta opción se modificó en el nivel de API 2.

r
captureStatus String Estado de captura actual. Margen aproximado predeterminado: "idle" Esto es útil para determinar el estado de la cámara cuando se conecta a una app por primera vez. Si la cámara se encuentra en medio de una grabación de video, es posible que se deba detener antes de realizar otras acciones, como otra grabación de video.

Esta opción se agregó en el nivel de API 2.1.

rw
captureStatusSupport Arreglo de strings Lista de estados de captura disponibles actualmente. De forma predeterminada, debe ser ["idle", "shooting"] si se admite la filmación de videos. También se pueden proporcionar otras estatuas, p.ej., "downloading".

Esta opción se agregó en el nivel de API 2.1.

r
exposureProgram Number Programa de exposición actual. rw
exposureProgramSupport Arreglo de números Lista de programas de exposición disponibles actualmente, por ejemplo, [0, 1, 2, 3, 4]. Cada número entero representa un programa de exposición diferente:
  • 0 = Sin definir
  • 1 = Manual
  • 2 = Programa normal
  • 3 = Prioridad de apertura
  • 4 = Prioridad del obturador
Selecciona el siguiente vínculo para descargar más detalles sobre ExposureProgram.
r
iso Number Configuración actual de la velocidad ISO. rw
isoSupport Arreglo de números

API nivel 1: Lista de opciones de configuración de ISO disponibles actualmente, por ejemplo, [100, 200, 400, 800,1600] o [] cuando está en modo auto.

API nivel 2: Lista de configuraciones ISO disponibles actualmente; por ejemplo, [0, 100, 200, 400, 800, 1600], donde 0 representa el modo auto.

Esta opción se modificó en el nivel de API 2.

r
shutterSpeed Number Configuración actual de velocidad del obturador rw
shutterSpeedSupport Arreglo de números

API nivel 1: Lista de las velocidades de obturador disponibles actualmente; por ejemplo, [0.067, 0.033, 0.017,0.008] o [] cuando se encuentra en modo auto.

API nivel 2: Lista de velocidades de obturador disponibles actualmente; por ejemplo, [0, 0.067, 0.033, 0.017, 0.008], donde 0 representa el modo auto.

Esta opción se modificó en el nivel de API 2.

r
aperture Number Configuración de apertura actual en f-stops. rw
apertureSupport Arreglo de números

API nivel 1: Lista de configuraciones de apertura disponibles actualmente, expresadas en f/number; por ejemplo, [1.4, 2, 2.8, 4, 5.6, 8, 11] o [] cuando está en modo auto.

API nivel 2: Lista de configuraciones de apertura disponibles actualmente, expresadas en f/number; por ejemplo, [0, 1.4, 2, 2.8, 4, 5.6, 8, 11], donde 0 representa el modo auto.

r
whiteBalance String Configuración actual del balance de blancos; por ejemplo, daylight. La configuración predeterminada es auto. rw
whiteBalanceSupport Arreglo de strings La configuración de lista de balance de blancos disponible actualmente puede ser un subconjunto de la lista predefinida:[ "auto", "incandescent", "fluorescent", "daylight", "cloudy-daylight", "shade", "twilight"]. Valores para cada uno:
  • incandescent, alrededor de 3,200,000
  • fluorescent, alrededor de 4,000,000
  • datalight, alrededor de 5,200,000
  • cloudy-daylight, alrededor de 6,000,000
  • shade, alrededor de 7,000,000
  • twilight, alrededor de 12,000,000
Prefija los nombres de las opciones de configuración específicos del proveedor con un guion bajo; por ejemplo: _vendor-setting
r
exposureCompensation Number Compensación de exposición actual. rw
exposureCompensationSupport Arreglo de números Lista de remuneraciones de exposición disponibles en la actualidad, generalmente en el paso 0.33 o 0.5 (por ejemplo: [-1, -0.67, -0.33, 0, 0.33, 0.67, 1]) r
fileFormat Objeto

Resolución y tipo de archivo actuales El formato debe reflejar el valor actual de captureMode. Por ejemplo, si captureMode es image, una respuesta adecuada podría ser la siguiente:

{
    "type": "jpeg",
    "width": 2000,
    "height": 1000
}
Si captureMode es video, una respuesta adecuada podría ser la siguiente:
{
    "type": "mp4",
    "width": 1920,
    "height": 1080,
    "framerate": 30
}

Esta opción se modificó en el nivel de API 2.

rw
fileFormatSupport Arreglo de objetos

Lista de los formatos de archivo disponibles actualmente; por ejemplo:

[
    {
    "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
    },
    ...
]
Selecciona el siguiente vínculo para obtener más información sobre todos los tipos.

Esta opción se modificó en el nivel de API 2.

r
exposureDelay Number El retraso actual entre el comando takePicture y el inicio de la exposición, en segundos. rw
exposureDelaySupport Arreglo de números Lista de demoras de exposición actualmente disponibles, en segundos; por ejemplo: [0, 1, 2, 5, 10, 30, 60] r
sleepDelay Number El retraso actual en segundos antes de que la cámara se suspenda. rw
sleepDelaySupport Arreglo de números Lista de las demoras de sueño disponibles en segundos (por ejemplo, [30, 60, 120, 300, 600, 1800, 65535]), donde 65535 inhabilita el modo de suspensión (la cámara no se suspende hasta que se apaga) y debe admitirse. r
offDelay Number Retraso actual en segundos antes de que se apague la cámara. rw
offDelaySupport Arreglo de números Lista de demoras de apagado disponibles actualmente, en segundos; por ejemplo, [1800, 3600, 7200, 65535], donde 65535 inhabilita el modo de apagado (la cámara no se apaga hasta que la batería se agote o se apague manualmente) y debe admitirse. r
totalSpace Number Solo lectura: la cantidad de bytes del almacenamiento total. r
remainingSpace Number Solo lectura: Cantidad de bytes de almacenamiento gratuito. r
remainingPictures Number Solo lectura: la cantidad estimada de imágenes restantes según la configuración de captura actual. r
gpsInfo Objeto

Información del GPS actual. Se establece con setOptions mediante el GPS del teléfono:

{
    "lat": 23.532,
    "lng": -132.35
}
Las propiedades lat y lng son grados decimales, con lat en el rango, [-90, 90] y lng en el rango, [-180, 180]. Cuando un teléfono lo proporciona, ten en cuenta que cada ubicación de GPS es válida solo hasta la próxima actualización del teléfono. El teléfono debe determinar cuándo actualizar la ubicación GPS; por ejemplo, justo antes de cada comando takePicture. 65535 notifica a la cámara que la ubicación GPS actual no es válida y que debe ignorarla y usar su propio GPS (si existe). Por ejemplo, setOptions({"gpsInfo": {"lat": 65535, "lng": 65535}}) significa que la ubicación GPS no es válida.
rw
dateTimeZone String Información sobre la fecha y hora actuales. Establecido por setOptions con la fecha, la hora y la zona horaria del teléfono. El formato es YYYY:MM:DD HH:MM:SS+(-)HH:MM. La hora tiene el formato de 24 horas, y la fecha y la hora están separadas por un espacio en blanco, y la zona horaria es una compensación de la hora UTC; por ejemplo, 2014:05:18 01:04:29+8:00 es la zona horaria de China (UTC+8:00). rw
hdr

API nivel 1: booleano

API nivel 2: string

API nivel 1: habilita o inhabilita el modo de captura de HDR. El valor es true para habilitar HDR o false para inhabilitarlo. El valor predeterminado es false. La configuración puede ser true solo cuando hdrSupport también es true.

API nivel 2: Modo HDR actual del tipo string.

Esta opción se modificó en el nivel de API 2.

rw
hdrSupport

API nivel 1: booleano

Nivel de API 2: arreglo de strings

API nivel 1: Un valor de true indica que la cámara admite HDR. Una configuración de false identifica una cámara sin HDR.

API nivel 2: Si no admites el modo HDR, es [“off”]. Si admites un modo HDR, es [“off”, “hdr”]. Si se admiten varios modos de HDR (diferentes algoritmos basados), significa [“off”, “hdr”, “hdr1”, “hdr2”, ...].

Esta opción se modificó en el nivel de API 2.

r
exposureBracket Objeto Configuración actual de corchetes de exposición. Solo está disponible cuando hdrSupport == true (nivel de API 1) o hdrSupport contiene al menos un modo HDR (nivel de API 2). Si la cámara usa horquillado de exposición manual, el objeto contiene dos entradas:
  1. shots, un número entero que contiene la cantidad de tomas que se tomarán.
  2. increment, un número que contiene un incremento de VE entre las tomas.
Por ejemplo:
{
    "shots": 3,
    "increment": 1.33
}
Si la cámara usa horquillado de exposición automática, el objeto contiene lo siguiente:
{
    "autoMode": true
}

Nivel de API 1: La configuración predeterminada es {} vacía cuando hdrSupport == false. Los fabricantes deciden los valores predeterminados (por ejemplo, horquillado de exposición automática), cuando hdr es true.

Nivel de API 2: el valor predeterminado es vacío {} cuando hdrSupport contiene solo "off". De lo contrario, los fabricantes deciden los valores predeterminados (por ejemplo, horquillado de exposición automática).

Esta opción se modificó en el nivel de API 2.

rw
exposureBracketSupport Objeto

La configuración de los corchetes de exposición está disponible actualmente. Por ejemplo:

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

API nivel 1: La configuración predeterminada es {} vacía si se configura en hdrSupport == false. Cuando es hdrSupport == true, pero no se admite el horquillado de exposición automática, autoMode será false.

Nivel de API 2: La configuración predeterminada es {} vacía si hdrSupport solo contiene "off". Cuando hdrSupport contenga cualquier modo HDR, pero no se admite el horquillado de exposición automática, autoMode será false.

Esta opción se modificó en el nivel de API 2.

r
gyro Booleano Configúralo en true para habilitar el módulo de giroscopio de la cámara o en false para inhabilitar esta función. El valor predeterminado es true si la cámara lo admite; de lo contrario, es false. Este parámetro de configuración puede ser true solo cuando gyroSupport == true. rw
gyroSupport Booleano Si la cámara tiene un giroscopio, este valor debe ser true; de lo contrario, es false. r
gps Booleano Habilita o inhabilita el módulo GPS de la cámara. El valor debe ser true para habilitar o false para inhabilitarlo. El valor predeterminado es true si la cámara lo admite; de lo contrario, es false. La configuración es true solo cuando gpsSupport == true. rw
gpsSupport Booleano Este valor debería ser true si la cámara tiene su propio módulo de GPS; de lo contrario, debería ser false. r
imageStabilization String Operación de estabilización de imagen actual; por ejemplo, off. rw
imageStabilizationSupport Arreglo de strings Hay opciones de estabilización de imagen disponibles actualmente. La lista predefinida es ["off", "on"].Si la cámara no admite la estabilización de la imagen, muestra ["off"]; de lo contrario, muestra ["off", "on"]. Prefija las strings específicas del proveedor con un guion bajo ( _ ); por ejemplo, [ "off", "_horizontal_stabilization", "_vibration_correction" ]. r
wifiPassword String
Debe tener al menos 8 caracteres y contener letras, números, símbolos, pero ningún espacio. Solo se puede cambiar cuando la cámara está conectada a un dispositivo cliente. Una vez que se modifique, la cámara debe desconectarse para que el usuario deba volver a conectarse con el nuevo wifiPassword.
La cámara debe proporcionar un mecanismo de restablecimiento en caso de que se olvide la contraseña; por ejemplo, un botón de restablecimiento para restablecer la contraseña predeterminada de fábrica.
w
previewFormat Objeto

Resolución actual de vista previa en vivo; por ejemplo:

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

Esta opción se agregó en el nivel de API 2.

rw
previewFormatSupport Arreglo de objetos

Actualmente, se admiten los formatos de vista previa en vivo, por ejemplo:

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

Esta opción se agregó en el nivel de API 2.

r
captureInterval Number Intervalo actual entre la captura de dos imágenes consecutivas, en seconds.

Esta opción se agregó en el nivel de API 2.

rw
captureIntervalSupport Objeto

Intervalos mínimos y máximos permitidos entre la captura de dos imágenes consecutivas, en segundos; por ejemplo:

{
    "minInterval": 10,
    "maxInterval": 60
}
Puede variar según fileFormat.

Esta opción se agregó en el nivel de API 2.

r
captureNumber Number Cantidad de imágenes que se deben capturar durante una sesión de captura por intervalos. La configuración predeterminada es 0, lo que significa que la captura debe finalizarse explícitamente con el comando stopCapture; de lo contrario, se detendrá automáticamente después de capturar imágenes del número especificado. La captura también se puede interrumpir cuando la cámara se queda sin batería o se apaga intencionalmente.

Esta opción se agregó en el nivel de API 2.

rw
captureNumberSupport Objeto

Cantidad mínima y máxima de imágenes que se pueden capturar durante una captura en intervalos; por ejemplo:

{
    "minNumber": 2,
    "maxNumber": 50
}
Es posible que cambie según el almacenamiento restante.

Esta opción se agregó en el nivel de API 2.

r
remainingVideoSeconds Number Cantidad estimada de seconds para el video restante según la configuración de captura actual.

Esta opción se agregó en el nivel de API 2.

r
pollingDelay Number Intervalo mínimo en segundos entre dos solicitudes de sondeo de estado consecutivas. Los clientes deben usar este campo para guiar su comportamiento de sondeo de estado. Por ejemplo, cuando se une una imagen, es posible que los clientes tengan que sondear la cámara de forma periódica para ver si termina de unirse. Las diferentes cámaras tienen compatibilidad diferente; por ejemplo, algunas cámaras pueden controlar el sondeo de estado cada segundo, mientras que otras admiten intervalos más largos.

Esta opción se agregó en el nivel de API 2.

r
delayProcessing Booleano True cuando se procesa (p.ej., la unión) tiene una prioridad más baja que la captura o, en otras palabras, se permite otra captura antes de que finalice el procesamiento de la imagen capturada anterior. Esto es muy recomendable, especialmente para las cámaras que requieren mucho tiempo de procesamiento.

Esta opción se agregó en el nivel de API 2.

rw
delayProcessingSupport Arreglo booleano

[true] significa que el procesamiento (p.ej., unión de imágenes) tiene una prioridad más baja que la captura y siempre se retrasa de forma predeterminada.

[false] significa que el procesamiento se realiza inmediatamente después de la captura.

[true, false] significa que hay una opción entre estos dos modos.

Esta opción se agregó en el nivel de API 2.

r
clientVersion Number

El nivel de API que el cliente decide usar. El valor predeterminado es 1 si la cámara admite los niveles de API 1 y 2, de modo que los clientes escritos para el nivel de API 1 aún funcionan con la cámara sin ningún cambio; en la configuración predeterminada, es 2 si la cámara solo admite el nivel de API 2, lo cual no se recomienda antes de que los clientes migren al nivel de API 2. Si la cámara solo admite el nivel de API 2, la solicitud que intenta establecerla en 1 debería fallar. Si clientVersion se establece en 2 correctamente y se solicita un comando obsoleto desde el nivel de API 1, la solicitud debería fallar con el código de error unknownCommand.

Esta opción se agregó en el nivel de API 2.

rw
photoStitchingSupport Arreglo de strings

Lista de opciones de unión de fotos. Muestra [ondevice] si las fotos siempre se unen en la cámara, [none] si la cámara no puede unir fotos y [none,ondevice] si el usuario lo puede configurar. Prefija los nombres de las opciones de configuración específicos del proveedor con un guion bajo, p.ej., _vendor-setting.

Esta opción se agregó en el nivel de API 2.1.

r
photoStitching String

Opción de unión actual de las fotos, p.ej., ondevice. Si es compatible, el valor predeterminado es ondevice.

Esta opción se agregó en el nivel de API 2.1.

rw
videoStitchingSupport Arreglo de strings

Lista de opciones de unión de videos. Muestra [ondevice] si los videos se unen siempre en la cámara, [none] si la cámara no puede unir videos y [none,ondevice] si el usuario puede configurarlo. Prefija los nombres de las opciones de configuración específicos del proveedor con un guion bajo, p.ej., _vendor-setting.

Esta opción se agregó en el nivel de API 2.1.

r
videoStitching String

Opción de unión actual para los videos, p.ej., ondevice. Si es compatible, el valor predeterminado es ondevice.

Esta opción se agregó en el nivel de API 2.1.

rw
videoGPSSupport Arreglo de strings

Lista de opciones de GPS durante la captura de video. Muestra [continuous] si la cámara puede capturar continuamente el GPS durante la captura de video e incorporar las ubicaciones en el video. Muestra [none] si no puede hacerlo y [none,continuous] si el usuario puede configurar la compatibilidad con GPS de video. Prefija los nombres de configuración específicos del proveedor con un guion bajo, p.ej., _vendor-setting.

Esta opción se agregó en el nivel de API 2.1.

r
videoGPS String

Opción actual de compatibilidad con GPS durante la captura de video, p.ej., continuous. Si es compatible, el valor predeterminado es continuous.

Esta opción se agregó en el nivel de API 2.1.

rw
_vendorSpecific [tipo] (opcional) Opciones de cámara adicionales específicas del proveedor Prefija las strings específicas del proveedor con un guion bajo ( _ ).