MediaEncodingProfile Klasse

Definition

Namespace:

Windows.Media.MediaProperties

Beschreibt das Codierungsprofil für eine Audio- oder Videodatei. Das Codierungsprofil enthält Beschreibungen der Audio- und Videocodierungsformate sowie eine Beschreibung des Mediencontainers.

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

Vererbung

Object Platform::Object IInspectable MediaEncodingProfile

Attribute

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Hinweise

Die Codierungsqualität Auto ist eine spezielle Voreinstellung, die die richtigen Einstellungen basierend auf den aktuellen Kameraeinstellungen ausfüllt. Einstellungen, die manuell geändert werden, werden ignoriert. Wenn Sie beispielsweise ein voreingestelltes Profil mit einer der statischen Erstellungsmethoden wie CreateM4a erstellen und Auto als Codierungsqualität angeben, werden alle Änderungen, die Sie an den Eigenschaften vornehmen, mit Werten überschrieben, die auf den aktuellen Kameraeinstellungen basieren.

Hinweis

Es ist möglich, ein MediaEncodingProfile zu erstellen, das auf einem bestimmten Gerät nicht unterstützt wird. Beispielsweise können Sie CreateMp3 erfolgreich aufrufen, aber wenn kein mp3-Encoder auf dem Gerät vorhanden ist, schlägt der Versuch, Audio mit den von dieser Methode zurückgegebenen Eigenschaften zu codieren, fehl. Eine Liste der standardmäßig für jede Gerätefamilie vorhandenen Codecs finden Sie unter Unterstützte Codecs.

Hinweis

Nur Videocodierungsprofiltypen unterstützen die Einstellung für die Codierungsqualität von Auto. Audioprofile unterstützen diese Einstellung nicht und generieren einen Fehler, wenn die Einstellung verwendet wird. Beispiel: Wenn Sie ein Profil mit MediaEncodingProfile.CreateMp3 mit AudioEncodingQuality.Auto erstellen und dann PrepareStreamTranscodeAsync aufrufen, erhalten Sie einen NullReferenceException-Fehler . In diesem Fall müssen Sie eine andere Einstellung für die Codierungsqualität als Auto auswählen, damit Sie ein Funktionsprofil erstellen können.

Anleitungen zur Verwendung von MediaEncodingProfile zum Festlegen der Codierungseigenschaften für aufgenommene Bilder finden Sie unter Grundlegende Foto-, Video- und Audioaufnahme mit MediaCapture. Informationen zur Verwendung von MediaEncodingProfile beim Transcodieren von Mediendateien finden Sie unter Transcodieren von Mediendateien.

Versionsverlauf

Windows-Version	SDK-Version	Mehrwert
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

Konstruktoren

MediaEncodingProfile()

Erstellt eine neue instance der MediaEncodingProfile-Klasse.

Eigenschaften

Audio	Ruft die Codierungseigenschaften für den Audiodatenstrom ab oder legt diese fest.
Container	Ruft die Eigenschaften des Mediencontainers ab oder legt sie fest.
Video	Ruft die Codierungseigenschaften für den Videostream ab oder legt diese fest.

Methoden

CreateAlac(AudioEncodingQuality)	Erstellt eine instance von MediaEncodingProfile für Apple Lossless Audio Codec (ALAC)-Audio.
CreateAv1(VideoEncodingQuality)	Erstellt ein Codierungsprofil für AOMedia Video 1 (AV1)-Video.
CreateAvi(VideoEncodingQuality)	Erstellt eine instance von MediaEncodingProfile für AVI.
CreateFlac(AudioEncodingQuality)	Erstellt eine instance mediaEncodingProfile für FLAC-Audioaudio (Free Lossless Audio Codec).
CreateFromFileAsync(IStorageFile)	Erstellt ein Codierungsprofil aus einer vorhandenen Mediendatei.
CreateFromStreamAsync(IRandomAccessStream)	Erstellt ein Codierungsprofil aus einem Stream, der Mediendaten enthält.
CreateHevc(VideoEncodingQuality)	Erstellt eine instance von MediaEncodingProfile für HEVC-Videos (High Efficiency Video Coding), auch bekannt als H.265-Video.
CreateM4a(AudioEncodingQuality)	Erstellt ein Codierungsprofil für AAC-Audio.
CreateMp3(AudioEncodingQuality)	Erstellt ein Codierungsprofil für MP3-Audio (MPEG-1 Layer 3).
CreateMp4(VideoEncodingQuality)	Erstellt ein Codierungsprofil für H.264-Video.
CreateVp9(VideoEncodingQuality)	Erstellt ein Codierungsprofil für VP9-Video.
CreateWav(AudioEncodingQuality)	Erstellt eine instance von MediaEncodingProfile für WAV
CreateWma(AudioEncodingQuality)	Erstellt ein Codierungsprofil für Windows Media Audio (WMA).
CreateWmv(VideoEncodingQuality)	Erstellt ein Codierungsprofil für Windows Media Video (WMV).
GetAudioTracks()	Ruft die Liste der AudioStreamDescriptor-Objekte ab, die die audiostreams beschreiben, die in MediaEncodingProfile enthalten sind.
GetTimedMetadataTracks()	Ruft die Liste der TimedMetadataStreamDescriptor-Objekte ab, die die zeitbestimmten Metadatenstreams beschreiben, die in MediaEncodingProfile enthalten sind.
GetVideoTracks()	Ruft die Liste der VideoStreamDescriptor-Objekte ab, die die videostreams beschreiben, die in MediaEncodingProfile enthalten sind.
SetAudioTracks(IIterable<AudioStreamDescriptor>)	Legt die Liste der AudioStreamDescriptor-Objekte fest, die die audiostreams beschreiben, die in MediaEncodingProfile enthalten sind.
SetTimedMetadataTracks(IIterable<TimedMetadataStreamDescriptor>)	Legt die Liste der TimedMetadataStreamDescriptor-Objekte fest, die die zeitbestimmten Metadatenstreams beschreiben, die in MediaEncodingProfile enthalten sind.
SetVideoTracks(IIterable<VideoStreamDescriptor>)	Legt die Liste der VideoStreamDescriptor-Objekte fest, die die videostreams beschreiben, die in MediaEncodingProfile enthalten sind.

Weitere Informationen

• Beispiel für die Medientranscodierung (Windows 10)
• Allgemeine Foto-, Video- und Audioaufnahme mit „MediaCapture“
• Transkodieren von Mediendateien