通話コードとサブコードのエラーについて

Calling SDK とそれぞれのサーバー インフラストラクチャは、統合フレームワークを使用してエラーを表します。 開発者は、エラー コード、サブコード、対応する結果カテゴリを使用して、これらのエラーをより簡単に理解し、発生した理由と今後の軽減方法に関する説明を見つけることができます。 エラー結果に関する詳細は、次のようにして確認できます。

Code: クライアントまたはサーバーの応答の状態を示す 3 桁の整数としてモデル化されています。 これらは次のようにグループ化されます。

  • 成功応答 (200 - 299)
  • クライアント エラー (400 - 499)
  • サーバー エラー (500 - 599)

Subcode: 整数として定義されており、各値はシナリオのグループまたは特定のシナリオの結果に固有の一意の理由を示します。
Message: 結果について説明されており、結果が失敗の場合に問題を軽減する方法のヒントを提供します。
ResultCategory: エラーの種類を示します。 コンテキストに応じて、その値は SuccessExpectedErrorUnexpectedClientError、または UnexpectedServerError になります

重要

この記事で説明されている機能は、現在パブリック プレビュー段階にあります。 このプレビュー バージョンはサービス レベル アグリーメントなしで提供されており、運用環境のワークロードに使用することは推奨されません。 特定の機能はサポート対象ではなく、機能が制限されることがあります。 詳しくは、Microsoft Azure プレビューの追加使用条件に関するページをご覧ください。

通話コードとサブコードのエラーについて

エラー コード、サブコード、および対応する結果カテゴリは、開発者がエラーを特定して診断するのに役立ちます。 これらのエラー コードは、通話の終了後に call.callEndReason プロパティを通じて公開されます。

エラー コードの詳細は次のとおりです。

コード - クライアントまたはサーバーの応答状態を表す 3 桁の整数です。 コード カテゴリ:

  • 成功応答 (200 - 299)
  • クライアント エラー (400 - 499)
  • サーバー エラー (500 - 599)
  • グローバル エラー (600-699)

Subcode: 整数として定義されており、各値はシナリオのグループまたは特定のシナリオの結果に固有の一意の理由を示します。

Message: 結果について説明されており、結果が失敗の場合に問題を軽減する方法のヒントを提供します。

ResultCategory: エラーの種類を示します。 コンテキストに応じて、その値は SuccessExpectedErrorUnexpectedClientError、または UnexpectedServerError になります。

Azure Communication Services Calling SDK クライアントのエラー コードとサブコード

クライアント エラーで、resultCategories プロパティが ExpectedError である場合、そのエラーは SDK の観点から予期されます。 そのようなエラーは一般的に、アプリから正しくない引数が渡された、または現在のシステム状態では API 呼び出しが許可されない場合など、前提条件の失敗において発生します。 アプリケーションでは、エラー理由と API 呼び出しのロジックをチェックする必要があります。

