MediaEncodingProfile Kelas

Definisi

Ruang nama:

Windows.Media.MediaProperties

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.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

Warisan

Object Platform::Object IInspectable MediaEncodingProfile

Atribut

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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.

Lihat juga

• Sampel media transkode (Windows 10)
• Pengambilan foto, video, dan audio dasar dengan MediaCapture
• Transkode file media