- 查询可用目标 — 了解应用提供了哪些可导航的屏幕和部分。
- 查询当前目标 — 确定用户正在查看哪个屏幕或部分。
- 导航到目标 — 将应用导航到特定屏幕或部分。
handleGetCurrentTarget— 可返回活动应用目标的回调。handleGetAvailableTargets— 可返回支持的导航目标的回调。handleNavigateTargetRequest— 当系统请求特定的目标导航时调用的回调。
updateCurrentTarget— 在当前目标发生变化时通知系统。updateAvailableTargets— 在可用目标列表发生变化时通知系统。
Vega目标导航器先决条件
在使用此API之前,请更新应用清单以声明您使用Vega目标导航器API的意图。修改清单条目时,请将com.amazondeveloper.media.sample替换为您的应用包ID。您的应用必须经过正确配置,才能与Vega目标导航器API交互。
步骤1: 安装和设置Vega目标导航器
要使用Vega目标导航器API,请使用以下依赖项更新package.json文件:
步骤2: 定义可用目标
TargetInfo对象使用以下字段表示每个目标:
identifier(数字,必需)— 目标在应用内的唯一数字ID。name(字符串,可选)— 目标的人类可读名称。standardId(StandardTargetIdentifier1,可选)— 标准标识符,可映射到已知目的地,使系统能够了解目标的用途。
您可以将目标定义为由标识符键控的映射:
standardId的自定义目标。
步骤3: 实现目标导航器处理程序
创建可实现三个回调方法的TargetNavigatorHandler对象。
处理程序方法详细信息
步骤4: 注册处理程序
使用useKeplerAppStateManager()中的IComponentInstance注册处理程序。在调用任何update方法之前,不要在启动时执行此操作。
步骤5: 报告目标状态变化
注册处理程序后,将当前状态通知系统。在启动时同时调用updateCurrentTarget和updateAvailableTargets,并在状态发生变化时再次调用。
更新当前目标
每当用户导航到不同的屏幕时,都会调用应用初始化:undefined以表明当前没有目标,例如处于过渡状态。
更新可用目标
当任何可导航的目的地发生变化时(例如用户登录时),更新目标。Vega目标导航器故障排除
API参考
类
- TargetNavigatorProvider — TargetNavigatorProvider
接口
- TargetInfo — 表示导航的目标。
- TargetNavigatorHandler — 由目标导航器服务器实现的用于处理请求的接口。
枚举
- StandardTargetIdentifier1 — 标准导航目标枚举。

