Dynamic Media のビデオ

ここでは、Dynamic Media でのビデオの操作について説明します。

クイックスタート：ビデオ

次のワークフローの手順説明は、Dynamic Media でアダプティブビデオセットをすぐに使い始めることを目的としたものです。各手順に続いて、詳しい説明のあるトピックの見出しへのリンクが記載されています。

1. 次の手順を実行して、Dynamic Media ビデオをアップロード​します。

   • 独自のビデオエンコーディングプロファイルを作成します。または、Dynamic Media に付属している事前定義済みの​アダプティブビデオエンコーディング（AVE）プロファイルを使用してもかまいません。

     • ビデオエンコーディングプロファイルを作成します。
     • 詳しくは、ビデオエンコーディングのベストプラクティスを参照してください。

   • ビデオ処理プロファイルを、プライマリソースビデオのアップロード先となる 1 つ以上のフォルダーに関連付けます。

     • ビデオプロファイルをフォルダーに適用します。
     • 詳しくは、処理プロファイルを使用するためのデジタルアセットの整理におけるベストプラクティスを参照してください。
     • 詳しくは、デジタルアセットの整理を参照してください。

   • フォルダーにプライマリソースビデオをアップロードします。フォルダーにビデオを追加すると、そのフォルダーに割り当てたビデオ処理プロファイルに従ってビデオがエンコードされます。

     • Dynamic Media では、最大長 30 分、最小解像度が 25 x 25 を超える短い形式のビデオが主にサポートされています。
     • 15 GB までのビデオファイルをアップロードできます。
     • ビデオをアップロードします。
     • 詳しくは、サポートされる入力ファイル形式を参照してください。

   • アセットビューまたはワークフロービューからビデオエンコーディングの進捗を監視します。

2. 次のいずれかの操作を行って、Dynamic Media ビデオを管理します。

   • ビデオアセットの整理、参照、検索

     • デジタルアセットの整理。
       詳しくは、処理プロファイルを使用するためのデジタルアセットの整理におけるベストプラクティスを参照してください。

     • ビデオアセットを検索するかアセットを検索します。

   • ビデオアセットをプレビューして公開します。

     • ソースビデオとビデオのエンコードされたレンディションを、関連するサムネールと共に表示します。

       ビデオをプレビューするかアセットをプレビューします。
       ビデオレンディションを表示
       ビデオレンディションを管理します。

     • ビューアプリセットの管理

     • アセットを公開します。

   • ビデオのメタデータを操作します。

     • フレームレート、オーディオおよびビデオのビットレート、コーデックなど、エンコードされたビデオレンディションのプロパティを表示します。

       ビデオレンディションのプロパティを表示

     • タイトル、説明、タグ、カスタムメタデータフィールドなど、ビデオのプロパティを編集します。

       ビデオのプロパティを編集します。

     • デジタルアセットのメタデータの管理

     • メタデータスキーマ

   • ビデオをレビューおよび承認し、注釈を付け、完全なバージョン管理を維持します。

     • ビデオの注釈またはアセットの注釈

     • バージョンを作成します。

     • アセットにワークフローを適用またはアセットでワークフローを開始を参照

     • フォルダーのアセットのレビュー

     • プロジェクト

3. 次のいずれかの操作を行って、Dynamic Media ビデオを公開します。

   • Adobe Experience Manager を web コンテンツ管理システムとして使用する場合、web ページにビデオを直接追加できます。

     • Web ページにビデオを追加します。

   • サードパーティの web コンテンツ管理システムを使用している場合、web ページにビデオをリンクするか、ビデオを埋め込むことができます。

     • URL を使用したビデオの統合：

       Web アプリケーションに URL をリンクします。

     • Web ページの埋め込みコードを使用したビデオの統合：

       Web ページにビデオビューアを埋め込みます。

   • ビデオレポートを生成します。

   • ビデオにキャプションを追加します。

Dynamic Media でのビデオの操作

Dynamic Media のビデオは、高品質のアダプティブビデオを簡単に公開して、デスクトップ、iOS、Android™、BlackBerry®、Windows などのモバイルデバイスを含む複数の画面にストリーミングするためのエンドツーエンドのソリューションです。アダプティブビデオセットでは、同じビデオを、400 kbps、800 kbps、1000 kbps などの様々なビットレートと形式でエンコードしたバージョンにグループ分けします。デスクトップコンピューターまたはモバイルデバイスによって、利用可能な帯域幅が検出されます。

例えば、iOS モバイルデバイスでは、3G、4G、Wi-Fi などの帯域幅が検出されます。次に、アダプティブビデオセット内の様々なビデオビットレートの中から、適切なエンコード済みビデオが自動的に選択されます。ビデオはデスクトップ、モバイルデバイスまたはタブレットにストリーミングされます。

また、デスクトップまたはモバイルデバイスでネットワークの状態が変化した場合は、ビデオ画質が自動的に動的に切り替わります。また、顧客がデスクトップで全画面表示モードに入ると、アダプティブビデオセットはより高い解像度を使用して顧客の視聴エクスペリエンスを向上させるよう対応します。アダプティブビデオセットを使用すると、Dynamic Media ビデオを複数の画面やデバイスで再生する顧客に最適な再生を提供できます。

どのエンコードされたビデオを再生するか、または再生中に選択するかを決定するためにビデオプレーヤーが使用するロジックは、次のアルゴリズムに基づいています。

1. ビデオプレーヤーは、プレーヤー自体の「初期ビットレート」に設定されている値に最も近いビットレートに基づいて、初期ビデオフラグメントを読み込みます。

2. 次の条件を使用して、帯域幅の速度の変化に応じてビデオプレーヤーが切り替わります。

   1. プレーヤーは、推定帯域幅を越えない範囲で最大帯域幅のストリームを選択します。
   2. プレーヤーは、使用可能な帯域幅の 80％ほどを見積もります。ただし、使用可能な帯域幅が上昇した場合は、帯域幅を大きく見積もりすぎてすぐに元の帯域幅に戻ることを防ぐために、より控えめな 70％ほどの見積もりとなります。

アルゴリズムの技術情報について詳しくは、https://android.googlesource.com/platform/frameworks/av/+/master/media/libstagefright/httplive/LiveSession.cpp を参照してください。

単一のビデオとアダプティブビデオセットの管理では、次の機能がサポートされています。

• 多数のサポートされているビデオ形式およびオーディオ形式からビデオをアップロードし、複数の画面で再生できるようにビデオを MP4 H.264 形式にエンコーディングします。事前定義済みのアダプティブビデオプリセット、または単一のビデオエンコーディングプリセットを使用するか、独自のエンコーディングをカスタマイズしてビデオの品質とサイズを制御することができます。

  • 生成されるアダプティブビデオセットには、MP4 ビデオが含まれます。
  • メモ：プライマリビデオ（ソースビデオ）はアダプティブビデオセットには追加されません。

• すべての HTML5 ビデオビューアーでビデオキャプションを追加します。

• ビデオアセットを効率的に管理するための完全なメタデータサポートを使用して、ビデオを整理、参照および検索します。

• Web やデスクトップおよびモバイルデバイス（iPhone、iPad、Android™、BlackBerry®、Windows Phone など）に対してアダプティブビデオセットを配信します。

アダプティブビデオのストリーミングは、各種 iOS プラットフォームでサポートされています。詳しくは、Dynamic Media ビューアリファレンスガイドを参照してください。

