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 回调的执行程序。 此值不能为 null。 回调和侦听器事件通过此执行程序调度,提供一种控制使用哪个线程的简单方法。 若要通过应用程序的主线程调度事件,可以使用 Context.getMainExecutor()。 否则,请提供调度到相应线程的执行程序。
- appFunctionObserver
- IAppFunctionObserver
要接收已注册应用函数更新的观察程序。 此值不能为 null。
返回
用于取消此观察的 AppFunctionObservation。 此值不能为 null。
- 特性
注解
注册观察程序以监视调用方可以查询的包中对应用函数的更改。
调用方应保留对返回的 AppFunctionObservation 的引用,并在不再需要观察时调用 AppFunctionObservation.cancel。
回调仅在注册后由更改触发。 不会报告注册之前发生的任何更改。
示例用法流是:调用 observeAppFunctions(Executor、AppFunctionObserver),以开始使用 AppFunctionObserver 监视应用函数更改;调用 searchAppFunctions(AppFunctionSearchSpec、Executor、ResultReceiver)和 getAppFunctionStates(List、Executor、ResultReceiver)以获取应用函数及其状态的初始列表;在 AppFunctionObserver.onAppFunctionMetadataChanged 中,使用 AppFunctionSearchSpec 调用 searchAppFunctions(AppFunctionSearchSpec、Executor、ResultReceiver),该 AppFunctionSearchSpec 与更改的包匹配以获取更新的元数据;在 AppFunctionObserver.onAppFunctionStatesChanged 中,使用与更改函数匹配的 AppFunctionNames 列表调用 getAppFunctionStates(List、Executor、ResultReceiver),以获取更新状态。 请注意,这可以保证在 AppFunctionObserver.onAppFunctionMetadataChanged 之后触发,这些函数或函数也更改了状态,因此无需在 AppFunctionObserver.onAppFunctionMetadataChanged 中调用 getAppFunctionStates(List、Executor、ResultReceiver)。
Android 参考。android.app.appfunctions.AppFunctionManager.observeAppFunctions
本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改,并根据 Creative Commons 2.5 属性许可证中所述的术语使用。