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 si su compatibilidad correspondiente está vacía o contiene solo una opción.

Nombre Tipo Descripción Lectura/escritura
captureMode String Modo de captura actual. Valor predeterminado: image. rw
captureModeSupport Array de cadenas Lista de modos de captura disponibles actualmente. El requisito mínimo para el nivel de API 1 es ["image"] y el requisito 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 separadas en un intervalo determinado. Consulta también captureInterval y captureIntervalSupport. El nivel de API 2 admite dos modos adicionales, por lo que el conjunto completo admitido por el nivel de API 2 es ["image", "interval", "video", "walkaround"], donde "video" representa el modo de captura de video y "walkaround" representa el modo de capturar dos imágenes en secuencia: el primero con los usuarios de pie en relación con la cámara y el segundo con los usuarios de pie en el lado opuesto (en relación con el primer punto de pie) de la cámara.("video" and "walkaround") Esto permite que la cámara quite a los usuarios de la imagen final combinando las dos imágenes. Cuando la cámara admite "walkaround" y está configurado en el modo de captura actual, el cliente debe esperar enviar dos comandos takePicture a la cámara, en los que la respuesta del primer comando (cuando finaliza) indica que la cámara está lista para tomar la segunda imagen, mientras que el segundo comando debe mostrar la imagen final cuando finalice.

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

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 está grabando un video, es posible que deba detenerse antes de que se le indique que realice otras acciones, p.ej., otra grabación de video.

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

 rw
captureStatusSupport Array de cadenas Lista de estados de captura disponibles actualmente. De forma predeterminada, debe ser ["idle", "shooting"] si se admite la grabación de video. También se pueden proporcionar otras estatuas, como, por ejemplo, "downloading"

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

 r
exposureProgram Número Programa de exposición actual. rw
exposureProgramSupport Array 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 = No definido
  • 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 Número Configuración de la velocidad ISO actual. rw
isoSupport Array de números

Nivel de API 1: Lista de configuraciones ISO disponibles en la actualidad. Por ejemplo, [100, 200, 400, 800,1600] o [] cuando está en modo auto.

Nivel de API 2: Lista de configuraciones ISO disponibles en la actualidad. 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 Número Configuración actual de la velocidad del obturador. rw
shutterSpeedSupport Array de números

Nivel de API 1: Lista de velocidades del obturador disponibles actualmente. Por ejemplo, [0.067, 0.033, 0.017,0.008] o [] cuando está en modo auto.

Nivel de API 2: Lista de velocidades del 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 Número Ajuste de apertura actual, en f-stops. rw
apertureSupport Array de números

Nivel de API 1: Lista de la configuración de apertura disponible actualmente, expresada en f/number. para Por ejemplo, [1.4, 2, 2.8, 4, 5.6, 8, 11] o [] cuando está en modo auto.

Nivel de API 2: Lista de la configuración de apertura disponible actualmente, expresada 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 Array de cadenas La lista de parámetros de configuración 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, aproximadamente 3200 000
  • fluorescent, alrededor de 4,000 000
  • datalight, aproximadamente 5200 000
  • cloudy-daylight, alrededor de 6,000,000
  • shade, alrededor de 7,000,000
  • twilight, alrededor de 12,000,000
Prefijar los nombres de configuración específicos del proveedor con un guion bajo; por ejemplo: _vendor-setting		 r
exposureCompensation Número Compensación de exposición actual. rw
exposureCompensationSupport Array de números Lista de compensaciones de exposición disponibles actualmente, por lo general, en el paso 0.33 o 0.5; por ejemplo: [-1, -0.67, -0.33, 0, 0.33, 0.67, 1] r
fileFormat Objeto

Tipo de archivo y resolución 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: 
{
    "type": "mp4",
    "width": 1920,
    "height": 1080,
    "framerate": 30
}

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

 rw