Dynamic Media では、MP4 H.264 ビデオのモバイルビデオ再生がサポートされています。このビデオ形式をサポートする BlackBerry® デバイスについては、BlackBerry® でサポートされているビデオ形式のページで確認できます。

このビデオ形式をサポートする Windows デバイスについては、Windows Phone 8 でサポートされているメディアコーデックのページで確認できます。

• 以下を含む Dynamic Media ビデオビューアープリセットを使用して、ビデオを再生します。

  • 単一のビデオビューアー
  • ビデオコンテンツと画像コンテンツの両方を組み合わせた混在メディアビューアー

• ブランド要件を満たすようにビデオプレーヤーを設定します。

• 単純な URL か埋め込みコードを使用して、ビデオを web サイト、モバイルサイトまたはモバイルアプリケーションに統合します。

Experience Manager Assets 用のビューアおよび Dynamic Media Classic 用のビューアと Experience Manager Assets 専用のビューアを参照してください。

ベストプラクティス：HTML5 ビデオビューアの使用

Dynamic Media の HTML5 ビデオビューアープリセットは、堅牢なビデオプレーヤーです。このプリセットを使用すれば、HTML5 ビデオ再生に関連する多くの一般的な問題のほか、アダプティブビットレートストリーミング配信の欠如やデスクトップブラウザーの限られたリーチなど、モバイルデバイスに関連する問題を回避することができます。

プレーヤーの設計側では、標準の web 開発ツールでビデオプレーヤーの機能を設計できます。例えば、HTML5 と CSS を使用して、ボタン、コントロールおよびカスタムのポスター画像背景をデザインすることにより、カスタマイズした表示で顧客にリーチすることができます。

ビューアーの再生側では、ブラウザーのビデオ機能が自動的に検出されます。次に、アダプティブビットレートストリーミングとも呼ばれる、HLS（HTTP ライブストリーミング）または DASH（HTTP での動的アダプティブストリーミング）を使用してビデオを提供します。これらの配信方法が使用できない場合は、HTML5 プログレッシブが代わりに使用されます。

単一のプレーヤーにまとめることで、次のようなことができるようになりました。

• HTML5 と CSS を使って再生コンポーネントをデザインする機能
• 埋め込み再生する機能
• ブラウザーの機能に応じて、アダプティブストリーミングとプログレッシブストリーミングを使い分ける

リッチメディアコンテンツの配信範囲をデスクトップユーザーとモバイルユーザーの両方に拡大し、ビデオエクスペリエンスを確実に効率化することができます。

HTML5 ビューアについても参照してください。

HTML5 ビデオビューアを使用した、デスクトップコンピューターおよびモバイルデバイス上でのビデオ再生

デスクトップおよびモバイルへのアダプティブビデオストリーミングの場合、ビットレートの切り替えに使用されるビデオは、アダプティブビデオセット内のすべての MP4 ビデオに基づいています。

ビデオ再生は、DASH か HLS、またはプログレッシブビデオダウンロードを使用して行われます。6.0、6.1、6.2 など以前の Experience Manager バージョンでは、ビデオは HTTP 上でストリーミングされました。

DM ゲートウェイサービスの URL が常に HTTPS も使用するので、Experience Manager 6.3 以降ではビデオが HTTPS（DASH または HLS） でストリーミングされるようになりました。このデフォルトの動作はユーザーに影響しません。つまり、ブラウザーでサポートされていない場合を除き、ビデオストリーミングは常に HTTPS 上で行われます（次の表を参照）。したがって、

• HTTPS web サイトが HTTPS ビデオストリーミングに対応している場合は、ストリーミングが適しています。
• HTTP web サイトが HTTPS ビデオストリーミングに対応している場合は、ストリーミングが適しており、web ブラウザーから混合コンテンツに関する問題は発生しません。

DASH は国際標準であり、HLS は Apple の標準です。どちらもアダプティブビデオストリーミングに使用されます。どちらのテクノロジーも、ネットワーク帯域幅の容量に基づいて再生を自動的に調整します。また、HLS では、ビデオの残りがダウンロードされるまで待たなくても、ビデオ内の任意のポイントを「シーク」できます。

プログレッシブビデオは、ユーザーのデスクトップシステムやモバイルデバイスにビデオをダウンロードしてローカルに保存することで配信されます。

デバイス、ブラウザーおよびデスクトップコンピューターやモバイルデバイスでの Dynamic Media ビデオビューアによるビデオの再生方法を次の表に示します。

Dynamic Media ビデオソリューションのアーキテクチャ

次の図に、アップロード後、（Dynamic Media Hybrid モードの）DMGateway によってエンコードされ、公開されるビデオのオーサリングワークフローの全体像を示します。

ビデオのハイブリッド公開アーキテクチャ

ビデオエンコーディングのベストプラクティス

Dynamic Media を有効にし、ビデオクラウドサービスを設定済みの場合、Dynamic Media エンコードビデオ​ワークフローがビデオをエンコードします。このワークフローは、ワークフローの処理履歴とエラー情報を取り込みます。Dynamic Media を有効にし、ビデオ Cloud Services を設定してある場合は、ビデオをアップロードすると、Dynamic Media エンコーディングビデオ​ワークフローが自動的に有効になります（Dynamic Media を使用していない場合は、DAM アセットの更新​ワークフローが有効になります）。

ソースビデオファイル

ビデオファイルをエンコードする場合は、可能な限り高品質のソースビデオファイルを使用します。 以前にエンコードされたビデオファイルは使用しないでください。これらのファイルは既に圧縮されており、さらにエンコーディングすると標準を下回る品質のビデオが作成されます。

• Dynamic Media では、最大長 30 分、最小解像度が 25 x 25 を超える短い形式のビデオが主にサポートされています。
• 15 GB までのプライマリソースビデオファイルをアップロードできます。

次の表に、ソースビデオファイルのエンコード前の推奨サイズ、縦横比および最小ビットレートを示します。

ファイルのメタデータの取得

ファイルのメタデータを取得するには、ビデオ編集ツールを使用してメタデータを表示するか、メタデータを取得するために設計されたアプリケーションを使用します。 次に、サードパーティアプリケーションである MediaInfo を使用してビデオファイルのメタデータを取得する手順を示します。

1. MediaInfo のダウンロードページに移動します。
2. GUI バージョンのインストーラーを選択してダウンロードし、インストール手順に従って操作します。
3. インストールの完了後、ビデオファイルを右クリックして（Windows のみ）MediaInfo を選択するか、MediaInfo を開いてビデオファイルをアプリケーションにドラッグします。ビデオの幅、高さ、fps を含む、ビデオファイルに関連するすべてのメタデータが表示されます。

縦横比

プライマリソースビデオファイルのビデオエンコーディングプリセットを選択または作成するときには、プライマリソースビデオファイルと同じ縦横比をプリセットに使用してください。縦横比とは、ビデオの高さに対する幅の比率のことです。

ビデオファイルのアスペクト比を求めるには、ファイルのメタデータを取得し、そのファイルの幅と高さを記録します（前述の「ファイルのメタデータの取得」を参照してください）。さらに、次の式を使用してアスペクト比を計算します。

幅/高さ = 縦横比

次の表に、数式の結果が一般的なアスペクト比に変換される方法を示します。

例えば、幅 1,440、高さ 1,080 のビデオの縦横比は 1,440/1,080、つまり 1.33 になります。このビデオファイルをエンコードするには、縦横比 4:3 のビデオエンコーディングプリセットを選択します。

