ApsaraVideo VODを使用すると、ビデオに透かしを追加できます。 ApsaraVideo VODコンソールで、またはApsaraVideo VOD API操作を呼び出すことで、透かしを管理できます。 トランスコード中にビデオに透かしを追加することもできます。 このトピックでは、透かし、透かしの種類、位置パラメーター、および使用シナリオの使用と管理について説明します。
概要
ビデオのトランスコーディング中に、画像、ビデオ、またはテキストを透かしとしてビデオストリームに追加し、透かしを含む新しいビデオファイルを生成できます。 エンタープライズロゴ、ブランドロゴ、テレビ局ロゴ、ユーザーID、ニックネームなどの署名情報を透かしとして追加して、ビデオの著作権を宣言したり、ブランドを宣伝したりできます。
透かしタイプ
ApsaraVideo VODは、静的画像透かし、動的画像透かし、およびテキスト透かしをサポートしています。
静止画像透かし
PNG形式の画像のみが静止画像透かしとして使用できます。 静止画像の透かしは、ビデオ全体の特定の位置に表示することも、指定した開始時間と終了時間に基づいて特定の期間内に表示することもできます。
静止画像透かしを使用して、ビデオの著作権を宣言したり、ブランドを宣伝したりできます。
ダイナミック画像透かし
ダイナミック画像透かしは、GIFおよびAPNG形式の画像とMOV形式のビデオをサポートします。動的画像透かしは、ビデオ全体の特定の位置に表示することも、指定した開始時間と終了時間に基づいて特定の期間内に表示することもできます。
動的画像透かしを使用して、ビデオの著作権を宣言したり、ブランドを宣伝したりできます。
説明ApsaraVideo VODコンソールで透かしを追加する場合、GIF画像のみを動的画像透かしとして追加できます。 API操作を呼び出して透かしを追加すると、GIF画像、APNG画像、MOVビデオを透かしとして追加できます。
ファイルが動的画像透かしとして使用される場合、ファイル名拡張子は小文字でなければなりません。 静止画像透かしとして使用されるファイルのファイル名拡張子は限定されない。
透かしとして使用されるファイルと、透かしが追加されるビデオは、同じオリジンに保存する必要があります。 たとえば、中国 (上海) リージョンのオリジンに保存されているビデオは、中国 (上海) リージョンの同じオリジンに保存されている透かしのみを使用できます。 ビデオは、別のリージョンまたはオリジンに保存されている透かしを使用できません。 ストレージオリジンの詳細については、「VODリソースの管理」をご参照ください。
テキスト透かし
1つ以上のテキストを透かしとしてビデオに追加できます。 フォントの種類、サイズ、色、透明度、枠線などのフォント構成を設定したり、異なるビデオに異なるテキストコンテンツを追加したりできます。 動的テキスト透かしについては、「SubmitTranscodeJobs」をご参照ください。
テキスト透かしを使用して、ビデオの著作権を宣言したり、ブランドを宣伝したりできます。 短いビデオのテキスト透かしを動的に置き換えることもできます。
説明MOVおよびAPNG形式の動的画像透かしとテキスト透かしは、API操作を呼び出すことによってのみ管理できます。 詳細については、「AddWatermark」をご参照ください。
使用上の注意
次の操作を実行して、ビデオに透かしを追加します。
透かしを追加および管理します。 詳細については、このトピックの「透かし管理」セクションを参照してください。
デフォルトの透かしを設定します。 詳細については、ApsaraVideo VODコンソールで透かしを追加する場合は透かしの管理を、API操作を呼び出して透かしを追加する場合はSetDefaultWatermarkをご参照ください。
コード変換テンプレートを作成し、透かしパラメーターを設定します。 詳細については、ApsaraVideo VODコンソールで透かしを追加する場合はトランスコード設定の管理を、API操作を呼び出して透かしを追加する場合はAddTranscodeTempleGroupをご参照ください。
ステップ3で作成したテンプレートを使用してビデオをアップロードします。 詳細については、「メディアアセットのアップロード」または「概要」をご参照ください。
コード変換テンプレートを複数の透かしに関連付ける必要があります。 詳細については、「AddTranscodeTemplateGroup」をご参照ください。
コード変換テンプレートで定義が [オリジナル] に設定されている場合、透かしは指定できません。 このテンプレートを使用してトランスコードされたビデオには、透かしを追加できません。
透かし管理
ApsaraVideo VODコンソールで、またはAPI操作を呼び出して透かしを管理できます。
ApsaraVideo VODコンソールでの透かしの管理
ApsaraVideo VODコンソールでの透かし管理に関連する操作については、「透かしの管理」をご参照ください。
説明ApsaraVideo VODコンソールでは、MOVおよびAPNG形式の動的画像透かしをアップロードすることはできません。 これは、AddWatermark操作を呼び出すことによってのみ実行できます。
API操作を使用した透かしの管理
透かしテンプレートを追加するには、次の操作を実行します。
CreateUploadAttachedMedia操作を呼び出して、透かしが追加されるディレクトリと一時的なアクセス許可を取得します。
Object Storage Service (OSS) を使用して透かしファイルをアップロードします。 詳細については、「OSSオブジェクトのアップロード」をご参照ください。
AddWatermark操作を呼び出して、透かし情報を追加します。
透かし位置パラメータ
透かし位置パラメータは、出力ビデオの画像上の透かしの位置およびサイズを設定するために使用される。 透かし位置パラメーターは、ApsaraVideo VODコンソールで設定するか、AddWatermark操作を呼び出して設定できます。
次の部分では、透かしの位置とサイズを指定するために使用されるパラメーターについて説明します。 詳細については、「メディア処理のパラメーター」トピックの「WatermarkConfig: specifies the watermark configuration」をご参照ください。
画像透かし
ReferPos、Dx、Dy、Width、Heightパラメーターを使用して、出力ビデオの画像上の画像透かしの位置とサイズを指定できます。
API パラメーター
コンソールパラメーター
説明
ReferPos
[場所] >
出力ビデオ画像に対するウォーターマークのおおよその位置。
左上: 左上隅。
左下: 左下隅。
右上: 右上隅。
右下: 右下隅。
Dx
水平シフト
出力ビデオ画像上の透かしの水平シフト。 このパラメーターは、次のいずれかの型の値に設定できます。
正の整数: 単位: ピクセル。 有効な値: [8,4096] 。
画像比率: ビデオ画像に対する比率。 有効な値: (0,1) 。
Dy
垂直シフト
出力ビデオ画像上の透かしの垂直方向のシフト。 このパラメーターは、次のいずれかの型の値に設定できます。
正の整数: 単位: ピクセル。 有効な値: [8,4096] 。
画像比率: ビデオ画像に対する比率。 有効な値: (0,1) 。
幅
幅
出力ビデオ画像の透かしの幅。 このパラメーターは、次のいずれかの型の値に設定できます。
正の整数: 単位: ピクセル。 有効な値: [8,4096] 。
画像比率: ビデオ画像に対する比率。 有効な値: (0,1) 。
Height
Height
出力ビデオ画像の透かしの高さ。 このパラメーターは、次のいずれかの型の値に設定できます。
正の整数: 単位: ピクセル。 有効な値: [8,4096] 。
画像比率: ビデオ画像に対する比率。 有効な値: (0,1) 。
タイムライン
タイムライン
透かしタイムラインは、ビデオ画像上の画像透かしの開始時間および継続時間を制御するために使用される。 複数の透かし設定を使用して、ビデオ画像に対する画像透かしの動的表示効果を制御できます。 詳細については、「メディア処理のパラメーター」トピックの「タイムライン: 透かしタイムラインの設定を指定する」をご参照ください。
注意このパラメーターは、テキスト透かしではサポートされません。
回路図
出力ビデオの画像に透かしを配置するには、DxパラメーターとDyパラメーターを0.5に設定します。 0.5の値は、ウォーターマークの水平または垂直シフトがビデオの幅または高さの50% であることを示します。
テキスト透かし
TopパラメーターとLeftパラメーターを設定するだけで、出力ビデオの画像上のテキスト透かしの位置を指定できます。 2つのパラメータは、出力ビデオ画像の左上隅に対する透かしのオフセットを示す。 2つのパラメータは、ピクセルの数を示す正の整数にのみ設定できます。 ビデオの幅または高さに対する比率を示す小数に設定することはできません。
API パラメーター
コンソールパラメーター
説明
上
垂直シフト
ウォーターマークの左上隅と出力ビデオ画像の上辺の間の距離。 単位: ピクセル。 有効な値: [8,4096] 。
左揃え
水平シフト
ウォーターマークの左上隅と出力ビデオ画像の左側との間の距離。 単位: ピクセル。 有効な値: [8,4096] 。
回路図
計算方法
イメージ透かしのDx、Dy、Width、およびHeightパラメーターは、指定した正の整数またはイメージ比率に基づいて計算できます。 テキスト透かしのTopパラメータとLeftパラメータは、正の整数のみに基づいて計算できます。 以下では、計算方法について説明します。
正の整数: 単位: ピクセル。 有効な値: [8,4096] 。
注意画像またはテキスト透かしのパラメータ設定が出力ビデオ画像のサイズよりも大きい場合、透かしは部分的に表示されてもよく、または全く表示されなくてもよい。
たとえば、出力ビデオの解像度が640 × 360で、ReferPosパラメーターが左上に、Dxパラメーターが4000に、Dyパラメーターが4000に設定されている場合、ウォーターマークは表示されません。出力ビデオ画像。
画像の割合: 画像の透かしの幅と高さと出力ビデオの透かしの幅と高さの割合。 有効値: (0, 1) 。 値は小数点以下4桁まで正確です。
注意出力ビデオの解像度が頻繁に変化する場合は、透かしの位置とサイズのパラメーターを画像比率の値に設定することを推奨します。
サンプル値: 0.9999。 例: 幅 /ビデオ幅=0.1。 高さ /ビデオ高さ=0.06。 Dx /ビデオ幅=0.02。 Dy /ビデオ幅=0.03。
デフォルト値
透かしの幅と高さのパラメーターを設定しない場合、透かしの幅は次の式に基づいて計算されます。透かしの幅=出力ビデオの幅 × 0.12。 透かしの高さは、ソース透かし画像のアスペクト比に基づいて比例的にスケーリングされる。
ウォーターマークにWidthパラメーターとHeightパラメーターのいずれかを指定した場合、もう一方のパラメーターの値は、指定したパラメーターとソースウォーターマーク画像のアスペクト比に基づいて計算されます。 たとえば、幅パラメーターが44に設定され、ソース画像のアスペクト比が2:1の場合、高さパラメーターの値は22になります。
WidthパラメーターとHeightパラメーターの両方を設定した場合、出力される透かしの幅と高さは指定された値に設定されます。
DxおよびDyパラメータのデフォルト値は両方とも0である。
一般的なシナリオ
動的テキスト透かしの置き換え
ユーザが短いビデオをアップロードするとき、ユーザは、典型的には製品ロゴである画像透かし、およびビデオ作成者のIDまたはニックネームなどのテキスト透かしを彼らの短いビデオに追加して、ビデオ著作権を宣言することができる。
ユーザーによってIDとニックネームが異なります。 したがって、トランスコーディング中に異なるビデオに異なるテキストコンテンツを追加する必要があります。 これは、複数の透かしに関連付けられたトランスコードテンプレートを使用してトランスコードジョブを送信することで実装できます。 詳細については、「SubmitTranscodeJobs」をご参照ください。
効果
画像透かしとテキスト透かしは、異なるユーザーによってアップロードされた動画の次の画像に追加されます。 画像透かしは両方の画像で同じですが、テキスト透かしは異なり、ユーザーのIDを示します。
ダイナミック画像透かしの置き換え
ビデオセキュリティを強化するために、ユーザが短いビデオをアップロードするとき、ユーザは、典型的にはユーザのロゴである動的画像透かしを彼らの短いビデオに追加して、ビデオ著作権を宣言することができる。
異なるユーザーによってアップロードされたビデオの場合、ビデオをトランスコードするときに異なる画像を透かしとして使用する必要があります。 ApsaraVideo VODを使用すると、CreateUploadAttachedMedia操作を呼び出して、透かしが追加されたディレクトリと一時的な権限を取得できます。 さまざまなユーザーがアップロードした動画にさまざまな透かしを追加するには、OSSを使用して指定された透かしファイルをアップロードして画像透かしファイルのOSS URLを取得し、SubmitTranscodeJobs操作を呼び出してトランスコードを開始し、画像透かしファイルのOSS URLを動的に置き換えます。 詳細については、「CreateUploadAttachedMedia」、「OSSオブジェクトのアップロード」、および「SubmitTranscodeJobs」をご参照ください。
実装
Java: SubmitTranscodeJobs
Python: SubmitTranscodeJobs
PHP: SubmitTranscodeJobs
. NET: SubmitTranscodeJobs
Node.js: SubmitTranscodeJobs