ntv.js框架源码解读 - 3key.js

最新推荐文章于 2021-05-29 00:25:32 发布

weixin_33795833

最新推荐文章于 2021-05-29 00:25:32 发布

阅读量144

点赞数

文章标签： python

原文链接：https://my.oschina.net/cotonchen/blog/375600

版权

2019独角兽企业重金招聘Python工程师标准>>>

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。

目前框架并未定义所有键值码，因为目前应用还未使用到更多的键值。对于各厂商中间件的键值码定义参考ntv.js框架(第一章) - 机顶盒中间件规范中的《东方有线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;
  })();

转载于:https://my.oschina.net/cotonchen/blog/375600