ビットレート

ビットレートとは、1 秒間のビデオ再生を構成するエンコードされたデータの量です。ビットレートは、キロビット/秒（Kbps）単位で測定されます。

ビットレートエンコーディングは、次の 2 つのタイプから選択できます。

• 固定ビットレートエンコーディング（CBR）- CBR エンコーディングでは、ビットレートまたは 1 秒あたりのビット数が、エンコーディングプロセス全体で同じ数値に維持されます。CBR エンコーディングでは、設定されているデータレートが、ビデオ全体での設定値として使用されます。また、CBR エンコーディングでは、メディアファイルの品質は最適化されませんが、その分、空き容量の節約になります。ビデオ全体に同じようなモーションレベルが含まれている場合は、CBR を使用します。CBR は、ビデオコンテンツのストリーミングに最も一般的に使用されています。カスタムで追加するビデオエンコーディングパラメーターの使用も参照してください。

• 可変ビットレートエンコーディング（VBR）- VBR エンコーディングでは、コンプレッサーで必要となるデータに基づいて、設定したデータレートが下限から上限の範囲内で調整されます。つまり、VBR エンコーディングプロセスでは、メディアファイルのビットレートが、そのニーズに応じて動的に増減します。VBR は、CBR よりエンコードに時間がかかりますが、生成されるメディアファイルは最高品質となります。VBR は、ビデオコンテンツの HTTP プログレッシブ配信に最も一般的に使用されます。

VBR と CRB のどちらを使用するべきかVBR と CBR のどちらを選択すべきかと言えば、ほとんどの場合、メディアファイルには VBR を使用することをお勧めします。VBR は、優位性のあるビットレートで CBR より高品質のファイルを生成します。VBR を使用するときは、2 パスエンコーディングを使用し、最大ビットレートをターゲットビデオのビットレートの 1.5 倍に設定してください。

ビデオエンコーディングプリセットを選択するときは、ターゲットエンドユーザーの接続速度を念頭に置いてください。その速度の 80% のデータレートを持つプリセットを選択してください。例えば、ターゲットエンドユーザーの接続速度が 1,000 Kbps の場合、ビデオデータレートが 800 kbps のプリセットが最適です。

次の表に、一般的な接続速度のデータレートを示します。

解像度

解像度​は、ビデオファイルの高さと幅をピクセル単位で表したものです。ほとんどのソースビデオは、1920 x 1080 などの高解像度で保存されます。ストリーミング用のソースビデオは、比較的低い解像度（640 x 480 以下）に圧縮されます。

解像度とデータレートは、ビデオ画質を決定する統合的な 2 つの要素です。同じビデオ画質を維持するには、ビデオファイルのピクセル数が多いほど（解像度が高いほど）、データレートを高くする必要があります。例えば、320 x 240 の解像度と 640 x 480 の解像度のビデオファイルで、フレームあたりのピクセル数を考えてみましょう。

640 x 480 ファイルのピクセル数は、フレームあたり 4 倍になります。この 2 つの解像度の例でデータレートを同じにするには、640 x 480 ファイルを 4 倍に圧縮します。これにより、ビデオの画質が低下する可能性があります。そのため、250 kbps のビデオデータレートの場合、320 x 240 の解像度では高画質になりますが、640 x 480 の解像度では高画質になりません。

一般に、高いデータレートを使用するほど、ビデオの画質は良くなり、高い解像度を使用するほど、その画質を維持するために必要になるデータレートも（解像度が低い場合と比較して）増加します。

解像度とデータレートには関連があるので、ビデオをエンコードする際には次の 2 つの方法から選択できます。

• データレートを選択してから、選択したデータレートで美しく表示される最高の解像度でエンコードします。
• 解像度を選択してから、選択した解像度で高品質のビデオを配信するために必要になるデータレートでエンコードします。

プライマリソースビデオファイルのビデオエンコーディングプリセットを選択（または作成）する場合は、次の表を使用して正しい解像度をターゲットにします。

Fps（1 秒あたりのフレーム数）

米国と日本では、ほとんどのビデオが 29.97 フレーム/秒（fps）で撮影されます。ヨーロッパでは、ほとんどのビデオが 25 fps で撮影されます。映画は 24 fps で撮影されます。

プライマリソースビデオファイルの fps レートに一致するビデオエンコーディングプリセットを選択します。例えば、プライマリソースビデオが 25 fps の場合は、25 fps のエンコーディングプリセットを選択します。デフォルトでは、すべてのカスタムエンコーディングでプライマリソースビデオファイルの fps が使用されます。そのため、ビデオエンコーディングプリセットを作成するときに、fps 設定を明示的に指定する必要はありません。

ビデオエンコーディングのサイズ

最適な結果を得るには、ソースビデオがすべてのエンコードされたビデオの整数倍になるようにエンコーディングのサイズを選択します。

この比率を計算するには、ソースの幅をエンコードされた幅で割って、幅の比率を求めます。次に、エンコードされた高さでソースの高さを割って、高さの比率を求めます。

結果の比率が整数の場合、ビデオは最適に縮小されています。結果の比率が整数でない場合は、余ったピクセルのアーティファクトがディスプレイに残るので、ビデオの画質に影響します。この影響は、ビデオにテキストが含まれている場合に顕著に現れます。

例えば、ソースビデオが 1920 x 1080 だとします。次の表では、エンコードされた 3 つのビデオで使用する、最適なエンコード設定を示しています。

エンコードされたビデオのファイル形式

Dynamic Media では、MP4 H.264 ビデオエンコーディングプリセットの使用をお勧めします。MP4 ファイルは H.264 ビデオコーデックを使用するので、ビデオは高品質になるものの圧縮されたファイルサイズです。

アカウントでの DASH の有効化

DASH（HTTP での動的アダプティブストリーミング）はビデオストリーミングの国際標準であり、様々なビデオビューアーで広く採用されています。アカウントで DASH が有効になっている場合は、アダプティブビデオストリーミング用に DASH または HLS のいずれかを選択できます。ビューアのプリセットで再生タイプとして「自動」が選択されていると、プレーヤー間の自動切り替えで両方を選択できます。

アカウントで DASH を有効にする場合の主なメリットには、次のようなものがあります。

• アダプティブビットレートストリーミング用に DASH ストリームビデオをパッケージ化できます。この方法では配信の効率が向上します。アダプティブストリーミングにより、顧客に最適な視聴エクスペリエンスが提供されます。
• Dynamic Media プレイヤーでブラウザーに最適化されたストリーミングにより、HLS と DASH のストリーミングを切り替え、最高のサービス品質を確保できます。Safari ブラウザーを使用すると、ビデオプレーヤーが HLS に自動的に切り替わります。
• ビデオビューアプリセットを編集して、優先ストリーミング方式（HLS または DASH）を設定できます。
• 最適化されたビデオエンコーディングにより、DASH 機能を有効にしながら、追加のストレージを使用しなくて済みます。HLS と DASH の両方に対して 1 つのビデオエンコードセットが作成され、ビデオの保存コストが最適化されます。
• 顧客がビデオ配信をアクセスしやすくなります。
• API を使用してストリーミング URL を取得することもできます。

アカウントで DASH を有効にするには、次の 2 つの手順が必要です。

