Media Services のトラブルシューティング

[アーティクル]
06/30/2023

警告

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

Media Services に関する問題の原因と解決策を示します。

注意

多くの問題は、Media Services v3 API に移行することで、または「ライブストリーミングのベストプラクティスガイド」を参照することで解決できます。

アカウントに関する問題

原因	解決策
v2 アカウントまたは v2 API 実装で v3 API の機能を使用しようとしている可能性があります。	v3 API を使用するようにコードを更新してください。詳細なサポートについては、「移行ガイド」を参照してください。

ビデオ再生に関する一般的な問題

ビデオの再生が開始されるまでに長い時間がかかる。
ビデオの再生が開始されると、ビデオがぼやける。
ビデオの品質が低い。
ビデオがまったく再生されない、または黒い画面が表示される。

原因	解決策
CDN を使用せずに多くの対象ユーザーに配信しようとしている可能性があります。それにより、待機時間の問題が発生しています。	ストリーミングロケーターに CDN を追加してください。 CDN の使用について詳しくは、「CDN 統合を使用してコンテンツをストリーミングする」を参照してください。
ダイナミックパッケージを実装していない可能性があります。	ダイナミックパッケージの実装について詳しくは、「Media Services v3 のダイナミックパッケージ」を参照してください。
"うるさい隣人" と呼ばれるものが存在する可能性があります。つまり、コンピューティングリソースを他のカスタマーと共有しています。	"うるさい隣人" を回避するために、Standard ストリーミングエンドポイントから専用ストリーミングユニットを備えた Premium ストリーミングエンドポイントにアップグレードしてください。
以前のブラウザーを使用してビデオを表示している可能性があります。	ブラウザーをアップグレードしてください。
サードパーティ製のプレーヤーとフィルターを使用している可能性があります。	ストリーミング URL に `audio-only=false` を追加してください (例: `https://streamingtest.streaming.media.azure.net/00000000-0000-0000-0000-000000000000/sample.ism/manifest(format-m3u8-aapl,audio-only=false)`)

アセットから MP4 ファイルを再生できない

原因	解決策
Azure Media Services は、フルサイズの MP4 ストリームを直接再生するように設計されておらず、マニフェストファイルを使用するように設計されています。マニフェストファイルにより、どのエンコード済みメディアフラグメントをどの順番で再生するかがプレーヤーに伝えられます。	提供されているメディアエンコーダーのいずれかを使用して、メディアフラグメントとマニフェストファイルを作成してください。エンコードについて詳しくは、「コンテンツに対応したエンコード」と「自動生成されたビットレートラダーでエンコードする」を参照してください。
ファイル名に予約文字が含まれています。	ファイル名から予約文字を削除します。

予約文字

