Camera Klasse

Referenz

Definition

Namespace:: Android.Hardware

Assembly:: Mono.Android.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Achtung

This class is obsoleted in this android platform

Die Camera-Klasse wird verwendet, um Einstellungen für die Bildaufnahme festzulegen, die Vorschau zu starten/zu beenden, Bilder aufzunehmen und Frames für die Codierung für Video abzurufen.

[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

Vererbung: Object

Object
Camera

Attribute: RegisterAttribute ObsoleteAttribute

Hinweise

Die Camera-Klasse wird verwendet, um Einstellungen für die Bildaufnahme festzulegen, die Vorschau zu starten/zu beenden, Bilder aufzunehmen und Frames für die Codierung für Video abzurufen. Diese Klasse ist ein Client für den Kameradienst, der die tatsächliche Kamerahardware verwaltet.

Um auf die Gerätekamera zuzugreifen, müssen Sie die android.Manifest.permission#CAMERA Berechtigung in Ihrem Android-Manifest deklarieren. Stellen Sie außerdem sicher, dass Sie das <manifestelement uses-feature> einschließen, um kamerafeatures zu deklarieren, die von Ihrer Anwendung verwendet werden. Wenn Sie beispielsweise die Kamera und die Autofokusfunktion verwenden, sollte Ihr Manifest Folgendes enthalten:

&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" />

Führen Sie die folgenden Schritte aus, um Bilder mit dieser Klasse zu machen:

<Ol><li>Erhalten Sie eine instance der Kamera von #open(int).

<li>Abrufen vorhandener (Standardeinstellungen) mit #getParameters().

<ändern>Sie bei Bedarf das zurückgegebene Camera.Parameters Objekt, und rufen Sie auf #setParameters(Camera.Parameters).

<li>Rufen Sie #setDisplayOrientation(int) auf, um die richtige Ausrichtung der Vorschau sicherzustellen.

<li><b>Wichtig</b>: Übergeben Sie einen vollständig initialisierten SurfaceHolder an #setPreviewDisplay(SurfaceHolder). Ohne eine Oberfläche kann die Kamera die Vorschau nicht starten.

<li><b>Wichtig</b>: Rufen Sie #startPreview() auf, um mit der Aktualisierung der Vorschauoberfläche zu beginnen. Die Vorschau muss gestartet werden, bevor Sie ein Bild aufnehmen können.

<li>Wenn Sie möchten, rufen #takePicture(Camera.ShutterCallback, Camera.PictureCallback, Camera.PictureCallback, Camera.PictureCallback) Sie an, um ein Foto aufzunehmen. Warten Sie, bis die Rückrufe die tatsächlichen Bilddaten bereitstellen.

<li>Nach der Aufnahme eines Bilds wird die Vorschauanzeige beendet. Um weitere Fotos zu machen, rufen Sie zuerst erneut an #startPreview() .

<li>Rufen Sie #stopPreview() auf, um die Aktualisierung der Vorschauoberfläche zu beenden.

<li><b>Wichtig:</b> Rufen Sie #release() auf, die Kamera für die Verwendung durch andere Anwendungen freizugeben. Anwendungen sollten die Kamera sofort in android.app.Activity#onPause() loslassen (und in erneut in android.app.Activity#onResume()).#open() </Ol>

Führen Sie die folgenden Schritte aus, um schnell in den Videoaufzeichnungsmodus zu wechseln:

<Ol><li>Erhalten und initialisieren Sie eine Kamera, und starten Sie die Vorschau, wie oben beschrieben.

<li>Rufen Sie #unlock() auf, um dem Medienprozess den Zugriff auf die Kamera zu ermöglichen.

<übergeben>Sie die Kamera an android.media.MediaRecorder#setCamera(Camera). Weitere Informationen finden Sie android.media.MediaRecorder unter Videoaufzeichnung.

<li>Rufen Sie nach Abschluss der Aufzeichnung auf, #reconnect() um die Kamera erneut abzurufen und erneut zu sperren.

<li>starten Sie bei Bedarf die Vorschau neu, und machen Sie weitere Fotos oder Videos.

<li>Rufen Sie #stopPreview() an und #release() wie oben beschrieben. </Ol>

Diese Klasse ist nicht threadsicher und für die Verwendung aus einem Ereignisthread vorgesehen. Die meisten Vorgänge mit langer Ausführungsdauer (Vorschau, Fokus, Fotoaufnahme usw.) erfolgen asynchron und rufen nach Bedarf Rückrufe auf. Rückrufe werden für den ereignisbasierten Thread #open(int) aufgerufen. Die Methoden dieser Klasse dürfen nie von mehreren Threads gleichzeitig aufgerufen werden.

<p class="caution"strong>Achtung><:</strong> Verschiedene Android-geräte können unterschiedliche Hardwarespezifikationen aufweisen, z. B. Megapixelbewertungen und Autofokusfunktionen. Damit Ihre Anwendung mit weiteren Geräten kompatibel ist, sollten Sie keine Annahmen über die Gerätekameraspezifikationen treffen.</P>

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

Weitere Informationen zur Verwendung von Kameras finden Sie im Kameraentwicklerhandbuch .

</Div>

Dieses Member ist veraltet. Es wird empfohlen, die neue android.hardware.camera2 API für neue Anwendungen zu verwenden.

Java-Dokumentation für android.hardware.Camera.

Teile dieser Seite sind Änderungen, die auf Arbeiten basieren, die vom Android Open Source Project erstellt und freigegeben wurden und gemäß den In Attribution License beschriebenen Begriffen verwendet werden.

Konstruktoren

Camera(IntPtr, JniHandleOwnership)

Veraltet.

Ein Konstruktor, der beim Erstellen verwalteter Darstellungen von JNI-Objekten verwendet wird; wird von der Runtime aufgerufen.

Felder

ActionNewPicture	Veraltet. Broadcast-Aktion: Ein neues Bild wird von der Kamera aufgenommen, und der Eintrag des Bilds wurde dem Medienspeicher hinzugefügt.
ActionNewVideo	Veraltet. Broadcast-Aktion: Ein neues Video wird von der Kamera aufgezeichnet, und der Eintrag des Videos wurde dem Medienspeicher hinzugefügt.

Eigenschaften

Class	Veraltet. Gibt die Laufzeitklasse dieses `Object`zurück. (Geerbt von Object)
Handle	Veraltet. Das Handle zum zugrunde liegenden Android-instance. (Geerbt von Object)
JniIdentityHashCode	Veraltet. Die Camera-Klasse wird verwendet, um Einstellungen für die Bildaufnahme festzulegen, die Vorschau zu starten/zu beenden, Bilder aufzunehmen und Frames für die Codierung für Video abzurufen. (Geerbt von Object)
JniPeerMembers	Veraltet. Die Camera-Klasse wird verwendet, um Einstellungen für die Bildaufnahme festzulegen, die Vorschau zu starten/zu beenden, Bilder aufzunehmen und Frames für die Codierung für Video abzurufen.
NumberOfCameras	Veraltet. Gibt die Anzahl der auf diesem Gerät verfügbaren physischen Kameras zurück.
PeerReference	Veraltet. Die Camera-Klasse wird verwendet, um Einstellungen für die Bildaufnahme festzulegen, die Vorschau zu starten/zu beenden, Bilder aufzunehmen und Frames für die Codierung für Video abzurufen. (Geerbt von Object)
ThresholdClass	Veraltet. Diese API unterstützt die Mono für Android-Infrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen.
ThresholdType	Veraltet. Diese API unterstützt die Mono für Android-Infrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen.

Methoden

AddCallbackBuffer(Byte[])	Veraltet. Fügt der Vorschaurückrufpufferwarteschlange einen vorab zugewiesenen Puffer hinzu.
AutoFocus(Camera+IAutoFocusCallback)	Veraltet. Startet den automatischen Fokus der Kamera und registriert eine Rückruffunktion, die ausgeführt wird, wenn die Kamera fokussiert ist.
CancelAutoFocus()	Veraltet. Bricht alle laufenden Autofokusfunktionen ab.
Clone()	Veraltet. Erstellt und gibt eine Kopie dieses Objekts zurück. (Geerbt von Object)
Dispose()	Veraltet. Die Camera-Klasse wird verwendet, um Einstellungen für die Bildaufnahme festzulegen, die Vorschau zu starten/zu beenden, Bilder aufzunehmen und Frames für die Codierung für Video abzurufen. (Geerbt von Object)
Dispose(Boolean)	Veraltet. Die Camera-Klasse wird verwendet, um Einstellungen für die Bildaufnahme festzulegen, die Vorschau zu starten/zu beenden, Bilder aufzunehmen und Frames für die Codierung für Video abzurufen. (Geerbt von Object)
EnableShutterSound(Boolean)	Veraltet. Aktivieren oder deaktivieren Sie den Standardauslöserton beim Aufnehmen eines Bilds.
Equals(Object)	Veraltet. Gibt an, ob ein anderes Objekt diesem "gleich" ist. (Geerbt von Object)
GetCameraInfo(Int32, Camera+CameraInfo)	Veraltet. Gibt die Informationen zu einer bestimmten Kamera zurück.
GetHashCode()	Veraltet. Gibt einen Hashcodewert für das Objekt zurück. (Geerbt von Object)
GetParameters()	Veraltet. Gibt die aktuellen Einstellungen für diesen Kameradienst zurück.
JavaFinalize()	Veraltet. Wird vom Garbage Collector für ein Objekt aufgerufen, wenn die Garbage Collection feststellt, dass keine Verweise mehr auf das Objekt vorhanden sind. (Geerbt von Object)
Lock()	Veraltet. Sperrt die Kamera erneut, um zu verhindern, dass andere Prozesse darauf zugreifen.
Notify()	Veraltet. Aktiviert einen einzelnen Thread, der auf dem Monitor dieses Objekts wartet. (Geerbt von Object)
NotifyAll()	Veraltet. Aktiviert alle Threads, die auf dem Monitor dieses Objekts warten. (Geerbt von Object)
Open()	Veraltet. Erstellt ein neues Camera-Objekt, um auf die erste rückseitige Kamera des Geräts zuzugreifen.
Open(Int32)	Veraltet. Erstellt ein neues Camera-Objekt für den Zugriff auf eine bestimmte Hardwarekamera.
Reconnect()	Veraltet. Stellt wieder eine Verbindung mit dem Kameradienst her, nachdem er von einem anderen Prozess verwendet wurde.
Release()	Veraltet. Trennt die Kameraobjektressourcen und gibt sie frei.
SetAutoFocusMoveCallback(Camera+IAutoFocusMoveCallback)	Veraltet. Legt den Automatischfokus-Rückruf der Kamera fest.
SetDisplayOrientation(Int32)	Veraltet. Legen Sie die Drehung der Vorschauanzeige im Uhrzeigersinn in Grad fest.
SetErrorCallback(Camera+IErrorCallback)	Veraltet. Registriert einen Rückruf, der aufgerufen wird, wenn ein Fehler auftritt.
SetFaceDetectionListener(Camera+IFaceDetectionListener)	Veraltet. Registriert einen Listener, um über die im Vorschaurahmen erkannten Gesichter benachrichtigt zu werden.
SetHandle(IntPtr, JniHandleOwnership)	Veraltet. Legt die Handle-Eigenschaft fest. (Geerbt von Object)
SetOneShotPreviewCallback(Camera+IPreviewCallback)	Veraltet. Installiert einen Rückruf, der für den nächsten Vorschaurahmen aufgerufen wird, und zeigt ihn zusätzlich auf dem Bildschirm an.
SetParameters(Camera+Parameters)	Veraltet. Ändert die Einstellungen für diesen Kameradienst.
SetPreviewCallback(Camera+IPreviewCallback)	Veraltet. Installiert einen Rückruf, der für jeden Vorschaurahmen aufgerufen werden soll, und zeigt diese zusätzlich auf dem Bildschirm an.
SetPreviewCallbackWithBuffer(Camera+IPreviewCallback)	Veraltet. Installiert einen Rückruf, der für jeden Vorschaurahmen aufgerufen werden soll, und verwendet puffer, die mit `#addCallbackBuffer(byte[])`bereitgestellt werden, und zeigt diese zusätzlich auf dem Bildschirm an.
SetPreviewDisplay(ISurfaceHolder)	Veraltet. Legt fest, dass für die `Surface` Livevorschau verwendet werden soll.
SetPreviewTexture(SurfaceTexture)	Veraltet. Legt fest, dass für die `SurfaceTexture` Livevorschau verwendet werden soll.
SetZoomChangeListener(Camera+IOnZoomChangeListener)	Veraltet. Registriert einen Listener, der benachrichtigt wird, wenn der Zoomwert vom Kameratreiber während des reibungslosen Zooms aktualisiert wird.
StartFaceDetection()	Veraltet. Startet die Gesichtserkennung.
StartPreview()	Veraltet. Beginnt mit dem Erfassen und Zeichnen von Vorschaurahmen auf dem Bildschirm.
StartSmoothZoom(Int32)	Veraltet. Zoomt problemlos auf den angeforderten Wert.
StopFaceDetection()	Veraltet. Beendet die Gesichtserkennung.
StopPreview()	Veraltet. Beendet das Aufzeichnen und Zeichnen von Vorschaurahmen auf der Oberfläche und setzt die Kamera für einen zukünftigen Aufruf auf zurück `#startPreview()`.
StopSmoothZoom()	Veraltet. Stoppt den reibungslosen Zoom.
TakePicture(Camera+IShutterCallback, Camera+IPictureCallback, Camera+IPictureCallback)	Veraltet. Entspricht
TakePicture(Camera+IShutterCallback, Camera+IPictureCallback, Camera+IPictureCallback, Camera+IPictureCallback)	Veraltet. Entspricht
ToArray<T>()	Veraltet. Die Camera-Klasse wird verwendet, um Einstellungen für die Bildaufnahme festzulegen, die Vorschau zu starten/zu beenden, Bilder aufzunehmen und Frames für die Codierung für Video abzurufen. (Geerbt von Object)
ToString()	Veraltet. Gibt eine Zeichenfolgendarstellung des Objekts zurück. (Geerbt von Object)
Unlock()	Veraltet. Entsperrt die Kamera, damit ein anderer Prozess darauf zugreifen kann.
UnregisterFromRuntime()	Veraltet. Die Camera-Klasse wird verwendet, um Einstellungen für die Bildaufnahme festzulegen, die Vorschau zu starten/zu beenden, Bilder aufzunehmen und Frames für die Codierung für Video abzurufen. (Geerbt von Object)
Wait()	Veraltet. Bewirkt, dass der aktuelle Thread wartet, bis er aktiviert wird, in der Regel durch em benachrichtigen/em> oder <em>interrupted</em>.<>< (Geerbt von Object)
Wait(Int64)	Veraltet. Bewirkt, dass der aktuelle Thread wartet, bis er aktiviert wird, in der Regel, indem <er>benachrichtigt</em> oder <em>interrupted</em> oder bis eine bestimmte Menge an Echtzeit verstrichen ist. (Geerbt von Object)
Wait(Int64, Int32)	Veraltet. Bewirkt, dass der aktuelle Thread wartet, bis er aktiviert wird, in der Regel, indem <er>benachrichtigt</em> oder <em>interrupted</em> oder bis eine bestimmte Menge an Echtzeit verstrichen ist. (Geerbt von Object)

Ereignisse

FaceDetection	Veraltet. Die Camera-Klasse wird verwendet, um Einstellungen für die Bildaufnahme festzulegen, die Vorschau zu starten/zu beenden, Bilder aufzunehmen und Frames für die Codierung für Video abzurufen.
ZoomChange	Veraltet. Die Camera-Klasse wird verwendet, um Einstellungen für die Bildaufnahme festzulegen, die Vorschau zu starten/zu beenden, Bilder aufzunehmen und Frames für die Codierung für Video abzurufen.

Explizite Schnittstellenimplementierungen

IJavaPeerable.Disposed()	Veraltet. Die Camera-Klasse wird verwendet, um Einstellungen für die Bildaufnahme festzulegen, die Vorschau zu starten/zu beenden, Bilder aufzunehmen und Frames für die Codierung für Video abzurufen. (Geerbt von Object)
IJavaPeerable.DisposeUnlessReferenced()	Veraltet. Die Camera-Klasse wird verwendet, um Einstellungen für die Bildaufnahme festzulegen, die Vorschau zu starten/zu beenden, Bilder aufzunehmen und Frames für die Codierung für Video abzurufen. (Geerbt von Object)
IJavaPeerable.Finalized()	Veraltet. Die Camera-Klasse wird verwendet, um Einstellungen für die Bildaufnahme festzulegen, die Vorschau zu starten/zu beenden, Bilder aufzunehmen und Frames für die Codierung für Video abzurufen. (Geerbt von Object)
IJavaPeerable.JniManagedPeerState	Veraltet. Die Camera-Klasse wird verwendet, um Einstellungen für die Bildaufnahme festzulegen, die Vorschau zu starten/zu beenden, Bilder aufzunehmen und Frames für die Codierung für Video abzurufen. (Geerbt von Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Veraltet. Die Camera-Klasse wird verwendet, um Einstellungen für die Bildaufnahme festzulegen, die Vorschau zu starten/zu beenden, Bilder aufzunehmen und Frames für die Codierung für Video abzurufen. (Geerbt von Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Veraltet. Die Camera-Klasse wird verwendet, um Einstellungen für die Bildaufnahme festzulegen, die Vorschau zu starten/zu beenden, Bilder aufzunehmen und Frames für die Codierung für Video abzurufen. (Geerbt von Object)
IJavaPeerable.SetPeerReference(JniObjectReference)	Veraltet. Die Camera-Klasse wird verwendet, um Einstellungen für die Bildaufnahme festzulegen, die Vorschau zu starten/zu beenden, Bilder aufzunehmen und Frames für die Codierung für Video abzurufen. (Geerbt von Object)

Erweiterungsmethoden

JavaCast<TResult>(IJavaObject)	Veraltet. Führt eine Für Android-Runtime überprüfte Typkonvertierung aus.
JavaCast<TResult>(IJavaObject)	Veraltet. Die Camera-Klasse wird verwendet, um Einstellungen für die Bildaufnahme festzulegen, die Vorschau zu starten/zu beenden, Bilder aufzunehmen und Frames für die Codierung für Video abzurufen.
GetJniTypeName(IJavaPeerable)	Veraltet. Die Camera-Klasse wird verwendet, um Einstellungen für die Bildaufnahme festzulegen, die Vorschau zu starten/zu beenden, Bilder aufzunehmen und Frames für die Codierung für Video abzurufen.

Gilt für: