Camera Classe

Définition

Espace de noms:: Android.Hardware

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.

Attention

This class is obsoleted in this android platform

La classe Camera est utilisée pour définir les paramètres de capture d’image, démarrer/arrêter l’aperçu, aligner des images et récupérer des images pour l’encodage pour la vidéo.

[Android.Runtime.Register("android/hardware/Camera", DoNotGenerateAcw=true)]
[System.Obsolete("This class is obsoleted in this android platform")]
public class Camera : Java.Lang.Object

[<Android.Runtime.Register("android/hardware/Camera", DoNotGenerateAcw=true)>]
[<System.Obsolete("This class is obsoleted in this android platform")>]
type Camera = class
    inherit Object

Héritage: Object

JavaObject

Object
Camera

Attributs: RegisterAttribute ObsoleteAttribute

Remarques

La classe Camera est utilisée pour définir les paramètres de capture d’image, démarrer/arrêter l’aperçu, aligner des images et récupérer des images pour l’encodage pour la vidéo. Cette classe est un client pour le service Caméra, qui gère le matériel de caméra réel.

Pour accéder à la caméra de l’appareil, vous devez déclarer l’autorisation android.Manifest.permission#CAMERA dans votre manifeste Android. Veillez également à inclure l’élément <manifeste use-feature> pour déclarer les fonctionnalités de caméra utilisées par votre application. Par exemple, si vous utilisez la caméra et la fonctionnalité de focus automatique, votre manifeste doit inclure les éléments suivants :

&lt;uses-permission android:name="android.permission.CAMERA" />
            &lt;uses-feature android:name="android.hardware.camera" />
            &lt;uses-feature android:name="android.hardware.camera.autofocus" />

Pour prendre des photos avec cette classe, procédez comme suit :

<ol><li>Obtenir une instance de caméra à partir de #open(int).

<li>Obtenir les paramètres existants (par défaut) avec #getParameters().

<li>Si nécessaire, modifiez l’objet retourné Camera.Parameters et appelez #setParameters(Camera.Parameters).

<li>Call #setDisplayOrientation(int) pour garantir l’orientation correcte de la préversion.

<li><b>Important</b> : Passez une valeur entièrement initialisée SurfaceHolder à #setPreviewDisplay(SurfaceHolder). Sans surface, l’appareil photo ne pourra pas démarrer l’aperçu.

<li><b>Important</b> : appel #startPreview() pour commencer à mettre à jour l’aire d’aperçu. La préversion doit être démarrée avant de pouvoir prendre une photo.

<li>Quand vous le souhaitez, appelez #takePicture(Camera.ShutterCallback, Camera.PictureCallback, Camera.PictureCallback, Camera.PictureCallback) pour capturer une photo. Attendez que les rappels fournissent les données d’image réelles.

<li>Après avoir pris une photo, l’affichage d’aperçu s’est arrêté. Pour prendre d’autres photos, appelez #startPreview() d’abord.

<li>Appel #stopPreview() pour arrêter la mise à jour de l’aire d’aperçu.

<li><b>Important :</b> Appel #release() pour libérer l’appareil photo à utiliser par d’autres applications. Les applications doivent libérer immédiatement l’appareil photo (android.app.Activity#onPause()et le réactiver#open()).android.app.Activity#onResume() </ol>

Pour passer rapidement au mode d’enregistrement vidéo, procédez comme suit :

<ol><li>Obtenir et initialiser une caméra et démarrer l’aperçu comme décrit ci-dessus.

<li>Call #unlock() to allow the media process to access the camera.

<li>Passer la caméra à android.media.MediaRecorder#setCamera(Camera). Consultez android.media.MediaRecorder des informations sur l’enregistrement vidéo.

<li>Une fois l’enregistrement terminé, appelez #reconnect() pour ré-acquérir et verrouiller à nouveau la caméra.

<li>Si vous le souhaitez, redémarrez l’aperçu et prenez plus de photos ou de vidéos.

<li>Call #stopPreview() et #release() comme décrit ci-dessus. </ol>

