CameraCaptureUI Classe

Définition

Espace de noms:

Windows.Media.Capture

Fournit une interface utilisateur de fenêtre complète pour la capture d’audio, de vidéo et de photos à partir d’un appareil photo. Ainsi que des contrôles pour le découpage vidéo, la capture différée et les paramètres de l’appareil photo.

public ref class CameraCaptureUI sealed

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

Héritage

Object Platform::Object IInspectable CameraCaptureUI

Attributs

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Configuration requise pour Windows

Famille d’appareils	Windows 10 (introduit dans 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v1.0)
Fonctionnalités de l’application	microphone webcam

Exemples

Ce code montre comment utiliser la classe CameraCaptureUI pour prendre une photo. Le code provient du fichier CapturePhoto.xaml.cs de l’exemple C# de l’interface utilisateur de capture de l’appareil photo. L’exemple C++ de l’interface utilisateur de capture de caméra équivalent est également disponible. Le dialogue avec l’utilisateur se produit lorsque vous appelez la méthode asynchrone CaptureFileAsync.

// 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);

Remarques

CameraCaptureUI fournit une expérience d’interface utilisateur de fenêtre complète pour la capture d’audio, de vidéo et d’images. Il fournit des contrôles permettant de définir un délai sur les captures de photos, de rogner la vidéo et d’ajuster les paramètres de l’appareil photo, tels que la résolution vidéo, l’appareil audio, la luminosité et le contraste.

Appelez CaptureFileAsync pour lancer l’interface utilisateur. L’utilisateur contrôle quand démarrer la capture. Une fois l’opération Asynchrone CaptureFileAsync terminée, un objet StorageFile est retourné. Pour obtenir des conseils sur l’utilisation de CameraCaptureUI, consultez Capturer des photos et des vidéos avec l’interface utilisateur intégrée de l’appareil photo Windows

Notes

Vous ne devez pas spécifier les fonctionnalités de webcam ou de microphone dans votre fichier manifeste d’application si vous utilisez CameraCaptureUI. Si vous le faites, votre application s’affiche dans les paramètres de confidentialité de l’appareil photo de l’appareil, mais même si l’utilisateur refuse l’accès de la caméra à votre application, cela n’empêchera pas CameraCaptureUI de capturer des médias. Cela s’explique par le fait que l’application d’appareil photo intégrée de Windows est une application interne approuvée qui nécessite que l’utilisateur démarre la capture photo, vidéo ou audio en appuyant sur un bouton. Votre application peut échouer à la certification du Kit de certification d’application Windows lorsqu’elle est soumise au Store si vous spécifiez les fonctionnalités de webcam ou de microphone lors de l’utilisation de CameraCaptureUI.

Vous devez spécifier les fonctionnalités de webcam ou de microphone dans votre fichier manifeste d’application si vous utilisez MediaCapture pour capturer de l’audio, des photos ou des vidéos par programmation.

Notes

Cette classe n’est pas agile, ce qui signifie que vous devez prendre en compte son modèle de thread et son comportement de marshaling. Pour plus d’informations, consultez Threading and Marshaling (C++/CX) et Using Windows Runtime objects in a multithreaded environment (.NET).

Constructeurs

CameraCaptureUI()

Créez un objet CameraCaptureUI .

Propriétés

PhotoSettings	Fournit des paramètres pour la capture de photos. Les paramètres incluent le rapport d’aspect, la taille de l’image, le format, la résolution et si le rognage est autorisé ou non par l’interface utilisateur.
VideoSettings	Fournit des paramètres pour la capture de vidéos. Les paramètres incluent le format, la résolution maximale, la durée maximale et l’autorisation ou non du découpage.

Méthodes

CaptureFileAsync(CameraCaptureUIMode)

Lance l’interface utilisateur CameraCaptureUI .

Voir aussi

• Audio, vidéo et appareil photo
• Capturer des photos et des vidéos à l’aide de l’interface utilisateur de l’appareil photo intégré à Windows