语言

AppFunctionMetadataScope 枚举

定义

public enum AppFunctionMetadataScope
type AppFunctionMetadataScope = 
继承
AppFunctionMetadataScope

字段

名称 值 说明
Global 0

指示应用函数全局范围的常量。

最多可以有一个应用函数实现,此范围提供相同的 AppFunctionName。 这对于绑定到单一实例组件的函数(例如前台服务)非常有用。

使用 AppFunctionManager.registerAppFunction 时,该函数将保持注册状态,直到显式注销或调用上下文被销毁。

若要执行全局范围的函数,AppFunctionManager.executeAppFunction 的调用方不得使用 ExecuteAppFunctionRequest.Builder.setActivityId(或将其设置为 null),否则将返回AppFunctionException.ERROR_FUNCTION_NOT_FOUND。

这始终是基于 AppFunctionService 的函数的范围。

重要说明:从活动上下文调用的 AppFunctionManager.registerAppFunction 提供的函数应首选SCOPE_ACTIVITY。 如果绝对确定只有该活动的一个实例,则仅对此类函数使用SCOPE_GLOBAL。

Android 参考。android.app.appfunctions.AppFunctionMetadata.SCOPE_GLOBAL

本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改,并根据 Creative Commons 2.5 属性许可证中所述的术语使用。

Activity 1

一个常量,指示应用函数是活动范围的。

具有相同 AppFunctionName 的多个应用函数实现可以同时存在,每个实现都从不同的活动实例注册,该实例由 AppFunctionActivityId 标识。

必须使用此作用域的函数使用 AppFunctionManager.registerAppFunction 进行注册,并且必须从活动上下文调用。 从任何其他上下文调用它将导致 IllegalStateException。

若要执行活动范围的函数,AppFunctionManager.executeAppFunction 的调用方必须使用 ExecuteAppFunctionRequest.Builder.setActivityId,否则将返回AppFunctionException.ERROR_FUNCTION_NOT_FOUND。

若要发现当前注册活动范围函数的特定活动,请参阅 AppFunctionManager.getAppFunctionStates 和 AppFunctionManager.getAppFunctionActivityStates。

在显式注销或销毁活动之前,该函数将保持注册状态。

重要说明:从活动上下文调用的 AppFunctionManager.registerAppFunction 提供的函数应首选SCOPE_ACTIVITY。 如果绝对确定只有该活动的一个实例,则仅对此类函数使用SCOPE_GLOBAL。

Android 参考。android.app.appfunctions.AppFunctionMetadata.SCOPE_ACTIVITY

本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改,并根据 Creative Commons 2.5 属性许可证中所述的术语使用。

适用于