鉴于大家对于SkeyePlayer插件的应用还不太熟悉,特此写一篇插件的应用文档,供大家参考;SkeyePlayer插件有两种,一种是基于IE的ActiveX控件,一种是基于FireFox(也反对多浏览器)的npAPI插件;两种插件均蕴含源码,因为FireBreath框架生成代码比拟多,npAPI插件只蕴含要害代码,后续会提供专门解说FireBreath生成SkeyePlayer npAPI插件的文档,上面咱们开始解说两种插件如何应用。
ActiveX OCX控件
ActiveX控件应用MFC ActiveX框架生成非常简单,这里就不做过多赘述,感兴趣的同学能够下载SkeyePlayer源码;留神,IE11曾经不反对AttachEvent的形式触发浏览器页面事件,所以,须要导出播放事件的同学在前端页面编写的时候须要做好IE11的兼容性解决;
- npAPI插件
npAPI插件由FireBreath框架生成,该框架提供了十分具体的步骤即可生成咱们想要的播放器插件框架,框架生成好当前将SkeyePlayer源码的SkeyePlayerPlugin目录下的代码替换掉生成的代码即可。
插件导出接口阐明
[1] LONG Start(LPCTSTR sURL, LPCTSTR sRenderFormat, LPCTSTR sUserName, LPCTSTR sPassword, LPCTSTR sHardDecord);
Start函数对SkeyePlayer_OpenStream函数进行了封装,其作用是关上一个RTSP流;
参数阐明:
[sURL]:关上的流地址,以rtsp://结尾;
[sRenderFormat]:播放渲染格局,枚举对应格局:
D3D反对格局如下:
YV12: 0YUY2: 1UYVY: 2A8R8G8B8: 3X8R8G8B8: 4RGB565: 5RGB555: 6
GDI反对格局:
RGB24: 7
留神:OCX接口函数所有参数均为字符串类型,次要是为了不便页面js调用,上面所有接口参数皆是如此;
[2] void Config(LPCTSTR sFrameCache, LPCTSTR sPlaySound, LPCTSTR sShowToScale, LPCTSTR sShowStatisticInfo);
Config函数配置播放器的一些参数,诸如缓存,是否播放音频,是否按比列显示,是否显示码率信息;
参数阐明:
[sFrameCache]:缓存帧数,1-n ,该数值越小,延时越小,当然播放画面可能再网络带宽不现实的状况下会比拟卡,反之则延时越大,相应的播放也会比拟晦涩;
[sPlaySound]:是否播放音频,1=播放,0=不播放
[sShowToScale]:是否按比列显示,1=是 0=否 ,软解码时无效
[sShowStatisticInfo]:是否显示码率信息,1=是 0=否 ,软解码时无效
[3] void SetOSD(LPCTSTR show, LPCTSTR alpha, LPCTSTR red, LPCTSTR green, LPCTSTR blue, LPCTSTR left, LPCTSTR top, LPCTSTR right, LPCTSTR bottom, LPCTSTR strOSD);
SetOSD是新增接口,用于设置视频显示时的OSD显示;
参数阐明:
[show]:是否显示OSD,1=显示 0=不显示
[alpha]:OSD显示叠加透明度, 0-255,0是齐全通明。255齐全不通明
[red]:OSD字幕色彩RGB重量中的R重量,
[green]:OSD字幕色彩RGB重量中的G重量,
[blue]:OSD字幕色彩RGB重量中的B重量,
[left]:OSD基于视频的显示地位坐标的左上角x轴坐标
[top]:OSD基于视频的显示地位坐标的左上角y轴坐标
[right]:OSD基于视频的显示地位坐标的右下角x轴坐标
[bottom]:OSD基于视频的显示地位坐标的右下角y轴坐标
[strOSD]:OSD字幕
[4] void Close(void);
Close敞开Start关上的流;
留神目前ActiveX控件定义一个控件初始化一个惟一的SkeyePlayer播放器实例,一个Start对应一个Close函数;Start函数只能调用一次,下一次调用时必然是先Cose,再Start;
- WEB网页端调用
咱们曾经理解了插件的导出接口,那么咱们就能够很容易的编写JS来实现网页端的播放啦,当然,在此之前,咱们须要注册一下插件,在SkeyePlayer目录下有reg.bat和np_reg.bat批处理文件别离对OCX和npAPI进行注册,提醒注册胜利后即可应用。
在SkeyePlayer的bin目录下咱们曾经提供了两个Demo html页面供大家测试和应用,JS代码很简略,间接调用即可:
function config(){ var obj = document.getElementById("SkeyePlayerOcx"); var cache = document.getElementById("cache").value; var playsound = document.getElementById("playsound").value; var showtoscale= document.getElementById("showtoscale").value; var showsatic = document.getElementById("showsatic").value; obj.Config(cache, playsound, showtoscale, showsatic); //alert(cache+";"+playsound+";"+showtoscale+";"+showsatic); } function startplay(){ var obj = document.getElementById("SkeyePlayerOcx"); var url = document.getElementById("url").value; var rendertype = document.getElementById("rendertype").value; var name= document.getElementById("name").value; var password = document.getElementById("password").value; var hardDecode = document.getElementById("hardwareDecode").value; obj.Start(url, rendertype, name, password,hardDecode); config(); //alert(url+";"+rendertype+";"+name+";"+password); } function stopplay(){ //alert("Close()!!!!!"); var obj = document.getElementById("SkeyePlayerOcx"); obj.Close(); }