• DASH を使用するように Dynamic Media を設定します。これは、自分で簡単に行えます。
• Experience Manager 6.5 で DASH を使用するように設定します。これは、Adobe カスタマーサポートにケースを作成して送信することにより行います。

アカウントで DASH を有効にするには

1. Dynamic Media の設定 - Experience Manager 6.5 の Dynamic Media で、https://localhost:4502/system/console/configMgr に移動します。

2. 「AEM Assets Dynamic Media のビデオの高度なストリーミング」機能フラグを検索します。

3. DASH を有効（オン）にするには、チェックボックスをオンにします。

4. 「保存」を選択します。

5. Experience Manager 6.5 の設定 - Admin Console で新しいサポートケースの作成を開始します。

6. サポートケースを作成するには、次の情報を必ず指定しながら、指示に従ってください。

   • 主要連絡先の氏名、メールアドレス、電話番号。
   • Dynamic Media アカウントの名前。
   • Experience Manager 6.5 で DASH を有効にするように指定します。

7. アドビカスタマーサポートでは、リクエストが送信された順序に基づいて、DASH の順番待ちリストに追加します。

8. リクエストを処理する準備が整った時点で、カスタマーサポートから連絡を差し上げ、DASH を有効にする日付の調整と設定を行います。

9. 完了後、カスタマーサポートから通知があります。

10. 通常通り、ビデオビューアープリセットを作成します。

ビデオレポートの表示

ビデオレポートでは、指定した時間内に複数の集計指標が表示され、 公開済み 個々のビデオと集計ビデオが期待どおりに動作しています。 次の上位指標データは、web サイト全体で公開されているすべてのビデオについて集計されます。

• ビデオ開始
• 完了率
• ビデオの平均視聴時間
• ビデオの合計視聴時間
• 訪問あたりのビデオ数

すべての​公開済み​ビデオの表も表示されるので、ビデオ開始数の合計に基づいて、web サイトで視聴された上位のビデオを追跡できます。

リストのビデオ名をタップすると、ビデオのオーディエンス保持（ドロップオフ）レポートが折れ線グラフの形式で表示されます。このグラフには、ビデオ再生の特定の時点におけるビュー数が表示されます。ビデオを再生すると、プレーヤーの時間インジケーターと同期して縦棒が表示されていきます。この折れ線グラフが急激に下る箇所は、オーディエンスが関心をなくして再生を終了した時点を示しています。

ビデオが Adobe Experience Manager Dynamic Media 以外でエンコードされた場合、オーディエンス保持（ドロップオフ）グラフおよび表内の再生率データは利用できません。

Dynamic Media クラウドサービスの設定も参照してください。

デフォルトでは、ビデオレポートを最初に開いたときに、今月初めから今月の今日の日付までのビデオデータが表示されます。ただし、このデフォルトの日付範囲を上書きして、独自の日付範囲を指定することができます。次回ビデオレポートを開くと、指定した日付範囲が使用されます。

ビデオレポートの正常動作のために、Dynamic Media Cloud Services の設定時に、レポートスイート ID が自動的に作成されます。そのときに、そのレポートスイート ID がパブリッシュサーバーにプッシュされ、アセットのプレビューの際に URL のコピー機能で使用できるようになります。ただし、この機能を使用するには、公開サーバーが既に設定されている必要があります。パブリッシュサーバーがセットアップされていない場合でも、公開してビデオレポートを確認することはできます。ただし、その際には Dynamic Media クラウド設定に戻って「OK」をタップする必要があります。

ビデオレポートを表示するには：

1. Experience Manager の左上隅にある Experience Manager ロゴをタップし、左のレールで​ツール（ハンマーのアイコン）／アセット／ビデオレポート​をタップします。

2. ビデオレポートページで、次のいずれかの操作を行います。

   • 右上付近にある​ビデオレポートを更新​アイコンをタップします。「更新」を使用するのは、レポートの終了日が今日の日付である場合のみです。これにより、前回のレポート実行以降に発生したビデオトラッキングを確認できます。

   • 右上付近にある​日付選択​アイコンをタップします。
     ビデオデータを表示する開始日と終了日の範囲を指定し、「レポートを実行」をタップします。

   「トップの指標」グループボックスに、サイト全体にわたるすべての​公開済み​ビデオに関する様々な集計値が表示されます。

3. 上位の公開済みビデオの一覧表でビデオ名をタップしてビデオを再生し、そのビデオのオーディエンス維持（ドロップオフ）レポートを確認します。

Dynamic Media HTML5 ビューア SDK を使用して作成したビデオビューアに基づいたビデオレポートの表示

Dynamic Media で標準提供されているビデオビューアを使用している場合、または標準提供のビデオビューアからカスタムのビューアプリセットを作成した場合は、ビデオレポートを表示するために必要な追加手順はありません。ただし、HTML5 ビューア SDK API から独自のビデオビューアを作成した場合は、次の手順を実行して、ビデオビューアが Dynamic Media のビデオレポートにトラッキングイベントを確実に送信するようにしてください。

独自のビデオビューアを作成するには、Adobe Dynamic Media ビューアリファレンスガイドおよび HTML5 ビューア SDK API を参照します。

Dynamic Media HTML5 ビューア SDK を使用して作成したビデオビューアに基づいてビデオレポートを表示するには：

1. 公開済みのビデオアセットに移動します。

2. アセットのページの左上隅付近にある、ドロップダウンリストで「ビューア」を選択します。

3. 任意のビデオビューアのプリセットを選択し、埋め込みコードをコピーします。

4. 埋め込みコード内で、以下を使用して行を見つけます。

   videoViewer.setParam("config2", "<value>");

   config2 パラメーターは、HTML5 ビューアでの追跡を有効にします。また、ビデオレポートの設定情報や、お客様固有の Adobe Analytics 設定を含む、会社固有のプリセットでもあります。

   config2 パラメーターの正しい値は、埋め込みコード​のコピー機能と URL のコピー機能のどちらでも検索できます。URL コピーコマンドから取得した URL 内で探すべきパラメーターは、&config2=<value> です。この値はほぼ常に companypreset ですが、一部のケースでは companypreset-1、companypreset-2 などとなっていることもあります。

5. カスタムのビデオビューアコードで、次の操作をおこなって、ビューアページに AppMeasurementBridge.jsp を追加します。

   • 最初に、&preset パラメーターが必要かどうかを判断します。

     config2 パラメーターが companypreset の場合、&preset=parameter は​不要​です。

     config2 がその他の場合は、プリセットパラメーターを config2 パラメーターと同じに設定します。例えば、config2=companypreset-2 の場合、&param2=companypreset-2 を AppMeasurmentBridge.jsp の URL に追加します。

   • 次に、AppMeasurementBridge.jsp にスクリプトを追加します。

     <script language="javascript" type="text/javascript" src="https://s7d1.scene7.com/s7viewers/AppMeasurementBridge.jsp?company=robindallas&preset=companypreset-2"></script>

