关于c++:SkeyePlayer插件使用说明

鉴于大家对于 SkeyePlayer 插件的应用还不太熟悉，特此写一篇插件的应用文档，供大家参考；SkeyePlayer 插件有两种，一种是基于 IE 的 ActiveX 控件，一种是基于 FireFox（也反对多浏览器）的 npAPI 插件；两种插件均蕴含源码，因为 FireBreath 框架生成代码比拟多，npAPI 插件只蕴含要害代码，后续会提供专门解说 FireBreath 生成 SkeyePlayer npAPI 插件的文档，上面咱们开始解说两种插件如何应用。

1. ActiveX OCX 控件

   ActiveX 控件应用 MFC ActiveX 框架生成非常简单，这里就不做过多赘述，感兴趣的同学能够下载 SkeyePlayer 源码；留神，IE11 曾经不反对 AttachEvent 的形式触发浏览器页面事件，所以，须要导出播放事件的同学在前端页面编写的时候须要做好 IE11 的兼容性解决；

2. npAPI 插件
   npAPI 插件由 FireBreath 框架生成，该框架提供了十分具体的步骤即可生成咱们想要的播放器插件框架，框架生成好当前将 SkeyePlayer 源码的 SkeyePlayerPlugin 目录下的代码替换掉生成的代码即可。

3. 插件导出接口阐明

   [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

留神：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；

4. 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();}