サブコード コード メッセージ 結果カテゴリ 通知
40101 408 CallAgent の作成に失敗しました。 もう一度お試しください。問題が解決しない場合は、ブラウザー コンソール ログと .HAR ファイルを収集し、Azure Communication Services サポートにお問い合わせください。 UnexpectedClientError
40104 408 CallAgent の作成に失敗しました。 もう一度お試しください。問題が解決しない場合は、ブラウザー コンソール ログと .HAR ファイルを収集し、Azure Communication Services サポートにお問い合わせください。 UnexpectedClientError
40114 408 Azure Communication Services インフラストラクチャへの接続に失敗しました。 もう一度お試しいただき、ブラウザーのネットワーク要求をチェックしてください。 要求が失敗し続ける場合は、ブラウザー コンソール ログと .HAR ファイルを収集し、Azure Communication Services サポートにお問い合わせください。 UnexpectedClientError 詳細については、ネットワークの要件に関するページを参照してください。
40115 412 CallAgent の作成に失敗しました。Azure Communication Services インフラストラクチャへの接続を初期化できません。 もう一度お試しいただき、ブラウザーのネットワーク要求をチェックしてください。 要求が失敗し続ける場合は、ブラウザー コンソール ログと .HAR ファイルを収集し、Azure Communication Services サポートにお問い合わせください。 UnexpectedClientError 詳細については、ネットワークの要件に関するページを参照してください。
40216 500 CallAgent の作成に失敗しました。 もう一度お試しください。問題が解決しない場合は、ブラウザー コンソール ログを収集し、Azure Communication Services サポートにお問い合わせください。 UnexpectedClientError
40228 409 CallAgent の作成に失敗しました。この ID に関連付けられた CallAgent のインスタンスは既に存在します。 既存の CallAgent を破棄するか、別の ID で新しく作成してください。 ExpectedError
40230 409 TeamsCallAgent の作成に失敗しました。この ID に関連付けられた TeamsCallAgent のインスタンスは既に存在します。 既存の TeamsCallAgent を破棄してから新しく作成してください。 ExpectedError
40606 405 スピーカーの列挙に失敗しました。Android Chrome、iOS Safari、macOS Safari 上でスピーカーを列挙または選択することはサポートされていません。 ExpectedError スピーカーの列挙や選択は、Android の Chrome、iOS の Safari、macOS の Safari のいずれでもサポートされていません。 オペレーティング システムは、スピーカー (出力デバイス) を自動的に選択します。

デバイス管理と、これらの問題を軽減する最適な方法の詳細についてご確認ください。
40613 400 マイクやカメラの使用に対するアクセス許可の取得に失敗しました。拒否された、または失敗しました。 ブラウザーと OS の設定内でアクセス許可を付与してください。 ExpectedError デバイスのアクセス許可を処理する最適な方法の詳細についてご確認ください。
40614 500 デバイスのアクセス許可の要求に失敗しました。ブラウザー設定内と OS 設定内でアクセス許可を付与してから、もう一度お試しください。 問題が解決しない場合は、ブラウザー コンソール ログを収集し、Azure Communication Services サポートにお問い合わせください。 UnexpectedClientError デバイスのアクセス許可を処理する最適な方法の詳細についてご確認ください。
41006 400 着信通話の受け入れに失敗しました。呼び出し中の状態ではありません。 CallAgent の incomingCall イベントをサブスクライブして、着信通話を受け入れます。 ExpectedError この問題の根本原因を特定するには、次の記事を参照してください
- 着信通話を受信する
- SDK イベントをサブスクライブする
41007 400 着信通話の拒否に失敗しました。呼び出し中の状態ではありません。 CallAgent の incomingCall イベントをサブスクライブして、着信通話を拒否します。 ExpectedError この問題の根本原因を特定するには、次の記事を参照してください
- 着信通話を受信する
- SDK イベントをサブスクライブする
41015 500 マイクのミュートに失敗しました。 もう一度お試しください。この問題が解決しない場合は、ブラウザー コンソール ログを収集し、Azure Communication Services サポートにお問い合わせください。 UnexpectedClientError
41016 400 マイクのミュート解除に失敗しました。 もう一度お試しください。この問題が解決しない場合は、ブラウザー コンソール ログを収集し、Azure Communication Services サポートにお問い合わせください。 UnexpectedClientError
41025 400 ビデオの開始に失敗しました。LocalVideoStream インスタンスが無効または空です。 LocalVideoStream インスタンスを渡してください。 ExpectedError ビデオを開始するために渡されるオブジェクトが LocalVideoStream のインスタンスであることをご確認ください。
VideoDeviceInfo オブジェクトまたは MediaStream オブジェクトを使用して、LocalVideoStream を構築します。