6. 次の操作をおこなって、TrackingManager コンポーネントを作成します。

   • s7sdk.Util.init(); を呼び出した後で、次のコードを追加して、イベントを追跡する TrackingManager インスタンスを作成します。

     var trackingManager = new s7sdk.TrackingManager();

   • 以下を行って、TrackingManager にコンポーネントを接続します。

     s7sdk.Event.SDK_READY イベントハンドラーで、追跡するコンポーネントを TrackingManager に関連付けます。

     例えば、コンポーネントが videoPlayer の場合、

     trackingManager.attach(videoPlayer);

     追加して、コンポーネントを trackingManager に関連付けます。ページ上の複数のビューアを追跡するには、複数のトラッキングマネージャーコンポーネントを使用します。

   • 次のコードを追加して、AppMeasurementBridge オブジェクトを作成します。

     var appMeasurementBridge = new AppMeasurementBridge(); appMeasurementBridge.setVideoPlayer(videoPlayer);
     

   • 次のコードを追加して、トラッキング関数を追加します。

     trackingManager.setCallback(appMeasurementBridge.track,
      appMeasurementBridge);
     

   appMeasurementBridge オブジェクトには組み込みのトラッキング関数があります。ただし、複数のトラッキングシステムやその他の機能をサポートするために、独自のトラッキング関数を作成することもできます。

ビデオへのキャプションまたはサブタイトルの追加

クローズドキャプションを 1 つのビデオまたはアダプティブビデオセットに追加することにより、ビデオの配信先をグローバルマーケットまで拡大できます。クローズドキャプションを追加すると、音声をダビングする必要も、異なる言語ごとにネイティブスピーカーの音声を使って再録音する必要もなくなります。ビデオは、録画された言語で再生されます。様々な言語を使う人々が音声を理解できるように、外国語の字幕が表示されます。

クローズドキャプションは、耳の不自由な方にもご利用いただけるため、アクセシビリティの向上にもつながります。

Dynamic Media のアクセシビリティも参照してください。

Dynamic Media では、キャプションファイルを JSON（JavaScript Object Notation）形式に変換します。このように変換できるので、JSON テキストを、ビデオの完全なトランスクリプトとして表示せずに Web ページに埋め込むことができます。この後、検索エンジンがコンテンツをクロールしてインデックスを作成します。これにより、ビデオを見つけやすくなるとともに、ビデオコンテンツについての追加情報を顧客に提供することができます。

URL で JSON 機能を使用する方法について詳しくは、Dynamic Media 画像サービングおよびレンダリング API ヘルプ​の静的コンテンツ（画像以外）の提供を参照してください。

ビデオにキャプションまたはサブタイトルを追加するには:

1. サードパーティのアプリケーションまたはサービスを使用して、ビデオのキャプションやサブタイトルのファイルを作成します。

   作成するファイルは、WebVTT（Web ビデオテキストトラック）標準に従っている必要があります。キャプションファイル名の拡張子は .vtt です。WebVTT キャプション標準をよく確認してください。

   WebVTT：Web Video Text Tracks 形式（英語）を参照してください。

   Dynamic Media 以外でキャプションやサブタイトルのファイルの作成に使用できる、無料と有料のツールやサービスが用意されています。例えば、スタイル設定のない単純なビデオキャプションファイルを作成するには、以下の無料のオンラインキャプションオーサリング編集ツールを使用できます。

   WebVTT Caption Maker

   良い結果を得るためには、このツールを Explorer 9 以上、Google Chrome、または Safari で使用してください。

   ツールの「ビデオファイルの URL を入力」フィールドにビデオファイルの URL をコピーして貼り付け、「読み込み」をクリックします。アセットの URL の取得を参照して、ビデオファイルそのものの URL を取得し、それを「ビデオファイルの URL を入力」フィールドに貼り付けてください。その後、Internet Explorer、Chrome、または Safari で、ビデオを再生できます。

   ここで、サイトの画面に表示される指示に従って、WebVTT ファイルを作成して保存します。完了したら、キャプションファイルの内容をコピーしてプレーンテキストエディターに貼り付け、.vtt のファイル拡張子で保存します。

   メモ

   複数言語のビデオサブタイトルを用意してグローバル対応する場合、WebVTT 標準の規定により、サポート対象の言語ごとに個別の .vtt ファイルを作成して呼び出す必要があります。

   一般に、キャプションの VTT ファイルにはビデオファイルと同じ名前を付け、名前の末尾に言語ロケール（-EN、-FR、-DE、-JA など）を追加します。そうしておくと、既存の web コンテンツ管理システムを使用してビデオの URL を自動的に生成する際に役立ちます。

2. Experience Manager で、WebVTT キャプションファイルを DAM にアップロードします。

3. アップロードしたキャプションファイルを関連付ける、公開済み​ビデオアセットに移動します。

   URL をコピーするには、その​前に​アセットを​公開​しておく必要があります。

   アセットの公開を参照してください。

4. 次のいずれかの操作を行います。

   • ポップアップビデオビューアエクスペリエンスの場合、「URL」をタップします。URL ダイアログボックスで、URL を選択してクリップボードにコピーし、その URL を単純なテキストエディターに貼り付けます。コピーしたビデオの URL を次の構文で追加します。

     &caption=<server_path>/is/content/<path_to_caption.vtt_file,1>

     キャプションパスの末尾にある ,1 に注意します。パスの .vtt ファイル名拡張子の直後で、ビデオプレーヤーバーのクローズドキャプションボタンの有効（オン）と無効（オフ）を任意に切り替えることができます。それには、それぞれ ,1 または ,0 を設定します。

   • 埋め込みビデオビューアエクスペリエンスの場合、「埋め込みコード」をタップします。埋め込みコードダイアログボックスで、埋め込みコードを選択してクリップボードにコピーし、そのコードを単純なテキストエディターに貼り付けます。コピーした埋め込みコードを次の構文で追加します。

     videoViewer.setParam("caption","<path_to_caption.vtt_file,1>");

     キャプションパスの末尾にある ,1 に注意します。パスの .vtt ファイル名拡張子の直後で、ビデオプレーヤーバーのクローズドキャプションボタンの有効（オン）と無効（オフ）を任意に切り替えることができます。それには、それぞれ ,1 または ,0 を設定します。

ビデオへのチャプターマーカーの追加

1 つのビデオまたはアダプティブビデオセットにチャプターマーカーを追加すると、長編ビデオの視聴と操作が簡単になります。ユーザーがビデオを再生する際、ビデオタイムライン（別名：ビデオスクラバー）のチャプターマーカーをクリックすると、関心のあるシーンに簡単に移動できます。または、新しいコンテンツ、デモおよびチュートリアルに即座にジャンプすることができます。

必要であれば、ビデオビューアプリセットを使用するのではなく、チャプター機能を備えた独自のカスタムビデオビューアを作成して、ブランディングできます。チャプターナビゲーション機能を備えた独自の HTML5 ビューアを作成する方法については、Adobe HTML5 Viewer SDK API ドキュメントで s7sdk.video.VideoPlayer クラスと s7sdk.video.VideoScrubber クラスの説明の「Customizing Behavior Using Modifiers」節を参照してください。HTML5 Viewer SDK API ドキュメントを参照してください。

ビデオのチャプターリストを作成する方法は、キャプションを作成する方法とほとんど同じです。つまり、WebVTT ファイルを作成します。ただし、WebVTT キャプションファイルも使用する場合は、このファイルを WebVTT ファイルと分けておく必要があります。キャプションとチャプターを 1 つの WebVTT ファイルにまとめることはできません。

チャプターナビゲーション機能を備えた WebVTT ファイルを作成する際に使用するフォーマットの例として、次のサンプルを使用できます。

ビデオチャプターナビゲーション機能を備えた WebVTT ファイル

WEBVTT
Chapter 1
00:00.000 --> 01:04.364
The bicycle store behind it all.
Chapter 2
01:04.364 --> 02:00.944
Creative Cloud.
Chapter 3
02:00.944 --> 03:02.937
Ease of management for a working solution.
Chapter 4
03:02.937 --> 03:35.000
Cost-efficient access to rapidly evolving technology.

