Call.EventDisplayDiagnosticMessage 欄位

[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

欄位值

屬性

RegisterAttribute

備註

從電信堆疊回報事件，以報告通話中診斷訊息，撥號器應用程式可選擇顯示給使用者。 診斷訊息用於傳達裝置偵測到可能影響通話品質的情境。

例如，藍牙耳機出現問題可能會建議使用者改用免持電話，或者當裝置偵測到進入服務範圍不佳時，可能會收到警告，讓使用者能在通話中斷前完成通話。

診斷訊息被視為具有持久性。 例如，當使用者進入服務品質差的區域時，隨附的診斷訊息會持續出現，直到他們離開服務差區域為止。 每則訊息都附有 a #EXTRA_DIAGNOSTIC_MESSAGE_ID ，唯一識別所報告的診斷狀況。 當報告的狀況已被清除時，框架會觸發一個呼叫 #EVENT_CLEAR_DIAGNOSTIC_MESSAGE 事件。 撥號器應用程式應該會顯示診斷訊息，直到它被清除為止。 如果有多則診斷訊息以不同 ID（尚未被清除）發送，撥號應用程式應優先處理最近收到的訊息，但仍提供使用者查看過去訊息的方式。

訊息的文字以人類可#EXTRA_DIAGNOSTIC_MESSAGE讀的形式呈現CharSequence，供呼叫UX中顯示。

電信框架會以聲音通知使用者診斷訊息的存在，因此撥號應用程式只需專注於視覺化顯示訊息即可。

撥號應用程式透過 接收此事件 Call.Callback#onConnectionEvent(Call, String, Bundle)。

Java 文件 android.telecom.Call.EVENT_DISPLAY_DIAGNOSTIC_MESSAGE。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。