この問題の根本原因を特定するには、次の記事を参照してください。
- ビデオ カメラを使用して呼び出しを行う
- 通話中にローカル ビデオの送信を開始および停止する
- 未加工のビデオにアクセスする
41027 400 ビデオの開始に失敗しました。ビデオは既に開始されています。 ExpectedError 役立つリンク:
- ビデオ カメラを使用して呼び出しを行う
- 通話中にローカル ビデオの送信を開始および停止する
41030 400 ビデオの停止に失敗しました。ビデオは既に停止しています。 ExpectedError 役立つリンク:
- ビデオ カメラを使用して呼び出しを行う
- 通話中にローカル ビデオの送信を開始および停止する
41032 400 ビデオの停止に失敗しました。引数が無効です。 入力として使用される LocalVideoStream は現在送信されていません。 ExpectedError 通話内で送信される LocalVideoStream は Call.localVideoStreams[] 配列内に格納され、その型は Video または RawMedia です。
この問題の根本原因を特定するには、次の記事を参照してください。
- ビデオ カメラを使用して呼び出しを行う
- 通話中にローカル ビデオの送信を開始および停止する
- 未加工のビデオにアクセスする
41033 500 通話の保留に失敗しました。 もう一度お試しください。この問題が解決しない場合は、ブラウザー コンソール ログを収集し、Azure Communication Services サポートにお問い合わせください。 UnexpectedClientError
41034 500 通話の再開に失敗しました。 もう一度お試しください。この問題が解決しない場合は、ブラウザー コンソール ログを収集し、Azure Communication Services サポートにお問い合わせください。 UnexpectedClientError
41035 400 画面共有の開始に失敗しました。画面共有は既に開始されています。 ExpectedError 通話中に画面共有を開始および停止する方法の詳細についてご確認ください
41041 400 画面共有の停止に失敗しました。画面共有は既に停止されています。 ExpectedError 通話中に画面共有を開始および停止する方法の詳細についてご確認ください
41048 410 通話のセットアップ プロセス中にビデオの開始に失敗しました。 ブラウザー設定内と OS 設定内でビデオのアクセス許可を付与し、そのカメラ デバイスが別のプロセスで使用されていないことをご確認ください。 UnexpectedClientError - カメラ デバイスがシステム内で無効になっている可能性があります。
- カメラが別のプロセスで使用されています。
41056 412 通話の開始または参加に失敗しました。この Azure Communication Services リソースに対して Teams Enterprise 音声ポリシーが有効ではありません。 オンラインのチュートリアルに従って有効にしてください。 ExpectedError Teams Enterprise 音声ポリシーを有効にするには、Enterprise Voice オンラインおよび電話システム ボイスメールのユーザーを有効にする方法を参照してください
41071 412 画面共有の開始に失敗しました。通話は接続状態ではありません。 通話の statteChanged イベントをサブスクライブして、通話がいつ接続されるかを確認します。 ExpectedError 役立つリンク:
- 通話のプロパティを確認する
- SDK イベントをサブスクライブする
41073 412 カスタム MediaStream の取得または設定に失敗しました。この機能は現在、Azure Communication Services によって無効になっています。 ExpectedError
43000 412 ビデオの開始に失敗しました。ビデオ デバイスは別のプロセスまたはアプリケーションで使用されています。 カメラが他のプロセスまたはアプリケーション内で使用されないようにして、もう一度お試しください。 ExpectedError 別のプロセスで使用されているカメラに対処する最適な方法の詳細について理解を深めてください
43001 403 ビデオの開始に失敗しました。選択したビデオ デバイスを使用するアクセス許可が許可されていませんでした。 ブラウザー設定内とシステム設定内で、ビデオ デバイスのアクセス許可が付与されていることをご確認ください。 ExpectedError ブラウザー設定とデバイス システム設定内で、カメラのアクセス許可が付与されていることをご確認ください。
デバイス システム設定内でカメラが無効ではないことをご確認ください。
macOS 上では、システム設定から画面記録が許可されていることをご確認ください。

役立つリンク:
- デバイスのアクセス許可を要求する-
macOS での画面共有のアクセス許可
- macOS および iOS 上の Safari でのデバイスの列挙またはアクセス
43002 500 ビデオの開始に失敗しました。不明なエラーです。 やり直してください。 この問題が解決しない場合は、Azure Communication Services サポートにお問い合わせください。 UnexpectedClientError
43004 400 ビデオ デバイスの切り替えに失敗しました。入力が無効です。 入力は VideoDeviceInfo 型である必要があります。 ExpectedError デバイス マネージャーを使用して VideoDeviceInfo オブジェクトの一覧を取得し、VideoDeviceInfo オブジェクトを使用してソースを切り替えます。

