MediaEncodingProfile Classe

Définition

Espace de noms:

Windows.Media.MediaProperties

Décrit le profil d’encodage d’un fichier audio ou vidéo. Le profil d’encodage comprend des descriptions des formats d’encodage audio et vidéo, ainsi qu’une description du conteneur multimédia.

public ref class MediaEncodingProfile sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class MediaEncodingProfile final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class MediaEncodingProfile

function MediaEncodingProfile()

Public NotInheritable Class MediaEncodingProfile

Héritage

Object Platform::Object IInspectable MediaEncodingProfile

Attributs

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Configuration requise pour Windows

Famille d’appareils	Windows 10 (introduit dans 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Remarques

L’auto de qualité d’encodage est une présélection spéciale qui remplit les paramètres appropriés en fonction des paramètres actuels de l’appareil photo. Les paramètres qui sont modifiés manuellement sont ignorés. Par exemple, si vous créez un profil prédéfini à l’aide de l’une des méthodes de création statique, telles que CreateM4a, et que vous spécifiez Auto comme qualité d’encodage, toutes les modifications que vous apportez aux propriétés seront remplacées par des valeurs en fonction des paramètres actuels de l’appareil photo.

Notes

Il est possible de créer un MediaEncodingProfile qui n’est pas pris en charge sur un appareil particulier. Par exemple, vous pouvez appeler avec succès CreateMp3, mais si un encodeur mp3 n’est pas présent sur l’appareil, la tentative d’encodage audio avec les propriétés retournées par cette méthode échoue. Pour obtenir la liste des codecs présents par défaut pour chaque famille d’appareils, consultez Codecs pris en charge..

Notes

Seuls les types de profils d’encodage vidéo prennent en charge le paramètre de qualité d’encodage auto. Les profils audio ne prennent pas en charge ce paramètre et génèrent une erreur lorsque le paramètre est utilisé. Par exemple : si vous créez un profil à l’aide de MediaEncodingProfile.CreateMp3 avec AudioEncodingQuality.Auto , puis appelez PrepareStreamTranscodeAsync, vous recevez une erreur NullReferenceException . Dans ce cas, vous devez choisir un paramètre de qualité d’encodage autre que Auto pour vous permettre de créer un profil fonctionnel.

Pour obtenir des instructions sur l’utilisation de MediaEncodingProfile pour définir les propriétés d’encodage des images capturées, consultez Capture photo, vidéo et audio de base avec MediaCapture. Pour plus d’informations sur l’utilisation de MediaEncodingProfile lors du transcodage de fichiers multimédias, consultez Transcoder des fichiers multimédias.

Historique des versions

Version de Windows	Version du SDK	Valeur ajoutée
1703	15063	CreateAlac
1703	15063	CreateFlac
1703	15063	CreateHevc
1709	16299	GetAudioTracks
1709	16299	GetVideoTracks
1709	16299	SetAudioTracks
1709	16299	SetVideoTracks
1803	17134	GetTimedMetadataTracks
1803	17134	SetTimedMetadataTracks

Constructeurs

MediaEncodingProfile()

Crée un instance de la classe MediaEncodingProfile.

Propriétés

Audio	Obtient ou définit les propriétés d’encodage du flux audio.
Container	Obtient ou définit les propriétés du conteneur multimédia.
Video	Obtient ou définit les propriétés d’encodage du flux vidéo.

Méthodes

CreateAlac(AudioEncodingQuality)	Crée une instance de MediaEncodingProfile pour l’audio ALAC (Lossless Audio Codec) Apple.
CreateAv1(VideoEncodingQuality)	Crée un profil d’encodage pour la vidéo AOMedia Video 1 (AV1).
CreateAvi(VideoEncodingQuality)	Crée un instance de MediaEncodingProfile pour AVI.
CreateFlac(AudioEncodingQuality)	Crée une instance de MediaEncodingProfile pour l’audio du codec audio sans perte (FLAC).
CreateFromFileAsync(IStorageFile)	Crée un profil d’encodage à partir d’un fichier multimédia existant.
CreateFromStreamAsync(IRandomAccessStream)	Crée un profil d’encodage à partir d’un flux qui contient des données multimédias.
CreateHevc(VideoEncodingQuality)	Crée une instance de la vidéo MediaEncodingProfile pour le codage vidéo à haute efficacité (HEVC), également appelée vidéo H.265.
CreateM4a(AudioEncodingQuality)	Crée un profil d’encodage pour l’audio AAC.
CreateMp3(AudioEncodingQuality)	Crée un profil d’encodage pour l’audio MP3 (MPEG-1 couche 3).
CreateMp4(VideoEncodingQuality)	Crée un profil d’encodage pour la vidéo H.264.
CreateVp9(VideoEncodingQuality)	Crée un profil d’encodage pour la vidéo VP9.
CreateWav(AudioEncodingQuality)	Crée un instance de MediaEncodingProfile pour WAV
CreateWma(AudioEncodingQuality)	Crée un profil d’encodage pour Windows Media Audio (WMA).
CreateWmv(VideoEncodingQuality)	Crée un profil d’encodage pour Windows Media Video (WMV).
GetAudioTracks()	Récupère la liste des objets AudioStreamDescriptor décrivant les flux audio inclus dans mediaEncodingProfile.
GetTimedMetadataTracks()	Récupère la liste des objets TimedMetadataStreamDescriptor décrivant les flux de métadonnées chronométrés inclus dans le MediaEncodingProfile.
GetVideoTracks()	Récupère la liste des objets VideoStreamDescriptor décrivant les flux vidéo inclus dans mediaEncodingProfile.
SetAudioTracks(IIterable<AudioStreamDescriptor>)	Définit la liste des objets AudioStreamDescriptor décrivant les flux audio inclus dans mediaEncodingProfile.
SetTimedMetadataTracks(IIterable<TimedMetadataStreamDescriptor>)	Définit la liste des objets TimedMetadataStreamDescriptor décrivant les flux de métadonnées chronométrés inclus dans le MediaEncodingProfile.
SetVideoTracks(IIterable<VideoStreamDescriptor>)	Définit la liste des objets VideoStreamDescriptor décrivant les flux vidéo inclus dans MediaEncodingProfile.

Voir aussi

• Exemple de support de transcodage (Windows 10)
• Capture photo, vidéo et audio de base à l’aide de MediaCapture
• Transcoder des fichiers multimédias