語言

AppFunctionManager.ObserveAppFunctions 方法

定義

註冊觀察者以監控呼叫者可查詢的套件中應用程式功能變更。

[Android.Runtime.Register("observeAppFunctions", "(Ljava/util/concurrent/Executor;Landroid/app/appfunctions/AppFunctionObserver;)Landroid/app/appfunctions/AppFunctionObservation;", "", ApiSince=37)]
public Android.App.AppFunctions.IAppFunctionObservation ObserveAppFunctions(Java.Util.Concurrent.IExecutor executor, Android.App.AppFunctions.IAppFunctionObserver appFunctionObserver);
[<Android.Runtime.Register("observeAppFunctions", "(Ljava/util/concurrent/Executor;Landroid/app/appfunctions/AppFunctionObserver;)Landroid/app/appfunctions/AppFunctionObservation;", "", ApiSince=37)>]
member this.ObserveAppFunctions : Java.Util.Concurrent.IExecutor * Android.App.AppFunctions.IAppFunctionObserver -> Android.App.AppFunctions.IAppFunctionObservation

參數

executor
IExecutor

執行器用來執行 AppFunctionObserver 回撥。 這個值不可能為零值。 回調與監聽事件透過此執行器派遣,提供簡便控制使用執行緒的方式。 要透過應用程式的主執行緒派發事件,可以使用 Context.getMainExecutor()。 否則,提供一個執行者,將執行者派遣到適當的執行緒。

appFunctionObserver
IAppFunctionObserver

觀察者接收註冊應用程式功能的更新。 這個值不可能為零值。

傳回

一個 AppFunctionObservation 用來取消這個觀察。 這個值不可能為零值。

屬性

備註

註冊觀察者以監控呼叫者可查詢的套件中應用程式功能變更。

呼叫者應保留對回傳 AppFunctionObservation 的參考,並在不再需要觀察時呼叫 AppFunctionObservation.cancel。

回撥只有在註冊後的變更才會觸發。 註冊前發生的任何變更均未被報告。

一個範例使用流程是:呼叫 observeAppFunctions(Executor, AppFunctionObserver),開始監控應用程式功能變更,使用 AppFunctionObserver;呼叫 searchAppFunctions(AppFunctionSearchSpec, Executor, OutcomeReceiver) 和 getAppFunctionStates(List, Executor, OutcomeReceiver) 以取得應用程式函式及其狀態的初始清單;在 AppFunctionObserver.onAppFunctionMetadataChanged 中,呼叫 searchAppFunctions(AppFunctionSearchSpec, Executor, OutcomeReceiver),並使用與變更套件相符的 AppFunctionSearchSpec 來取得更新的元資料;在 AppFunctionObserver.onAppFunctionStatesChanged 中,呼叫 getAppFunctionStates(List, Executor, OutcomeReceiver) 並列出與變更函式相符的 AppFunctionNames 清單,以取得更新後的狀態。 請注意,對於新函式或同時改變狀態的函式,這必定會在 AppFunctionObserver.onAppFunctionMetadataChanged 之後觸發,因此不需要在 AppFunctionObserver.onAppFunctionMetadataChanged 中呼叫 getAppFunctionStates(List, Executor, OutcomeReceiver)。

Android 參考資料。android.app.appfunctions.AppFunctionManager.observeAppFunctions

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

適用於