Cette classe n’est pas thread-safe et est destinée à être utilisée à partir d’un thread d’événements. La plupart des opérations de longue durée (préversion, focus, capture de photos, etc.) se produisent de manière asynchrone et appellent des rappels si nécessaire. Les rappels seront appelés sur le thread #open(int) d’événement à partir duquel. Les méthodes de cette classe ne doivent jamais être appelées à partir de plusieurs threads à la fois.

<attention forte>:</les> différents appareils android peuvent avoir des spécifications matérielles différentes, telles que les évaluations de millisecondes et les fonctionnalités de focus automatique. Pour que votre application soit compatible avec d’autres appareils, vous ne devez pas faire d’hypothèses sur les spécifications de la caméra de l’appareil.

<div class="special reference"><h3>Developer Guides</h3>

Pour plus d’informations sur l’utilisation des caméras, consultez le guide du développeur de la caméra .

Ce membre est déconseillé. Nous vous recommandons d’utiliser la nouvelle android.hardware.camera2 API pour les nouvelles applications.

Java documentation pour android.hardware.Camera.

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
Camera(IntPtr, JniHandleOwnership)	Obsolète. Constructeur utilisé lors de la création de représentations managées d’objets JNI ; appelée par le runtime.

Champs

Nom	Description
ActionNewPicture	Obsolète. Action de diffusion : une nouvelle image est prise par l’appareil photo et l’entrée de l’image a été ajoutée au magasin multimédia.
ActionNewVideo	Obsolète. Action de diffusion : une nouvelle vidéo est enregistrée par la caméra et l’entrée de la vidéo a été ajoutée au magasin multimédia.

Propriétés

Nom	Description
Class	Obsolète. Retourne la classe runtime de ce `Object`. (Hérité de Object)
Handle	Obsolète. Handle de l’instance Android sous-jacente. (Hérité de Object)
JniIdentityHashCode	Obsolète. Obtient le code de hachage d’identité affecté à cet homologue Java par le runtime d’interopérabilité. (Hérité de Object)
JniManagedPeerState	Obsolète. La classe Camera est utilisée pour définir les paramètres de capture d’image, démarrer/arrêter l’aperçu, aligner des images et récupérer des images pour l’encodage pour la vidéo. (Hérité de JavaObject)
JniPeerMembers	Obsolète. La classe Camera est utilisée pour définir les paramètres de capture d’image, démarrer/arrêter l’aperçu, aligner des images et récupérer des images pour l’encodage pour la vidéo.
NumberOfCameras	Obsolète. Retourne le nombre de caméras physiques disponibles sur cet appareil.
PeerReference	Obsolète. Obtient la référence d’objet JNI pour cet homologue Java. (Hérité de Object)
ThresholdClass	Obsolète. Cette API prend en charge l’infrastructure Mono pour Android et n’est pas destinée à être utilisée directement à partir de votre code.
ThresholdType	Obsolète. Cette API prend en charge l’infrastructure Mono pour Android et n’est pas destinée à être utilisée directement à partir de votre code.

Méthodes

