語言

Context.RegisterReceiver 方法

定義

多載

名稱 Description
RegisterReceiver(BroadcastReceiver, IntentFilter, String, Handler, ReceiverFlags)

註冊以接收意圖廣播,以便在排程器情境下執行。 更多資訊請參見 registerReceiver(BroadcastReceiver,IntentFilter,整數)與 registerReceiver(BroadcastReceiver,IntentFilter,String,Handler)。 欲了解更多意圖廣播資訊,請參閱 BroadcastReceiver。 截至Build.VERSION_CODES年。UPSIDE_DOWN_CAKE ,系統可在應用程式處於快取狀態時,將上下文註冊的廣播放入佇列。 當應用程式離開快取狀態,例如回到前景時,系統會傳送所有排隊的廣播。 某些廣播的多個實例可能會合併成一個廣播。 截至Build.VERSION_CODES年。ICE_CREAM_SANDWICH,使用此方法註冊的接收器會正確遵守廣播意圖所指定的 Intent.setPackage(字串)。 在此之前,這份郵件會被忽略,並送達所有匹配的註冊收件人。 使用這些資料時要小心。

RegisterReceiver(BroadcastReceiver, IntentFilter, String, Handler)

註冊以接收意圖廣播,並在 排程器情境下執行。

RegisterReceiver(BroadcastReceiver, IntentFilter, String, Handler, ActivityFlags)
已淘汰.

註冊以接收意圖廣播,並在 排程器情境下執行。

RegisterReceiver(BroadcastReceiver, IntentFilter, ActivityFlags)
已淘汰.

註冊以接收意圖廣播,接收端可選擇性地暴露給即時應用程式。

RegisterReceiver(BroadcastReceiver, IntentFilter)

註冊一個廣播接收器(BroadcastReceiver)以便在主活動執行緒中執行。

RegisterReceiver(BroadcastReceiver, IntentFilter, ReceiverFlags)

註冊以接收意圖廣播,接收端可選擇性地暴露給即時應用程式。 更多資訊請參閱 registerReceiver(BroadcastReceiver, IntentFilter)。 預設情況下,即時應用程式無法與其他應用程式中的接收器互動,這讓你可以公開一個接收器,讓即時應用程式能互動。 欲了解更多意圖廣播資訊,請參閱 BroadcastReceiver。 截至Build.VERSION_CODES年。UPSIDE_DOWN_CAKE ,系統可在應用程式處於快取狀態時,將上下文註冊的廣播放入佇列。 當應用程式離開快取狀態,例如回到前景時,系統會傳送所有排隊的廣播。 某些廣播的多個實例可能會合併成一個廣播。 截至Build.VERSION_CODES年。ICE_CREAM_SANDWICH,使用此方法註冊的接收器會正確遵守廣播意圖所指定的 Intent.setPackage(字串)。 在此之前,這份郵件會被忽略,並送達所有匹配的註冊收件人。 使用這些資料時要小心。

RegisterReceiver(BroadcastReceiver, IntentFilter, String, Handler, ReceiverFlags)

註冊以接收意圖廣播,以便在排程器情境下執行。 更多資訊請參見 registerReceiver(BroadcastReceiver,IntentFilter,整數)與 registerReceiver(BroadcastReceiver,IntentFilter,String,Handler)。 欲了解更多意圖廣播資訊,請參閱 BroadcastReceiver。 截至Build.VERSION_CODES年。UPSIDE_DOWN_CAKE ,系統可在應用程式處於快取狀態時,將上下文註冊的廣播放入佇列。 當應用程式離開快取狀態,例如回到前景時,系統會傳送所有排隊的廣播。 某些廣播的多個實例可能會合併成一個廣播。 截至Build.VERSION_CODES年。ICE_CREAM_SANDWICH,使用此方法註冊的接收器會正確遵守廣播意圖所指定的 Intent.setPackage(字串)。 在此之前,這份郵件會被忽略,並送達所有匹配的註冊收件人。 使用這些資料時要小心。

