as

Settings
Sign out
Notifications
Alexa
亚马逊应用商店
Ring
AWS
文档
Support
Contact Us
My Cases
新手入门
设计和开发
应用发布
参考
支持
跳转到主要内容
Vega目标导航器API将应用内的屏幕或部分作为“目标”,用户可以在其中与主页、设置、配置文件或搜索等输入模式进行交互。 实现目标导航器提供方接口的应用可以执行以下操作。
  1. 查询可用目标—了解应用提供了哪些可导航的屏幕和部分。
  2. 查询当前目标—确定用户正在查看哪个屏幕或部分。
  3. 导航到目标—将应用导航到特定屏幕或部分。
目标导航器提供方API有三个关键组件。
  • 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参考

类

接口

枚举

相关主题


最后修改于 2026年10月26日