Compartilhar via


CameraCharacteristics.AvailableSessionKeys Propriedade

Definição

Retorna um subconjunto de teclas que o dispositivo da #getAvailableCaptureRequestKeys câmera pode passar como parte da inicialização da sessão 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 da propriedade

Lista de chaves que podem ser passadas durante a inicialização da sessão de captura. Caso o dispositivo da câmera não suporte essas chaves, a lista pode ser nula.

Atributos

Comentários

Retorna um subconjunto de teclas que o dispositivo da #getAvailableCaptureRequestKeys câmera pode passar como parte da inicialização da sessão de captura.

Essa lista inclui chaves que são difíceis de aplicar por quadro e podem resultar em atrasos inesperados quando modificadas durante o tempo de vida da sessão de captura. Exemplos típicos incluem parâmetros que exigem uma reconfiguração de hardware demorada ou alteração interna do pipeline da câmera. Por razões de desempenho, sugerimos que os clientes passem seus valores iniciais como parte do SessionConfiguration#setSessionParameters. Uma vez que a sessão de captura da câmera está ativada, também é recomendável evitar alterá-los de seus valores iniciais definidos em SessionConfiguration#setSessionParameters . O controle sobre os parâmetros de sessão ainda pode ser exercido em solicitações de captura, mas os clientes devem estar cientes e esperar atrasos durante a aplicação. Um exemplo de cenário de uso pode ter esta aparência:

<><ul li>O cliente da câmera começa consultando a lista de chaves de parâmetros da sessão via android.hardware.camera2.CameraCharacteristics#getAvailableSessionKeys .</li><li>Antes de acionar a sequência de criação da sessão de captura, uma solicitação de captura deve ser criada usando CameraDevice#createCaptureRequest um modelo apropriado correspondente ao caso de uso específico.</li><li>O cliente deve examinar a lista de parâmetros de sessão e verificar se algumas das chaves listadas correspondem aos parâmetros que pretendem modificar como parte da primeira solicitação de captura.</li><li Se>não houver essa correspondência, a solicitação de captura pode ser passada sem modificações para SessionConfiguration#setSessionParameters .</li><li Se>houver correspondências, o cliente deve atualizar os respectivos valores e passar a solicitação para SessionConfiguration#setSessionParameters .</li><li Após>a conclusão da inicialização da sessão de captura, a lista de chaves de parâmetros da sessão pode continuar a servir como referência ao postar ou atualizar outras solicitações. Como mencionado acima, alterações adicionais nos parâmetros de sessão devem ser idealmente evitadas, se atualizações forem necessárias, no entanto, os clientes podem esperar um atraso/falha durante a troca de parâmetros.</li></ul>

A lista retornada não é modificável, portanto, qualquer tentativa de modificá-la lançará um UnsupportedOperationExceptionarquivo .

Cada chave é listada apenas uma vez na lista. A ordem das chaves é indefinida.

Documentação Java para android.hardware.camera2.CameraCharacteristics.getAvailableSessionKeys().

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Android Open Source Project e usado de acordo com os termos descritos na Creative Commons 2.5 Attribution License.

Aplica-se a