MediaCapture Classe

Définition

public ref class MediaCapture sealed : IClosable

/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
class MediaCapture final : IClosable

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class MediaCapture final : IClosable

[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.Standard)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
public sealed class MediaCapture : System.IDisposable

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class MediaCapture : System.IDisposable

function MediaCapture()

Public NotInheritable Class MediaCapture
Implements IDisposable

Héritage

Object Platform::Object IInspectable MediaCapture

Attributs

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implémente

IClosable IDisposable

Configuration requise pour Windows

Exemples

L’exemple de code suivant montre comment créer et initialiser un objet MediaCapture .

// Create and initialze the MediaCapture object.
public async void InitMediaCapture()
{
    _mediaCapture = null;
    _mediaCapture = new Windows.Media.Capture.MediaCapture();

    // Set the MediaCapture to a variable in App.xaml.cs to handle suspension.
    (App.Current as App).MediaCapture = _mediaCapture;

    await _mediaCapture.InitializeAsync(_captureInitSettings);

    CreateProfile();
}

Pour plus d’informations sur la gestion de la suspension, consultez Gérer la suspension d’application.

<StackPanel Orientation="Horizontal">
    <CaptureElement x:Name="capturePreview" Width="320" Height="240" />
    <Image x:Name="imagePreview" Stretch="None" Width="320" Height="240" />
</StackPanel>

<StackPanel Orientation="Horizontal">
    <Button Click="InitCamera_Click" Content="Initialize Camera" />
    <Button Click="StartCapturePreview_Click" Content="Start Capture Preview" />
    <Button Click="CapturePhoto_Click" Content="Capture Photo"/>
    <Button Click="StopCapturePreview_Click" Content="Stop Capture Preview" />
</StackPanel>

Windows.Media.Capture.MediaCapture captureManager;

async private void InitCamera_Click(object sender, RoutedEventArgs e)
{
    captureManager = new MediaCapture();
    await captureManager.InitializeAsync();
}

async private void StartCapturePreview_Click(object sender, RoutedEventArgs e)
{
    capturePreview.Source = captureManager;
    await captureManager.StartPreviewAsync();
}

async private void StopCapturePreview_Click(object sender, RoutedEventArgs e)
{
    await captureManager.StopPreviewAsync();
}

async private void CapturePhoto_Click(object sender, RoutedEventArgs e)
{
    ImageEncodingProperties imgFormat = ImageEncodingProperties.CreateJpeg();

    // create storage file in local app storage
    StorageFile file = await ApplicationData.Current.LocalFolder.CreateFileAsync(
        "TestPhoto.jpg",
        CreationCollisionOption.GenerateUniqueName);

    // take photo
    await captureManager.CapturePhotoToStorageFileAsync(imgFormat, file);

    // Get photo as a BitmapImage
    BitmapImage bmpImage = new BitmapImage(new Uri(file.Path));

    // imagePreview is a <Image> object defined in XAML
    imagePreview.Source = bmpImage;
}

Remarques

La classe MediaCapture est utilisée pour capturer de l’audio, de la vidéo et des images à partir d’une caméra. Pour obtenir des instructions pratiques sur l’affichage de l’aperçu de l’appareil photo, consultez Afficher l’aperçu de l’appareil photo. Pour commencer rapidement à capturer des photos, de l’audio ou de la vidéo, consultez Capture photo, vidéo et audio de base avec MediaCapture.

La page Appareil photo est le hub main pour obtenir des conseils pratiques sur l’utilisation de MediaCapture dans votre application. En plus des tâches de base de l’appareil photo, cette page renvoie à des articles pratiques pour les scénarios avancés, notamment :

• Utilisation du bouton de la caméra matérielle sur les appareils qui en ont un
• Gestion de l’orientation de l’appareil et de l’écran
• Utilisation de profils d’appareil photo pour déterminer les fonctionnalités de l’appareil
• Définition du format, de la résolution et de la fréquence d’images de la vidéo capturée
• Utilisation d’AdvancedPhotoCapture pour capturer des photos HDR ou en basse lumière
• Utilisation de VideoDeviceController pour accéder aux contrôles manuels de l’appareil photo comme l’exposition, la balance des blancs, le focus automatique et le flash
• Utilisation d’effets lors de la capture vidéo
• Capture de séquences de photos
• Utilisation de MediaFrameReader pour obtenir un flux d’images à partir d’une ou plusieurs caméras, notamment des caméras rvb, infrarouges et de profondeur
• Obtention d’une image à partir du flux d’aperçu

