Add Watermarks

最終更新日:2025-05-29 14:41:09

ウォーターマークは動画コンテンツの著作権保護に効果的な手段です。CDNetworksでは可視ウォーターマークの追加をサポートし、不正利用防止に貢献します。当プラットフォームでは4種類のウォーターマーク形式をサポートしています:

  1. 画像ウォーターマーク:解像度変化に比例して自動スケーリングする静止画像を挿入
  2. 動画ウォーターマーク:アニメーションロゴや広告挿入に最適な動画クリップをオーバーレイ
  3. テキストウォーターマーク:著作権表示やテキストキャプションを追加
  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.jpgdGVzdDoxLmpwZw==

複数指定:カンマ区切りでエンコード
例: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以下:アスペクト比に基づき自動調整

wmWidthwmHeight両方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 - 標準(デフォルト)

推奨:小サイズ/複雑背景で視認性向上

ウォーターマーク位置パラメータ(wmGravity)

パラメータ 説明
TOP_LEFT 左上
TOP_CENTER 上部中央
TOP_RIGHT 右上
CENTER_LEFT 左中央
CENTER 中央
CENTER_RIGHT 右中央
BOTTOM_LEFT 左下
BOTTOM_CENTER 下部中央
BOTTOM_RIGHT 右下

例1:動的画像ウォーターマーク

test.mp4に以下の動作の画像ウォーターマークを追加:

  • ウォーターマーク画像:vod-wcs-test001バケットのwatermark.jpg
  • 初期位置:左上
  • 5秒後:右上に20px左オフセットで移動
  • 更に5秒後:左上に戻る
  • サイズ:動画寸法の20%

擬似コード:

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"

例2:動画ウォーターマーク

test.mp4に動画ウォーターマーク追加:

  • ウォーターマーク動画:vod-wcs-test001バケットのwatermark.mp4
  • 位置:左上
  • サイズ:メイン動画寸法の20%

擬似コード:

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"

例3:テキストウォーターマーク

test.mp4にテキストウォーターマーク追加:

  • 表示テキスト:“CDNetworks”
  • フォント:“Arial Unicode MS”
  • 位置:左上

擬似コード:

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 シン
文泉驛 文泉驛等幅正黑
文泉驛点陣正黑
文泉驛正黑