Menggunakan API Transcode
Topik ini menjelaskan cara menggunakan API transcode untuk mengodekan file media.
- Gambaran Umum
- Membuat Sumber Media
- Membuat Profil Transcode
- Membuat Topologi Transkode
- Menjalankan Sesi Pengodean
- Topik terkait
Gambaran Umum
Sebelum menggunakan API transcode, aplikasi harus memiliki informasi berikut:
- Jalur atau URL ke file media yang ada yang akan dikodekan ulang.
- Nama file output.
- Jenis kontainer untuk file output, seperti MP4 atau Advanced Streaming Format (ASF).
- Format pengodean. Informasi ini mencakup jenis media yang menjelaskan aliran audio dan video yang dikodekan.
Untuk menggunakan API transcode, aplikasi melakukan langkah-langkah berikut.
- Buat sumber media untuk membaca file sumber.
- Membuat profil transkode. Tambahkan atribut yang menjelaskan aliran audio, aliran video, dan kontainer file.
- Gunakan profil transkode untuk membuat topologi pengodean. (Untuk informasi selengkapnya tentang topologi, lihat Tentang Topologi.)
- Atur topologi pada Sesi Media.
- Mulai Sesi Media dan tunggu peristiwa MESessionEnded .
Sisa topik ini menjelaskan langkah-langkah ini secara lebih rinci.
Membuat Sumber Media
Sumber media adalah objek yang membaca dan mengurai file sumber. Untuk membuat sumber media, gunakan Pemecah Masalah Sumber. Anda dapat menemukan contoh kode dalam topik Menggunakan Pemecah Masalah Sumber.
Membuat Profil Transcode
Profil transkode menjelaskan format dan pengaturan yang digunakan untuk mengodekan file output. Profil transkode berisi tiga set atribut:
- Atribut audio: Menjelaskan format audio target dan pengaturan encoder audio.
- Atribut video: Menjelaskan format video target dan pengaturan encoder video.
- Atribut kontainer: Tentukan jenis kontainer file, serta beberapa pengaturan pengodean global.
Untuk membuat profil transkode, panggil fungsi MFCreateTranscodeProfile . Fungsi ini mengembalikan penunjuk ke antarmuka IMFTranscodeProfile . Objek profil awal kosong; tidak berisi atribut. Langkah selanjutnya adalah menambahkan atribut yang menentukan profil.
Atribut Audio
Untuk menambahkan atribut untuk aliran audio, panggil IMFTranscodeProfile::SetAudioAttributes. Atribut ini menentukan bagaimana aliran audio dikodekan. Jika file output tidak akan berisi aliran audio, hilangkan atribut ini.
Atribut audio termasuk dalam dua kategori:
- Atribut yang menentukan format aliran yang dikodekan
- Atribut yang menentukan parameter pengodean lainnya.
Atribut format hanyalah atribut jenis media, seperti yang dijelaskan di bagian Jenis Media Audio. Set atribut format yang tepat tergantung pada encoder. (Lihat Format Media yang Didukung di Media Foundation.) Berikut adalah daftar atribut format audio umum:
| Format Atribut | Deskripsi |
|---|---|
| MF_MT_SUBTYPE | Subjenisnya. Lihat GUID Subjenis Audio. |
| MF_MT_AUDIO_NUM_CHANNELS | Jumlah saluran audio. |
| MF_MT_AUDIO_SAMPLES_PER_SECOND | Jumlah sampel audio per detik. |
| MF_MT_AUDIO_BLOCK_ALIGNMENT | Perataan blok. |
| MF_MT_AUDIO_AVG_BYTES_PER_SECOND | Jumlah rata-rata byte per detik (laju bit yang dikodekan). |
Parameter pengodean berikut ditentukan.
| Parameter Pengodean | Deskripsi |
|---|---|
| MF_TRANSCODE_DONOT_INSERT_ENCODER | Mencegah API transkode menyisipkan encoder untuk aliran audio. |
| MF_TRANSCODE_ENCODINGPROFILE | Menentukan templat kesuaian perangkat. (Hanya berlaku untuk file ASF.) |
| MF_TRANSCODE_QUALITYVSSPEED | Menentukan trade-off antara kualitas dan kecepatan pengodean. |
Anda harus mengatur atribut format. Parameter pengodean bersifat opsional.
Salah satu cara untuk menemukan format yang kompatibel dengan encoder adalah dengan memanggil fungsi MFTranscodeGetAudioOutputAvailableTypes . Encoder yang diinginkan ditentukan oleh subjenis. Fungsi mengembalikan kumpulan jenis media untuk encoder tersebut. Anda dapat memilih jenis dari daftar dan menyalin atribut ke profil. Misalnya kode yang menggunakan pendekatan ini, lihat Tutorial: Mengodekan File WMA.
Atribut Video
Untuk menambahkan atribut untuk aliran video, panggil IMFTranscodeProfile::SetVideoAttributes. Atribut ini menentukan bagaimana aliran video dikodekan. Jika file output tidak akan berisi aliran video, hilangkan atribut ini.
Seperti atribut audio, atribut video termasuk dalam dua kategori:
- Atribut yang menentukan format aliran yang dikodekan
- Atribut yang menentukan parameter pengodean lainnya.
Atribut format adalah atribut jenis media, seperti yang dijelaskan di bagian Jenis Media Video. Berikut adalah daftar atribut format video umum:
| Format Atribut | Deskripsi |
|---|---|
| MF_MT_SUBTYPE | Subjenisnya. Lihat GUID Subjenis Video. |
| MF_MT_FRAME_RATE | Kecepatan bingkai. |
| MF_MT_FRAME_SIZE | Ukuran bingkai. |
| MF_MT_AVG_BITRATE | Laju bit rata-rata. |
| MF_MT_PIXEL_ASPECT_RATIO | Rasio aspek piksel. |
Parameter pengodean berikut ditentukan.
| Parameter Pengodean | Deskripsi |
|---|---|
| MF_TRANSCODE_DONOT_INSERT_ENCODER | Mencegah API transkode menyisipkan encoder untuk aliran video. |
| MF_TRANSCODE_ENCODINGPROFILE | Menentukan templat kesuaian perangkat. (Hanya berlaku untuk file ASF.) |
| MF_TRANSCODE_QUALITYVSSPEED | Menentukan trade-off antara kualitas dan kecepatan pengodean. |
Anda harus mengatur atribut format. Parameter pengodean bersifat opsional.
Atribut Kontainer
Atribut kontainer menentukan karakteristik tingkat file dari file output. Untuk mengatur atribut kontainer, panggil IMFTranscodeProfile::SetContainerAttributes. Atribut berikut didefinisikan.
| Atribut | Deskripsi |
|---|---|
| MF_TRANSCODE_ADJUST_PROFILE | Menentukan pengaturan aliran yang akan digunakan untuk topologi transkode. Anda dapat mengatur bendera untuk menggunakan pengaturan sumber input atau menggunakan atribut aliran kustom. |
| MF_TRANSCODE_CONTAINERTYPE | Menentukan format file file output, seperti MP4 atau ASF. Berdasarkan nilai ini, sink media yang sesuai ditambahkan ke topologi. |
| MF_TRANSCODE_SKIP_METADATA_TRANSFER | Menentukan apakah metadata dari sumber disalin ke file output. |
| MF_TRANSCODE_TOPOLOGYMODE | Menentukan apakah codec berbasis perangkat keras dapat digunakan selama transcoding. |
| MFT_FIELDOFUSE_UNLOCK_Attribute | Membuka kodek yang memiliki batasan bidang penggunaan. Untuk informasi selengkapnya, lihat Bidang Pembatasan Penggunaan. |
Atribut MF_TRANSCODE_CONTAINERTYPE diperlukan. Atribut kontainer lainnya bersifat opsional.
Membuat Topologi Transkode
Topologi transkode adalah topologi parsial yang berisi sumber media, codec yang sesuai, dan sink media. Untuk membuat topologi transkode, panggil ke fungsi MFCreateTranscodeTopology . Fungsi ini mengambil parameter berikut sebagai input:
- Penunjuk ke antarmuka IMFMediaSource dari sumber media.
- Nama file output.
- Penunjuk ke antarmuka IMFTranscodeProfile dari profil transkode.
Fungsi mengembalikan penunjuk ke antarmuka IMFTopology .
Menjalankan Sesi Pengodean
Setelah membuat topologi, Anda siap untuk mengodekan file. Anda dapat membuang profil pada saat ini.
- Panggil MFCreateMediaSession untuk membuat Sesi Media.
- Panggil IMFMediaSession::SetTopology untuk mengatur topologi pada Sesi Media.
- Panggil IMFMediaSession::Mulai untuk memulai sesi pengodean.
- Tunggu peristiwa MESessionEnded .
- Panggil IMFMediaSession::Close untuk menutup Sesi Media.
- Tunggu peristiwa MESessionClosed .
- Hubungi IMFMediaSource::Shutdown.
- Panggil IMFMediaSession::Shutdown.
Sebagian besar waktu yang dihabiskan untuk pengodean terjadi antara langkah 3 dan 4.
Topik terkait