OutputConfiguration Classe

Définition

Espace de noms:: Android.Hardware.Camera2.Params

Assembly:: Mono.Android.dll

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.

Classe permettant de décrire la sortie de l’appareil photo, qui contient une configuration spécifique pour la création d’une Surface session de capture.

[Android.Runtime.Register("android/hardware/camera2/params/OutputConfiguration", ApiSince=24, DoNotGenerateAcw=true)]
public sealed class OutputConfiguration : Java.Lang.Object, Android.OS.IParcelable, IDisposable

[<Android.Runtime.Register("android/hardware/camera2/params/OutputConfiguration", ApiSince=24, DoNotGenerateAcw=true)>]
type OutputConfiguration = class
    inherit Object
    interface IParcelable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

Héritage: Object

JavaObject

Object
OutputConfiguration

Attributs: RegisterAttribute

Implémente: IParcelable IJavaObject IJavaPeerable IDisposable

Remarques

Classe permettant de décrire la sortie de l’appareil photo, qui contient une configuration spécifique pour la création d’une Surface session de capture.

Il existe plusieurs façons d’instancier, de modifier et d’utiliser OutputConfigurations. Les modèles d’utilisation les plus courants et recommandés sont résumés dans la liste suivante :

<ul><li>Passing a Surface to the constructor and using the OutputConfiguration instance as argument to CameraDevice#createCaptureSessionByOutputConfigurations. Il s’agit de l’utilisation la plus fréquente et les clients doivent d’abord l’envisager avant d’autres alternatives plus complexes. </li>

