Bagikan melalui


MediaEncodingProfile Kelas

Definisi

Menjelaskan profil pengodean untuk file audio atau video. Profil pengodean mencakup deskripsi format pengodean audio dan video, dan deskripsi kontainer media.

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
Warisan
Object Platform::Object IInspectable MediaEncodingProfile
Atribut

Persyaratan Windows

Rangkaian perangkat
Windows 10 (diperkenalkan dalam 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)

Keterangan

Kualitas pengodean Otomatis adalah preset khusus yang mengisi pengaturan yang tepat berdasarkan pengaturan kamera saat ini. Pengaturan yang dimodifikasi secara manual diabaikan. Misalnya, jika Anda membuat profil prasetel menggunakan salah satu metode pembuatan statis, seperti CreateM4a, dan menentukan Otomatis sebagai kualitas pengodean, setiap perubahan yang Anda buat pada properti akan ditimpa dengan nilai berdasarkan pengaturan kamera saat ini.

Catatan

Dimungkinkan untuk membuat MediaEncodingProfile yang tidak didukung pada perangkat tertentu. Misalnya, Anda mungkin berhasil memanggil CreateMp3, tetapi jika encoder mp3 tidak ada di perangkat, mencoba mengodekan audio dengan properti yang dikembalikan dari metode ini akan gagal. Untuk daftar codec yang ada secara default untuk setiap keluarga perangkat, lihat Codec yang didukung..

Catatan

Hanya jenis profil pengodean video yang mendukung pengaturan kualitas pengodean Otomatis. Profil audio tidak mendukung pengaturan ini dan akan menghasilkan kesalahan saat pengaturan digunakan. Misalnya: Jika Anda membuat profil menggunakan MediaEncodingProfile.CreateMp3 dengan AudioEncodingQuality.Auto lalu memanggil PrepareStreamTranscodeAsync, Anda akan menerima kesalahan NullReferenceException . Dalam hal ini Anda harus memilih pengaturan kualitas pengodean selain Otomatis untuk memungkinkan Anda membuat profil fungsi.

Untuk panduan cara menggunakan MediaEncodingProfile untuk mengatur properti pengodean untuk gambar yang diambil, lihat Pengambilan foto, video, dan audio dasar dengan MediaCapture. Untuk informasi tentang menggunakan MediaEncodingProfile saat melakukan transkode file media, lihat File media transkode.

Riwayat versi

Versi Windows Versi SDK Nilai ditambahkan
1703 15063 CreateAlac
1703 15063 CreateFlac
1703 15063 BuatHevc
1709 16299 GetAudioTracks
1709 16299 GetVideoTracks
1709 16299 SetAudioTracks
1709 16299 SetVideoTracks
1803 17134 GetTimedMetadataTracks
1803 17134 SetTimedMetadataTracks

Konstruktor

MediaEncodingProfile()

Membuat instans baru kelas MediaEncodingProfile .

Properti

Audio

Mendapatkan atau mengatur properti pengodean untuk aliran audio.

Container

Mendapatkan atau mengatur properti kontainer media.

Video

Mendapatkan atau mengatur properti pengodean untuk streaming video.

Metode

CreateAlac(AudioEncodingQuality)

Membuat instans MediaEncodingProfile untuk audio Apple Lossless Audio Codec (ALAC).

CreateAv1(VideoEncodingQuality)

Membuat profil pengodean untuk video AOMedia Video 1 (AV1).

CreateAvi(VideoEncodingQuality)

Membuat instans MediaEncodingProfile untuk AVI.

CreateFlac(AudioEncodingQuality)

Membuat instans MediaEncodingProfile untuk audio Free Lossless Audio Codec (FLAC).

CreateFromFileAsync(IStorageFile)

Membuat profil pengodean dari file media yang ada.

CreateFromStreamAsync(IRandomAccessStream)

Membuat profil pengodean dari aliran yang berisi data media.

CreateHevc(VideoEncodingQuality)

Membuat instans video MediaEncodingProfile untuk High Efficiency Video Coding (HEVC), juga dikenal sebagai video H.265.

CreateM4a(AudioEncodingQuality)

Membuat profil pengodean untuk audio AAC.

CreateMp3(AudioEncodingQuality)

Membuat profil pengodean untuk audio MP3 (MPEG-1 lapisan 3).

CreateMp4(VideoEncodingQuality)

Membuat profil pengodean untuk video H.264.

CreateVp9(VideoEncodingQuality)

Membuat profil pengodean untuk video VP9.

CreateWav(AudioEncodingQuality)

Membuat instans MediaEncodingProfile untuk WAV

CreateWma(AudioEncodingQuality)

Membuat profil pengodean untuk Windows Media Audio (WMA).

CreateWmv(VideoEncodingQuality)

Membuat profil pengodean untuk Windows Media Video (WMV).

GetAudioTracks()

Mengambil daftar objek AudioStreamDescriptor yang menjelaskan aliran audio yang disertakan dalam MediaEncodingProfile.

GetTimedMetadataTracks()

Mengambil daftar objek TimedMetadataStreamDescriptor yang menjelaskan aliran metadata berwaktu yang disertakan dalam MediaEncodingProfile.

GetVideoTracks()

Mengambil daftar objek VideoStreamDescriptor yang menjelaskan aliran video yang disertakan dalam MediaEncodingProfile.

SetAudioTracks(IIterable<AudioStreamDescriptor>)

Mengatur daftar objek AudioStreamDescriptor yang menjelaskan aliran audio yang disertakan dalam MediaEncodingProfile.

SetTimedMetadataTracks(IIterable<TimedMetadataStreamDescriptor>)

Mengatur daftar objek TimedMetadataStreamDescriptor yang menjelaskan aliran metadata berwaktu yang disertakan dalam MediaEncodingProfile.

SetVideoTracks(IIterable<VideoStreamDescriptor>)

Mengatur daftar objek VideoStreamDescriptor yang menjelaskan aliran video yang disertakan dalam MediaEncodingProfile.

Berlaku untuk

Lihat juga