最終更新日:2025-05-29 14:41:09
ウォーターマークは動画コンテンツの著作権保護に効果的な手段です。CDNetworksでは可視ウォーターマークの追加をサポートし、不正利用防止に貢献します。当プラットフォームでは4種類のウォーターマーク形式をサポートしています:
CDNetworksはMP4、FLV、M3U8、TS、MKV、MOV、WMV、AVI、VP8、VP9、RealVideo、Windows Media Video、H.265、H.264、H.263、MPEGなど、多様な動画形式とコーデックをサポートします。
リクエストボディ内でfopsコマンドを以下の形式で構成:
<op>/<Format>
/wmImage2/<value>
/wmGravity/<value>
/wmauto/<value>
/wmWidth/<value>
/wmHeight/<value>
/wmDissolve/<value>
/wmdx/<value>
/wmdy/<value>
/wmInterval/<value>
/multiConvertTime/<value>
/wmText/<value>
/wmFont/<value>
/wmFontColor/<value>
/wmFontSize/<value>
/wmFontDissolve/<value>
/wmFontBorderWidth/<value>
/wmFontBorderColor/<value>
/wmTextGravity/<value>
/wmtextdx/<value>
/wmtextdy/<value>
/wmTextInterval/<value>
/wmFontBold/<value>
|saveas/<Urlsafe_Base64_Encode(bucket:filekey)>
| パラメータ | 必須 | 説明 |
|---|---|---|
op |
はい | 操作タイプ。ウォーターマーク処理にはavthumbを指定 |
format |
はい | 出力形式(flv、mp4、m3u8等) |
saveas |
いいえ | URLセーフBase64エンコードされた出力先:Urlsafe_Base64_Encode(bucket:保存ファイル名) |
| パラメータ | 必須 | 説明 |
|---|---|---|
wmImage2 |
いいえ | ウォーターマーク用画像/動画のパス 形式:URLセーフBase64エンコード <bucket>:<path>例: test:1.jpg → dGVzdDoxLmpwZw==複数指定:カンマ区切りでエンコード 例: Url-Safe-Base64-Encode(test:1.jpg),Url-Safe-Base64-Encode(test:2.jpg)ヒント:動画ウォーターマークはメイン動画との同期維持のため短いクリップが最適 |
wmGravity |
いいえ | 配置位置(wmGravityパラメータ表参照)推奨:ブランディングには視聴体験を妨げにくい BOTTOM_RIGHTが一般的 |
wmauto |
いいえ | アダプティブスケーリング: • 1 - 解像度変化に比例スケーリング• 0(デフォルト) - 原寸維持例:1200×600動画に40×40ウォーターマークの場合、300×200に変換時 wmauto/1で10×10に縮小推奨:多デバイス視聴環境では wmauto/1を有効化 |
wmWidth |
いいえ | ウォーターマーク幅(ピクセル/%指定): • 絶対値: wmWidth/40(40px)• 相対値: wmWidth/50%(動画幅の50%)• 0以下:アスペクト比に基づき自動調整 推奨:固定ピクセル値より%指定で解像度対応を最適化 |
wmHeight |
いいえ | ウォーターマーク高さ(ピクセル/%指定): • 絶対値: wmHeight/60(60px)• 相対値: wmHeight/20%(動画高さの20%)• 0以下:アスペクト比に基づき自動調整 wmWidthとwmHeight両方0以下で原寸使用推奨:ロゴには動画高さの10-15%が視認性と邪魔にならないバランス良好 |
wmDissolve |
いいえ | 透明度設定(1-100): • 100 - 完全不透明(デフォルト)• 1 - ほぼ透明• 範囲外値は自動調整 推奨:70-85がコンテンツ視認性と邪魔になさのバランス良好 |
wmdx |
いいえ | wmGravity位置からの水平オフセット:• 正値:右移動 • 負値:左移動 wmGravityパラメータ数と一致必須推奨:端から10-20pxオフセットで画面切り落とし防止+美的配置 |
wmdy |
いいえ | wmGravity位置からの垂直オフセット:• 正値:上移動 • 負値:下移動 wmGravityパラメータ数と一致必須推奨:下部配置時は正値オフセットで下端接触防止 |
wmInterval |
いいえ | 位置変更間隔(秒指定) 推奨:不正録画防止には15-30秒間隔が効果的 |
multiConvertTime |
いいえ | 変更タイムスタンプ(カンマ区切り) 例: 5,10,20(5秒、10秒、20秒で変更)wmIntervalと併用不可推奨:シーン切り替えタイミングと同期させ自然な移動を実現 |
| パラメータ | 必須 | 説明 |
|---|---|---|
wmText |
いいえ | テキスト内容(URLセーフBase64エンコード) 複数テキスト:カンマ区切りでエンコード 例: Url-Safe-Base64-Encode(text1),Url-Safe-Base64-Encode(text2)重要:中国語簡体字はUTF-8エンコード必須 推奨:社名・URL・著作権表示など簡潔明瞭な表記が効果的 |
wmFont |
いいえ | フォント指定(URLセーフBase64エンコード) 許可文字:英数字・スペース・ハイフン 複数フォント:カンマ区切りでエンコード 形式: <Urlsafe_Base64_Encode(<Font1>,<Font2>…)>推奨:サンセリフフォントが視認性良好(サポートフォント表参照) |
wmFontColor |
いいえ | 文字色(RGB形式/URLセーフBase64エンコード) 形式: 0xrrggbb または &Hrrggbb(プレフィックス省略可)複数色指定:カンマ区切りでエンコード 形式: <Urlsafe_Base64_Encode(<色1>,<色2>…)>推奨:暗背景には白( 0xFFFFFF)・薄黄(0xFFFF00)+コントラスト枠追加 |
wmFontSize |
いいえ | 文字サイズ(ピクセル/%指定): • 絶対値:5-2160px • 相対値:動画高さに対する%(>0%-100%) • デフォルト:6% 推奨:動画高さの5-8%がコンテンツ邪魔せず視認性良好 |
wmFontDissolve |
いいえ | 文字透明度(1-100): • 100 - 完全不透明(デフォルト)• 1 - ほぼ透明• 範囲外値は自動調整 推奨:画像ウォーターマークと同原則(70-85推奨) |
wmFontBorderWidth |
いいえ | 文字枠線幅: • 0以下:枠線なし(デフォルト) • 正値:枠線厚さ(px) 推奨:1-2px枠追加で複雑背景上でも視認性向上 |
wmFontBorderColor |
いいえ | 文字枠線色(wmFontColorと同形式)デフォルト: 0x000000(黒)推奨:白文字+黒枠で多様な背景に対応可能 |
wmTextGravity |
いいえ | テキスト配置位置(wmGravityと同形式)動的テキストはカンマ区切り複数位置指定可能 推奨:重要部分を隠さない画面下部配置が効果的 |
wmtextdx |
いいえ | wmGravity位置からの水平オフセット(wmdxと同原則)推奨:端から10-20pxオフセットで切り落とし防止 |
wmtextdy |
いいえ | wmGravity位置からの垂直オフセット(wmdyと同原則)推奨:下部配置時は正値オフセットで下端接触防止 |
wmTextInterval |
いいえ | テキスト変更間隔(秒指定/1以上必須) 推奨:著作権表示の位置変更は20-30秒間隔で煩わしさ低減 |
wmFontBold |
いいえ | 太字設定: • 1 - 太字• 0 - 標準(デフォルト)推奨:小サイズ/複雑背景で視認性向上 |
| パラメータ | 説明 |
|---|---|
TOP_LEFT |
左上 |
TOP_CENTER |
上部中央 |
TOP_RIGHT |
右上 |
CENTER_LEFT |
左中央 |
CENTER |
中央 |
CENTER_RIGHT |
右中央 |
BOTTOM_LEFT |
左下 |
BOTTOM_CENTER |
下部中央 |
BOTTOM_RIGHT |
右下 |
test.mp4に以下の動作の画像ウォーターマークを追加:
vod-wcs-test001バケットのwatermark.jpg擬似コード:
curl -v -X POST
–d "bucket=Urlsafe_Base64_Encode(vod-wcs-test001)&key=Urlsafe_Base64_Encode(test.mp4)&fops=Urlsafe_Base64_Encode(avthumb/mp4/wmImage2/Urlsafe_Base64_Encode(vod-wcs-test001:watermark.jpg) /wmGravity/TOP_LEFT,TOP_RIGHT/wmInterval/5/wmdx/0,-20/wmdy/0,0/wmWidth/20%/wmHeight/20%|saveas/Urlsafe_Base64_Encode(vod-wcs-test001:test_watermark.mp4))&force=1&separate=1"
–H "Authorization:AccessKey:EncodeSign"
--url "http://mgrDomain/fops"
実リクエスト:
curl -v -X POST
-d "bucket=dm9kLXdjcy10ZXN0MDAx&key=dGVzdC5tcDQ=&fops=YXZ0aHVtYi9tcDQvd21JbWFnZTIvZG05a0xYZGpjeTEwWlhOME1EQXhPbmRoZEdWeWJXRnlheTVxY0djPS93bUdyYXZpdHkvVE9QX0xFRlQsVE9QX1JJR0hUL3dtSW50ZXJ2YWwvNS93bWR4LzAsLTIwL3dtZHkvMCwwL3dtV2lkdGgvMjAlL3dtSGVpZ2h0LzIwJXxzYXZlYXMvZG05a0xYZGpjeTEwWlhOME1EQXhPblJsYzNSZmQyRjBaWEp0WVhKckxtMXdOQT09&force=1&separate=1"
-H "Authorization:AccessKey:EncodeSign"
--url "http://mgrDomain/fops"
test.mp4に動画ウォーターマーク追加:
vod-wcs-test001バケットのwatermark.mp4擬似コード:
curl -v -X POST
–d "bucket=Urlsafe_Base64_Encode(vod-wcs-test001)&key=Urlsafe_Base64_Encode(test.mp4)&fops=Urlsafe_Base64_Encode(avthumb/mp4/wmImage2/Urlsafe_Base64_Encode(vod-wcs-test001:watermark.mp4)/wmGravity/TOP_LEFT/wmWidth/20%/wmHeight/20%|saveas/Urlsafe_Base64_Encode(vod-wcs-test001:test_video.mp4))&force=1&separate=1"
–H "Authorization:AccessKey:EncodeSign"
--url "http://mgrDomain/fops"
実リクエスト:
curl -v -X POST
-d "bucket=dm9kLXdjcy10ZXN0MDAx&key=dGVzdC5tcDQ=&fops=YXZ0aHVtYi9tcDQvd21JbWFnZTIvZG05a0xYZGpjeTEwWlhOME1EQXhPbmRoZEdWeWJXRnlheTV0Y0RRPS93bUdyYXZpdHkvVE9QX0xFRlQvd21XaWR0aC8yMCUvd21IZWlnaHQvMjAlfHNhdmVhcy9kbTlrTFhkamN5MTBaWE4wTURBeE9uUmxjM1JmZG1sa1pXOHViWEEw&force=1&separate=1"
-H "Authorization:AccessKey:EncodeSign"
--url "http://mgrDomain/fops"
test.mp4にテキストウォーターマーク追加:
擬似コード:
curl -v -X POST
–d "bucket=Urlsafe_Base64_Encode(vod-wcs-test001)&key=Urlsafe_Base64_Encode(test.mp4)&fops=Urlsafe_Base64_Encode(avthumb/mp4/wmText/Urlsafe_Base64_Encode(CDNetworks)/wmFont/Urlsafe_Base64_Encode(Arial Unicode MS)/wmTextGravity/TOP_LEFT|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=dGVzdC5tcDQ=&fops=YXZ0aHVtYi9tcDQvd21UZXh0L0ppTjROMFkxTVRzbUkzZzFRa0pHT3lZamVEYzVSREU3SmlONE5qSTRNRHNnSmlONE56QkNPVHNtSTNnMk5FRkVPeVlqZURVeVFUQTdKaU40T1RBeFJqcz0vd21Gb250L1FYSnBZV3dnVlc1cFkyOWtaU0JOVXc9PS93bVRleHRHcmF2aXR5L1RPUF9MRUZUfHNhdmVhcy9kbTlrTFhkamN5MTBaWE4wTURBeE9uUmxjM1JmWm1sc1pTNXRjRFE9&force=1&separate=1"
-H "Authorization:AccessKey:EncodeSign"
--url "http://mgrDomain/fops"
| 字体系列 | フォントバリエーション |
|---|---|
| Noto Sans CJK SC | Noto Sans CJK SC レギュラー Noto Sans CJK SC ブラック Noto Sans CJK SC ボールド Noto Sans CJK SC デミライト Noto Sans CJK SC ライト Noto Sans CJK SC ミディアム Noto Sans CJK SC シン |
| Noto Sans Mono CJK SC | Noto Sans Mono CJK SC レギュラー Noto Sans Mono CJK SC ボールド |
| Noto Serif CJK SC | Noto Serif CJK SC レギュラー Noto Serif CJK SC ブラック Noto Serif CJK SC エクストラライト Noto Serif CJK SC ライト Noto Serif CJK SC ミディアム Noto Serif CJK SC セミボールド |
| Roboto | Roboto レギュラー Roboto コンデンスト Roboto コンデンストライト Roboto ブラック Roboto ライト Roboto ミディアム Roboto シン |
| 文泉驛 | 文泉驛等幅正黑 文泉驛点陣正黑 文泉驛正黑 |