Nom	Description
AddCallbackBuffer(Byte[])	Obsolète. Ajoute une mémoire tampon pré-allouée à la file d’attente de mémoire tampon de rappel d’aperçu.
AutoFocus(Camera+IAutoFocusCallback)	Obsolète. Démarre le focus automatique de l’appareil photo et inscrit une fonction de rappel à exécuter lorsque l’appareil photo est concentré.
CancelAutoFocus()	Obsolète. Annule toute fonction de focus automatique en cours.
Clone()	Obsolète. Crée et retourne une copie de cet objet. (Hérité de Object)
Construct(JniObjectReference, JniObjectReferenceOptions)	Obsolète. La classe Camera est utilisée pour définir les paramètres de capture d’image, démarrer/arrêter l’aperçu, aligner des images et récupérer des images pour l’encodage pour la vidéo. (Hérité de JavaObject)
Dispose()	Obsolète. Libère les ressources détenues par cet homologue Java. (Hérité de Object)
Dispose(Boolean)	Obsolète. Libère les ressources détenues par cet homologue Java. (Hérité de Object)
DisposeUnlessReferenced()	Obsolète. La classe Camera est utilisée pour définir les paramètres de capture d’image, démarrer/arrêter l’aperçu, aligner des images et récupérer des images pour l’encodage pour la vidéo. (Hérité de JavaObject)
EnableShutterSound(Boolean)	Obsolète. Activez ou désactivez le son d’obturation par défaut lors de la prise d’une photo.
Equals(Object)	Obsolète. La classe Camera est utilisée pour définir les paramètres de capture d’image, démarrer/arrêter l’aperçu, aligner des images et récupérer des images pour l’encodage pour la vidéo. (Hérité de JavaObject)
Equals(Object)	Obsolète. Indique si un autre objet est « égal à » celui-ci. (Hérité de Object)
GetCameraInfo(Int32, Camera+CameraInfo)	Obsolète. Retourne les informations relatives à une caméra particulière.
GetHashCode()	Obsolète. Retourne une valeur de code de hachage pour l’objet. (Hérité de Object)
GetParameters()	Obsolète. Retourne les paramètres actuels de ce service caméra.
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)
Lock()	Obsolète. Verrouille à nouveau la caméra pour empêcher d’autres processus d’y accéder.
Notify()	Obsolète. Réveille un thread unique qui attend le moniteur de cet objet. (Hérité de Object)
NotifyAll()	Obsolète. Réveille tous les threads qui attendent le moniteur de cet objet. (Hérité de Object)
Open()	Obsolète. Crée un objet Camera pour accéder à la première caméra arrière sur l’appareil.
Open(Int32)	Obsolète. Crée un objet Camera pour accéder à une caméra matérielle particulière.
Reconnect()	Obsolète. Se reconnecte au service de caméra après un autre processus utilisé.
Release()	Obsolète. Déconnecte et libère les ressources de l’objet Camera.
SetAutoFocusMoveCallback(Camera+IAutoFocusMoveCallback)	Obsolète. Définit le rappel de déplacement du focus automatique de l’appareil photo.
SetDisplayOrientation(Int32)	Obsolète. Définissez la rotation dans le sens des aiguilles d’une montre de l’affichage en degrés.
SetErrorCallback(Camera+IErrorCallback)	Obsolète. Inscrit un rappel à appeler lorsqu’une erreur se produit.
SetFaceDetectionListener(Camera+IFaceDetectionListener)	Obsolète. Inscrit un écouteur pour être informé des visages détectés dans le cadre d’aperçu.
SetHandle(IntPtr, JniHandleOwnership)	Obsolète. Définit la propriété Handle. (Hérité de Object)
SetOneShotPreviewCallback(Camera+IPreviewCallback)	Obsolète. Installe un rappel à appeler pour l’image d’aperçu suivante en plus de l’afficher à l’écran.
SetParameters(Camera+Parameters)	Obsolète. Modifie les paramètres de ce service Caméra.
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	Obsolète. La classe Camera est utilisée pour définir les paramètres de capture d’image, démarrer/arrêter l’aperçu, aligner des images et récupérer des images pour l’encodage pour la vidéo. (Hérité de JavaObject)
SetPreviewCallback(Camera+IPreviewCallback)	Obsolète. Installe un rappel à appeler pour chaque image d’aperçu en plus de les afficher à l’écran.
SetPreviewCallbackWithBuffer(Camera+IPreviewCallback)	Obsolète. Installe un rappel à appeler pour chaque image d’aperçu, à l’aide de mémoires tampons fournies avec `#addCallbackBuffer(byte[])`, en plus de les afficher sur l’écran.
SetPreviewDisplay(ISurfaceHolder)	Obsolète. Définit la `Surface` valeur à utiliser pour la préversion en direct.
SetPreviewTexture(SurfaceTexture)	Obsolète. Définit la `SurfaceTexture` valeur à utiliser pour la préversion en direct.
SetZoomChangeListener(Camera+IOnZoomChangeListener)	Obsolète. Inscrit un écouteur pour être averti lorsque la valeur de zoom est mise à jour par le pilote de la caméra pendant le zoom lisse.
StartFaceDetection()	Obsolète. Démarre la détection des visages.
StartPreview()	Obsolète. Démarre la capture et le dessin des images d’aperçu sur l’écran.
StartSmoothZoom(Int32)	Obsolète. Effectue un zoom sur la valeur demandée en douceur.
StopFaceDetection()	Obsolète. Arrête la détection des visages.
StopPreview()	Obsolète. Arrête la capture et le dessin des images d’aperçu sur la surface et réinitialise l’appareil photo pour un prochain appel à `#startPreview()`.
StopSmoothZoom()	Obsolète. Arrête le zoom lisse.
TakePicture(Camera+IShutterCallback, Camera+IPictureCallback, Camera+IPictureCallback, Camera+IPictureCallback)	Obsolète. Équivalent à
TakePicture(Camera+IShutterCallback, Camera+IPictureCallback, Camera+IPictureCallback)	Obsolète. Prend une photo. L’affichage de l’aperçu s’arrête après la capture ; appel StartPreview() avant de prendre une autre photo.
ToArray<T>()	Obsolète. Crée un tableau managé à partir de ce wrapper de tableau Java. (Hérité de Object)
ToString()	Obsolète. Retourne une représentation sous forme de chaîne de l’objet. (Hérité de Object)
Unlock()	Obsolète. Déverrouille la caméra pour permettre à un autre processus d’y accéder.
UnregisterFromRuntime()	Obsolète. Annule l’inscription de cet homologue Java à partir du runtime d’interopérabilité. (Hérité de Object)
Wait()	Obsolète. 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)	Obsolète. 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)	Obsolète. 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)

