AppFunctionMetadataScope 枚举
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
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 开放源代码项目创建和共享的工作进行的修改,并根据 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 开放源代码项目创建和共享的工作进行的修改,并根据 Creative Commons 2.5 属性许可证中所述的术语使用。 |