<li>Passage uniquement d’une classe source surface en tant qu’argument au constructeur. Il s’agit généralement d’un appel pour créer une session de capture (voir CameraDevice#createCaptureSessionByOutputConfigurations et ajouter un Surface appel #addSurface avec une valeur valide Surface. La séquence se termine par CameraCaptureSession#finalizeOutputConfigurations. Il s’agit du cas d’utilisation différé qui vise à améliorer les performances en permettant à la session de capture gourmande en ressources d’exécuter un appel en parallèle avec n’importe quelle Surface initialisation, par exemple en attendant qu’elle android.view.SurfaceView soit prête dans le cadre de l’initialisation de l’interface utilisateur.</li>

<li>Le troisième modèle d’utilisation le plus complexe implique le partage de surface. Une fois instanciée, un OutputConfiguration peut être activé pour le partage de surface via #enableSurfaceSharing. Cette opération doit être effectuée avant de créer une session de capture et active les appels à CameraCaptureSession#updateOutputConfiguration. Une OutputConfiguration avec le partage de surface activé peut être modifiée via #addSurface ou #removeSurface. Les mises à jour de cette OutputConfiguration ne seront appliquées qu’après CameraCaptureSession#updateOutputConfiguration les retours sans lever d’exceptions. Ces mises à jour peuvent être effectuées tant que la session est active. Les clients doivent toujours prendre en compte les exigences et limitations supplémentaires placées sur les surfaces de sortie (pour plus d’informations, voir #enableSurfaceSharing, #addSurface, #removeSurfaceCameraCaptureSession#updateOutputConfiguration). Un compromis existe entre une complexité et une flexibilité supplémentaires. Si l’exercice est correct, le partage de surface peut basculer entre différentes surfaces de sortie sans interrompre les demandes de capture répétées en cours. Cela permet de gagner du temps et d’améliorer considérablement l’expérience utilisateur.</li>

<li> Surface partage peut être utilisé en combinaison avec des surfaces différées. Les règles des deux cas sont combinées et les clients doivent appeler #enableSurfaceSharing avant de créer une session de capture. Attachez et/ou supprimez des surfaces de sortie via #addSurface/#removeSurface et finalisez la configuration à l’aide CameraCaptureSession#finalizeOutputConfigurationsde . CameraCaptureSession#updateOutputConfiguration peut être appelé après le retour de la méthode de finalisation de la configuration sans exceptions.</li>

<li>Si l’appareil photo prend en charge les flux de sortie à résolution multiple, CameraCharacteristics#SCALER_MULTI_RESOLUTION_STREAM_CONFIGURATION_MAP contient les formats et leurs informations de flux correspondantes. L’application peut utiliser une OutputConfiguration créée avec les informations de flux à résolution multiple interrogées et MultiResolutionStreamConfigurationMap#getOutputInfoandroid.hardware.camera2.MultiResolutionImageReader capturer des images de taille variable.

</ul>

À partir de android.os.Build.VERSION_CODES#P Android P, tous les formats sauf ImageFormat#JPEG et ImageFormat#RAW_PRIVATE peuvent être utilisés pour le partage, sous réserve de la prise en charge de l’appareil. Sur les niveaux d’API précédents, seul ImageFormat#PRIVATE le format peut être utilisé.

Java documentation pour android.hardware.camera2.params.OutputConfiguration.

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

Constructeurs

Nom	Description
OutputConfiguration(ImageFormatType, Size, Int64)	Créez une `OutputConfiguration` instance pour un `ImageReader` format, une taille et des indicateurs d’utilisation donnés.
OutputConfiguration(ImageFormatType, Size)	Créez une `OutputConfiguration` instance pour un `ImageReader` format et une taille donnés.
OutputConfiguration(Int32, ImageFormatType, Size, Int64)	Créez une `OutputConfiguration` instance pour un `ImageReader` ID de groupe surface, un format, une taille et des indicateurs d’utilisation donnés.
OutputConfiguration(Int32, ImageFormatType, Size)	Créez une `OutputConfiguration` instance pour une `ImageReader` surfaceGroupId, un format et une taille donnés.
OutputConfiguration(Int32, Surface)	Créez une `OutputConfiguration` instance avec un `Surface`id de groupe surface.
OutputConfiguration(Size, Class)	Créez une `OutputConfiguration` instance, avec une taille de Surface souhaitée et Surface classe source.
OutputConfiguration(Surface)	Créez une `OutputConfiguration` instance avec un `Surface`.

Champs

Nom	Description
MirrorModeAuto	Obsolète. Mise en miroir automatique basée sur l’appareil photo exposé
MirrorModeH	Obsolète. La sortie de la caméra est mise en miroir horizontalement
MirrorModeNone	Obsolète. Aucune transformation miroir n’est appliquée
MirrorModeV	Obsolète. La sortie de la caméra est mise en miroir verticalement
SurfaceGroupIdNone	ID de groupe surface non valide.
TimestampBaseChoreographerSynced	Obsolète. Timestamp est synchronisé avec chorégraphe.
TimestampBaseDefault	Obsolète. Base d’horodatage par défaut.
TimestampBaseMonotonic	Obsolète. Timestamp base à peu près identique à `android.os.SystemClock#uptimeMillis`.
TimestampBaseRealtime	Obsolète. Timestamp base à peu près identique à `android.os.SystemClock#elapsedRealtime`.
TimestampBaseSensor	Obsolète. Base d’horodatage de `CameraCharacteristics#SENSOR_INFO_TIMESTAMP_SOURCE`.

Propriétés

Nom	Description
Class	Retourne la classe runtime de ce `Object`. (Hérité de Object)
ConfiguredFormat	Obtenez le format configuré associé à ce `OutputConfiguration`.
ConfiguredSize	Obtenez la dernière taille configurée associée à ce `OutputConfiguration`paramètre .
Creator	Classe permettant de décrire la sortie de l’appareil photo, qui contient une configuration spécifique pour la création d’une `Surface` session de capture.
DynamicRangeProfile	Retourne le profil de plage dynamique actuel. -ou- Définir un profil de plage dynamique pris en charge par un appareil spécifique.
Handle	Handle de l’instance Android sous-jacente. (Hérité de Object)
JniIdentityHashCode	Obtient le code de hachage d’identité affecté à cet homologue Java par le runtime d’interopérabilité. (Hérité de Object)
JniManagedPeerState	Classe permettant de décrire la sortie de l’appareil photo, qui contient une configuration spécifique pour la création d’une `Surface` session de capture. (Hérité de JavaObject)
JniPeerMembers	Classe permettant de décrire la sortie de l’appareil photo, qui contient une configuration spécifique pour la création d’une `Surface` session de capture.
MaxSharedSurfaceCount	Obtenez le nombre maximal de partages `Surface` pris en charge.
MirrorMode	Obtenir le mode de mise en miroir actuel -ou- Définir le mode de mise en miroir pour cette cible de sortie
PeerReference	Obtient la référence d’objet JNI pour cet homologue Java. (Hérité de Object)
ReadoutTimestampEnabled	Indique si l’horodatage de lecture est utilisé pour cette OutputConfiguration. -ou- Utilisez le délai de lecture du capteur de caméra pour l’horodatage de l’image.
StreamUseCase	Obtenir le cas d’usage actuel du flux -ou- Définir le cas d’usage de flux pour cette OutputConfiguration
Surface	Obtenez l’associé `Surface` à ce `OutputConfiguration`fichier .
SurfaceGroupId	Obtenez l’ID du groupe surface associé à ce `OutputConfiguration`.
Surfaces	Obtenez la liste immuable des surfaces associées à ce `OutputConfiguration`.
ThresholdClass	Cette API prend en charge l’infrastructure Mono pour Android et n’est pas destinée à être utilisée directement à partir de votre code. (Hérité de Object)
ThresholdType	Cette API prend en charge l’infrastructure Mono pour Android et n’est pas destinée à être utilisée directement à partir de votre code. (Hérité de Object)
TimestampBase	Obtenir la base d’horodatage actuel -ou- Définir la base d’horodatage pour cette cible de sortie
Usage	Obtenez l’indicateur d’utilisation associé à ce `OutputConfiguration`.

Méthodes

Nom	Description
AddSensorPixelModeUsed(Int32)	Ajoutez un mode de pixels de capteur dans lequel cette OutputConfiguration sera utilisée.
AddSurface(Surface)	Ajoutez une surface à cette OutputConfiguration.
Clone()	Crée et retourne une copie de cet objet. (Hérité de Object)
Construct(JniObjectReference, JniObjectReferenceOptions)	Classe permettant de décrire la sortie de l’appareil photo, qui contient une configuration spécifique pour la création d’une `Surface` session de capture. (Hérité de JavaObject)
CreateInstancesForMultiResolutionOutput(ICollection<MultiResolutionStreamInfo>, ImageFormatType)	Créez une liste d’instances `OutputConfiguration` pour un `MultiResolutionImageReader`.
CreateInstancesForMultiResolutionOutput(MultiResolutionImageReader)	Créez une liste d’instances `OutputConfiguration` pour les sorties utilisées par un `android.hardware.camera2.MultiResolutionImageReader`.
DescribeContents()	Classe permettant de décrire la sortie de l’appareil photo, qui contient une configuration spécifique pour la création d’une `Surface` session de capture.
Dispose()	Libère les ressources détenues par cet homologue Java. (Hérité de Object)
Dispose(Boolean)	Libère les ressources détenues par cet homologue Java. (Hérité de Object)
DisposeUnlessReferenced()	Classe permettant de décrire la sortie de l’appareil photo, qui contient une configuration spécifique pour la création d’une `Surface` session de capture. (Hérité de JavaObject)
EnableSurfaceSharing()	Activer plusieurs surfaces partageant le même OutputConfiguration
Equals(Object)	Classe permettant de décrire la sortie de l’appareil photo, qui contient une configuration spécifique pour la création d’une `Surface` session de capture. (Hérité de JavaObject)
Equals(Object)	Indique si un autre objet est « égal à » celui-ci. (Hérité de Object)
GetHashCode()	Retourne une valeur de code de hachage pour l’objet. (Hérité de Object)
JavaFinalize()	Obsolète. Appelé par le garbage collector sur un objet lorsque le garbage collection détermine qu’il n’y a plus de références à l’objet. (Hérité de Object)
MakeDeferredAndRemoveSurfaces()	Effacez toutes les surfaces de sortie valides et marquez la configuration comme différée.
Notify()	Réveille un thread unique qui attend le moniteur de cet objet. (Hérité de Object)
NotifyAll()	Réveille tous les threads qui attendent le moniteur de cet objet. (Hérité de Object)
RemoveSensorPixelModeUsed(Int32)	Supprimez un mode pixel de capteur, précédemment ajouté via addSensorPixelModeUsed, de cette OutputConfiguration.
RemoveSurface(Surface)	Supprimez une surface de cette OutputConfiguration.
SetHandle(IntPtr, JniHandleOwnership)	Définit la propriété Handle. (Hérité de Object)
SetMirrorMode(Surface, MirrorMode)	Définir le mode de mise en miroir d’une surface appartenant à cette OutputConfiguration
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	Classe permettant de décrire la sortie de l’appareil photo, qui contient une configuration spécifique pour la création d’une `Surface` session de capture. (Hérité de JavaObject)
SetPhysicalCameraId(String)	Définir l’ID de la caméra physique pour cette OutputConfiguration
SetSurfacesForMultiResolutionOutput(ICollection<OutputConfiguration>, MultiResolutionImageReader)	Définissez les surfaces OutputConfiguration correspondant au `MultiResolutionImageReader`fichier .
ToArray<T>()	Crée un tableau managé à partir de ce wrapper de tableau Java. (Hérité de Object)
ToString()	Retourne une représentation sous forme de chaîne de l’objet. (Hérité de Object)
UnregisterFromRuntime()	Annule l’inscription de cet homologue Java à partir du runtime d’interopérabilité. (Hérité de Object)
Wait()	Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti par em ou><em>interrompu</em>.<> (Hérité de Object)
Wait(Int64, Int32)	Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti> par< em>ou <em>interrompu/em<,> ou jusqu’à ce qu’une certaine quantité de temps réel s’est écoulée. (Hérité de Object)
Wait(Int64)	Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti> par< em>ou <em>interrompu/em<,> ou jusqu’à ce qu’une certaine quantité de temps réel s’est écoulée. (Hérité de Object)
WriteToParcel(Parcel, ParcelableWriteFlags)	Classe permettant de décrire la sortie de l’appareil photo, qui contient une configuration spécifique pour la création d’une `Surface` session de capture.

Implémentations d’interfaces explicites

Nom	Description
IJavaPeerable.Disposed()	Classe permettant de décrire la sortie de l’appareil photo, qui contient une configuration spécifique pour la création d’une `Surface` session de capture. (Hérité de JavaObject)
IJavaPeerable.Finalized()	Classe permettant de décrire la sortie de l’appareil photo, qui contient une configuration spécifique pour la création d’une `Surface` session de capture. (Hérité de JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	Classe permettant de décrire la sortie de l’appareil photo, qui contient une configuration spécifique pour la création d’une `Surface` session de capture. (Hérité de JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Classe permettant de décrire la sortie de l’appareil photo, qui contient une configuration spécifique pour la création d’une `Surface` session de capture. (Hérité de JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Classe permettant de décrire la sortie de l’appareil photo, qui contient une configuration spécifique pour la création d’une `Surface` session de capture. (Hérité de JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	Classe permettant de décrire la sortie de l’appareil photo, qui contient une configuration spécifique pour la création d’une `Surface` session de capture. (Hérité de JavaObject)
IJavaPeerable.UnregisterFromRuntime()	Classe permettant de décrire la sortie de l’appareil photo, qui contient une configuration spécifique pour la création d’une `Surface` session de capture.

Méthodes d’extension

Nom	Description
GetJniTypeName(IJavaPeerable)	Obtient le nom JNI du type de l’instance `self`.
JavaAs<TResult>(IJavaPeerable)	Essayez de forcer `self` le type`TResult`, en vérifiant que le forçage est valide côté Java.
JavaCast<TResult>(IJavaObject)	Effectue une conversion de type vérifiée par le runtime Android.
JavaCast<TResult>(IJavaObject)	Classe permettant de décrire la sortie de l’appareil photo, qui contient une configuration spécifique pour la création d’une `Surface` session de capture.
TryJavaCast<TResult>(IJavaPeerable, TResult)	Essayez de forcer `self` le type`TResult`, en vérifiant que le forçage est valide côté Java.

S’applique à