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

err：

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

示例代码

var tvcontrol = api.require('tvcontrol');
tvcontrol.open({
    coverBack: false,
    coverHome: false,
    canClick: false,
    coverOtherDefault: true
}, function(ret, err){
    if (ret.keyCode == 19) { //向上键
       keyUp();
    } else if (ret.keyCode == 20) { //向下键
      keyDown();
    } else if(ret.keyCode == 23) {
       keyEnter();
    }
});

可用性

Android系统

可提供的1.0.0及更高版本

是否仍需要帮助？ 请保持联络！
最后更新于 2024/11/18