fileFormatSupport Array 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 Número Es el retraso actual, en segundos, entre el comando takePicture y el inicio de la exposición. rw
exposureDelaySupport Array de números Lista de retrasos de exposición disponibles actualmente, en segundos. por ejemplo: [0, 1, 2, 5, 10, 30, 60] r
sleepDelay Número Retraso actual, en segundos, antes de que la cámara se suspenda. rw
sleepDelaySupport Array de números Lista de las demoras del sueño disponibles actualmente, en segundos; Por ejemplo, [30, 60, 120, 300, 600, 1800, 65535], en el que 65535 inhabilita el modo reposo (la cámara no se suspende hasta que se apaga) y debe ser compatible. r
offDelay Número Es el retraso actual en segundos antes de que se apague la cámara. rw
offDelaySupport Array de números Lista de demoras en el apagado disponibles actualmente, en segundos; Por ejemplo, [1800, 3600, 7200, 65535], en el que 65535 inhabilita el modo apagado (la cámara no se apaga hasta que se agote la batería o se apague de forma manual) y debe ser compatible. r
totalSpace Número Solo lectura: Cantidad de bytes del almacenamiento total. r
remainingSpace Número Solo lectura: Cantidad de bytes de almacenamiento gratuito. r
remainingPictures Número Solo lectura: Cantidad estimada de imágenes restantes en función de la captura actual del lugar. r
gpsInfo Objeto

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

{
    "lat": 23.532,
    "lng": -132.35
}
Las propiedades lat y lng son grados decimales, y lat en el rango, [-90, 90] y lng en el rango, [-180, 180]. Si la proporciona un teléfono, ten en cuenta que cada ubicación GPS solo es válida hasta la próxima actualización del teléfono. El teléfono debe determinar cuándo actualizarse la ubicación GPS; por ejemplo, justo antes de cada comando takePicture. 65535 notifica a la cámara que la ubicación actual del GPS no es válida y que la cámara debes ignorarlo y usar su propio GPS, si existe. por ejemplo, setOptions({"gpsInfo": {"lat": 65535, "lng": 65535}}) significa que la ubicación GPS es no válido.		 rw
dateTimeZone String Información de fecha y hora actuales. Se establece 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, la fecha y la hora están separadas por un espacio en blanco y la zona horaria es una diferencia respecto 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

Nivel de API 1: Booleano

Nivel de API 2: cadena

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

Nivel de API 2: Modo HDR actual de tipo de cadena.

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

 rw
hdrSupport

Nivel de API 1: Booleano

Nivel de API 2: array de cadenas

Nivel de API 1: Un valor de true significa que la cámara es compatible con HDR. Un parámetro de configuración false identifica una cámara sin HDR.

Nivel de API 2: Si no admites el modo HDR, esta [“off”]; Si admites un modo HDR, el valor es [“off”, “hdr”]. Si se admiten varios modos HDR (basados en algoritmos diferentes), el valor será [“off”, “hdr”, “hdr1”, “hdr2”, ...].

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

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

Nivel de API 1: El valor predeterminado es {} cuando el valor es hdrSupport == false. Los fabricantes deciden los valores predeterminados (por ejemplo, corchetes de exposición automática) cuando hdr es true.

Nivel de API 2: Se establece de forma predeterminada como {} vacío cuando hdrSupport contiene solo "off". De lo contrario, los fabricantes deciden 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 del corchete 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]
}

Nivel de API 1: El valor predeterminado es {} si es hdrSupport == false. Si es hdrSupport == true, pero no se admite el horquillado de exposición automática, el valor de autoMode será false.

