語言

Notification.Builder.SetShortcutId(String) 方法

定義

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

從 Android 11 起，使用此方法連結到已發佈的長期分享捷徑的訊息通知（使用 MessagingStyle）可能會出現在該陰影的專用對話區塊，並可能顯示對話專屬的設定選項。

[Android.Runtime.Register("setShortcutId", "(Ljava/lang/String;)Landroid/app/Notification$Builder;", "GetSetShortcutId_Ljava_lang_String_Handler", ApiSince=26)]
public virtual Android.App.Notification.Builder SetShortcutId(string? shortcutId);
[<Android.Runtime.Register("setShortcutId", "(Ljava/lang/String;)Landroid/app/Notification$Builder;", "GetSetShortcutId_Ljava_lang_String_Handler", ApiSince=26)>]
abstract member SetShortcutId : string -> Android.App.Notification.Builder
override this.SetShortcutId : string -> Android.App.Notification.Builder

參數

shortcutId
String

String：這個通知所連結的捷徑的 ID

傳回

Notification.Builder

這個 Android.App.Notification.Builder 實例，允許通話串接。

屬性
RegisterAttribute

備註

從 Android 11 起，使用此方法連結到已發佈的長期分享捷徑的訊息通知（使用 MessagingStyle）可能會出現在該陰影的專用對話區塊，並可能顯示對話專屬的設定選項。 這種行為應該保留給面對面對話，當個體可能有社會義務回應時。 例如，以下是一些應該出現在對話空間的通知範例：兩人之間的1：1對話、人人之間可以參與的群組對話以及以下是一些不屬於對話空間的通知範例：來自機器人的廣告（即使是個人化且有情境的）、來自機器人的互動通知、有主動說話者且有許多被動個體的定向對話串流/發布他人的最新消息、電子郵件、文件留言或其他非即時的對話類型

此外，此方法可用於所有類型的通知，以標記此通知為啟動器捷徑的重複。 顯示徽章或通知內容的啟動器可能會自動壓制捷徑，轉而顯示該通知內容。 如果這份通知附帶了 BubbleMetadata，且是用 shortcutID 建立的，將會進行檢查，以確保提供給 bubble metadata 的 shortcutId，是否與這裡設定的 shortcutId（如果有設定的話）相符。 若 shortcutId 被指定但不匹配，則會拋出例外。

另請參閱：

Android 參考資料。android.app.Notification.Builder.setShortcutId

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

適用於