上記の例では、Chapter 1 はキュー識別子で、オプションです。00:00:000 --> 01:04:364 のキュー時間は、チャプターの開始時間と終了時間を、00:00:000 という形式で指定しています。最後の 3 桁はミリ秒で、000 のまま残しておくこともできます。The bicycle store behind it all のチャプタータイトルは、チャプターの内容を示す実際の説明です。ビデオのタイムラインのビジュアルキューポイントにマウスポインターを合わせると、キュー識別子、開始キュー時間およびチャプタータイトルが、ビデオプレーヤーのポップアップに表示されます。

HTML5 ビデオビューアを使用するので、作成するチャプターファイルが WebVTT（Web Video Text Tracks）標準に準拠していることを確認してください。チャプターファイルの拡張子は .vtt です。WebVTT キャプション標準をよく確認してください。

詳しくは、WebVTT: The Web Video Text Tracks Format を参照してください。

ビデオチャプターナビゲーションを追加するには：

1. この .vtt ファイルを UTF8 エンコーディングで保存して、チャプタータイトルテキストの文字レンディションに関する問題を回避します。

   一般に、チャプター VTT ファイルの名前には、ビデオファイルと同じ名前を付けて、名前の末尾にチャプターを追加します。そうしておくと、既存の web コンテンツ管理システムを使用してビデオの URL を自動的に生成する際に役立ちます。

2. Experience Manager で、WebVTT チャプターファイルをアップロードします。

   アセットのアップロードを参照してください。

