エンコードのシナリオ ベースの移行ガイダンス

  • [アーティクル]

移行ガイドのロゴ

移行の手順 2

重要

V2 API の廃止は Azure Media Services の廃止に合わせるために、Azure Media Service v2 から v3 に移行する必要はなくなりました。 詳細については、 Azure Media Services 廃止ガイド を参照してください。

この記事では、Azure Media Services v2 から v3 への移行に役立つエンコード シナリオベースのガイダンスを提供します。

前提条件

エンコード ワークフローの変更を開始する前に、ストレージの管理方法の違いを理解しておく必要があります。 AMS V3 では、Azure Storage API は、Media Services アカウントに関連付けられているストレージ アカウントを管理するために使用されます。

注意

v2 で作成されたジョブやタスクは、変換に関連付けられていないため v3 では表示されません。 v3 の変換およびジョブに切り替えることをお勧めします。

エンコード ワークフローの比較

V2 と V3 のエンコード ワークフローを視覚的に比較するために、次のフローチャートを数分で調べてみましょう。

V2 のエンコード ワークフロー

次の画像をクリックすると、より大きなバージョンが表示されます。

V2 のエンコード ワークフロー

  1. セットアップ
    1. 資産を作成するか、または既存の資産を使用します。 新しい資産を使用している場合は、コンテンツをその資産にアップロードします。 既存の資産を使用している場合は、その資産内に既に存在するファイルをエンコードする必要があります。
    2. 次の項目の値を取得します。
      • メディア プロセッサ ID またはオブジェクト
      • 使用するエンコーダーのエンコーダー文字列 (名前)
      • 新しい資産の資産 ID、または既存の資産の資産 ID
    3. 監視のために、ジョブまたはタスク レベルの通知サブスクリプションか、SDK イベント ハンドラーのどちらかを作成します。
  2. 1 つまたは複数のタスクを含むジョブを作成します。 各タスクには、上の項目と次の項目が含まれている必要があります。
    • 出力資産を作成する必要のあるディレクティブ。 この出力資産は、システムによって作成されます。
    • 出力資産の省略可能な名前
  3. ジョブを送信します。
  4. ジョブを監視します。

V3 のエンコード ワークフロー

V3 のエンコード ワークフロー

  1. 設定
    1. 資産を作成するか、または既存の資産を使用します。 新しい資産を使用している場合は、コンテンツをその資産にアップロードします。 既存の資産を使用している場合は、その資産内に既に存在するファイルをエンコードする必要があります。 "その資産にさらにコンテンツをアップロードすることはやめてください。 "
    2. 出力アセットを作成する。 この出力資産は、エンコードされたファイルや入力および出力メタデータが格納される場所です。
    3. 次の変換の値を取得します。
      • Standard Encoder プリセット
      • AMS リソース グループ
      • AMS アカウント名
    4. 変換を作成するか、または既存の変換を使用します。 変換は再利用可能です。 ジョブを送信するたびに新しい変換を作成する必要はありません。
  2. ジョブの作成
    1. ジョブについて、次の項目の値を取得します。
      • 変換名
      • 資産の SAS URL のベース URI、ファイル共有の HTTP ソース パス、またはファイルのローカル パス。 JobInputAsset では、入力として資産名を使用することもできます。
      • ファイル名
      • 出力資産
      • リソース グループ
      • AMS アカウント名
  3. ジョブを監視するために Event Grid を使用します。
  4. ジョブを送信します。

V2 から V3 エンコードへのカスタム プリセット

V2 コードでカスタム プリセットを使用して Standard Encoder を呼び出した場合は、ジョブを送信する前に、まず、カスタム Standard Encoder プリセットを使用して新しい変換を作成する必要があります。

カスタム プリセットは現在 JSON であり、XML ベースではなくなりました。 Transform Open API (Swagger) のドキュメントで定義されているカスタム プリセット スキーマに従って、JSON でプリセットを再作成します。

エンコード ジョブからの入力および出力メタデータ ファイル

v2 では、XML の入力と出力のメタデータ ファイルは、エンコード ジョブの結果として生成されます。 v3 では、メタデータの形式が XML から JSON に変更されました。 メタデータの詳細については、「入力メタデータ」および「出力メタデータ」を参照してください。

Premium Encoder から v3 Standard Encoder またはパートナー ベースのソリューションへ

v2 API では、Premium Encoder がサポートされなくなりました。 以前に HEVC エンコードにワークフロー ベースの Premium Encoder を使用していた場合は、HEVC エンコードのサポートを含む新しい v3 Standard Encoder に移行する必要があります。

Premium Encoder の高度なワークフロー機能が必要な場合は、Imagine Communications、Telestream、または Bitmovin からの Azure の高度なエンコード パートナー ソリューションの使用を開始することをお勧めします。

HTTPS でホストされた URL に入力が存在するジョブ

現在は、HTTP(S) のジョブ入力サポートを使用して、Azure ストレージ、ローカル、または外部 Web サーバーに格納されているファイルから V3 でジョブを送信できます。

以前に、ジョブを送信する前にワークフローを使用して Azure BLOB ファイルから空の資産にファイルをコピーした場合は、Azure BLOB ストレージ内のファイルの SAS URL を直接ジョブに渡すことによってそのワークフローを簡略化できる可能性があります。

新しい AudioAnalyzer "基本モード" へのインデクサー v1 の音声の文字起こし

v2 API でインデクサー v1 プロセッサを使用している顧客の場合は、ジョブを送信する前に、基本モードで新しい AudioAnalyzer を呼び出す変換を作成する必要があります。

エンコード、変換、ジョブの概念、チュートリアル、ハウツー ガイド

ヘルプとサポート

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

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