SkeyePlayer插件使用说明
鉴于大家对于SkeyePlayer插件的使用还不太熟悉,特此写一篇插件的使用文档,供大家参考;SkeyePlayer插件有两种,一种是基于IE的ActiveX控件,一种是基于FireFox(也支持多浏览器)的npAPI插件;两种插件均包含源码,由于FireBreath框架生成代码比较多,npAPI插件只包含关键代码,后续会提供专门讲解FireBreath生成SkeyePlayer npAPI插件的文档,下面我们开始讲解两种插件如何使用。
- ActiveX OCX控件
ActiveX控件使用MFC ActiveX框架生成非常简单,这里就不做过多赘述,感兴趣的同学可以[下载SkeyePlayer源码](https://gitee.com/visual-opening/skeyplayer/tree/master/Src/C++/SkeyePlayerWebActiveX);注意,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: 0
YUY2: 1
UYVY: 2
A8R8G8B8: 3
X8R8G8B8: 4
RGB565: 5
RGB555: 6
GDI支持格式:
RGB24: 7
sUserName: RTSP流验证用户名,如果流URL里面已经包含, 这里填空;
sPassword: RTSP流验证密码,如果流URL里面已经包含, 这里填空;
sHardDecord: 是否使用硬件解码, 0=软解 1=硬解
注意: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();
}
相关文章
- WordPress 并不是插件越多速度越慢而是劣质插件越多速度越慢
- 使用插件配置vscode快捷键支持多command命令
- webstorm必装十大插件_webpack常用插件
- 分享Nexus桌面插件的安装及使用,超级好看、好用的插件。附下载链接。「建议收藏」
- Eclipse中SVN插件的基本使用「建议收藏」
- Vim高级用法之taglist插件
- WordPress 网站使用 “微信机器人高级版” 插件连通微信公众号
- Ansible 如何使用 Filter 插件转换数据
- Ansible如何使用lookup插件模板化外部数据
- Jmeter 5.3 服务器资源监控插件 PerfMon 使用介绍
- 使用 ClusterResourceSet 为 Cluster API 集群自动安装 CNI 插件
- 使用流水线插件实现持续集成、持续部署
- pytest学习和使用21-测试报告插件allure-pytest如何使用?
- 【Android 屏幕适配】屏幕适配通用解决方案 ① ( 定义 dimens.xml 方案 | 使用 ScreenMatch 插件生成不同屏幕分辨率的 dimens.xml 配置 )
- 【Android Gradle 插件】Gradle 扩展属性 ① ( Gradle 扩展属性简介 | Gradle 自定义 task 任务示例 )
- 【Android Gradle 插件】自定义 Gradle 任务 ⑧ ( 控制 Gradle 执行任务顺序 | Task#shouldRunAfter 函数 | 三个函数使用场景对比 )
- WordPress SEO 中文插件 0.4
- jQuery Timers 定时插件使用详解编程语言
- 经典海量jQuery插件大家可以收藏一下
- 在PHP中使用反射技术的架构插件使用说明
- jQuerypowerFloat万能浮动层下拉层插件使用介绍
- jQuery插件selectToSelect使用方法
- jquery插件tooltipv顶部淡入淡出效果使用示例
- 使用python开发vim插件及心得分享
- node.js使用npm安装插件时提示installError:ENOENT报错的解决方法
- Jquery弹出层插件ThickBox的使用方法
- jQuery多媒体插件jQueryMediaPlugin使用详解