开发者控制台
登录
登录
开发者控制台

仅限应用的集成已知的限制

仅限应用的集成已知的限制

以下是与仅限应用的集成相关的已知限制或其他问题。

受支持的Fire TV设备

在仅限应用的集成可用于您的设备之前，您需要在Fire TV设备上安装版本631098910或更高版本。要检查您的版本是否正确，请执行以下操作：

  1. 通过ADB连接到您的Fire TV
  2. 运行此adb命令：
adb shell dumpsys package com.amazon.vizzini | grep versionCode

响应将和以下所列类似：

versionCode=631098910 minSdk=22 targetSdk=28

versionCode必须是631098910或更高版本。或者，按下麦克风按钮并说出语音命令。如果语音镶边（Alexa的蓝条）出现在屏幕底部，则说明您有了新的版本。如果它出现在顶部，则表示您没有新版本。

要查看您的Fire TV内部版本，请前往Settings（设置）> About（关于）。单击Device & Software（设备和软件）或My Fire TV（我的Fire TV）（菜单名称因设备而异）。然后单击您的Fire TV设备并查找Fire TV Home Version（Fire TV家庭版）。如果您没有看到内部版本631098910或更高版本，请单击Check for updates（检查更新），并获取最新内部版本。

如果您不想等到推出日期，可以将设备序列号（DSN）和客户ID（CID）发送给您的亚马逊代表，从而手动将您的设备添加到软件发布中。要检索您的DSN和CID，请执行以下操作：

  1. DSN: 在Fire TV上，前往Settings（设置）>Device & Software（设备和软件）（或My Fire TV（我的Fire TV））> About（关于）。
  2. CID： 首先，登录开发者门户；登录后，前往https://developer.amazon.com/mycid.html。

使用示例应用和其他预发布应用进行显式定向

显式定向是指在请求中包含应用名称，例如 “Alexa, watch Interstellar on App Name”（Alexa，在某个应用上观看星际穿越），而非只是说 “Alexa, watch Interstellar”（Alexa，观看星际穿越）。 请注意以下事项：

  • 在示例应用中，显式定向不起作用。
  • 只有在（1）完成目录集成，以及（2）将应用提交到动态应用测试（LAT）或生产中之后，显式定向才能在您的实际应用中起作用。支持显式定向所需的亚马逊服务要求您的应用处于LAT或生产状态。

若您在显式定向方面遇到问题，作为合作伙伴，您可能没有很好的办法去解决。您需要向亚马逊代表提出问题，然后亚马逊团队将需要使用内部工具来诊断和解决显式定向问题。

支持在启动表述中使用应用别名

可以使用不同的应用名称启动应用。例如，假设该应用名为 “Sports Streamz Now”。 用户可以通过说 “Open Sports Streamz”（打开Sports Streamz）、“Open Streamz Now”（现在打开Streamz）甚至是“Open Streamz”（打开Streamz）来打开应用。 这些备选应用名称都是可识别的别名。通过云端集成，您可以在Alexa控制台的视频技能配置中指定这些别名。但是，仅限应用的集成不需要您在Alexa控制台中创建视频技能。（该技能是在后端自动为您创建的，因此您看不见。） 但因为这个缘故，您也找不到位置来指定别名以启动您的应用。您需要联系您的亚马逊代表提出请求，找到指定别名的方法。然后，VSK团队将手动为您的应用创建所需的别名。

支持Web应用（封装的网页应用）

仅限应用的集成专为原生Android项目而设计。如果您有HTML5网页应用，则不支持仅限应用的集成。但是，如果您有混合应用（通过诸如Cordova之类的包装器使用原生Android封装的网页应用），则支持这种方法。但是，您可能需要自行确定如何管理原生层和Amazon Web View（AWV）之间的通信。VSK团队尚未在混合应用上测试仅限应用的集成。您需要创建一个可以处理意图的BroadcastReciever，通过BroadcastReciever从意图中获取指令有效负载，然后在您的应用中处理逻辑。

对于仅限应用的集成，唯一推荐的VSK接口是RemoteVideoPlayer，特别是SearchAndPlay和SearchAndDisplayResults指令。对于其他，建议如下：

对于Fire TV集成，有这么多VSK接口不予推荐，这看起来可能有些奇怪。如果不使用它们，为什么还要开发它们？ 请记住，视频技能工具包（VSK）不只是用于Fire TV应用。其他设备以及Echo Show和第三方设备（例如机顶盒、游戏机或其他客厅娱乐设备）也使用其中的接口。在其他环境下，当中的某些接口会更合适。

Alexa如何读取您的目录

当您声明应用的RemoteVideoPlayer功能时，您需要在catalogs对象中列出您的合作伙伴ID：

"catalogs": [
  {
    "type": "VIDEO_INGESTION_IDENTIFIER",
    "sourceId": "<INSERT PARTNER ID>"
  }]

但是，目前亚马逊并未使用此值来检索您的目录。目前，Alexa通过应用的ASIN、标题及合作伙伴ID的后端映射，从您的目录中获取信息。计划将来使用catalogs对象。

Last updated: 2021年7月27日