語言

NotificationManager.MatchesCallFilter(Uri) 方法

定義

命名空間:
Android.App
組件:
Mono.Android.dll

回傳是否允許從所提供 URI 發出的呼叫通知使用者。

[Android.Runtime.Register("matchesCallFilter", "(Landroid/net/Uri;)Z", "GetMatchesCallFilter_Landroid_net_Uri_Handler", ApiSince=33)]
public virtual bool MatchesCallFilter(Android.Net.Uri uri);
[<Android.Runtime.Register("matchesCallFilter", "(Landroid/net/Uri;)Z", "GetMatchesCallFilter_Landroid_net_Uri_Handler", ApiSince=33)>]
abstract member MatchesCallFilter : Android.Net.Uri -> bool
override this.MatchesCallFilter : Android.Net.Uri -> bool

參數

uri
Uri

一個代表來電者的URI。 不得為 Null。

傳回

Boolean

一個布林值表示根據目前過濾器，URI 所提供的呼叫是否被允許中斷使用者。

屬性
RegisterAttribute

備註

回傳是否允許從所提供 URI 發出的呼叫通知使用者。

真實回傳值表示以下其中之一：請勿打擾目前未啟用;或者來電者是重複來電者，且現行政策允許重複來電者中斷;或來電者屬於用戶的聯絡人組，該聯絡人可中斷請勿打擾。

若啟用請勿打擾且不允許中斷或僅允許警報，無論輸入為何，此方法都會回傳 false。

所提供的 URI 應為 tel: 或 mailto: schema URI，指示呼叫來源。 為了準確判斷呼叫者是否符合使用者允許的聯絡人，URI 的路徑部分必須與相應欄位中的聯絡人資料庫條目相符。

傳入 a android.provider.ContactsContract.Contacts#CONTENT_LOOKUP_URI 也是允許的，但應僅用於優先接觸中斷，對於重複呼叫者可能無法提供準確結果。

另 Person.Builder#setUri 見及 android.provider.ContactsContract.Contacts#CONTENT_LOOKUP_URI 更多資訊。

使用此方法的呼叫者必須具備通知監聽者權限、讀取聯絡人的權限，或擁有系統權限。

注意：此方法會呼叫 Contacts，可能需要一些時間，且不應在主執行緒中呼叫。

Java 文件 android.app.NotificationManager.matchesCallFilter(android.net.Uri)。

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

適用於