Share via

Media Services の Tracks API

  • [アーティクル]

Media Services ロゴ v3

警告

Azure Media Services は、2024 年 6 月 30 日に廃止されます。 詳細については、「 AMS 廃止ガイド」を参照してください。

Media Services アセットには、関連付けられている Azure ストレージ アカウント内のメディア ファイルが含まれています。 これらのファイルには、オーディオ、ビデオ、テキストトラックのデータが含まれています。 トラック API を使用すると、資産内のトラックを理解して管理できます。 トラックは、DASH または HLS ビデオ プレーヤーによって使用され、オーディオ、ビデオ、字幕またはキャプション (テキスト) を対象ユーザーに提示します。 Media Services ストリーミング エンドポイントは、要求時に DASH マニフェストまたは HLS プレイリストを介してトラックに関する情報をプレーヤーに通信します。

Tracks API を使用すると、次のことができます。

  • 資産内のオーディオ、ビデオ、テキストのトラックの一覧を取得します。
  • テキスト トラックを追加または削除します。
  • オーディオ トラックを追加または削除します。
  • テキストトラックまたはオーディオトラックのアクセシビリティ属性を指定します。
  • Azure portalでトラックを編集するか、ダウンロードしてアセットにアップロードし直します。
  • ビデオ プレーヤーでテキスト トラックを表示または非表示にします。

Note

ビデオ オンデマンド (VOD) アセットに対してのみテキスト トラックを追加または更新できます。 また、ライブ ストリーミング資産では、オーディオ遅延バインディングはサポートされていません。

テキスト トラック

ローカルで生成されたメディアでのテキスト トラックの使用

ビデオをローカルで作成し、キャプションをエクスポートしたら、オンデマンド メディアを含むアセットにキャプションをアップロードできます。

ローカルで生成されたテキストでテキスト トラックを使用するための一般的なワークフロー:

  1. ビデオを作成し、キャプションを VTT または TTML 形式のファイルにエクスポートします。
  2. VTT または TTML ファイルを翻訳または編集し、次の目的でコピーを保存します。
    1. アクセシビリティ要件を満たす説明テキストを含む追加言語のトラック。
    2. 監督の解説のための追加テキストのトラック。
  3. 重要: クライアント プレーヤーに表示する正しい言語の言語指定子を VTT ヘッダーに追加する必要があります。 例:
    WEBVTT
Language: en-us
  4. ビデオを Media Services にアップロードします。
  5. ビデオをエンコードする変換とジョブを作成します。
  6. 追加のテキスト トラックをアップロードします。

ライブ文字起こしでテキスト トラックを使用する

ライブ イベントでライブ文字起こしを有効にすると、ライブ ビデオ プレーヤーで視聴者に表示されるリアルタイムのライブ文字起こしトラックに加えて、追加の WebVTT テキスト トラックが作成されます。 この WebVTT ファイルには、部分的なリアルタイムの結果ではなく、完全な文を含むライブ トランスクリプトの最適なバージョンが含まれています。 トランスクリプト全体を使用でき、ライブ出力が削除された後に、.vtt ファイルをダウンロードできます。

警告

最終的に自動生成されたライブ文字起こし VTT ファイルは、処理のために遅延されます。 ライブ出力を削除する前に数分間待たなければ、ファイル内のコンテンツは切り詰められます。 さらに、ライブ文字起こしは、ライブ イベントの複数の入力ストリームで使用することはできません。

ライブ文字起こしテキスト トラックを使用するための一般的なワークフロー:

  1. ライブ文字起こしが有効で、ソース言語が選択されたライブ イベントを作成します。
  2. ライブ イベントが終了したら、数分待ってから、ライブ出力を削除します。 アーカイブされた資産は、オンデマンド ストリーミングで使用できます。 有効なストリーミング URL は、視聴者が引き続きアクセスできます。
  3. アーカイブされた資産のトラックを一覧表示するか、ポータルで表示します。 NBest 文字起こしを含む WebVTT ファイルがあります。 拡張子は .vtt です。 ファイルの名前は auto-generated-best_XXX.vtt です。
  4. Azure portalで VTT ファイルを編集するか、ダウンロードして編集します。
  5. 複数の言語でテキスト トラックを表示するには、ソース テキスト トラックをそれらの言語に翻訳し、.vtt 拡張子を使用して言語ごとに個別のファイルとして保存します。
  6. ソース言語トラックと各言語のテキスト トラックをアップロードします。
  7. Azure portalを使用してファイルをアップロードしない場合は、.ism ファイルを編集 (または更新) して、使用するテキストトラックとそのラベル付けと可視性をプレーヤーに伝えます。
    1. Track API を使用して、SDK または CLI のいずれかを使用してマニフェストをプログラムで更新します。
      1. Node.JS
      2. Python
      3. 。ネット
      4. CLI

重要

.ism ファイルを更新するときは、ライブ文字起こしテキスト トラックを非表示にし、ビューアーに適した言語でテキスト トラックを表示してください。

オーディオ トラック

アセットにオーディオ トラックを追加して、さまざまな言語のオーディオを視聴者に提供したり、アクセシビリティのための説明オーディオを追加したり、ディレクターの解説を追加したりできます。

オーディオ トラックの一般的なワークフロー

  1. ライブ イベント用の追加のオーディオ トラックを作成します。 異なる言語のオーディオ、またはアクセシビリティに使用される説明オーディオを指定できます。 また、監督の解説にオーディオトラックを使用することもできます。
  2. アーカイブされたアセットにオーディオ トラックをアップロードします。
  3. ポータルでマニフェスト ファイルを編集するか、REST または SDK を使用してトラック データを更新して、トラック データを更新します。

注意

オーディオまたはテキスト トラックが削除されると、基になるファイルはストレージ コンテナーから削除されません。 Media Services は、動的パッケージャー (ストリーミング エンドポイント) を設定して、ビデオ プレーヤーによって要求されたマニフェストまたはプレイリスト内のトラックに関する情報を表示しないようにします。

Tracks API の詳細な手順については、以下のサンプルを参照してください。

サンプル

ハウツー、チュートリアル、クイックスタート

ヘルプとサポート

Media Services に質問がある場合は、次のいずれかの方法で更新プログラムに従ってください。

  • Q & A
  • Stack Overflow。 質問に タグを付け、 を使用します azure-media-services。
  • @MSFTAzureMedia するか 、@AzureSupport を使用してサポートを要求します。
  • Azure portalからサポート チケットを開きます。