public Android.Content.Intent? RegisterReceiver(Android.Content.BroadcastReceiver? receiver, Android.Content.IntentFilter? filter, string? broadcastPermission, Android.OS.Handler? scheduler, Android.Content.ReceiverFlags flags);
member this.RegisterReceiver : Android.Content.BroadcastReceiver * Android.Content.IntentFilter * string * Android.OS.Handler * Android.Content.ReceiverFlags -> Android.Content.Intent

參數

receiver
BroadcastReceiver

廣播接收器要註冊。

filter
IntentFilter

意圖過濾器,負責選擇接收廣播。

broadcastPermission
String

廣播業者必須持有的權限名稱,才能向此接收者發送意圖。 若為無效,則無需授權。

scheduler
Handler

接球員回撥的處理者。

flags
ReceiverFlags

控制這次行動的旗幟。

傳回

第一個固定意圖找到的 與濾波器 相符,若沒有則為 null。

備註

註冊以接收意圖廣播,以便在排程器情境下執行。 更多資訊請參見 registerReceiver(BroadcastReceiver,IntentFilter,整數)與 registerReceiver(BroadcastReceiver,IntentFilter,String,Handler)。 欲了解更多意圖廣播資訊,請參閱 BroadcastReceiver。 截至Build.VERSION_CODES年。UPSIDE_DOWN_CAKE ,系統可在應用程式處於快取狀態時,將上下文註冊的廣播放入佇列。 當應用程式離開快取狀態,例如回到前景時,系統會傳送所有排隊的廣播。 某些廣播的多個實例可能會合併成一個廣播。 截至Build.VERSION_CODES年。ICE_CREAM_SANDWICH,使用此方法註冊的接收器會正確遵守廣播意圖所指定的 Intent.setPackage(字串)。 在此之前,這份郵件會被忽略,並送達所有匹配的註冊收件人。 使用這些資料時要小心。

Java 文件 android.content.Context.registerReceiver(android.content.BroadcastReceiver, android.content.IntentFilter, java.lang.String, android.os.Handler, int)。

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

適用於

RegisterReceiver(BroadcastReceiver, IntentFilter, String, Handler)

註冊以接收意圖廣播,並在 排程器情境下執行。

[Android.Runtime.Register("registerReceiver", "(Landroid/content/BroadcastReceiver;Landroid/content/IntentFilter;Ljava/lang/String;Landroid/os/Handler;)Landroid/content/Intent;", "GetRegisterReceiver_Landroid_content_BroadcastReceiver_Landroid_content_IntentFilter_Ljava_lang_String_Landroid_os_Handler_Handler")]
public abstract Android.Content.Intent? RegisterReceiver(Android.Content.BroadcastReceiver? receiver, Android.Content.IntentFilter? filter, string? broadcastPermission, Android.OS.Handler? scheduler);
[<Android.Runtime.Register("registerReceiver", "(Landroid/content/BroadcastReceiver;Landroid/content/IntentFilter;Ljava/lang/String;Landroid/os/Handler;)Landroid/content/Intent;", "GetRegisterReceiver_Landroid_content_BroadcastReceiver_Landroid_content_IntentFilter_Ljava_lang_String_Landroid_os_Handler_Handler")>]
abstract member RegisterReceiver : Android.Content.BroadcastReceiver * Android.Content.IntentFilter * string * Android.OS.Handler -> Android.Content.Intent

參數

receiver
BroadcastReceiver

BroadcastReceiver 負責處理廣播。

filter
IntentFilter

選擇接收的意圖廣播。

broadcastPermission
String

字串命名一個廣播者必須持有的權限,才能向你發送意圖。 若為無效,則無需授權。

scheduler
Handler

處理器識別將接收意圖的執行緒。 若為空執行緒,則會使用程序的主執行緒。

傳回

第一個黏性意圖發現符合 篩選器,若無則為空。

屬性

備註

註冊以接收意圖廣播,並在 排程器情境下執行。 如需相關資訊,請參閱 #registerReceiver(BroadcastReceiver, IntentFilter) 。 這讓你能強制執行誰可以向接收端廣播意圖,或讓接收器在與主應用程式執行緒不同的執行緒中執行。

