AppFunctionManager.ObserveAppFunctions 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
註冊觀察者以監控呼叫者可查詢的套件中應用程式功能變更。
[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 所創建與分享的作品,並依授權條款所描述的使用進行修改。