tvcontrol

来自于:开发者立即使用

概述

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及更高版本