3key.js源代码:
ntv.key类,遥控器键值和系统消息的监听代理接口及遥控器键值的绑定。
ntv.key = function(){}; ntv.key.init = function(){ this.listener_keyevent(); // 键值事件监听,监听遥控器键值动作(物理触发)。 this.listener_systemevent(); // 系统事件监听,监听系统发出的消息(系统虚拟触发)。 this.keycode_set(); // 键值码绑定。 };
1. 键值事件监听,主要函数说明:
ntv.key.keypress() 函数就是监听键值事件的函数。其中对一些键值进行了处理,例如将上/下/左/右 确定/刷新/返回 等系统控制类(操作类)事件转发到了ntv.navigation类的move()函数进行处理。同样也将所有键值事件透传到了ntv.key.keypress_handle()函数,你可以通过重写ntv.key.keypress_handle()函数来对键值事件进行处理。
ntv.key.keypress = function(event){ var key_event = event ? event : window.Event; var key_code = key_event.which ? key_event.which : key_event.keyCode; ntv.log.console("ntv.key.keypress, keycode: " + key_code); ntv.navigation.move(key_code, event); // 用来处理 上/下/左/右/确定/刷新/返回 等常规键值 ntv.key.keypress_handle(key_code); // 用来自定义处理键值的函数};
代码示例:自定义处理红色键。
var set_listen_red_key = function(){ ntv.key.keypress_handle = set_listen_handle;};var set_listen_handle = function(event_code){ if(event_code == ntv.key.keycode.KEY_RED) set_red_key_action();};var set_red_key_action = function(){ // 按红色键触发的代码写在这里 ntv.log.console("$PAGE, app.sale.set_red_key_action(), 红色键被触发!");};(function(){ set_listen_red_key();})();
关于手动控制返回键页面地址的方法说明。默认情况下浏览器系统默认处理返回键,但是有些业务情况下我们想要浏览器返回到指定的页面地址,这个时候就需要禁用浏览器对返回键的处理。
/* * 用于手动控制返回页面路径的键值处理函数, 由于各浏览器厂商对返回事件处理不一致. * 说明: 通过禁止系统处理返回事件来达到手动控制返回操作. 代码经测试, 必须写在此处. * 使用:通过调用如下代码来手动控制返回操作 * ntv.stb.key.enable_manual_control_back_event(); * ntv.stb.key.move_back_url = "返回页面地址"; */ ntv.key.keypress_for_manual_control_back_event = function(event){ var key_event = event ? event : window.Event; var key_code = key_event.which ? key_event.which : key_event.keyCode; ntv.log.console("ntv.key.keypress, keycode: " + key_code); // 禁用系统返回键动作,以下代码必须放置在此 var browser = ntv.profile.browser; if(browser == "NGB-H" && key_code == ntv.key.keycode_stb_ngb_h.KEY_BACK) { event.preventDefault(); ntv.navigation.move_back(); } else if(browser == "iPanel" && key_code == ntv.key.keycode_stb_ipanel.KEY_BACK) { ntv.navigation.move_back(); return 0; } else if(browser == "SHDV" && key_code == ntv.key.keycode_stb_shdv.KEY_BACK) { ntv.navigation.move_back(); } else if(browser == "PCBrowser" && key_code == ntv.key.keycode_pc.KEY_BACK) { event.preventDefault(); ntv.navigation.move_back(); }else { ntv.navigation.move(key_code, event); // 用来处理 上/下/左/右/确定/刷新/返回 等常规键值 ntv.key.keypress_handle(key_code); // 用来自定义处理键值的函数 } };
代码示例:指定当前页面的返回页面为 http://192.168.1.163/example/home.html。
(function(){ ntv.stb.key.enable_manual_control_back_event(); ntv.stb.key.move_back_url = "http://192.168.1.163/example/home.html";})();
2. 系统事件监听,主要函数说明:
ntv.key.systemevent() 函数就是监听系统事件的函数。系统事件主要是媒体播放模块与应用层交互的消息定义,各厂商中间件的事件代码定义也不一致。ntv.js框架已经对这些系统事件进行了处理,一般应用不需要开发者来处理这些系统事件。同样所有的系统事件都透传给了ntv.key.systemevent_handle() 函数,在其他框架模块中也是通过重写ntv.key.systemevent_handle() 函数来处理系统事件的。
ntv.key.systemevent = function(event){ // SHDV回传对象需重新构造 if(ntv.profile.browser == "SHDV") { // 重构透传参数 var shdv_system_event = { type: event.type, which: event.msg, modifiers: event.info }; event = shdv_system_event; } var system_event = event ? event : window.Event; var event_code = system_event.which ? system_event.which : system_event.keyCode; ntv.log.console("ntv.key.systemevent(), event_code: " + event_code); ntv.key.systemevent_handle(event_code); };
3. 键值码绑定,主要函数说明:
由于各厂商对遥控器的键值码定义不统一,所以框架通过获取当前运行的浏览器,然后将当前浏览器的键值码对象赋值给了ntv.key.keycode对象。所以对于开发者来说,键值码对象为 ntv.key.keycode。
目前框架并未定义所有键值码,因为目前应用还未使用到更多的键值。对于各厂商中间件的键值码定义参考中的《东方有线NGB信息服务内容解析规范》。
ntv.key.keycode_pc = { KEY_OK : 13, KEY_UP : 38, KEY_DOWN : 40, KEY_LEFT : 37, KEY_RIGHT : 39, KEY_REFRESH : 116, KEY_BACK : 32, KEY_RED: 192 // ~键(tab上方) }; ntv.key.keycode_stb_ipanel = { KEY_OK : 13, KEY_UP : 1, KEY_DOWN : 2, KEY_LEFT : 3, KEY_RIGHT : 4, KEY_REFRESH : 338, KEY_BACK : 340, KEY_RED: 832 }; ntv.key.keycode_stb_shdv = { KEY_OK : 13, KEY_UP : 38, KEY_DOWN : 40, KEY_LEFT : 37, KEY_RIGHT : 39, KEY_REFRESH : 338, KEY_BACK : 70, KEY_RED: 66 }; ntv.key.keycode_stb_ngb_h= { KEY_OK : 4097, KEY_UP : 38, KEY_DOWN : 40, KEY_LEFT : 37, KEY_RIGHT : 39, KEY_REFRESH : 4226, KEY_BACK : 4096, KEY_RED: 2305 }; ntv.key.keycode = ntv.key.keycode_pc; ntv.key.keycode_set = function(){ if(ntv.profile.browser == "iPanel") this.keycode = this.keycode_stb_ipanel; else if(ntv.profile.browser == "SHDV") this.keycode = this.keycode_stb_shdv; else if(ntv.profile.browser == "NGB-H") this.keycode = this.keycode_stb_ngb_h; };
代码示例:自定义处理键值。
var set_listen_handle = function(keycode){ switch(keycode) { case ntv.key.keycode.KEY_UP: // to do break; case ntv.key.keycode.KEY_DOWN: // to do break; case ntv.key.keycode.KEY_LEFT: // to do break; case ntv.key.keycode.KEY_RIGHT: // to do break; case ntv.key.keycode.KEY_REFRESH: // to do break; case ntv.key.keycode.KEY_OK: // to do break; } }; (function(){ ntv.key.keypress_handle = set_listen_handle; })();