一般的なトラブルシューティング戦略の概要

  • [アーティクル]

通話中に十分なエクスペリエンスを確保するには、多くの要素が連携して動作する必要があります。

  • 安定したネットワークとハードウェア環境
  • 優れたユーザー インターフェイス設計
  • 現在の状態とエラーに関するユーザーへのタイムリーなフィードバック

ユーザーから報告された問題のトラブルシューティングを行うには、問題の発生元を特定することが重要です。 この問題は、アプリケーション、SDK、またはデバイス、ネットワーク、ブラウザーなどのユーザーの環境内にある可能性があります。

この記事では、問題の根本原因を効率的に特定するのに役立つデバッグ戦略について説明します。

ユーザーから報告された問題の明確化

まず、ユーザーによって報告された問題を明確にする必要があります。

ユーザーが問題を報告する際、問題を正確に説明できない場合があるため、あいまいさが生じる可能性があります。 たとえば、通話中に遅延が発生したとユーザーが報告した場合、それは通話が接続された後かつ音声が聞こえる前の遅延を指している可能性があります。 あるいは、互いに通信している 2 者間で発生した遅延を指している場合もあります。

これらの 2 つの状況は異なり、問題を特定して解決するには異なるアプローチが必要です。 ユーザーから多くの情報を収集して問題を理解し、適宜対処することが重要です。

問題が発生した頻度とユーザー数の把握

ユーザーが問題を報告した場合は、その再現性を把握する必要があります。 1 回だけ発生した場合と常に発生する場合では、状況が異なります。

一部の問題については、通話診断ツールと Azure Monitor ログを使用して、同様の問題が発生する可能性のあるユーザー数を把握することもできます。

問題の再現性と影響を受けるユーザー数を把握することで、問題の優先順位を決定できます。

ドキュメントの参照

Azure Communication Services Calling SDK のドキュメントは豊富で、概要ドキュメント、クイックスタート ガイド、チュートリアル、既知の問題、トラブルシューティング ガイドなど、多くのテーマを網羅しています。

既知の問題とサービスの制限に関するページを慎重に確認してください。 ユーザーが報告する問題は、サービス自体の制限による場合もあります。 大規模な会議中に表示できるビデオの数が良い例です。 問題の原因として、ユーザーのブラウザーまたはそのデバイスの動作が考えられます。

たとえば、モバイル ブラウザーがバックグラウンドで動作している場合や、ユーザーの電話がロックされている場合は、プラットフォームによってさまざまな動作を示すことがあります。 ブラウザーはビデオ フレームの送信を完全に停止したり、黒いフレームだけを送信したりする可能性があります。

特にトラブルシューティング ガイドでは、ACS Calling SDK の使用時に発生する可能性のあるさまざまな問題に対処しています。 トラブルシューティング ガイドで一般的な問題のリストを確認して、ユーザーによって報告された同様の問題があるかどうかを確認し、手順に従って問題の詳細なトラブルシューティングを行うことができます。

問題をレポートする

ユーザーから報告された問題がトラブルシューティング ガイドに存在しない場合は、問題の報告を検討します。

ほとんどの場合、問題の明確な説明と共に callId を指定する必要があります。 問題を再現できる場合は、問題に関連する詳細を含めます。 たとえば、

  • 前提条件 (プラットフォーム、ネットワーク条件、役に立つ可能性があるその他の情報) を含む、問題を再現するための手順
  • 想定される結果
  • 実際に表示される結果
  • 問題の再現率

詳細については、「問題の報告」を参照してください。

次のステップ

トラブルシューティング ガイドに加えて、役に立つ記事を紹介します。