Nivel de API 2: El valor predeterminado es {} vacío si hdrSupport solo contiene "off". Si hdrSupport contiene algún modo HDR, pero no se admite el horquillado de exposición automático, el valor de 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 solo puede ser true cuando gyroSupport == true. rw
gyroSupport Booleano Si la cámara tiene un giroscopio, este valor debe ser true; de lo contrario, false. r
gps Booleano Habilita o inhabilita el módulo de GPS de la cámara. El valor debe ser true para habilitarlo o false para inhabilitarlo. El valor predeterminado es true si la cámara lo admite; de lo contrario, es false. El parámetro de configuración es true solo cuando gpsSupport == true. rw
gpsSupport Booleano Este valor debe ser true si la cámara tiene su propio módulo GPS; de lo contrario, debe ser false. r
imageStabilization String Operación de estabilización de imagen actual. por ejemplo, off. rw
imageStabilizationSupport Array de cadenas Opciones de estabilización de imagen disponibles actualmente. La lista predefinida es ["off", "on"].Si la cámara no admite la estabilización de imagen, muestra ["off"]; de lo contrario, muestra ["off", "on"]. Prefija las cadenas 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 del cliente. Una vez que se modifique, la cámara se debe desconectar, por lo que el usuario debe 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 la 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 Array de objetos

Formatos de vista previa en vivo que se admiten actualmente 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 Número Es el 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 Número Cantidad de imágenes que se deben capturar para una sesión de captura en intervalo El valor predeterminado es 0, lo que significa que la captura debe finalizarse de manera explícita con el comando stopCapture. De lo contrario, la captura se detendrá automáticamente después de capturar las imágenes del número especificado. La captura también puede interrumpirse cuando la cámara se queda sin batería o cuando 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 intervalo por ejemplo:

{
    "minNumber": 2,
    "maxNumber": 50
}
Puede cambiar según el almacenamiento restante.

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

 r
remainingVideoSeconds Número Cantidad estimada de seconds para el video restante en función de la configuración de captura actual.

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

 r
pollingDelay Número Intervalo mínimo en segundos entre dos solicitudes consecutivas de sondeo de estado. Los clientes deben usar este campo para guiar su comportamiento de sondeo de estado. Por ejemplo, cuando unen una imagen, es posible que los clientes deban consultar la cámara periódicamente para ver si termina de unirse. Las diferentes cámaras tienen una 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 el procesamiento (p.ej., unión) tiene una prioridad menor 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 un tiempo de procesamiento prolongado.

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

 rw
delayProcessingSupport Array booleano

[true] significa que el procesamiento (p.ej., unión) tiene una prioridad menor 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 puedes elegir entre estos dos modos.

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

 r
clientVersion Número

El nivel de API que el cliente decide usar. El valor predeterminado es 1 si cámara admite niveles de API 1 y 2, de modo que los clientes escritos para El nivel de API 1 sigue funcionando con la cámara sin ningún cambio. predeterminado en 2 si la cámara solo admite el nivel de API 2, que no es 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 establecerlo en 1 debe fallan. Si clientVersion se establece en 2 correctamente y en una obsoleto desde el nivel de API 1, se solicita debería fallar con el código de error unknownCommand.

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

 rw
photoStitchingSupport Array de cadenas

Lista de opciones de unión para fotos. Regresar [ondevice] si las fotos siempre se unen en la cámara, [none] si la cámara no puede unir fotos [none,ondevice] si la unión es configurable por el usuario. Prefija los nombres de los parámetros 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 actual de unión de fotos, p.ej., ondevice El valor predeterminado es ondevice si es no es compatible.

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

 rw
videoStitchingSupport Array de cadenas

Lista de opciones de unión para los videos. Regresar [ondevice] si los videos siempre se unen en la cámara, [none] si la cámara no puede unir videos [none,ondevice] si la unión es configurable por el usuario. Prefija los nombres de los parámetros 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 actual de unión para los videos, p.ej., ondevice El valor predeterminado es ondevice si es no es compatible.

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

 rw
videoGPSSupport Array de cadenas

Lista de opciones de GPS durante la captura de video. Regresar [continuous] si la cámara puede capturar el GPS de forma continua durante la captura del video e incorpora las ubicaciones en el video. Regresar [none] si no puede y [none,continuous] si el usuario puede configurar la compatibilidad con GPS para video. Prefijo específico del proveedor nombres de parámetros de configuración con un guion bajo, por ejemplo, _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 El valor predeterminado es continuous si es no es compatible.

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. Agrégale el prefijo a las cadenas específicas del proveedor con un guion bajo ( _ ).