3. 次のいずれかの操作を行います。

   ポップアップビデオビューアエクスペリエンスの場合

   アップロードしたチャプターファイルを関連付ける、公開済みビデオアセットに移動します。URL をコピーするには、その前にアセットを公開しておく必要があります。アセットの公開を参照してください。 ドロップダウンメニューで「ビューア」をクリックまたはタップします。 左側のレールで、ビデオビューアプリセット名をタップまたはクリックします。ビデオのプレビューが別のページで開きます。 左側のレールの下部にある「URL」をクリックします。 URL ダイアログボックスで、URL を選択してクリップボードにコピーし、その URL を単純なテキストエディターに貼り付けます。 ビデオのコピー済み URL を次の構文で追加すると、チャプターファイルのコピー済み URL に関連付けることができます。 &navigation=<full_copied_URL_path_to_chapter_file.vtt>

   埋め込みビデオビューアエクスペリエンスの場合

   アップロードしたチャプターファイルを関連付ける、公開済みビデオアセットに移動します。URL をコピーするには、その前にアセットを公開しておく必要があります。アセットの公開を参照してください。 ドロップダウンメニューで「ビューア」をクリックまたはタップします。 左側のレールで、ビデオビューアプリセット名をタップまたはクリックします。ビデオのプレビューが別のページで開きます。 左側のレールの下部にある「埋め込み」をクリックします。 埋め込みコードダイアログボックスで、コード全体を選択してクリップボードにコピーし、そのコードを単純なテキストエディターに貼り付けます。 ビデオの埋め込みコードを次の構文で追加して、チャプターファイルのコピー済み URL に関連付けることができます。 videoViewer.setParam("navigation","<full_copied_URL_path_to_chapter_file.vtt>"

Dynamic Media - Scene7 モードのビデオサムネールについて

ビデオサムネールは、ビデオフレームまたは画像アセットの縮小バージョンで、顧客向けのビデオを表すものです。サムネールは、顧客がビデオを選択するよう促すのに役立ちます。

Experience Manager 内のすべてのビデオには、サムネールを関連付ける必要があります。サムネールを置き換えずに削除することはできません。デフォルトでは、Experience Manager にビデオをアップロードすると、最初のフレームがサムネールとして使用されます。例えば、ブランド設定やビジュアル検索用にサムネールをカスタマイズできます。ビデオのサムネールをカスタマイズするには、ビデオを再生して、使用するフレームで一時停止します。あるいは、Digital Asset Manager に既にアップロードして​公開​している画像アセットを選択できます。

ビデオから選択したカスタムビデオサムネール画像は抽出されず、別個のアセットとして DAM に保存されます。ただし、既存の画像アセットから選択したカスタムビデオサムネイルは JCR に保存されます。選択したアセットのパスは、次のサンプルパスのように、ビデオアセットのノードに保存されます。

/content/dam/*<folder_name*>/<*video_name*>/jcr:content/manualThumbnail

ビデオのサムネiルをカスタマイズする機能は、ビデオがあるフォルダーにビデオプロファイルを適用した後でのみ使用できます。

「Dynamic Media - ハイブリッドモード のビデオサムネイルについて」も参照してください。

カスタムビデオサムネールの追加

これらの手順は、「Dynamicmedia_Scene7」モードで動作している Dynamic Media にのみ適用されます。

カスタムビデオサムネールを追加するには：

1. 次の作業が完了していることを確認してください。

   • ビデオアセット用のフォルダーの作成。

   • ビデオプロファイルをフォルダーに適用します.。

   • フォルダーへのビデオのアップロード。

2. サムネイル画像を変更するアップロード済みビデオアセットに移動します。

3. リスト表示​または​カード表示​のいずれかのアセット選択モードで、ビデオアセットをタップします。

4. ツールバーで、「プロパティ」アイコン（中に「i」がある円）をタップします。

5. ビデオのプロパティページで、「サムネイルを変更」をタップします。

6. 「サムネイルを変更」ページで以下のいずれかを行います。

   • ビデオのフレームを新しいサムネイルとして使用するには：

     • ツールバーで「ビデオからフレームを選択」をタップします。
     • 「再生」ボタンをタップし、ビデオの新しいサムネールとしてキャプチャするフレームの「一時停止」ボタンをタップします。

   • 画像アセットを新しいサムネールとして使用するには：

     • ツールバーで、「アセットからサムネイルを選択」をタップします。
     • 「サムネールを選択」をタップします。
     • 使用を希望する、以前にアップロードおよび公開された画像アセットに移動します。アセットは、ビデオのサムネール画像として機能するように自動的にサイズ変更されます。
     • 画像アセットを選択し、「選択」をタップします。

7. 「サムネイルを変更」ページで、「変更を保存」をタップします。

8. ビデオのプロパティページで、右上隅にある「保存して閉じる」をタップします。

Dynamic Media - ハイブリッドモード のビデオサムネイルについて

Dynamic Media で自動的に生成された 10 個のサムネイル画像の中から 1 つを選択して、ビデオに追加できます。選択したサムネールは、Experience Manager Sites、Experience Manager Mobile または Experience Manager Screens のオーサリング環境で Dynamic Media コンポーネントとともにビデオアセットを使用するときに、ビデオプレーヤーに表示されます。このサムネールは、ビデオの内容を最も適切に表し、かつユーザーが再生ボタンをクリックしたくなるような静的画像として提供されます。

Dynamic Media では、ビデオの合計時間に基づいて 10 個（デフォルト）のサムネール画像がキャプチャされます。画像は、1%、11%、21%、31%、41%、51%、61%、71%、81% および 91% でビデオにキャプチャされます。10 個のサムネイルが保持されるので、後で別のサムネールを選択する場合にシリーズを再生成する必要はありません。10 個のサムネール画像をプレビューし、ビデオで使用する画像を選択します。デフォルトに変更する場合は、CRXDE Lite を使用して、サムネール画像が生成される時間間隔を設定できます。例えば、ビデオから均等に配置された 4 つのサムネイル画像のみを生成する場合は、間隔を 24%、49%、74%、99%に設定できます。

ビデオのアップロード後、web サイトにビデオを公開する前に、いつでもビデオサムネiルを追加できるのが理想です。

Dynamic Media で生成されたサムネイルを使用する代わりに、ビデオを表すカスタムサムネイルをアップロードすることもできます。例えば、ビデオのタイトル、人目を引くオープニング画像、またはビデオからキャプチャした特定の画像を含むカスタムサムネール画像を作成できます。アップロードするカスタムビデオサムネール画像は、最大解像度が 1280 x 720 ピクセル（最小幅 640 ピクセル）で、2 MB を超えないようにしてください。

また、Dynamic Media - Scene7 モードのビデオサムネールについても参照してください。

ビデオサムネールの追加

これらの手順は、ハイブリッドモードで動作している Dynamic Media にのみ適用されます。

ビデオサムネールを追加するには：

1. ビデオサムネールを追加する、アップロード済みビデオアセットに移動します。

2. リスト表示またはカード表示のアセット選択モードで、ビデオアセットをタップします。

3. ツールバーで、「プロパティを表示」アイコン（中に「i」がある円）をタップします。

4. ビデオのプロパティページで、「サムネイルを変更」をタップします。

5. サムネールの変更ページのツールバーで、「フレームを選択」をタップします。

   デフォルトの時間間隔またはカスタマイズした時間間隔に基づき、Dynamic Media によって一連のサムネール画像がビデオから生成されます。

6. 生成されたサムネイル画像をプレビューし、ビデオに追加する画像を選択します。

7. 「変更を保存」をタップします。

   ビデオのサムネイル画像が更新され、選択したサムネールが使用されます。後でサムネール画像を変更する場合は、「サムネールを変更」ページに戻って新しいサムネイルを選択します。

   新しいデフォルトの時間間隔を設定した場合、または新しいビデオをアップロードして既存のビデオを置き換えた場合は、Dynamic Media によってサムネールを再生成します。

   詳しくは、ビデオサムネールが生成されるデフォルトの時間間隔の設定を参照してください。

ビデオサムネールが生成されるデフォルトの時間間隔の設定

新しいデフォルトの時間間隔を設定して保存すると、今後アップロードするビデオにのみに変更が自動的に適用されます。以前にアップロードしたビデオには、新しいデフォルトは自動的に適用されません。既存のビデオの場合は、サムネールを再生成する必要があります。

詳しくは、ビデオサムネールの追加を参照してください。

ビデオサムネールが生成されるデフォルトの時間間隔を設定するには：

1. Experience Manager で、ツール／一般／CRXDE Lite をタップします。

2. CRXDE Lite ページの左側にあるディレクトリパネルで、o etc/dam/imageserver/configuration/jcr:content/settings. に移動します。

   このディレクトリパネルが表示されない場合は、「ホーム」タブの左側にある >> アイコンをタップします。

3. 右下のパネルにある「プロパティ」タブで、「thumbnailtime」をダブルタップします。

4. thumbnailtime を編集​ダイアログボックスで、テキストフィールドに間隔値を割合で入力します。

   • 1 つ以上の間隔値フィールドを追加するには、プラス記号（+）アイコンをタップします。このアイコンは、ダイアログボックスの下部までスクロールしないと表示されない場合があります。
   • リストから間隔値フィールドを削除するには、そのフィールドの右側にあるマイナス記号（-）アイコンをタップします。
   • 間隔値の順序を変更するには、上向き矢印アイコンと下向き矢印アイコンをタップします。

5. 「OK」をタップして、「プロパティ」タブに戻ります。

6. CRXDE Lite ページの左上隅にある「すべて保存」をタップした後、左上隅の「ホームに戻る」アイコンをタップして Experience Manager に戻ります。

   詳しくは、ビデオサムネールの追加を参照してください。

カスタムビデオサムネールの追加

これらの手順は、ハイブリッドモードで動作している Dynamic Media にのみ適用されます。

カスタムビデオサムネールを追加するには：

1. カスタムビデオサムネールを追加するアップロード済みビデオアセットに移動します。

2. リスト表示またはカード表示のアセット選択モードで、ビデオアセットをタップします。

3. ツールバーで、「プロパティを表示」アイコン（中に「i」がある円）をタップします。

4. ビデオのプロパティページで、「サムネールを変更」をタップします。

5. サムネールの変更ページのツールバーで、「新しいサムネールをアップロード」をタップします。

6. 使用するサムネール画像に移動してその画像を選択し、「開く」をタップして Experience Manager への画像のアップロードを開始します。アップロード後は、必ず画像を公開してください。

7. 画像のアップロードと公開が完了したら、サムネールの変更ページで「変更を保存」をタップします。

   カスタムサムネールがビデオに追加されます。

Dynamic Media アセットの Dynamic Media URL の変更

Dynamic Media で処理したビデオは標準のビューアで使用できますが、直接マニフェスト URL にアクセスして独自のカスタムビューアで再生して使用することもできます。次に、ビデオのマニフェスト URL を取得する API を示します。

getVideoManifestURI API について

getVideoManifestURIAPI は cq-scene7-api:com.day.cq.dam.scene7.api を通じて公開され、次のマニフェスト URL を生成するために使用できます。

/**
* Returns the manifest url for videos
* @param resource video resource
* @param manifestType type of video streaming manifest being requested
* @param onlyIfPublished return a manifest only if the video is published
* @return the manifest url for videos
*
* @throws Exception
*/
@Nullable
String getVideoManifestURI(Resource resource, ManifestType manifestType, boolean onlyIfPublished) throws Exception;

getVideoManifestURI API パラメーター

この API では、次の 3 つのパラメーターを取り込みます。

上記のメソッドを使用してビデオのマニフェスト URL を取得するには、ビデオエンコーディングプロファイルを「ビデオのアップロード」フォルダーに追加します。Dynamic Media は、フォルダーに割り当てられたビデオエンコーディングファイルで見つかったエンコーディングに基づいて、これらのビデオを処理します。これで、上記の API を呼び出して、アップロードされたビデオのマニフェスト URL を取得できます。

エラーシナリオ

エラーがある場合、API は null を返します。例外は、Experience Manager エラーログに記録されます。ログに記録されるこれらのエラーは、すべて Could not generate Video Manifest URI で始まります。次のシナリオでは、このようなエラーが発生する可能性があります。

• IllegalArgumentException は、次のいずれかに関してログに記録されます。

  • 渡された resource パラメーターが null である。
  • 渡された resource パラメーターがビデオではない。
  • 渡された manifestType パラメーターが null である。
  • onlyIfPublished パラメーターは true として渡されたものの、ビデオが公開されていない。
  • Dynamic Media のアダプティブビデオセットを使用してビデオが取り込まれていない。

• IOException は、Dynamic Media への接続で問題が発生した場合にログに記録されます。

• 渡された manifestType パラメーターが ManifestType.DASH であり、ビデオが DASH 形式で処理されていない場合、UnsupportedOperationException がログに記録されます。

以下は、HTTPWhiteBoard 仕様で記述されたサーブレットを使用した上記の API の例です。コード構文の各タブを選択します。

dependency>
     <groupId>com.day.cq.dam</groupId>
     <artifactId>cq-scene7-api</artifactId>
     <version>5.12.64</version>
     <scope>provided</scope>
</dependency>

@Component
        service = Servlet.class
)
@HttpWhiteboardServletPattern(value = ManifestServlet.SERVLET_PATTERN)
@HttpWhiteboardContextSelect(value = Constants.SERVLET_CONTEXT_SELECTOR)
public class ManifestServlet extends HttpServlet {