通話中にローカル ビデオの送信を開始および停止する方法の詳細についてご確認ください
43005 400 ビデオ デバイスの切り替えに失敗しました。同じビデオ デバイスに切り替えることはできません。既に選択されています。 ExpectedError
43013 412 ビデオの開始に失敗しました。ビデオ デバイスが見つかりませんでした。 ビデオ デバイスの電源が接続されており、システム設定内で有効なことをご確認ください。 ExpectedError デバイス上にカメラが接続され、インストールされていることをご確認ください。
43014 412 ビデオの開始に失敗しました。メディア ストリームを要求中にエラーが発生しました。 もう一度お試しください。問題が解決しない場合は、Azure Communication Services サポートにお問い合わせください。 UnexpectedClientError
43015 412 ビデオの開始に失敗しました。メディア ストリーム要求がタイムアウトしました。ブラウザーのプロンプトに応じてカメラへのアクセス許可を付与し、もう一度お試しください。 ExpectedError このエラーは、ユーザーがブラウザーのアクセス許可プロンプト上で、カメラへのアクセスを付与するアクションを実行しない場合に発生することがあります。
43016 412 ビデオの開始に失敗しました。アクセス許可はシステムによって拒否されました。 ブラウザー設定内とシステム設定内で、ビデオ デバイスのアクセス許可が付与されていることをご確認ください。 ExpectedError - ブラウザー設定とデバイス システム設定内で、カメラのアクセス許可が付与されていることをご確認ください。
- デバイス システム設定内でカメラが無効ではないことをご確認ください。
- macOS 上では、システム設定から画面記録が許可されていることをご確認ください。

役立つリンク:
- デバイスのアクセス許可を要求する
-macOS での画面共有のアクセス許可
- macOS および iOS 上の Safari でのデバイスの列挙またはアクセス
43017 412 ビデオの開始に失敗しました。サポートされていないストリームです。 もう一度お試しください。問題が解決しない場合は、Azure Communication Services サポートにお問い合わせください。 UnexpectedClientError
43018 412 ビデオの開始に失敗しました。制約の設定に失敗しました。 もう一度お試しください。問題が解決しない場合は、Azure Communication Services サポートにお問い合わせください。 UnexpectedClientError ビデオの制約を設定する方法の詳細についてご確認ください
43019 412 ビデオの開始に失敗しました。デバイスが選択されていません。 VideoDeviceInfo を使用して作成された LocalVideoStream を確実に渡して、もう一度お試しください。 問題が解決しない場合は、Azure Communication Services サポートにお問い合わせください。 UnexpectedClientError 役立つリンク:
- ビデオ カメラを使用して呼び出しを行う
- 通話中にローカル ビデオの送信を開始および停止する
43200 412 ビデオ ストリームのレンダリングに失敗しました。このストリームは使用できません。 ストリームの isAvailable プロパティをサブスクライブし、リモート参加者がビデオをオンにして、かつストリームがレンダリングに使用できる際に通知を受け取ってください。 ExpectedError 役立つリンク:
- リモート参加者の動画/画面共有ストリームをレンダリングする
- アプリに 1 対 1 のビデオ通話を追加する
- SDK イベントをサブスクライブする
43202 404 ビデオ ストリームのレンダリングに失敗しました。このストリームは使用できなくなりました。 リモート参加者がビデオをオフにしました。 ExpectedError リモート参加者が、そのビューの作成中にビデオをオフにしました。
43203 408 ビデオ ストリームのレンダリングに失敗し、ビデオ フレームの待機中にレンダリングがタイムアウトしました。 もう一度お試しください。問題が解決しない場合は、Azure Communication Services サポートにお問い合わせください。 UnexpectedClientError
43204 500 ビデオ ストリームのレンダリングが失敗し、Azure Communication Services インフラストラクチャ上でビデオのサブスクライブに失敗しました。 もう一度お試しください。問題が解決しない場合は、Azure Communication Services サポートにお問い合わせください。 UnexpectedClientError
43209 405 ビデオ ストリームのレンダリングに失敗し、初期化プロセス中に VideoStreamRenderer が破棄されました。 ExpectedError
43210 400 VideoStreamRenderer の破棄に失敗しました。既に破棄されています。 ExpectedError
43220 400 ビューの作成に失敗しました。アクティブな RemoteVideoStream ビューの最大数に既に達しています。 新しく作成するためには、以前のものを破棄してください。 ExpectedError 受信ビデオ ストリームの最適な数を適切にサポートする方法の詳細についてご確認ください
480 リモート クライアント エンドポイントが登録されていません。 リモート エンドポイントが使用可能であることを確認します。
481 着信通話の処理に失敗しました。 Azure portal からサポート リクエストを提出します。
487 エンドポイントの不一致の問題が原因で通話がキャンセルされたか、ローカルで拒否されたか、終了しました。または、メディア プランの生成に失敗しました。 想定されている動作です。
490、491、496、497、498 ローカル エンドポイント ネットワークの問題。 ネットワークを確認します。
503、504 Communication Services インフラストラクチャ エラー。 Azure portal からサポート リクエストを提出します。
600 どこでも通話中です。 参加者は正常に接続しましたが、通話中のシグナルが返されました。 想定されている動作です。
603 Communication Services のリモート参加者によって、通話がグローバルに拒否されました。 想定されている動作です。
604 どこにも存在しません。 要求された URI が存在しません。 想定されている動作です。
606 受信不可。 参加者は正常に接続されましたが、説明されているセッションをサポートできません。 想定されている動作です。

