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:
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, API nivel 2: Lista de configuraciones ISO disponibles actualmente; por ejemplo, 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, API nivel 2: Lista de velocidades de obturador disponibles actualmente; por ejemplo, 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 API nivel 2: Lista de configuraciones de apertura disponibles actualmente, expresadas en |
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:
_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 { "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 { "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 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 API nivel 2: Si no admites el modo HDR, es 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:
{ "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 Nivel de API 2: el valor predeterminado es vacío {} cuando 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 Nivel de API 2: La configuración predeterminada es 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 |
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 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 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., 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 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., 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 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., 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 ( _ ). |