tvcontrol

来自于：开发者立即使用

open

概述

tvcontrol 模块专门针对android智能电视等遥控器无法识别问题开发的，比如你用Apicloud开发的app 安装到电视上以后，无法获取遥控器的 上、下、左、右和确定键，用这个模块可以获取所有的遥控器按键，特别是对上下左右和确定键做了优化。建议TV开发用户使用。（开发游戏手柄情况下，也可以使用）

open

开启电视遥控器等按键监听

open({params}, callback(ret, err))

params

coverBack：

  • 类型：boolean
  • 描述：（可选项）是否覆盖返回键，填true时，点击返回键将没有效果，自行在回调函数中处理。默认false时，不覆盖，也就是说回调函数返回“返回键”的keyCode值时，原先返回事件依然有效。
  • 默认值：false

coverHome：

  • 类型：boolean
  • 描述：（可选项）是否覆盖主页键，填true时，点主页键将没有效果，自行在回调函数中处理。
  • 默认值：false

canClick：

  • 类型：boolean
  • 描述：（可选项）页面是否可以点击。填true时，点击一下屏幕后，监听事件结束，然后，就可以点击页面按钮了。（这个函数只是为了方便大家在手机上调试时使用，因为手机没有遥控器上下左右和确定键，只有通过屏幕点击到下一页。去电视上测试时，可以忽略这个。）
  • 默认值：false

coverOtherDefault：

  • 类型：boolean
  • 描述：（可选项）是否覆盖其他键（除了“返回键”和“主页键”以外的键，要想增加按键是否覆盖，后期可以联系开发者添加），填true时，点击遥控器其他键盘将没有效果，自行在回调函数中处理。
  • 默认值：true

callback(ret, err)

ret：

  • 类型：JSON对象
  • 内部字段：
  1. {
  2.     keyCode: 4   //按键值，是int类型，取值范围包括如下按键值，4：返回键，23：确定键，19：向上键，20：向下键，21：向左键，22：向右键；另外，其他的按键也会返回，只是不常用。自行打印一下就知道了（打印时，请不要用alert之类的弹框，可以直接显示在页面上最好。）。
  3. }

err：

  • 类型：JSON对象
  • 内部字段：
  1. {
  2. }

示例代码

  1. var tvcontrol = api.require('tvcontrol');
  2. tvcontrol.open({
  3.     coverBack: false,
  4.     coverHome: false,
  5.     canClick: false,
  6.     coverOtherDefault: true
  7. }, function(ret, err){
  8.     if (ret.keyCode == 19) { //向上键
  9.        keyUp();
  10.     } else if (ret.keyCode == 20) { //向下键
  11.       keyDown();
  12.     } else if(ret.keyCode == 23) {
  13.        keyEnter();
  14.     }
  15. });

可用性

Android系统

可提供的1.0.0及更高版本