   private static final Logger LOGGER = LoggerFactory.getLogger(ManifestServlet.class);

   private final ObjectMapper objectMapper;

    @Reference
    private Scene7Service scene7Service;

   public static final String SERVLET_PATTERN = Constants.VIDEO_API_PREFIX + "/manifestUrl";

   public ManifestServlet() {
         this.objectMapper = new ObjectMapper();
         objectMapper.setSerializationInclusion(JsonInclude.Include.NON_NULL);
   }

   @Override

   protected void doGet(HttpServletRequest request, HttpServletResponse response) throws IOException {
        final ResourceResolver resolver = getResourceResolver(request);
        String assetPath = request.getParameter("assetPath");
        String manifest = request.getParameter("manifestType");
        String onlyIfPublished = request.getParameter("onlyIfPublished");
        Resource resource = resolver.getResource(assetPath);
        response.setCharacterEncoding(StandardCharsets.UTF_8.toString());
        response.setContentType("application/json");
        if(resource == null) {
            LOGGER.info("could not retrieve the resource from JCR");
            error("could not retrieve the resource from JCR", response);
            return;
        }

        String manifestUri = null;

        try{
            ManifestType manifestType =  ManifestType.DASH;
            if(manifest != null) {
                manifestType = ManifestType.valueOf(manifest);
            }
            manifestUri = scene7Service.getVideoManifestURI(resource, manifestType, onlyIfPublished != null);
            objectMapper.writeValue(response.getWriter(), new ManifestUrl(manifestUri));
            response.setContentType("application/json");
        } catch (Exception e) {
            LOGGER.error(e.getMessage(), e);
            error(String.format("Unable to get the manifest url for %s. %s", assetPath, e.getMessage()), response);
        }
    }

    private ResourceResolver getResourceResolver(HttpServletRequest request) {
        Object rr = request.getAttribute(AuthenticationSupport.REQUEST_ATTRIBUTE_RESOLVER);
        if (!(rr instanceof ResourceResolver)) {
            throw new IllegalStateException(
                    "The request does not seem to have been created via Apache Sling's authentication mechanism.");
        } else {
            return (ResourceResolver) rr;
        }
    }

    private void error(String errorMessage, HttpServletResponse response) throws IOException {
        ManifestUrl errorManifest = new ManifestUrl(null);
        errorManifest.setErrorMessage(errorMessage);
        response.setStatus(HttpServletResponse.SC_INTERNAL_SERVER_ERROR);
        objectMapper.writeValue(response.getWriter(), errorManifest);
    }
}

public class ManifestUrl extends VideoResponse {
     String manifestUrl;
     public ManifestUrl(String manifestUrl) {
         this.manifestUrl = manifestUrl;
     }
     public String getManifestUrl() {
         return manifestUrl;
     }
}

public abstract class VideoResponse {
     String errorString;

     public String getErrorString() {
         return errorString;
     }

     public void setErrorMessage(String errorString) {
         this.errorString = errorString;
     }
}

public final class Constants {

     private Constants() {
     }

     public static final String VIDEO_API_PREFIX = "/dynamicmedia/video";
     public static final String SERVLET_CONTEXT_SELECTOR = "(" + HttpWhiteboardConstants.HTTP_WHITEBOARD_CONTEXT_NAME + "=" +
             DMSampleApiHttpContext.CONTEXT_NAME + ")";

 }

public class DMSampleApiHttpContext extends ServletContextHelper {

 public static final String CONTEXT_NAME = "com.adobe.dmSample";
 public static final String CONTEXT_PATH = "/dmSample";

 private final MimeTypeService mimeTypeService;

 private final AuthenticationSupport authenticationSupport;

 /**
  * Constructs a new context that will use the given dependencies.
  *
  * @param mimeTypeService Used when providing mime type of requests.
  * @param authenticationSupport Used to authenticate requests with sling.
  */
 @Activate
 public DMSampleApiHttpContext(@Reference final MimeTypeService mimeTypeService,
                               @Reference final AuthenticationSupport authenticationSupport) {
     this.mimeTypeService = mimeTypeService;
     this.authenticationSupport = authenticationSupport;
 }

 // ---------- HttpContext interface ----------------------------------------
 /**
  * Returns the MIME type as resolved by the <code>MimeTypeService</code> or
  * <code>null</code> if the service is not available.
  */
 @Override
 public String getMimeType(String name) {
     MimeTypeService mtservice = mimeTypeService;
     if (mtservice != null) {
         return mtservice.getMimeType(name);
     }
     return null;
 }

 /**
  * Returns the real context path that is used to mount this context.
  * @param req servlet request
  * @return the context path
  */
 public static String getRealContextPath(HttpServletRequest req) {
     final String path = req.getContextPath();
     if (path.equals(CONTEXT_PATH)) {
         return "";
     }
     return path.substring(CONTEXT_PATH.length());
 }

 /**
  * Returns a request wrapper that transforms the context path back to the original one
  * @param req request
  * @return the request wrapper
  */
 public static HttpServletRequest createContextPathAdapterRequest(HttpServletRequest req) {
     return new HttpServletRequestWrapper(req) {

         @Override
         public String getContextPath() {
             return getRealContextPath((HttpServletRequest) getRequest());
         }

     };

 }

 /**
  * Always returns <code>null</code> because resources are all provided
  * through individual endpoint implementations.
  */
 @Override
 public URL getResource(String name) {
     return null;
 }

 /**
  * Tries to authenticate the request using the
  * <code>SlingAuthenticator</code>. If the authenticator or the Repository
  * is missing this method returns <code>false</code> and sends a 503/SERVICE
  * UNAVAILABLE status back to the client.
  */
 @Override
 public boolean handleSecurity(HttpServletRequest request,
                               HttpServletResponse response) throws IOException {

     final AuthenticationSupport authenticator = this.authenticationSupport;
     if (authenticator != null) {
         return authenticator.handleSecurity(createContextPathAdapterRequest(request), response);
     }

     // send 503/SERVICE UNAVAILABLE, flush to ensure delivery
     response.sendError(HttpServletResponse.SC_SERVICE_UNAVAILABLE,
             "AuthenticationSupport service missing. Cannot authenticate request.");
     response.flushBuffer();

     // terminate this request now
     return false;
 }
}

サンプルサーブレットの使用

このサーブレットを呼び出すには、/dmSample/dynamicmedia/video/manifestUrl で GET 操作を実行します。次のクエリパラメーターが渡されます。

この例では、次の設定を考えます。

• 会社は samplecompany です。
• オーサリングインスタンスは http://sample-aem-author.com です。
• フォルダー /content/dam/video-example には、ビデオエンコーディングプロファイルが適用されています。
• ビデオ scenery.mp4 がフォルダー /content/dam/video-example にアップロードされています。

サーブレットは、次の方法で呼び出すことができます。

Business.Adobe.com リソース

Cms Cloud Responsive Forms Web Content Management Dynamic Media Content Management Content Management System