本文详细阐述了 tizen tv 应用中的按键事件处理机制，区别于移动/穿戴设备的 `tizenhwkey`，tizen tv 采用标准的 `keydown` 事件监听器来响应遥控器输入。文章提供了默认的事件处理代码示例，并重点讲解了如何通过捕获 `return` 键（keycode 10009）来实现应用的正常退出。
在开发 Tizen TV 应用程序时，理解其独特的事件处理机制至关重要。与 Tizen 移动或可穿戴设备不同，Tizen TV 不支持 tizenhwkey API 来处理硬件按键事件。电视设备主要通过遥控器进行交互，因此其事件处理方式是基于标准的 DOM keydown 事件。
Tizen TV 的按键事件处理机制
Tizen TV 应用通过监听 document 上的 keydown 事件来捕获来自遥控器的用户输入。当用户按下遥控器上的任何按键时，浏览器会触发一个 keydown 事件，开发者可以通过事件对象 e 获取按键的 keyCode，从而识别是哪个按键被按下。
Tizen Studio 在为 TV 配置文件创建项目时，通常会默认添加一个 keydown 事件监听器，作为开发者实现自定义事件处理的良好起点。这个默认的监听器不仅为常见的导航按键提供了处理框架，还特别包含了应用退出的逻辑。
实现应用退出功能
在 Tizen TV 应用中，最常见的退出方式是响应遥控器上的“返回”或“退出”按键。这个按键对应的 keyCode 是 10009。通过捕获这个 keyCode，并调用 Tizen 平台提供的 tizen.application.getCurrentApplication().exit() 方法，即可实现应用的正常退出。
以下是 Tizen Studio 默认提供的 keydown 事件监听器示例代码，它展示了如何处理常见的导航按键以及如何实现应用退出：
// 为 keydown 事件添加监听器
document.addEventListener('keydown', function(e) {
switch(e.keyCode){
case 37: // 左箭头 (LEFT arrow)
console.log('左键被按下');
// 在此处添加左键的自定义逻辑
break;
case 38: // 上箭头 (UP arrow)
console.log('上键被按下');
// 在此处添加上键的自定义逻辑
break;
case 39: // 右箭头 (RIGHT arrow)
console.log('右键被按下');
// 在此处添加右键的自定义逻辑
break;
case 40: // 下箭头 (DOWN arrow)
console.log('下键被按下');
// 在此处添加下键的自定义逻辑
break;
case 13: // 确定键 (OK button)
console.log('确定键被按下');
// 在此处添加确定键的自定义逻辑
break;
case 10009: // 返回键 (RETURN button)
console.log('返回键被按下，应用即将退出');
// 调用 Tizen API 退出当前应用
tizen.application.getCurrentApplication().exit();
break;
default:
// 打印其他未处理按键的 keyCode
console.log('未知按键 Key code : ' + e.keyCode);
break;
}
});代码解析：
- document.addEventListener('keydown', function(e) { ... });：注册一个全局的 keydown 事件监听器。
- e.keyCode：事件对象 e 的 keyCode 属性包含了按下按键的唯一数字标识符。
- case 37 到 case 40：分别对应遥控器上的左、上、右、下导航键。开发者可以在各自的 break 前添加相应的UI焦点移动或功能逻辑。
- case 13：对应遥控器上的“确定”或“OK”键，通常用于选择当前聚焦的元素。
- case 10009：这是实现应用退出的关键。当用户按下遥控器上的“返回”键时，会触发此 keyCode。
- tizen.application.getCurrentApplication().exit();：这是 Tizen 平台提供的 JavaScript API，用于获取当前运行的应用实例并调用其 exit() 方法来终止应用进程。
注意事项与最佳实践
- 区分平台：始终牢记 tizenhwkey 适用于移动和可穿戴设备，而 Tizen TV 采用 keydown 事件。
- 默认代码：Tizen Studio 提供的默认 keydown 监听器是一个很好的起点。在此基础上进行扩展，可以避免重复编写基础的按键处理逻辑。
- 按键码查询：如果需要处理其他特定按键，可以通过 default 分支打印 e.keyCode 来发现其对应的按键码，然后添加到 switch 语句中。
- 用户体验：确保“返回”键的行为符合用户预期，即通常用于返回上一级界面或退出应用。
- Tizen API 访问：tizen.application API 属于 Tizen Web Device API，确保您的 config.xml 中包含了必要的权限，以便应用能够访问这些 API。通常，http://tizen.org/privilege/application.launch 权限是必需的。
总结
Tizen TV 应用的按键事件处理主要通过标准的 keydown 事件监听器实现，而非 tizenhwkey。通过捕获遥控器的 keyCode，开发者可以灵活地响应用户输入。特别是，利用 keyCode 10009 并结合 tizen.application.getCurrentApplication().exit() 方法，可以轻松实现应用的正常退出功能。理解并正确运用这些机制，是开发高质量 Tizen TV 应用的基础。