L’article Appareil photo renvoie également à tous les exemples du KIT de développement logiciel (SDK) UWP pour l’appareil photo, tels que l’exemple du kit de démarrage appareil photo .

La méthode InitializeAsync , qui initialise l’objet MediaCapture , doit être appelée avant de pouvoir commencer à prévisualiser ou à capturer à partir de l’appareil. Dans les applications C# ou C++, la première utilisation de l’objet MediaCapture pour appeler InitializeAsync doit se trouver sur le thread STA. Les appels d’un thread MTA peuvent entraîner un comportement non défini. InitializeAsync lance une invite de consentement pour obtenir l’autorisation de l’utilisateur pour que l’application accède au microphone ou à la caméra. InitializeAsync doit être appelé à partir du thread d’interface utilisateur main de votre application. Les applications doivent gérer la suspension ou l’arrêt des applications en nettoyant correctement les ressources de capture multimédia. Pour plus d’informations sur l’arrêt correct de l’objet MediaCapture , consultez Capture photo, vidéo et audio de base avec MediaCapture.

Sur Windows, les applications de capture de musique et multimédia doivent surveiller SystemMediaTransportControls.SoundLevel pour déterminer si les flux audio de l’application ont été désactivés. Pour les applications utilisant l’objet MediaCapture, la capture est automatiquement arrêtée lorsque les flux de capture de l’application sont désactivés. La capture n’étant pas redémarrée automatiquement lorsque les flux audio sont désactivés, la notification de modification SoundLevel peut être utilisée pour redémarrer la capture. Utilisez l’événement SystemMediaTransportControls.PropertyChanged pour déterminer quand la propriété SoundLevel change.

Pour Windows Phone applications 8.x, les applications de musique et de média doivent propre l’objet MediaCapture et les ressources associées dans le gestionnaire d’événements Suspending et les recréer dans le gestionnaire d’événements Reprise.

Dans Windows 8.1 applications audio uniquement, si le paramètre MediaCategory est Autre, le mode de latence élevée est utilisé. Pour une faible latence, définissez le paramètre MediaCategory sur Communications.

L’ajout d’un effet de transformation Media Foundation sur place dans l’aperçu de capture n’aura aucun effet sur le flux.

Windows 8 applications UWP qui ont déclaré les fonctionnalités de webcam et de microphone ne fonctionnent pas dans Windows 8.1 si l’utilisateur n’a pas activé les paramètres de confidentialité de la webcam et du microphone.

MediaCapture ne prend en charge qu’un seul encodage CBR de passage.

Remarques sur JPEG : Les types JPEG sont passthrough uniquement. Pour capturer une image, le profil d’encodage d’image peut être défini sur Auto ou vous devez spécifier un profil d’encodage qui correspond au type natif. Pour ajouter un effet, vous devez basculer vers un type de média vidéo natif non compressé, tel que NV12 ou RGB32.

Remarques sur H.264 : Si le type natif est H.264, vous pouvez enregistrer à l’aide d’un type de média vidéo de type identique au type natif. Vous ne pouvez pas ajouter un effet à un flux de type natif H.264. Pour capturer la vidéo, le profil d’encodage d’image peut être défini sur Auto ou vous devez spécifier un profil d’encodage qui correspond au type natif.

Historique des versions

Constructeurs

Propriétés

Méthodes

Événements

S’applique à

Voir aussi

• Appareil photo
• Capture photo, vidéo et audio de base à l’aide de MediaCapture
• Exemple de capture multimédia
• Exemple d’interface utilisateur de capture d’appareil photo
• Exemple d’interface utilisateur des options de l’appareil photo
• Exemple d’énumération d’appareil
• Exemple de communication en temps réel
• Exemple d’extension de média
• Formats audio et vidéo pris en charge
• Exemple de communication en temps réel (Windows 10)
• Exemple d’image d’aperçu de l’appareil photo
• Exemple de stabilisation vidéo
• Exemple de capture de Mixed Reality holographique