更多關於意圖廣播的資訊請參見 BroadcastReceiver 。

截至目前 android.os.Build.VERSION_CODES#UPSIDE_DOWN_CAKE,系統可以在 應用程式處於 快取狀態時,將上下文註冊的廣播放入隊列。 當應用程式離開快取狀態,例如回到前景時,系統會傳送所有排隊的廣播。 某些廣播的多個實例可能會合併成一個廣播。

自 android.os.Build.VERSION_CODES#ICE_CREAM_SANDWICH,註冊使用此方法的接收器將正確遵守 Intent#setPackage(String) 所廣播意圖的規定。 在此之前,這份郵件會被忽略,並送達所有匹配的註冊收件人。 使用這些資料時要小心。

對於鎖定 android.os.Build.VERSION_CODES#UPSIDE_DOWN_CAKE的#RECEIVER_EXPORTED應用程式,若接收器未註冊系統#RECEIVER_NOT_EXPORTED,必須指定 或 ,否則會拋出 。SecurityException 請參閱 #registerReceiver(BroadcastReceiver, IntentFilter, String, Handler, int) 註冊帶有旗標的接收器。

Java 文件 android.content.Context.registerReceiver(android.content.BroadcastReceiver, android.content.IntentFilter, java.lang.String, android.os.Handler)。

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

另請參閱

適用於

RegisterReceiver(BroadcastReceiver, IntentFilter, String, Handler, ActivityFlags)

警告

This method has an incorrect enumeration type. Use the overload that takes ReceiverFlags instead.

註冊以接收意圖廣播,並在 排程器情境下執行。

[Android.Runtime.Register("registerReceiver", "(Landroid/content/BroadcastReceiver;Landroid/content/IntentFilter;Ljava/lang/String;Landroid/os/Handler;I)Landroid/content/Intent;", "GetRegisterReceiver_Landroid_content_BroadcastReceiver_Landroid_content_IntentFilter_Ljava_lang_String_Landroid_os_Handler_IHandler", ApiSince=26)]
[System.Obsolete("This method has an incorrect enumeration type. Use the overload that takes ReceiverFlags instead.")]
public abstract Android.Content.Intent? RegisterReceiver(Android.Content.BroadcastReceiver? receiver, Android.Content.IntentFilter? filter, string? broadcastPermission, Android.OS.Handler? scheduler, Android.Content.ActivityFlags flags);
[<Android.Runtime.Register("registerReceiver", "(Landroid/content/BroadcastReceiver;Landroid/content/IntentFilter;Ljava/lang/String;Landroid/os/Handler;I)Landroid/content/Intent;", "GetRegisterReceiver_Landroid_content_BroadcastReceiver_Landroid_content_IntentFilter_Ljava_lang_String_Landroid_os_Handler_IHandler", ApiSince=26)>]
[<System.Obsolete("This method has an incorrect enumeration type. Use the overload that takes ReceiverFlags instead.")>]
abstract member RegisterReceiver : Android.Content.BroadcastReceiver * Android.Content.IntentFilter * string * Android.OS.Handler * Android.Content.ActivityFlags -> Android.Content.Intent

參數

receiver
BroadcastReceiver

BroadcastReceiver 負責處理廣播。

filter
IntentFilter

選擇接收的意圖廣播。

broadcastPermission
String

字串命名一個廣播者必須持有的權限,才能向你發送意圖。 若為無效,則無需授權。

scheduler
Handler

處理器識別將接收意圖的執行緒。 若為空執行緒,則會使用程序的主執行緒。

flags
ActivityFlags

