Freigeben über


MediaEncodingProfile Klasse

Definition

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.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
Vererbung
Object Platform::Object IInspectable MediaEncodingProfile
Attribute

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.

Gilt für:

Weitere Informationen