Media Services は、ストリーミングコンテンツの URL を構築する際に、アセットファイル名の値を使用します。このため、パーセントエンコーディングは利用できません。 name プロパティの値には、パーセントエンコード予約文字 (!*'();:@&=+$,/?%#[]" のいずれかを指定することはできません。また、ファイル名拡張子で使用できる "." は 1 つのみです。
名前は 260 文字以内で指定する必要があります。

暗号化されたコンテンツがオフラインモードで再生されない。

原因	解決策
ダウンロードした AES で暗号化されたビデオを、iOS デバイスでオフラインモードで再生する場合、その再生のために使用するプレーヤーが、それらのビデオの再生方法に対処します。原因は Media Services ではありません。	選択したオフラインビデオプレーヤーのドキュメントを確認してください。

オーディオが同期されない。

原因	解決策
ビデオパケットの配信が遅延している。	考えられる解決策: 1. ストレージのバージョン管理ポリシーを実装していて、それが自動的にオンになり、それが原因でバッファリングと切断が発生している可能性があります。このポリシーを削除し、ストレージの自動バージョン管理をオフにします。 2. CDN を有効にします。 3. 十分な予約ユニットを備えた Premium ストリーミングエンドポイントを使用します。

原因

解決策

ビデオパケットの配信が遅延している。

考えられる解決策:

1. ストレージのバージョン管理ポリシーを実装していて、それが自動的にオンになり、それが原因でバッファリングと切断が発生している可能性があります。このポリシーを削除し、ストレージの自動バージョン管理をオフにします。
2. CDN を有効にします。
3. 十分な予約ユニットを備えた Premium ストリーミングエンドポイントを使用します。

VTT ファイルのプレーヤー要求が原因で CORS エラーが発生した。

原因	解決策
CORS ルールの設定	ストレージアカウントまたは CDN に対して CORS ルールを設定してください。

また、アセットから VTT ファイルのダウンロード URL を取得することもできます。

ストリーミングエンドポイントが開始されない。

原因	解決策
HTTPS のみを有効にするカスタムポリシーを作成している可能性があります。これは、Media Services では現在サポートされていません。	考えられる回避策: 1. Azure portal で、カスタムポリシーを無効にします。 2. CDN が有効化されたストリーミングエンドポイントを作成し、CDN エンドポイントの HTTP を無効にします。 Or 1. ポータルまたは API を使用して、ストリーミングエンドポイントの CDN を有効にしないでください。 2. 代わりに、Azure portal の Azure CDN ページに移動するか、Azure CDN API を使用して、Media Services エンドポイントを指すエンドポイントを作成し、CDN エンドポイントの配信元をストリーミングエンドポイントのホスト名に設定します。
CDN を備えたストリーミングエンドポイントを停止している可能性があります。	ストリーミングエンドポイントが停止しないことについて説明した項目を参照してください

原因

解決策

HTTPS のみを有効にするカスタムポリシーを作成している可能性があります。これは、Media Services では現在サポートされていません。

考えられる回避策:
1. Azure portal で、カスタムポリシーを無効にします。
2. CDN が有効化されたストリーミングエンドポイントを作成し、CDN エンドポイントの HTTP を無効にします。
Or
1. ポータルまたは API を使用して、ストリーミングエンドポイントの CDN を有効にしないでください。
2. 代わりに、Azure portal の Azure CDN ページに移動するか、Azure CDN API を使用して、Media Services エンドポイントを指すエンドポイントを作成し、CDN エンドポイントの配信元をストリーミングエンドポイントのホスト名に設定します。

CDN を備えたストリーミングエンドポイントを停止している可能性があります。

ストリーミングエンドポイントが停止しないことについて説明した項目を参照してください

CDN を備えたストリーミングエンドポイントが停止しない。

原因	解決策
ストリーミングエンドポイントに対して CDN を有効にした場合、ストリーミングエンドポイントを開始するまで、CDN エンドポイントは作成されません。この理由は、開始プロセス中に、プラットフォームによって CDN エンドポイントが作成され、ストリーミングエンドポイントにリンクされるためです (これにはカスタムホスト名の構成が含まれます)。ストリーミングエンドポイントの停止プロセス中に、プラットフォームによって CDN エンドポイントは必ず削除されます。したがって、ストリーミングエンドポイントが停止状態の場合、CDN エンドポイントは存在しないか、またはストリーミングエンドポイントを指していません。ただし、一部のシナリオで、AMS が CDN を呼び出して CDN エンドポイントを削除した場合、CDN 上のキャッシュが原因でエンドポイントの削除が失敗します。これにより、CDN エンドポイントがまだ存在する場合はホスト名の競合の問題が発生し、ストリーミングエンドポイントの停止の問題がトリガーされます。	CDN プロファイルを手動で削除し、その後ストリーミングエンドポイントを削除し、新しいストリーミングエンドポイントを設定してください。

原因

解決策

ストリーミングエンドポイントに対して CDN を有効にした場合、ストリーミングエンドポイントを開始するまで、CDN エンドポイントは作成されません。この理由は、開始プロセス中に、プラットフォームによって CDN エンドポイントが作成され、ストリーミングエンドポイントにリンクされるためです (これにはカスタムホスト名の構成が含まれます)。

ストリーミングエンドポイントの停止プロセス中に、プラットフォームによって CDN エンドポイントは必ず削除されます。したがって、ストリーミングエンドポイントが停止状態の場合、CDN エンドポイントは存在しないか、またはストリーミングエンドポイントを指していません。

ただし、一部のシナリオで、AMS が CDN を呼び出して CDN エンドポイントを削除した場合、CDN 上のキャッシュが原因でエンドポイントの削除が失敗します。これにより、CDN エンドポイントがまだ存在する場合はホスト名の競合の問題が発生し、ストリーミングエンドポイントの停止の問題がトリガーされます。

CDN プロファイルを手動で削除し、その後ストリーミングエンドポイントを削除し、新しいストリーミングエンドポイントを設定してください。

アカウントを別のサブスクリプションに移動した後、ストリーミングエンドポイントが表示されない。

原因	解決策
ストリーミングエンドポイントが新しいサブスクリプションに移動されるまで、多少時間がかかります。	2 時間待ってから、ストリーミングエンドポイントが新しいサブスクリプションに表示されることを確認してください。

オンプレミスエンコーダーがライブイベントにデータを送信しない。

原因	解決策
Media Services でテストされていないエンコーダーを使用している可能性があります。	「検証済みのオンプレミスライブストリーミングエンコーダー」を参照してください。
オンプレミスエンコーダーが正しく構成されていない可能性があります。	正しくオンプレミスエンコーダーを構成していることを確認してください。

エンコードに長い時間がかかる。

エンコード期間に関するほとんどの問題は、速度と品質のバランスを制御するエンコーダー設定を構成することで解決できます。エンコードを高速化するには、エンコードを "速度" モードに設定します。

原因	解決策
中間ファイルが非常に大きい可能性があります。ファイルサイズは、ビットレートに期間を掛けた値に等しくなります。	なし
多数の出力レイヤーがある。	出力レイヤーの数を減らしてください。
出力レイヤーの解像度が高い。	出力レイヤーの解像度を、メディアをストリーミングするビットレートまで減らしてください。
中間ファイルが複雑になっている可能性があります (特に 4K 解像度ファイルをエンコードしている場合)。	なし

変換に関するエラー

原因	解決策
アカウントあたりの変換のクォータ (100) を超えた可能性があります。	未使用の変換を削除してください。

メディアをアップロードできない

メディアをストレージアカウントにアップロードできない。

原因	解決策
HTTP を使用しようとしている。	HTTPS を使用する。 HTTP プロトコルは、コンテンツのアップロードではサポートされなくなりました。
ストレージアカウントがデプロイされるまで、十分長い時間待機していない。	ストレージアカウントをプログラムで作成する場合は、メディアのアップロードを試みる前にストレージアカウントがデプロイされたかテストするコードを追加してください。

CORS に関する問題

原因	解決策
トレースペアレントヘッダーを含むプレフライト要求を使用しようとすると、CORS エラーが発生します。現時点では、Media Services はプレフライト要求をサポートしていません。	Microsoft は、プレフライト要求がお客様にとって価値があると認識しています。プレフライト要求の機能が使用可能になるまで、プレフライト要求は使用しないでください。

ストレージアカウント接続に関する問題

切断状態

Media Services アカウントの「切断」状態は、ストレージアクセスキーの変更が原因で、そのアカウントが、アタッチされたストレージアカウントのうちの 1 つ以上にアクセスできなくなったことを示します。アカウント内の多くのタスクを実行するには、Media Services に最新のストレージアクセスキーが必要です。

アタッチされたストレージアカウントに Media Services アカウントがアクセスできなくなる主なシナリオを次に示します。

原因	解決策
Media Services アカウントまたはアタッチされたストレージアカウントが別々のサブスクリプションに移行された。	ストレージアカウントまたは Media Services アカウントがすべて同じサブスクリプションに含まれるように、これらのアカウントを移行してください。また、ストレージアカウントが同じテナントにある場合は、ストレージアカウント認証にマネージド ID を使用してください。
Media Services アカウントは、これがサポートされていたのが初期の Media Services アカウントであったため、別のサブスクリプションのアタッチされたストレージアカウントを使用している。初期の Media Services アカウントはすべて最新の Azure Resources Manager ベースのアカウントに変換されたので、切断状態になります。	ストレージアカウントまたは Media Services アカウントがすべて同じサブスクリプションに含まれるように、これらのアカウントを移行してください。また、ストレージアカウントが同じテナントにある場合は、ストレージアカウント認証にマネージド ID を使用してください。

原因

解決策

Media Services アカウントまたはアタッチされたストレージアカウントが別々のサブスクリプションに移行された。

ストレージアカウントまたは Media Services アカウントがすべて同じサブスクリプションに含まれるように、これらのアカウントを移行してください。また、ストレージアカウントが同じテナントにある場合は、ストレージアカウント認証にマネージド ID を使用してください。

Media Services アカウントは、これがサポートされていたのが初期の Media Services アカウントであったため、別のサブスクリプションのアタッチされたストレージアカウントを使用している。初期の Media Services アカウントはすべて最新の Azure Resources Manager ベースのアカウントに変換されたので、切断状態になります。

Media Services アカウントがストレージアカウントにアクセスできない

原因	解決策
Media Services マネージド ID には、ストレージ BLOB データ共同作成者ロールが付与されていません。	Azure Portal でこれを確認するには、まず Media Services アカウントのメニューから [ストレージアカウント] を選択してストレージアカウントに設定されている ID を確認します。これは、"システム割り当て" またはユーザー割り当てマネージド ID の名前である必要があります。次に、ポータルで [ストレージアカウント] に移動し、メニューから [アクセス制御 (IAM)] を選択し、ツールバーから [ロールの割り当て] を選択し、ロールの割り当てを追加します。ロールの割り当てを追加するときは、ロールを "ストレージ BLOB データ共同作成者" に設定し、メンバーを Media Services アカウントがストレージアカウントにアクセスするために使用するマネージド ID に設定する必要があります。ロールの割り当てを追加した後、変更が有効になるまで数分かかる場合があります。

原因

解決策

Media Services マネージド ID には、ストレージ BLOB データ共同作成者ロールが付与されていません。

Azure Portal でこれを確認するには、まず Media Services アカウントのメニューから [ストレージアカウント] を選択してストレージアカウントに設定されている ID を確認します。これは、"システム割り当て" またはユーザー割り当てマネージド ID の名前である必要があります。次に、ポータルで [ストレージアカウント] に移動し、メニューから [アクセス制御 (IAM)] を選択し、ツールバーから [ロールの割り当て] を選択し、ロールの割り当てを追加します。ロールの割り当てを追加するときは、ロールを "ストレージ BLOB データ共同作成者" に設定し、メンバーを Media Services アカウントがストレージアカウントにアクセスするために使用するマネージド ID に設定する必要があります。ロールの割り当てを追加した後、変更が有効になるまで数分かかる場合があります。

Azure Media Indexer 2 がメディアプロセッサの一覧で返されない。

原因	解決策
Azure Media Indexer 2 は、2020 年 1 月 1 日に非推奨となりました。	Media Services v3 API に移行してください。

ネットワークエラーが原因でビデオのダウンロードが途中で失敗する。

原因	解決策
通常、このエラーの原因はクライアント側でのネットワーク接続の問題であり、Media Services ではありません。	ネットワーク管理者に問い合わせるか、Fiddler または F12 ブラウザーデバッグを使用して、根本的なエラーを確認してください。

ダウンロードに関する問題

次のエラーが表示される場合がある。

"While trying to download the input files, the files were not accessible, please check the availability of the source (入力ファイルをダウンロードしようとしましたが、ファイルにアクセスできませんでした。ダウンロード元が使用可能であることを確認してください)"

原因	解決策
SAS トークンを使用してファイルにアクセスしている場合、そのトークンの有効期限が切れている可能性があります。	コードを調整して、トークンを使用して認証する前にそのトークンの有効期限が切れていないか確認してください。

5xx エラーが過剰かつ断続的に発生する

原因	解決策
オンプレミスのエンコードが正しく実装されていない可能性があります。	エンコーダーが正しく構成されていることを確認してください。
テストされていないオンプレミスエンコーダーを使用している可能性があります	テスト済みのオンプレミスエンコーダーを使用し、そのエンコーダーが正しく構成されていることを確認してください。
ストリーミングエンドポイントと CDN 間のキャッシュ比率が不十分である可能性があります。	1. CDN がより多くのトラフィックを処理するようにキャッシュ比率を調整します。 2. CDN のストリーミング最適化ルールを調整します。
フィルターの構成が正しくない可能性があります。	フィルターが正しく構成されているか確認してください。

「ライブストリーミングのベストプラクティスガイド」を参照してください。

コードに関する一般的なエラー

「ストリーミングエンドポイントのエラーコード」、「ライブイベントのエラーコード」、または「ジョブエラーコード」リファレンスで説明されていないエラーがコードで発生している可能性があります。

原因	解決策
以前のバージョンの API に含まれていないオブジェクト、プロパティ、またはメソッドを使用しようとしている可能性があります。	開発環境で API ライブラリをアップグレードしてください。

問題の解決策が見つからない場合は、Media Services サポートにお問い合わせください。

ヘルプとサポート

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

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