Add Subtitles
最終更新日：2025-05-22 15:09:39
動画に字幕を追加可能：ハードコード（永久表示）とソフトコード（視聴者選択可能）両方の字幕トラックをサポート
対応フォーマット
-
入力動画形式：MP4、FLV、M3U8、TS、MKV、MOV、WMV、AVI、VP8、VP9、RealVideo、Windows Media Video 他
-
コーデック：H.265、H.264、H.263、MPEG 他
-
字幕形式：SRT、MKV字幕、埋め込み字幕ストリーム
使用方法
fopsコマンドを以下の形式で構成：
<op>/<Format>
/subtitle/<value>
/subtitleType/<value>
/subtitleAttr/<value>
|saveas/<Urlsafe_Base64_Encode(bucket:filekey)>
パラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
op |
はい | 操作タイプ。字幕処理時はavthumbを指定 |
format |
はい | 出力形式（mp4/flv/m3u8等） |
subtitle |
はい | 埋め込み字幕ファイル（URL-safe Base64エンコード形式 bucket:path）対応ソース： • UTF-8エンコードSRTファイル • MKVファイル抽出字幕 • 元動画の埋め込み字幕ストリーム 例：バケット test内1.srtの場合 → test:1.srt → dGVzdDoxLnNydA==複数指定時：カンマ区切りで連結 例： subtitle=aHR0cDovL2VuY29kZS5jaGFodW8uY29tLw,aHR0cDovL2VuY29kZS5jaGFodW8uY29tLw |
subtitleType |
いいえ | 字幕埋め込み方式： • 0（既定） - システム自動判別• 1 - ソフトコード：視聴者表示切替可能• 2 - ハードコード：動画に直接焼き込み |
subtitleAttr |
いいえ | 適応型ビットレート（m3u8）出力向けソフトコード字幕属性 形式： subtitleAttr=base64_encode(lang=xx1,name=yy1)• lang - 言語コード（ISO 639-1）• name - 字幕名称複数設定時：カンマ区切り 例： subtitleAttr=base64_encode(lang=en,name=English),base64_encode(lang=es,name=Spanish)注意：字幕ファイル数と属性数は完全一致必須 |
saveas |
いいえ | 出力先指定（URL-safe Base64エンコード形式）：Urlsafe_Base64_Encode(bucket:保存ファイル名) |
例
vod-wcs-test001バケット内のtest.flv動画にzimu.srt字幕を追加し、MP4形式でtest_file.mp4として保存：
疑似コード
curl -v -X POST
–d "bucket=Urlsafe_Base64_Encode(vod-wcs-test001)&key=Urlsafe_Base64_Encode(test.flv)&fops=Urlsafe_Base64_Encode(avthumb/mp4/subtitle/Urlsafe_Base64_Encode(vod-wcs-test001:zimu.srt)|saveas/Urlsafe_Base64_Encode(vod-wcs-test001:test_file.mp4))&force=1&separate=1"
–H "Authorization:AccessKey:EncodeSign"
--url "http://mgrDomain/fops"
実際のリクエスト
curl -v -X POST
-d "bucket=dm9kLXdjcy10ZXN0MDAx&key=dGVzdC5mbHY=&fops=YXZ0aHVtYi9tcDQvc3VidGl0bGUvZG05a0xYZGpjeTEwWlhOME1EQXhPbnBwYlhVdWMzSjBDZz09fHNhdmVhcy9kbTlrTFhkamN5MTBaWE4wTURBeE9uUmxjM1JmWm1sc1pTNXRjRFFLQ2c9PQ==&force=1&separate=1"
-H "Authorization:AccessKey:EncodeSign"
--url "http://mgrDomain/fops"
このドキュメントの内容は役に立ちましたか?
はい
いいえ