Intelligent Media Services:複数字幕のトランスコーディングとパッケージングに関するベストプラクティス

設定ワークフロー

次のフローチャートは、トランスコーディングテンプレートの設定ワークフローを示しています。

サンプル要件

この例では、次の要件を使用します。

• エンコーディングプロトコル — H264 または H265

• ビデオ解像度 — 360P、540P、720P、または 1080P

• オーディオ — HE-AAC (64 Kbps)。その他のオーディオパラメーターはデフォルト値を使用します。

• 字幕 — M3U8 (VTT)

設定例

この例では、4 つのビデオ品質レベルを使用します。次の表に従って、ビデオトランスコーディングテンプレートを作成します。詳細については、「トランスコーディングテンプレートの作成」をご参照ください。

このトピックのジョブ例では、HE-AAC オーディオ出力用に Audio-64Kbps という名前のオーディオトランスコーディングテンプレートも参照します。パッケージングジョブを送信する前に、このテンプレートが作成されていることを確認してください。

狭帯域 HD トランスコーディングを使用するには、表に従って対応するテンプレートを作成し、チケットを送信してください。その後、Alibaba Cloud がバックエンドで設定をアップグレードします。

次の表は、H264 および H265 エンコーディングプロトコルのテンプレートについて説明しています。H265 を使用する場合は、次のコンテナフォーマットに関する考慮事項を確認してください。

• 推奨オプション — fmp4 コンテナフォーマットを使用します。これは Apple の標準プロトコルであり、Safari ブラウザーで正常に動作します。

• 代替案 — ts コンテナフォーマットも機能しますが、Safari との互換性はありません。

• コンソールの制限 — コンソールでは fmp4 コンテナフォーマットを作成できません。まず、m3u8 (ts) コンテナフォーマットでテンプレートを作成します。その後、Alibaba Cloud がバックエンドで設定をアップグレードします。

OverrideParams を使用した字幕ストリームの設定

トランスコーディングテンプレートでは字幕情報をカスタマイズできません。字幕ストリームを設定するには、ジョブの送信時に OverrideParams を使用して字幕情報を明示的に設定する必要があります。次の表は、字幕ストリームの設定について説明しています。

Subtitles

Subtitle

設定の説明 (HlsGroupConfig)

ジョブ例の各出力には、HLS マニフェスト内の出力ストリームを記述する HlsGroupConfig オブジェクトが含まれています。次の表は、パラメーターについて説明しています。

例：マルチビットレートのパッケージ化されたファイルのトランスコーディングと生成

次の例では、ビデオ (video)、英語のオーディオトラック (EnglishAudio)、中国語の字幕トラック (ChineseSubtitle)、および英語の字幕トラック (EnglishSubtitle) の 4 つの入力を定義しています。出力には、2 つのビデオ品質レベル (720P および 360P)、2 つのオーディオトラック、および 2 つの字幕トラックが含まれます。この例では、作成した 4 つのビデオテンプレートのうち 2 つを使用します。必要に応じて、ビデオ出力を追加または削除できます。

各字幕出力を含む各出力には、TemplateId が必要です。字幕出力の場合は、パッケージングジョブ内の任意のトランスコーディングテンプレートの ID を指定します。次の例では、<TemplateId> を Video-360P などの既存のテンプレート ID に置き換えます。

次の JSON は、SubmitMediaConvertJob リクエストの Config パラメーターに対応しています。山括弧で囲まれたプレースホルダーを実際の値に置き換えてください。

{
    "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
                        }
                    }
                ]
            }
        ]
    }
}

コールバックイベント

パッケージングジョブが完了すると、IMS はコールバックイベントを送信します。イベントタイプ (EventType) は MediaConvertComplete です。コンソールでは、まだこのイベントを選択できません。設定するには、SetEventCallback API を呼び出します。

主要フィールドの説明

次の表は、コールバックイベントの主要フィールドについて説明しています。

次の例は、コールバックイベントを示しています。

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