CameraCharacteristics.AvailableSessionKeys Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Devuelve un subconjunto de claves que el dispositivo de #getAvailableCaptureRequestKeys
cámara puede pasar como parte de la inicialización de la sesión de captura.
public System.Collections.Generic.IList<Android.Hardware.Camera2.CaptureRequest.Key>? AvailableSessionKeys { [Android.Runtime.Register("getAvailableSessionKeys", "()Ljava/util/List;", "", ApiSince=28)] get; }
[<get: Android.Runtime.Register("getAvailableSessionKeys", "()Ljava/util/List;", "", ApiSince=28)>]
member this.AvailableSessionKeys : System.Collections.Generic.IList<Android.Hardware.Camera2.CaptureRequest.Key>
Valor de propiedad
Lista de claves que se pueden pasar durante la inicialización de la sesión de captura. En caso de que el dispositivo de cámara no admita estas claves, la lista puede ser null.
- Atributos
Comentarios
Devuelve un subconjunto de claves que el dispositivo de #getAvailableCaptureRequestKeys
cámara puede pasar como parte de la inicialización de la sesión de captura.
Esta lista incluye claves que son difíciles de aplicar por fotograma y pueden dar lugar a retrasos inesperados cuando se modifican durante la duración de la sesión de captura. Entre los ejemplos típicos se incluyen parámetros que requieren un cambio de canalización de cámara interna o de reconfiguración de hardware que consume mucho tiempo. Por motivos de rendimiento, se recomienda a los clientes que pasen sus valores iniciales como parte de SessionConfiguration#setSessionParameters
. Una vez habilitada la sesión de captura de cámara, también se recomienda evitar cambiarlos de sus valores iniciales establecidos en SessionConfiguration#setSessionParameters
. El control sobre los parámetros de sesión todavía se puede ejercer en las solicitudes de captura, pero los clientes deben tener en cuenta y esperar retrasos durante su aplicación. Un escenario de uso de ejemplo podría tener este aspecto:
<ul><li>El cliente de cámara comienza consultando la lista de claves de parámetros de sesión a través de android.hardware.camera2.CameraCharacteristics#getAvailableSessionKeys
.</li li>><Antes de desencadenar la secuencia de creación de la sesión de captura, se debe crear una solicitud de captura mediante CameraDevice#createCaptureRequest
una plantilla adecuada que coincida con el caso de uso concreto.</li li><>El cliente debe pasar por la lista de parámetros de sesión y comprobar si algunas de las claves enumeradas coinciden con los parámetros que pretenden modificar como parte de la primera solicitud de captura.</li li>><Si no hay ninguna coincidencia de este tipo, la solicitud de captura se puede pasar sin modificar a .< SessionConfiguration#setSessionParameters
/li li>><Si existen coincidencias, el cliente debe actualizar los valores respectivos y pasar la solicitud a .< SessionConfiguration#setSessionParameters
/li li><>Una vez completada la inicialización de la sesión de captura, la lista de claves de parámetros de sesión puede seguir funcionando como referencia al publicar o actualizar más solicitudes. Como se mencionó anteriormente, se deben evitar cambios adicionales en los parámetros de sesión, si las actualizaciones son necesarias, pero los clientes podrían esperar un retraso o error durante el modificador de parámetros.</li></ul>
La lista devuelta no es modificable, por lo que los intentos de modificarlo producirán un UnsupportedOperationException
.
Cada clave solo aparece una vez en la lista. El orden de las claves no está definido.
Documentación de Java para android.hardware.camera2.CameraCharacteristics.getAvailableSessionKeys()
.
Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el proyecto de código abierto de Android y se usan según los términos descritos en la licencia de atribución de Creative Commons 2.5.