ビデオウォーターマークは、会社のロゴ、テレビ局のアイコン、ユーザーのニックネーム、ユーザー ID などの識別情報をビデオに追加する機能です。ウォーターマークは、ブランドの強調、著作権の保護、プロダクト認知度の向上に役立ちます。ApsaraVideo VOD は、静止画、アニメーション画像、テキストの 3 種類のウォーターマークをサポートしています。ニーズに最適なタイプを選択できます。
仕組み
ApsaraVideo VOD のウォーターマーク機能は、トランスコーディングに基づいています。トランスコーディングプロセス中に、画像やテキストなどの情報がビデオストリームに埋め込まれます。このプロセスにより、ウォーターマークを含む新しいビデオファイルが作成されます。
利用シーン
短編動画
短編動画アプリケーションでは、ダウンロードおよび共有されたビデオには、著作権を保護するために、プロダクトロゴなどの画像ウォーターマークと、ユーザー ID などのテキストウォーターマークが通常付加されます。
オーディオ/ビデオウェブサイト
オーディオ/ビデオウェブサイトでは、著作権の所有権を示すために、ブランドロゴをビデオに追加することがよくあります。バラエティ番組では、エンゲージメントを高めたり、広告を表示したりするためにスタンプが追加されることもあります。
ウォーターマークのタイプ
タイプ | サポートされているフォーマット | 手順 |
画像 |
|
|
テキスト | - | テキストのフォント、フォントサイズ、色、不透明度、および輪郭のエフェクトを設定します。 |
課金
ウォーターマークはトランスコーディングに基づいており、トランスコーディングプロセスには料金が発生します。課金の詳細については、「メディアトランスコーディングの課金」をご参照ください。
使用方法
手順 1：ウォーターマークテンプレートの作成
ウォーターマークの適用を簡素化するため、ApsaraVideo VOD はテンプレートを使用して、ウォーターマークの位置、サイズ、フォント、色などの複雑なパラメーターを保存します。各テンプレートには一意の ID があります。
ウォーターマークの位置とサイズのパラメーターの詳細
画像ウォーターマーク
ReferPos、Dx、Dy、Width、および Height パラメーターを使用して、出力ビデオ内の画像の表示位置とサイズを制御します。
API パラメーター
コンソールパラメーター
説明
ReferPos
位置
出力ビデオに対するウォーターマークのおおよその位置。
左上隅：TopLeft
左下隅：BottomLeft
右上隅：TopRight
右下隅：BottomRight
Dx
水平オフセット
出力ビデオ内のウォーターマークの水平オフセット。有効な値：
正の整数。単位はピクセルです。値は 8 から 4096 までの整数である必要があります。
ビデオのパーセンテージ。単位は % です。値は 0 を除く 0 から 1 までの数値である必要があります。
Dy
垂直オフセット
出力ビデオ内のウォーターマークの垂直オフセット。有効な値：
正の整数。単位はピクセルです。値は 8 から 4096 までの整数である必要があります。
ビデオのパーセンテージ。単位は % です。値は 0 を除く 0 から 1 までの数値である必要があります。
Width
サイズ (幅)
出力ビデオ内のウォーターマークの幅。有効な値：
正の整数。単位はピクセルです。値は 8 から 4096 までの整数である必要があります。
ビデオのパーセンテージ。単位は % です。値は 0 を除く 0 から 1 までの数値である必要があります。
Height
サイズ (高さ)
出力ビデオ内のウォーターマークの高さ。有効な値：
正の整数。単位はピクセルです。値は 8 から 4096 までの整数である必要があります。
ビデオのパーセンテージ。単位は % です。値は 0 を除く 0 から 1 までの数値である必要があります。
Timeline
タイムライン
ウォーターマークのタイムライン。このパラメーターは、ビデオ内の画像ウォーターマークの開始時刻と表示時間を指定します。複数のウォーターマークを設定して、画像ウォーターマークの動的な表示エフェクトを作成できます。詳細については、「ウォーターマークのタイムライン」をご参照ください。
重要このパラメーターはテキストウォーターマークではサポートされていません。
図
ウォーターマークを中央に配置するには、Dx および Dy パラメーターを 0.5 に設定します。これにより、ウォーターマークのオフセットが出力ビデオの幅と高さの 50% に設定されます。
テキストウォーターマーク
テキストウォーターマークは、出力ビデオの左上隅からのみオフセットできます。オフセットには Top および Left パラメーターが使用されます。ピクセル値のみがサポートされ、パーセント値はサポートされていません。
API パラメーター
コンソールパラメーター
説明
Top
垂直オフセット
テキストウォーターマークと出力ビデオの上部との距離。単位はピクセルです。値は 8 から 4096 までの整数である必要があります。
Left
水平オフセット
テキストウォーターマークと出力ビデオの左側との距離。単位はピクセルです。値は 8 から 4096 までの整数である必要があります。
図
計算方法
画像ウォーターマークの Dx、Dy、Width、および Height パラメーターは、ピクセル値とパーセント値をサポートします。テキストウォーターマークの Top および Left パラメーターは、ピクセル値のみをサポートします。詳細は次のとおりです：
ピクセル値：8 から 4096 までの整数。単位はピクセルです。
重要指定した値が出力ビデオのサイズを超えると、ウォーターマークが部分的に表示されるか、まったく表示されない場合があります。
たとえば、出力ビデオが 640 × 360 ピクセルで、参照位置が TopLeft で、Dx と Dy を 4000 に設定した場合、ウォーターマークは出力ビデオに表示されません。これはテキストウォーターマークにも適用されます。
パーセント値：値は、出力ビデオの幅と高さのパーセンテージです。値は 0 より大きく 1 以下の数値で、小数点以下 4 桁まで指定できます。
重要出力ビデオのアスペクト比が可変で制御できない場合は、ウォーターマークの位置とサイズのパラメーターをパーセンテージで設定します。
たとえば、0.9999。計算例：幅/ビデオ幅 = 0.1。高さ/ビデオ高さ = 0.06。Dx/ビデオ幅 = 0.02。Dy/ビデオ高さ = 0.03。
デフォルト値
ウォーターマークの幅と高さを設定しない場合：ウォーターマークの幅は出力ビデオの幅の 12% に設定されます。ウォーターマークの高さは、ソースウォーターマーク画像のアスペクト比を維持するようにスケーリングされます。
幅または高さのみを設定した場合：指定したディメンションが使用されます。もう一方のディメンションは、ソースウォーターマーク画像のアスペクト比を維持するようにスケーリングされます。たとえば、Width を 44 に設定し、ソース画像のアスペクト比が 2:1 の場合、高さは 22 に設定されます。
幅と高さの両方を設定した場合：指定したディメンションがウォーターマークに使用されます。
Dx と Dy を設定しない場合：デフォルト値 0 が使用されます。
手順 2：トランスコーディングテンプレートグループを作成し、ウォーターマークテンプレートを関連付ける
ビデオのウォーターマークはトランスコーディングに基づいています。トランスコーディングジョブは、トランスコーディングテンプレートグループに基づいて開始されます。1 つのトランスコーディングテンプレートに複数のウォーターマークテンプレートを関連付けることができます。
手順 3 (オプション)：ワークフローを作成し、トランスコーディングテンプレートグループを関連付ける
ワークフローを使用すると、トランスコーディング、コンテンツ審査、スナップショットなどのメディア処理タスクを特定の順序で編成できます。メディアファイルをアップロードするか、ワークフローをトリガーすると、メディアファイルは事前に定義されたタスクフローに基づいて自動的に処理されます。ワークフローは ApsaraVideo VOD コンソールでのみ作成できます。詳細については、「ワークフロー」をご参照ください。
手順 4 (オプション)：トランスコーディングイベント通知の設定
トランスコーディングジョブを開始する前に、ApsaraVideo VOD のイベント通知を設定できます。これにより、トランスコーディングジョブが完了した後に、そのステータスと結果を含むコールバックメッセージを受信できます。イベント通知の設定方法の詳細については、「イベント通知」をご参照ください。
トランスコーディングに関連するイベント通知タイプは次のとおりです：
手順 5：ウォーターマーク付きトランスコーディングジョブの開始
ApsaraVideo VOD では、メディアのアップロード時またはメディアの処理時にトランスコーディングをトリガーできます。トランスコーディングテンプレートグループまたはメディアトランスコーディングノードを含むワークフローに基づいてトランスコーディングを開始できます。
手順 6：結果の取得
非同期の結果通知
イベント通知を設定している場合、単一トランスコーディングジョブ完了 または 全トランスコーディングジョブ完了 のコールバックメッセージを受信して、ウォーターマーク付きトランスコーディングジョブに関する情報を取得できます。
同期クエリ
適用例
このセクションでは、複数のウォーターマークの設定や API を使用した動的なウォーターマークコンテンツの置換など、一般的なウォーターマークシナリオで ApsaraVideo VOD を使用する方法の例を示します。
短編動画の著作権表示：動的テキストウォーターマークの置換
シナリオの説明
短編動画アプリケーションでは、ユーザーが短編動画プラットフォームにアップロードしたビデオが他のユーザーによってダウンロードまたは共有される場合、ビデオには通常、短編動画プラットフォームのロゴと、元の作成者の ID またはニックネームが付加されます。
期待される結果
画像と、各ユーザーに固有のテキストコンテンツを組み合わせたウォーターマーク。
手順
2 つのウォーターマークテンプレートを作成します：プラットフォームロゴ用の画像ウォーターマークテンプレートと、作成者の ID またはニックネーム用のテキストウォーターマークテンプレート。詳細については、「手順 1：ウォーターマークテンプレートの作成」をご参照ください。
トランスコーディングテンプレートグループを作成し、前の手順で作成した 2 つのウォーターマークテンプレートを関連付けます。詳細については、「手順 2：トランスコーディングテンプレートグループを作成し、ウォーターマークテンプレートを関連付ける」をご参照ください。
SubmitTranscodeJobs 操作を呼び出してトランスコーディングジョブを開始します。ジョブを開始する際に、
OverrideParamsパラメーターをWatermarkIdおよびContentパラメーターとともに使用して、指定したウォーターマークテンプレートのテキストコンテンツを上書きします。OverrideParamsパラメーターの例：{"Watermarks":[{"WatermarkId":"画像ウォーターマークテンプレートの ID"},{"WatermarkId":"テキストウォーターマークテンプレートの ID","Content":"元のウォーターマークコンテンツを置換するテキスト"}]}必要に応じて、トランスコーディングジョブのトリガーロジックを設計します。たとえば、ユーザーがビデオをアップロードしたときにトランスコーディングをトリガーできます。トランスコーディング中に、元のビデオ作成者の ID またはニックネームが自動的に取得され、テキストウォーターマークのコンテンツを置換するために使用されます。
ビデオウェブサイトのブランドプロモーション：動的画像ウォーターマークの置換
シナリオの説明
あるビデオウェブサイトが映画やテレビシリーズの著作権を取得し、それを他の複数のビデオウェブサイトにサブライセンスします。各ビデオウェブサイトで配信されるビデオには、そのウェブサイトのブランドロゴを表示する必要があります。
期待される結果
画像ウォーターマークはビデオウェブサイトごとに異なります。
手順
GetAuxiliaryUploadAddressAndAuth 操作を呼び出して、ウォーターマーク画像 (各ビデオウェブサイトのブランドロゴ) を ApsaraVideo VOD にアップロードします。ファイルのアップロード方法の詳細については、「ApsaraVideo VOD API を使用したメディアファイルのアップロード」をご参照ください。
画像ウォーターマークテンプレートを作成し、ウォーターマーク画像をブランドロゴに設定します。詳細については、「手順 1：ウォーターマークテンプレートの作成」をご参照ください。
トランスコーディングテンプレートグループを作成し、前の手順で作成した画像ウォーターマークテンプレートを関連付けます。詳細については、「手順 2：トランスコーディングテンプレートグループを作成し、ウォーターマークテンプレートを関連付ける」をご参照ください。
SubmitTranscodeJobs 操作を呼び出してトランスコーディングジョブを開始します。ジョブを開始する際に、
OverrideParamsパラメーターをWatermarkIdおよびFileUrlパラメーターとともに使用して、指定したウォーターマークテンプレートのウォーターマーク画像を上書きします。OverrideParamsパラメーターの例：{"Watermarks":{"WatermarkId":"画像ウォーターマークテンプレートの ID","FileUrl":"元のウォーターマーク画像を置換する画像の URL"}}必要に応じて、トランスコーディングジョブのトリガーロジックを設計します。たとえば、ビデオがアップロードされたときにトランスコーディングをトリガーできます。
よくある質問
ApsaraVideo VOD コンソールで「利用できない画像 URL」エラーが表示され、ウォーターマーク画像を追加できない
ApsaraVideo VOD で高速化ドメイン名を設定している場合、そのドメイン名に HTTPS 証明書を設定する必要があります。詳細については、「HTTPS セキュアアクセラレーション」をご参照ください。
関連ドキュメント
侵害を抑止するために、再生中に視聴者のニックネームや ID をリアルタイムで表示できます。この目的には、ApsaraVideo Player SDK のマーキー機能を使用できます。詳細については、「公式コンポーネント」をご参照ください。