Intelligent Media Services:Praktik terbaik untuk transkoding dan pengemasan multi-subtitle

Alur kerja konfigurasi

Bagan alir berikut menunjukkan alur kerja konfigurasi templat transkoding.

Kebutuhan contoh

Contoh ini menggunakan persyaratan berikut:

• Protokol encoding — H264 atau H265

• Resolusi video — 360P, 540P, 720P, atau 1080P

• Audio — HE-AAC pada 64 Kbps. Parameter audio lainnya menggunakan nilai default.

• Subtitle — M3U8 (VTT)

Contoh konfigurasi

Contoh ini menggunakan empat tingkat kualitas video. Buat templat transkoding video seperti yang dijelaskan dalam tabel berikut. Untuk informasi lebih lanjut, lihat Buat templat transkoding.

Contoh pekerjaan dalam topik ini juga mereferensikan templat transkoding audio bernama Audio-64Kbps untuk output audio HE-AAC. Pastikan templat ini telah dibuat sebelum Anda mengirim pekerjaan pengemasan.

Untuk menggunakan transkoding Narrowband HD, buat templat yang sesuai seperti yang dijelaskan dalam tabel, lalu submit a ticket. Alibaba Cloud kemudian akan melakukan peningkatan konfigurasi di Backend.

Tabel berikut menjelaskan templat untuk protokol encoding H264 dan H265. Jika Anda menggunakan H265, pertimbangkan hal-hal berikut terkait format kontainer:

• Opsi utama — Gunakan format kontainer fmp4. Ini adalah protokol standar Apple dan bekerja dengan baik pada browser Safari.

• Alternatif — Format kontainer ts juga berfungsi, tetapi tidak kompatibel dengan Safari.

• Batasan Konsol — Anda tidak dapat membuat format kontainer fmp4 di Konsol. Buat templat terlebih dahulu dengan format kontainer m3u8(ts). Alibaba Cloud kemudian akan melakukan peningkatan konfigurasi di Backend.

Gunakan OverrideParams untuk mengatur aliran subtitle

Anda tidak dapat menyesuaikan informasi subtitle dalam templat transkoding. Untuk mengonfigurasi aliran subtitle, atur secara eksplisit informasi subtitle dengan OverrideParams saat mengirim pekerjaan. Tabel berikut menjelaskan pengaturan aliran subtitle.

Subtitle

Subtitle

Deskripsi konfigurasi (HlsGroupConfig)

Setiap output dalam contoh pekerjaan berisi objek HlsGroupConfig yang menjelaskan aliran output dalam manifes HLS. Tabel berikut menjelaskan parameter-parameternya.

Contoh: transkode dan hasilkan file terkemas multi-bitrate

Contoh berikut mendefinisikan empat input: sebuah video (video), track audio Inggris (EnglishAudio), track subtitle Tiongkok (ChineseSubtitle), dan track subtitle Inggris (EnglishSubtitle). Output mencakup dua tingkat kualitas video (720P dan 360P), dua track audio, dan dua track subtitle. Contoh ini menggunakan dua dari empat templat video yang telah Anda buat. Anda dapat menambah atau menghapus output video sesuai kebutuhan.

Setiap output, termasuk setiap output subtitle, memerlukan TemplateId. Untuk output subtitle, tentukan ID templat transkoding apa pun dalam pekerjaan pengemasan. Pada contoh berikut, ganti <TemplateId> dengan ID templat yang ada, misalnya Video-360P.

JSON berikut sesuai dengan parameter Config dari permintaan SubmitMediaConvertJob. Ganti placeholder dalam tanda kurung sudut dengan nilai aktual Anda.

