OutputConfiguration Classe

Définition

Espace de noms:

Android.Hardware.Camera2.Params

Assembly:

Mono.Android.dll

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, Java.Interop.IJavaPeerable

[<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

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>

<Le partage li>Surface 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#getOutputInfo android.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é.

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

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.

Constructeurs

OutputConfiguration(Int32, Surface)	Créez une OutputConfiguration instance avec un SurfaceID de groupe surface.
OutputConfiguration(Size, Class)	Créez une OutputConfiguration instance, avec la taille de Surface souhaitée et la classe source Surface.
OutputConfiguration(Surface)	Créez une OutputConfiguration instance avec un Surface.

Champs

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

Class	Retourne la classe runtime de ce Object. (Hérité de Object)
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	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 Object)
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	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 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 OutputConfigurationfichier .
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

Méthodes

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)
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()	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 Object)
Dispose(Boolean)	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 Object)
EnableSurfaceSharing()	Activer plusieurs surfaces partageant le même OutputConfiguration
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()	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)
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)
SetPhysicalCameraId(String)	Définir l’ID de la caméra physique pour cette OutputConfiguration
ToArray<T>()	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 Object)
ToString()	Retourne une représentation de chaîne de l'objet. (Hérité de Object)
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. (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

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 Object)
IJavaPeerable.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 Object)
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 Object)
IJavaPeerable.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 Object)
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 Object)
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 Object)
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 Object)

Méthodes d’extension

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.
GetJniTypeName(IJavaPeerable)	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.