接球員的額外選項。 對於針對 android.os.Build.VERSION_CODES#UPSIDE_DOWN_CAKE#RECEIVER_EXPORTED 或 的應用程式,如果接收器沒有註冊系統廣播,必須指定 或 #RECEIVER_NOT_EXPORTEDSecurityException ,否則會被拋出。 若 #RECEIVER_EXPORTED 指定為 ,接收者可額外指定 #RECEIVER_VISIBLE_TO_INSTANT_APPS。 完整系統廣播動作清單,請參閱 Android SDK 中的 BROADCAST_ACTIONS.TXT 檔案。 若同時 #RECEIVER_EXPORTED 指定 和 #RECEIVER_NOT_EXPORTED ,則會拋出 a IllegalArgumentException 。

傳回

第一個黏性意圖發現符合 篩選器,若無則為空。

屬性

備註

註冊以接收意圖廣播,並在 排程器情境下執行。 如需詳細資訊,請參閱 #registerReceiver(BroadcastReceiver, IntentFilter, int) 和 #registerReceiver(BroadcastReceiver, IntentFilter, String, Handler)。

更多關於意圖廣播的資訊請參見 BroadcastReceiver 。

截至目前 android.os.Build.VERSION_CODES#UPSIDE_DOWN_CAKE,系統可以在 應用程式處於 快取狀態時,將上下文註冊的廣播放入隊列。 當應用程式離開快取狀態,例如回到前景時,系統會傳送所有排隊的廣播。 某些廣播的多個實例可能會合併成一個廣播。

自 android.os.Build.VERSION_CODES#ICE_CREAM_SANDWICH,註冊使用此方法的接收器將正確遵守 Intent#setPackage(String) 所廣播意圖的規定。 在此之前,這份郵件會被忽略,並送達所有匹配的註冊收件人。 使用這些資料時要小心。

Java 文件 android.content.Context.registerReceiver(android.content.BroadcastReceiver, android.content.IntentFilter, java.lang.String, android.os.Handler, int)。

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

適用於

RegisterReceiver(BroadcastReceiver, IntentFilter, ActivityFlags)

警告

This method has an incorrect enumeration type. Use the overload that takes ReceiverFlags instead.

註冊以接收意圖廣播,接收端可選擇性地暴露給即時應用程式。

[Android.Runtime.Register("registerReceiver", "(Landroid/content/BroadcastReceiver;Landroid/content/IntentFilter;I)Landroid/content/Intent;", "GetRegisterReceiver_Landroid_content_BroadcastReceiver_Landroid_content_IntentFilter_IHandler", ApiSince=26)]
[System.Obsolete("This method has an incorrect enumeration type. Use the overload that takes ReceiverFlags instead.")]
public abstract Android.Content.Intent? RegisterReceiver(Android.Content.BroadcastReceiver? receiver, Android.Content.IntentFilter? filter, Android.Content.ActivityFlags flags);
[<Android.Runtime.Register("registerReceiver", "(Landroid/content/BroadcastReceiver;Landroid/content/IntentFilter;I)Landroid/content/Intent;", "GetRegisterReceiver_Landroid_content_BroadcastReceiver_Landroid_content_IntentFilter_IHandler", ApiSince=26)>]
[<System.Obsolete("This method has an incorrect enumeration type. Use the overload that takes ReceiverFlags instead.")>]
abstract member RegisterReceiver : Android.Content.BroadcastReceiver * Android.Content.IntentFilter * Android.Content.ActivityFlags -> Android.Content.Intent

參數

receiver
BroadcastReceiver

BroadcastReceiver 負責處理廣播。

filter
IntentFilter

選擇接收的意圖廣播。

flags
ActivityFlags

接球員的額外選項。 對於針對 android.os.Build.VERSION_CODES#UPSIDE_DOWN_CAKE#RECEIVER_EXPORTED 或 的應用程式,如果接收器沒有註冊系統廣播,必須指定 或 #RECEIVER_NOT_EXPORTEDSecurityException ,否則會被拋出。 若 #RECEIVER_EXPORTED 指定為 ,接收者可額外指定 #RECEIVER_VISIBLE_TO_INSTANT_APPS。 完整系統廣播動作清單,請參閱 Android SDK 中的 BROADCAST_ACTIONS.TXT 檔案。 若同時 #RECEIVER_EXPORTED 指定 和 #RECEIVER_NOT_EXPORTED ,則會拋出 a IllegalArgumentException 。