{
    "Config": {
        "Inputs": [
            {
                "Name": "video",
                "InputFile": {
                    "Type": "OSS",
                    "Url": "https://<Bucket>.<OSSPublicEndpoint>/<Video1Chinese>"
                }
            },
            {
                "Name": "EnglishAudio",
                "InputFile": {
                    "Type": "OSS",
                    "Url": "https://<Bucket>.<OSSPublicEndpoint>/<Audio1English>"
                }
            },
            {
                "Name": "ChineseSubtitle",
                "InputFile": {
                    "Type": "OSS",
                    "Url": "https://<Bucket>.<OSSPublicEndpoint>/<Subtitle1Chinese>"
                }
            },
            {
                "Name": "EnglishSubtitle",
                "InputFile": {
                    "Type": "OSS",
                    "Url": "https://<Bucket>.<OSSPublicEndpoint>/<Subtitle1English>"
                }
            }
        ],
        "OutputGroups": [
            {
                "Name": "Hls",
                "GroupConfig": {
                    "Type": "Hls",
                    "OutputFileBase": {
                        "Type": "OSS",
                        "Url": "https://<Bucket>.<PublicEndpoint>/<URI>/"
                    },
                    "ManifestName": "<m3u8filename>"
                },
                "Outputs": [
                    {
                        "Name": "720P",
                        "OutputFileName": "video/720p/720p",
                        "TemplateId": "Video-720P",
                        "HlsGroupConfig": {
                            "Type": "Video"
                        }
                    },
                    {
                        "Name": "360P",
                        "OutputFileName": "video/360p/360p",
                        "TemplateId": "Video-360P",
                        "HlsGroupConfig": {
                            "Type": "Video"
                        }
                    },
                    {
                        "OutputFileName": "audio/chinese/chinese",
                        "TemplateId": "Audio-64Kbps",
                        "HlsGroupConfig": {
                            "Type": "Audio",
                            "Name": "ChineseAudio",
                            "Language": "zh",
                            "Autoselect": "TRUE",
                            "Default": "TRUE"
                        }
                    },
                    {
                        "InputRef": "ChineseSubtitle",
                        "OutputFileName": "subtitle/chinese/chinese",
                        "TemplateId": "<TemplateId>",
                        "OverrideParams": {
                            "Subtitles": [
                                {
                                    "Codec": "vtt"
                                }
                            ]
                        },
                        "HlsGroupConfig": {
                            "Type": "Subtitle",
                            "Name": "ChineseSubtitle",
                            "Language": "zh",
                            "Autoselect": "TRUE",
                            "Default": "TRUE"
                        }
                    },
                    {
                        "InputRef": "EnglishAudio",
                        "OutputFileName": "audio/english/english",
                        "TemplateId": "Audio-64Kbps",
                        "HlsGroupConfig": {
                            "Type": "Audio",
                            "Name": "EnglishAudio",
                            "Language": "en",
                            "Autoselect": "TRUE",
                            "Default": "FALSE"
                        }
                    },
                    {
                        "InputRef": "EnglishSubtitle",
                        "OutputFileName": "subtitle/english/english",
                        "TemplateId": "<TemplateId>",
                        "OverrideParams": {
                            "Subtitles": [
                                {
                                    "Codec": "vtt"
                                }
                            ]
                        },
                        "HlsGroupConfig": {
                            "Type": "Subtitle",
                            "Name": "EnglishSubtitle",
                            "Language": "en",
                            "Autoselect": "TRUE",
                            "Default": "FALSE"
                        }
                    }
                ]
            }
        ]
    }
}

Event callback

Saat pekerjaan pengemasan selesai, IMS mengirim event callback. Tipe event (EventType) adalah MediaConvertComplete. Konsol belum mendukung pemilihan event ini. Untuk mengonfigurasinya, panggil operasi SetEventCallback.

Deskripsi bidang utama

Tabel berikut menjelaskan bidang-bidang utama dari event callback.

Contoh berikut menunjukkan event callback:

{
    "FinishTime": "2025-05-09T08:03:21Z",
    "JobId": "your-job-id",
    "Status": "Success",
    "TriggerSource": "IceWorkflow",
    "UserData": "{\"ImsSrc\":\"Workflow\",\"TaskId\":\"e89a955d88ca47f0b9b79c562e5c622f\"}"
}