Événements

Nom	Description
FaceDetection	Obsolète. La classe Camera est utilisée pour définir les paramètres de capture d’image, démarrer/arrêter l’aperçu, aligner des images et récupérer des images pour l’encodage pour la vidéo.
ZoomChange	Obsolète. La classe Camera est utilisée pour définir les paramètres de capture d’image, démarrer/arrêter l’aperçu, aligner des images et récupérer des images pour l’encodage pour la vidéo.

Implémentations d’interfaces explicites

Nom	Description
IJavaPeerable.Disposed()	Obsolète. La classe Camera est utilisée pour définir les paramètres de capture d’image, démarrer/arrêter l’aperçu, aligner des images et récupérer des images pour l’encodage pour la vidéo. (Hérité de JavaObject)
IJavaPeerable.Finalized()	Obsolète. La classe Camera est utilisée pour définir les paramètres de capture d’image, démarrer/arrêter l’aperçu, aligner des images et récupérer des images pour l’encodage pour la vidéo. (Hérité de JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	Obsolète. La classe Camera est utilisée pour définir les paramètres de capture d’image, démarrer/arrêter l’aperçu, aligner des images et récupérer des images pour l’encodage pour la vidéo. (Hérité de JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Obsolète. La classe Camera est utilisée pour définir les paramètres de capture d’image, démarrer/arrêter l’aperçu, aligner des images et récupérer des images pour l’encodage pour la vidéo. (Hérité de JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Obsolète. La classe Camera est utilisée pour définir les paramètres de capture d’image, démarrer/arrêter l’aperçu, aligner des images et récupérer des images pour l’encodage pour la vidéo. (Hérité de JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	Obsolète. La classe Camera est utilisée pour définir les paramètres de capture d’image, démarrer/arrêter l’aperçu, aligner des images et récupérer des images pour l’encodage pour la vidéo. (Hérité de JavaObject)

Méthodes d’extension

Nom	Description
GetJniTypeName(IJavaPeerable)	Obsolète. Obtient le nom JNI du type de l’instance `self`.
JavaAs<TResult>(IJavaPeerable)	Obsolète. Essayez de forcer `self` le type`TResult`, en vérifiant que le forçage est valide côté Java.
JavaCast<TResult>(IJavaObject)	Obsolète. Effectue une conversion de type vérifiée par le runtime Android.
JavaCast<TResult>(IJavaObject)	Obsolète. La classe Camera est utilisée pour définir les paramètres de capture d’image, démarrer/arrêter l’aperçu, aligner des images et récupérer des images pour l’encodage pour la vidéo.
TryJavaCast<TResult>(IJavaPeerable, TResult)	Obsolète. Essayez de forcer `self` le type`TResult`, en vérifiant que le forçage est valide côté Java.

S’applique à