MediaEncodingProfile Classe

Définition

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.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [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)]
class MediaEncodingProfile final
/// [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.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[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)]
public sealed class MediaEncodingProfile
[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

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.

S’applique à

Voir aussi