Compartilhar via


OutputConfiguration.StreamUseCase Propriedade

Definição

Obter o caso de uso de fluxo atual -ou- Definir caso de uso de fluxo para este OutputConfiguration

public long StreamUseCase { [Android.Runtime.Register("getStreamUseCase", "()J", "", ApiSince=33)] get; [Android.Runtime.Register("setStreamUseCase", "(J)V", "", ApiSince=33)] set; }
[<get: Android.Runtime.Register("getStreamUseCase", "()J", "", ApiSince=33)>]
[<set: Android.Runtime.Register("setStreamUseCase", "(J)V", "", ApiSince=33)>]
member this.StreamUseCase : int64 with get, set

Valor da propriedade

o caso de uso de fluxo atualmente definido

Atributos

Comentários

Documentação do proprietário getter:

Obter o caso de uso de fluxo atual

Se nenhum #setStreamUseCase for chamado primeiro, essa função retornará CameraCharacteristics#SCALER_AVAILABLE_STREAM_USE_CASES_DEFAULT DEFAULT.

Documentação Java para android.hardware.camera2.params.OutputConfiguration.getStreamUseCase().

Documentação do setter de propriedades:

Definir caso de uso de fluxo para este OutputConfiguration

O caso de uso do fluxo é usado para descrever a finalidade do fluxo, seja para visualização ao vivo, captura de imagem estática, gravação de vídeo ou suas combinações. Esse sinalizador é útil para cenários em que o destino imediato do consumidor não é suficiente para indicar o uso do fluxo.

A principal diferença entre o caso de uso do fluxo e a intenção de captura é que o primeiro permite que o dispositivo da câmera otimize os pipelines de hardware e software da câmera com base nos cenários do usuário para cada fluxo, enquanto o segundo é principalmente uma dica para a câmera decidir a estratégia 3A ideal que é aplicável a toda a sessão. O dispositivo da câmera realiza configurações como a seleção de parâmetros de ajuste, a escolha do modo de sensor da câmera e a construção do pipeline de processamento de imagem com base nos casos de uso dos fluxos. As intenções de captura são então usadas para ajustar comportamentos 3A, como ajustar a velocidade de convergência AE/AF, e as intenções de captura podem mudar durante a vida útil de uma sessão. Por exemplo, para uma sessão com um fluxo de caso de uso PREVIEW_VIDEO_STILL e um fluxo de caso de uso STILL_CAPTURE, as intenções de captura podem ser PREVIEW com velocidade de convergência 3A rápida e medição de flash com controle automático para visualização ao vivo, STILL_CAPTURE com os melhores parâmetros 3A para captura de fotos estáticas ou VIDEO_RECORD com velocidade de convergência 3A mais lenta para melhor experiência de reprodução de vídeo.

Os casos de uso de fluxo suportados suportados por um dispositivo de câmera podem ser consultados pelo android.hardware.camera2.CameraCharacteristics#SCALER_AVAILABLE_STREAM_USE_CASES.

As combinações de fluxo obrigatórias envolvendo casos de uso de fluxo podem ser encontradas em android.hardware.camera2.CameraDevice#createCaptureSession, bem como consultadas via android.hardware.camera2.params.MandatoryStreamCombination. O aplicativo é altamente recomendável para selecionar uma das combinações de fluxo garantido onde todos os casos de uso de fluxos são definidos como valores não-DEFAULT. Se o aplicativo escolher uma combinação de fluxo que não esteja na lista obrigatória, o dispositivo da câmera poderá ignorar alguns sinalizadores de caso de uso devido a restrições de hardware ou detalhes de implementação.

Essa função deve ser chamada antes CameraDevice#createCaptureSession ou CameraDevice#createCaptureSessionByOutputConfigurations. Chamar essa função após CameraDevice#createCaptureSession ou CameraDevice#createCaptureSessionByOutputConfigurations não tem efeito para a sessão da câmera.

Documentação Java para android.hardware.camera2.params.OutputConfiguration.setStreamUseCase(long).

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