通話コードとサブコードのエラーについて

エラー コード、サブコード、および対応する結果カテゴリは、開発者がエラーを特定して診断するのに役立ちます。 これらのエラー コードは、通話の終了後に call.callEndReason プロパティを通じて公開されます。

エラー コードの詳細は次のとおりです。

コード - クライアントまたはサーバーの応答状態を表す 3 桁の整数です。 コード カテゴリ:

  • 成功応答 (200 - 299)
  • クライアント エラー (400 - 499)
  • サーバー エラー (500 - 599)
  • グローバル エラー (600-699)

Subcode: 整数として定義されており、各値はシナリオのグループまたは特定のシナリオの結果に固有の一意の理由を示します。

Message: 結果について説明されており、結果が失敗の場合に問題を軽減する方法のヒントを提供します。

ResultCategory: エラーの種類を示します。 コンテキストに応じて、その値は SuccessExpectedErrorUnexpectedClientError、または UnexpectedServerError になります。

通話終了コードとサブコードの呼び出し

通話が終了した理由については、さまざまな説明があります。 通話の終了コードと、通話がどのように終了したかを示すサブコードの意味を次に示します。

サブコード コード メッセージ 結果カテゴリ 通知
0 0 通話は、ローカル参加者によって正常に終了されました。 成功
0 487 通話は、呼び出し元が通話を取り消したために正常に終了しました。 成功
0 603 通話は、呼び出し先から拒否されたため正常に終了しました。 成功
3100 410 クライアントで予期しないネットワークの問題が発生したため、呼び出しのセットアップに失敗しました。クライアントのネットワークを確認して再試行してください。 UnxpectedClientError - サポート対象の環境で最新の SDK を使っていることを確認します。
3101 410 クライアントの予期しないネットワークの問題が原因で通話が切断されました。クライアントのネットワークを確認して再試行してください。 UnxpectedClientError
3112 410 クライアント側のネットワーク構成の問題が原因で呼び出しのセットアップに失敗しました。クライアントのネットワーク構成を確認してから、再試行してください。 ExpectedError
4097 0 通話は、会議の開催者によってすべてのユーザーについて終了されました。 成功
4507 495 通話は、アプリケーションが有効な Azure Communication Services トークンを提供しなかったために終了しました。 UnexpectedClientError アプリケーションでトークン更新メカニズムが正しく実装されていることを確認します。
4521 0 ユーザーが通話から突然切断されたため、通話は終了しました。 これは、ユーザーが通話をホストしているアプリケーションを閉じたことが原因である可能性があります。たとえば、ユーザーが通話を切るための適切な操作をせずに、ブラウザー タブを閉じてアプリケーションを終了した場合などです。 ExpectedError
5000 0 この参加者の通話は終了しました。 参加者が別の参加者によって会話から削除されました。 成功
5003 0 通話は、すべての呼び出し先エンドポイントが通話を拒否したため、正常に終了しました。 成功
5300 0 この参加者の通話は終了しました。 参加者が別の参加者によって会話から削除されました。 成功
5,317 0 参加者ロールの更新のために、ターゲット参加者が削除されます。 ExpectedError
5828 403 ユーザーが招待者リストに含まれていないため、Rooms 会議への参加は承認されません。 UnexpectedClientError
5829 403 会議の終了時刻を過ぎているか、開始時刻より前に Rooms 会議に参加することはできません。 UnexpectedClientError
5830 403 Communication Services ユーザーのみが Rooms 会議に参加できます。 ExpectedError
7000 0 通話は、Azure Communication Services プラットフォームによって終了されました。 成功
10003 487 通話は、このユーザーの別のエンドポイントによって、他の場所で受け入れられました。 成功
10004 487 通話は、タイムアウトで取り消されました。どの呼び出し先エンドポイントも、時間内に受け入れませんでした。 ユーザーが通知を見たことを確認し、その通話をもう一度始めてみてください。 ExpectedError
10024 487 通話は正常に終了しました。 すべての呼び出し先エンドポイントによって通話が拒否されました。 成功 - もう一度通話を行ってみます。
10057 408 通話が失敗し、呼び出し先が通話のセットアップを完了できなかった、呼び出し先がネットワークを失った、またはアプリケーションを突然終了した可能性が一番高いです。 クライアントが接続され、使用可能であることを確認します。 ExpectedError
301005 410 同じインフラストラクチャとのメディア接続が失われたため、Azure Communication Services インフラストラクチャによる通話から参加者が削除されました。 これは通常、参加者が突然通話を終了するか、ネットワーク接続を失った場合に発生します。 参加者が通話を続行する場合は、再接続できます。 UnexpectedClientError サポートされている環境で最新の SDK を使用していることを確認します。
510403 403 通話は終了し、以前はスパムとしてマークされ、現在はブロックされました。 ExpectedError - Communication Services トークンが有効であり、有効期限が切れていないことを確認します。
- 通話オプションで AlternateId を渡していることを確認します。
540487 487 通話は、呼び出し元が通話を取り消したために正常に終了しました。 成功
560000 0 通話は、リモート PSTN 参加者によって正常に終了されました。 成功 考えられる原因:
- ユーザーが通話を終了しました。
- 通話はメディア エージェントによって終了されました。
560486 486 通話は、リモート PSTN 参加者がビジー状態であったため終了しました。 呼び出された番号が既に通話中であったか、技術的な問題が発生していました。
404 通話が見つかりません。 通話先の番号 (または参加している通話) が存在することを確認します。
408 通話コントローラーがタイムアウトしました。 ユーザー エンドポイントからのプロトコル メッセージの待機中に通話コントローラーがタイムアウトしました。 クライアントが接続され、使用可能であることを確認します。
410 ローカル メディア スタックまたはメディア インフラストラクチャ エラー。 サポートされている環境で最新の SDK を使用していることを確認します。
430 クライアント アプリケーションにメッセージを配信できません。 クライアント アプリケーションが実行されていて使用可能であることを確認します。
480 リモート クライアント エンドポイントが登録されていません。 リモート エンドポイントが使用可能であることを確認します。
481 着信通話の処理に失敗しました。 Azure portal からサポート リクエストを提出します。
490、491、496、497、498 ローカル エンドポイント ネットワークの問題。 ネットワークを確認します。
500、503、504 Communication Services インフラストラクチャ エラー。 Azure portal からサポート リクエストを提出します。