语言

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 回调的执行程序。 此值不能为 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 属性许可证中所述的术语使用。

适用于