傳回

第一個黏性意圖發現符合 篩選器,若無則為空。

屬性

備註

註冊以接收意圖廣播,接收端可選擇性地暴露給即時應用程式。 如需相關資訊,請參閱 #registerReceiver(BroadcastReceiver, IntentFilter) 。 預設情況下,即時應用程式無法與其他應用程式中的接收器互動,這讓你可以公開一個接收器,讓即時應用程式能互動。

更多關於意圖廣播的資訊請參見 BroadcastReceiver 。

截至目前 android.os.Build.VERSION_CODES#UPSIDE_DOWN_CAKE,系統可以在 應用程式處於 快取狀態時,將上下文註冊的廣播放入隊列。 當應用程式離開快取狀態,例如回到前景時,系統會傳送所有排隊的廣播。 某些廣播的多個實例可能會合併成一個廣播。

自 android.os.Build.VERSION_CODES#ICE_CREAM_SANDWICH,註冊使用此方法的接收器將正確遵守 Intent#setPackage(String) 所廣播意圖的規定。 在此之前,這份郵件會被忽略,並送達所有匹配的註冊收件人。 使用這些資料時要小心。

Java 文件 android.content.Context.registerReceiver(android.content.BroadcastReceiver, android.content.IntentFilter, int)。

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

適用於

RegisterReceiver(BroadcastReceiver, IntentFilter)

註冊一個廣播接收器(BroadcastReceiver)以便在主活動執行緒中執行。

[Android.Runtime.Register("registerReceiver", "(Landroid/content/BroadcastReceiver;Landroid/content/IntentFilter;)Landroid/content/Intent;", "GetRegisterReceiver_Landroid_content_BroadcastReceiver_Landroid_content_IntentFilter_Handler")]
public abstract Android.Content.Intent? RegisterReceiver(Android.Content.BroadcastReceiver? receiver, Android.Content.IntentFilter? filter);
[<Android.Runtime.Register("registerReceiver", "(Landroid/content/BroadcastReceiver;Landroid/content/IntentFilter;)Landroid/content/Intent;", "GetRegisterReceiver_Landroid_content_BroadcastReceiver_Landroid_content_IntentFilter_Handler")>]
abstract member RegisterReceiver : Android.Content.BroadcastReceiver * Android.Content.IntentFilter -> Android.Content.Intent

參數

receiver
BroadcastReceiver

BroadcastReceiver 負責處理廣播。

filter
IntentFilter

選擇接收的意圖廣播。

傳回

第一個黏性意圖發現符合 篩選器,若無則為空。

屬性

備註

註冊一個廣播接收器(BroadcastReceiver)以便在主活動執行緒中執行。 接收 器 會在主應用程式執行緒中,以符合 濾波器的廣播意圖被呼叫。

系統可能會廣播「黏著」的意圖——這些意圖會在廣播結束後保留,並送往後續的註冊者。 如果您的 IntentFilter 符合上述其中一個黏著意圖,該意圖將由此函式回傳 ,並 像剛廣播一樣傳送給 您的接收器 。

可能存在多個與 過濾器相符的黏性意圖,此時每個都會傳送給 接收端。 在這種情況下,函數只能直接回傳其中一種;系統會隨意決定哪些回傳。

如果你知道你要註冊的意圖是固定的,你可以為 接收器提供空值。 此時,未註冊接收器——函數僅回傳符合 篩選器的黏性意圖。 多場比賽的情況,適用上述相同的規則。

更多關於意圖廣播的資訊請參見 BroadcastReceiver 。

截至目前 android.os.Build.VERSION_CODES#UPSIDE_DOWN_CAKE,系統可以在 應用程式處於 快取狀態時,將上下文註冊的廣播放入隊列。 當應用程式離開快取狀態,例如回到前景時,系統會傳送所有排隊的廣播。 某些廣播的多個實例可能會合併成一個廣播。

