Partager via


OutputConfiguration.SetPhysicalCameraId(String) Méthode

Définition

Définir l’ID de la caméra physique pour cette OutputConfiguration

[Android.Runtime.Register("setPhysicalCameraId", "(Ljava/lang/String;)V", "", ApiSince=28)]
public void SetPhysicalCameraId(string? physicalCameraId);
[<Android.Runtime.Register("setPhysicalCameraId", "(Ljava/lang/String;)V", "", ApiSince=28)>]
member this.SetPhysicalCameraId : string -> unit

Paramètres

physicalCameraId
String
Attributs

Remarques

Définir l’ID de la caméra physique pour cette OutputConfiguration

Dans le cas où une caméra logique est constituée de plusieurs caméras physiques, il peut être souhaitable que l’application de la caméra demande des flux provenant de caméras physiques individuelles. Cet appel l’obtient en mappant OutputConfiguration à l’ID de la caméra physique.

Les ID de caméra physique valides peuvent être interrogés par CameraCharacteristics#getPhysicalCameraIds.

Le passage d’un physicalCameraId null signifie que OutputConfiguration est destiné à un flux logique.

Cette fonction doit être appelée avant CameraDevice#createCaptureSessionByOutputConfigurations ou CameraDevice#createReprocessableCaptureSessionByConfigurations. Appel de cette fonction après CameraDevice#createCaptureSessionByOutputConfigurations ou CameraDevice#createReprocessableCaptureSessionByConfigurations sans effet.

À compter de android.os.Build.VERSION_CODES#S Android 12, une mémoire tampon d’image à partir d’un flux de caméra physique peut être utilisée pour le retraitement vers des flux et des flux de caméra logiques à partir de la même caméra physique si l’appareil photo prend en charge les flux d’entrée et de sortie à résolution multiple. Pour plus d'informations, consultez CameraCharacteristics#SCALER_MULTI_RESOLUTION_STREAM_CONFIGURATION_MAP. Les comportements de retraitement d’un flux de caméra non physique vers un flux de caméra physique, et d’un flux de caméra physique à un flux de caméra physique de différentes caméras physiques, sont spécifiques à l’appareil et ne sont pas garantis pour être pris en charge.

Sur les niveaux d’API précédents, la surface appartenant à une caméra physique OutputConfiguration ne doit pas être utilisée comme entrée ou sortie d’une demande de retraitement.

Documentation Java pour android.hardware.camera2.params.OutputConfiguration.setPhysicalCameraId(java.lang.String).

Les parties de cette page sont des modifications basées sur le travail créé et partagé par le projet Android Open Source et utilisés en fonction des termes décrits dans la licence d’attribution Creative Commons 2.5.

S’applique à