Language

Call.EventDisplayDiagnosticMessage フィールド

定義

ダイヤル アプリがユーザーに表示することを選択できる通話内診断メッセージを報告するために、Telecom スタックから報告されたイベント。

[Android.Runtime.Register("EVENT_DISPLAY_DIAGNOSTIC_MESSAGE", ApiSince=31)]
public const string EventDisplayDiagnosticMessage;
[<Android.Runtime.Register("EVENT_DISPLAY_DIAGNOSTIC_MESSAGE", ApiSince=31)>]
val mutable EventDisplayDiagnosticMessage : string

フィールド値

属性

注釈

ダイヤル アプリがユーザーに表示することを選択できる通話内診断メッセージを報告するために、Telecom スタックから報告されたイベント。 診断メッセージは、デバイスが検出したシナリオを伝えるために使用され、継続的な呼び出しの品質に影響を与える可能性があります。

たとえば、Bluetooth ヘッドセットに関する問題により、ユーザーが代わりにスピーカーフォンを使用しようとしたり、デバイスが不適切なサービスエリアに入ったと検出された場合、ユーザーに警告が表示され、ドロップする前に通話が完了する可能性があります。

診断メッセージは本質的に永続的と見なされます。 たとえば、ユーザーが不適切なサービス領域に入ると、付随する診断メッセージは、サービスが低下した領域から離れるまで保持されます。 各メッセージには、報告される診断条件を一意に識別する #EXTRA_DIAGNOSTIC_MESSAGE_ID が付属しています。 フレームワークは、報告された条件がクリアされたときに #EVENT_CLEAR_DIAGNOSTIC_MESSAGE 型の呼び出しイベントを発生させます。 ダイヤラー アプリは、クリアされるまで診断メッセージを表示する必要があります。 異なる ID (まだクリアされていない) で複数の診断メッセージが送信される場合、ダイヤラー アプリは、最近受信したメッセージに優先順位を付ける必要がありますが、ユーザーに過去のメッセージを確認する手段を提供する必要があります。

メッセージのテキストは、呼び出し UX での表示を目的とした人間が判読できる#EXTRA_DIAGNOSTIC_MESSAGEの形式でCharSequenceで見つかります。

通信フレームワークは、診断メッセージの存在をユーザーに通知するので、ダイヤラー アプリは、メッセージを視覚的に表示することだけに関心を持つ必要があります。

ダイヤラー アプリは、 Call.Callback#onConnectionEvent(Call, String, Bundle)経由でこのイベントを受信します。

Javaドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

適用対象