Freigeben über


CameraCaptureUI Klasse

Definition

Stellt eine vollständige Fensterbenutzeroberfläche zum Aufzeichnen von Audio, Video und Fotos von einer Kamera bereit. Sowie Steuerelemente zum Kürzen von Videos, zeitverzögerte Aufnahmen und Kameraeinstellungen.

public ref class CameraCaptureUI sealed
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.None)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.STA)]
class CameraCaptureUI final
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.None)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.STA)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class CameraCaptureUI final
[Windows.Foundation.Metadata.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.None)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.STA)]
public sealed class CameraCaptureUI
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.None)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.STA)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class CameraCaptureUI
function CameraCaptureUI()
Public NotInheritable Class CameraCaptureUI
Vererbung
Object Platform::Object IInspectable CameraCaptureUI
Attribute

Windows-Anforderungen

Gerätefamilie
Windows 10 (eingeführt in 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v1.0)
App-Funktionen
microphone webcam

Beispiele

Dieser Code zeigt, wie Sie die CameraCaptureUI-Klasse verwenden, um ein Bild zu machen. Der Code stammt aus der Datei CapturePhoto.xaml.cs des C#-Beispiels kameraaufnahme UI. Das entsprechende C++-Beispiel für die Kameraerfassungs-UI ist ebenfalls verfügbar. Das Dialogfeld mit dem Benutzer tritt auf, wenn Sie die asynchrone Methode CaptureFileAsync aufrufen.

// Using Windows.Media.Capture.CameraCaptureUI API to capture a photo
CameraCaptureUI dialog = new CameraCaptureUI();
Size aspectRatio = new Size(16, 9);
dialog.PhotoSettings.CroppedAspectRatio = aspectRatio;

StorageFile file = await dialog.CaptureFileAsync(CameraCaptureUIMode.Photo);

Hinweise

CameraCaptureUI bietet eine vollständige Benutzeroberfläche für das Fenster zum Erfassen von Audio, Video und Bildern. Es bietet Steuerelemente zum Festlegen einer Zeitverzögerung bei Fotoaufnahmen, zum Kürzen von Videos und zum Anpassen der Kameraeinstellungen wie Videoauflösung, Audiogerät, Helligkeit und Kontrast.

Rufen Sie CaptureFileAsync auf, um die Benutzeroberfläche zu starten. Der Benutzer hat die Kontrolle darüber, wann die Erfassung gestartet werden soll. Wenn der asynchrone CaptureFileAsync-Vorgang abgeschlossen ist, wird ein StorageFile-Objekt zurückgegeben. Anleitungen zur Verwendung von CameraCaptureUI finden Sie unter Aufnehmen von Fotos und Videos mit der integrierten Windows-Kamerabenutzeroberfläche

Hinweis

Sie sollten die Webcam - oder Mikrofonfunktionen in Ihrer App-Manifestdatei nicht angeben, wenn Sie CameraCaptureUI verwenden. In diesem Fall wird Ihre App in den Kamera-Datenschutzeinstellungen des Geräts angezeigt, aber selbst wenn der Benutzer den Kamerazugriff auf Ihre App verweigert, wird dies nicht daran gehindert, dass CameraCaptureUI Medien erfasst. Das liegt daran, dass es sich bei der integrierten Kamera-App von Windows um eine vertrauenswürdige Erstanbieter-App handelt, die erfordert, dass der Benutzer die Foto-, Audio- und Videoaufnahme durch einen Tastendruck initiiert. Wenn Sie die Webcam - oder Mikrofonfunktionen bei Verwendung von CameraCaptureUI angeben, schlägt ihre App möglicherweise die Zertifizierung des Windows Application Certification Kit fehl.

Sie müssen die Webcam - oder Mikrofonfunktionen in Ihrer App-Manifestdatei angeben, wenn Sie MediaCapture verwenden, um Audio, Fotos oder Videos programmgesteuert aufzunehmen.

Hinweis

Diese Klasse ist nicht agil, was bedeutet, dass Sie das Threadingmodell und das Marshallverhalten berücksichtigen müssen. Weitere Informationen finden Sie unter Threading and Marshaling (C++/CX) und Using Windows-Runtime objects in a multithreaded environment (.NET).

Konstruktoren

CameraCaptureUI()

Erstellen Sie ein neues CameraCaptureUI-Objekt .

Eigenschaften

PhotoSettings

Stellt Einstellungen für die Aufnahme von Fotos bereit. Die Einstellungen umfassen Seitenverhältnis, Bildgröße, Format, Auflösung und ob das Zuschneiden von der Benutzeroberfläche zulässig ist oder nicht.

VideoSettings

Stellt Einstellungen zum Aufzeichnen von Videos bereit. Die Einstellungen umfassen Format, maximale Auflösung, maximale Dauer und ob das Kürzen zulässig ist oder nicht.

Methoden

CaptureFileAsync(CameraCaptureUIMode)

Startet die CameraCaptureUI-Benutzeroberfläche .

Gilt für:

Weitere Informationen