CameraCharacteristics.AvailableSessionKeys Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Retourne un sous-ensemble de #getAvailableCaptureRequestKeys
clés que l’appareil photo peut passer dans le cadre de l’initialisation de session de capture.
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>
Valeur de propriété
Liste des clés qui peuvent être passées pendant l’initialisation de session de capture. Si l’appareil photo ne prend pas en charge ces clés, la liste peut être null.
- Attributs
Remarques
Retourne un sous-ensemble de #getAvailableCaptureRequestKeys
clés que l’appareil photo peut passer dans le cadre de l’initialisation de session de capture.
Cette liste inclut des clés difficiles à appliquer par image et peut entraîner des retards inattendus lors de la modification pendant la durée de vie de la session de capture. Les exemples classiques incluent des paramètres qui nécessitent une reconfiguration matérielle fastidieuse ou un changement de pipeline de caméra interne. Pour des raisons de performances, nous suggérons aux clients de passer leurs valeurs initiales dans le cadre de SessionConfiguration#setSessionParameters
. Une fois la session de capture de caméra activée, il est également recommandé d’éviter de les modifier de leurs valeurs initiales définies dans SessionConfiguration#setSessionParameters
. Le contrôle des paramètres de session peut toujours être exercé dans les demandes de capture, mais les clients doivent être conscients et attendre des retards pendant leur application. Un exemple de scénario d’utilisation peut ressembler à ceci :
<ul><li>Le client de caméra commence par interroger la liste de clés de paramètre de session via android.hardware.camera2.CameraCharacteristics#getAvailableSessionKeys
.</li li>><Avant de déclencher la séquence de création de session de capture, une demande de capture doit être générée à CameraDevice#createCaptureRequest
l’aide d’un modèle approprié correspondant au cas d’usage particulier.</li li><>Le client doit parcourir la liste des paramètres de session et vérifier si certaines clés répertoriées correspondent aux paramètres qu’ils ont l’intention de modifier dans le cadre de la première demande de capture.</li li>><S’il n’existe aucune correspondance de ce type, la demande de capture peut être transmise non modifiée à .<SessionConfiguration#setSessionParameters
/li li>><Si les correspondances existent, le client doit mettre à jour les valeurs respectives et passer la demande à .<SessionConfiguration#setSessionParameters
/li li><>Une fois l’initialisation de session de capture terminée, la liste des clés de paramètre de session peut continuer à servir de référence lors de la publication ou de la mise à jour de demandes supplémentaires. Comme mentionné ci-dessus, les modifications supplémentaires apportées aux paramètres de session doivent idéalement être évitées, si les mises à jour sont nécessaires, toutefois, les clients peuvent s’attendre à un retard/un problème pendant le commutateur de paramètres.</li></ul>
La liste retournée n’est pas modifiable. Par conséquent, toute tentative de modification lève un UnsupportedOperationException
.
Chaque clé n’est répertoriée qu’une seule fois dans la liste. L’ordre des clés n’est pas défini.
Documentation Java pour android.hardware.camera2.CameraCharacteristics.getAvailableSessionKeys()
.
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.