自 android.os.Build.VERSION_CODES#ICE_CREAM_SANDWICH,註冊使用此方法的接收器將正確遵守 Intent#setPackage(String) 所廣播意圖的規定。 在此之前,這份郵件會被忽略,並送達所有匹配的註冊收件人。 使用這些資料時要小心。

對於鎖定 android.os.Build.VERSION_CODES#UPSIDE_DOWN_CAKE的#RECEIVER_EXPORTED應用程式,若接收器未註冊系統#RECEIVER_NOT_EXPORTED,必須指定 或 ,否則會拋出 。SecurityException 請參閱 #registerReceiver(BroadcastReceiver, IntentFilter, int) 註冊帶有旗標的接收器。

注意:此方法 <em>無法從元件呼叫 BroadcastReceiver ;</em> ,也就是來自應用程式清單中宣告的廣播接收器。 然而,從另一個本身在執行時已註冊的 #registerReceiverBroadcastReceiver 呼叫此方法是可以的,因為該註冊 BroadcastReceiver 的存續期與註冊它的物件綁定。

Java 文件 android.content.Context.registerReceiver(android.content.BroadcastReceiver, android.content.IntentFilter)。

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

另請參閱

適用於

RegisterReceiver(BroadcastReceiver, IntentFilter, ReceiverFlags)

註冊以接收意圖廣播,接收端可選擇性地暴露給即時應用程式。 更多資訊請參閱 registerReceiver(BroadcastReceiver, IntentFilter)。 預設情況下,即時應用程式無法與其他應用程式中的接收器互動,這讓你可以公開一個接收器,讓即時應用程式能互動。 欲了解更多意圖廣播資訊,請參閱 BroadcastReceiver。 截至Build.VERSION_CODES年。UPSIDE_DOWN_CAKE ,系統可在應用程式處於快取狀態時,將上下文註冊的廣播放入佇列。 當應用程式離開快取狀態,例如回到前景時,系統會傳送所有排隊的廣播。 某些廣播的多個實例可能會合併成一個廣播。 截至Build.VERSION_CODES年。ICE_CREAM_SANDWICH,使用此方法註冊的接收器會正確遵守廣播意圖所指定的 Intent.setPackage(字串)。 在此之前,這份郵件會被忽略,並送達所有匹配的註冊收件人。 使用這些資料時要小心。

public Android.Content.Intent? RegisterReceiver(Android.Content.BroadcastReceiver? receiver, Android.Content.IntentFilter? filter, Android.Content.ReceiverFlags flags);
member this.RegisterReceiver : Android.Content.BroadcastReceiver * Android.Content.IntentFilter * Android.Content.ReceiverFlags -> Android.Content.Intent

參數

receiver
BroadcastReceiver

廣播接收器要註冊。

filter
IntentFilter

意圖過濾器,負責選擇接收廣播。

flags
ReceiverFlags

控制這次行動的旗幟。

傳回

第一個固定意圖找到的 與濾波器 相符,若沒有則為 null。

備註

註冊以接收意圖廣播,接收端可選擇性地暴露給即時應用程式。 更多資訊請參閱 registerReceiver(BroadcastReceiver, IntentFilter)。 預設情況下,即時應用程式無法與其他應用程式中的接收器互動,這讓你可以公開一個接收器,讓即時應用程式能互動。 欲了解更多意圖廣播資訊,請參閱 BroadcastReceiver。 截至Build.VERSION_CODES年。UPSIDE_DOWN_CAKE ,系統可在應用程式處於快取狀態時,將上下文註冊的廣播放入佇列。 當應用程式離開快取狀態,例如回到前景時,系統會傳送所有排隊的廣播。 某些廣播的多個實例可能會合併成一個廣播。 截至Build.VERSION_CODES年。ICE_CREAM_SANDWICH,使用此方法註冊的接收器會正確遵守廣播意圖所指定的 Intent.setPackage(字串)。 在此之前,這份郵件會被忽略,並送達所有匹配的註冊收件人。 使用這些資料時要小心。

Java 文件 android.content.Context.registerReceiver(android.content.BroadcastReceiver, android.content.IntentFilter, int)。

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

適用於