- 查询可用目标—了解应用提供了哪些可导航的屏幕和部分。
- 查询当前目标—确定用户正在查看哪个屏幕或部分。
- 导航到目标—将应用导航到特定屏幕或部分。
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—标准导航目标枚举。

