迁移现有 Web 应用


迁移现有 Web 应用

Amazon Fire TV 支持 HTML5 Web 应用。如果您希望在 Fire TV 上提供现有 Web 应用,请查看以下清单,以便将 Web 应用迁移到 Fire TV 平台。

如果您正在开发新的 Web 应用而不是迁移现有应用,请参阅 Web 应用入门

在开始之前,请查看设计和用户体验指南,了解有关为 10 英尺用户界面体验设计应用的详细信息。

Web 应用迁移清单

如果您的 Web 应用... 您需要...
播放视频 确保当您的应用重新获得焦点时,您的用户界面处于正确的状态。请注意,当您的应用失去焦点时,视频播放会自动暂停。

您可以使用页面可见性 API 检测焦点变化并相应地进行响应。请参阅 Web 应用入门中的“焦点变化”。此外,请确保在提交应用时选中阻止在播放视频时进入睡眠状态复选框。这将在您的应用播放视频时禁用 Fire TV 屏幕保护程序。
播放音频 当应用失去焦点时暂停音频播放。音频不会自动暂停,一旦应用处于后台,用户无法使用遥控器暂停音频。

您可以使用页面可见性 API 来检测焦点变化并相应地作出响应。有关更多详细信息,请参阅 Web 应用入门中的“焦点变化”。
在播放期间显示音频或视频持续时间 侦听 durationchange 事件以显示适当的持续时间。请注意,持续时间属性在初始化期间报告错误的持续时间,因此您需要在播放开始后更新持续时间。请参阅常见问题解答的 Web 应用常见问题解答中的“为什么我的 Web 应用在音频和视频播放期间显示不变的持续时间 1:40 秒?”
使用自定义播放控件 捕获按键以使用来自 Amazon Fire TV 遥控器和 Amazon Fire TV 游戏控制器的输入。请参阅 Web 应用中的支持控制器
有退出按钮 正确关闭您的 Web 应用。请参阅 Web 应用常见问题解答中的“如何正确关闭 Web 应用?”
是单页应用 使用 W3C 历史记录来浏览内容并正确响应后退按钮。请参阅 Web 应用常见问题解答中的“如何为 Web 应用自定义亚马逊遥控器后退按钮的行为?”
使用视口 API 控制缩放 确保您的应用的目标是 1080p。请参阅“入门”中的 Web 应用入门中的“分辨率和页面缩放”。
明确确定目标 720p 分辨率 将您的应用的目标更改为 1080p。如果设备设置为 720p,您的应用将自动缩小。请参阅 Web 应用入门中的“分辨率和页面缩放”。
依赖于触摸或单击事件在应用组件之间进行导航 检查您的 UI,确保它使用遥控器和游戏控制器输入,而不是触摸和单击输入。所有可选择的 UI 元素都应该可以使用遥控器和游戏控制器上的上、下、左和右导航按钮访问。请参阅设计和用户体验指南以及 Web 应用中的支持控制器
是一个游戏 请查看有关支持性游戏控制器和处理焦点变化的信息。请参阅 Web 应用中的支持控制器中的“使用来自 Amazon Fire 游戏控制器的输入”以及入门中的“焦点变化”。