TSINGSEE青犀视频流媒体播放器EasyPlayer-RTMP定制窗体开发过程分享

因为2020年年底的时候各大浏览器厂商逐渐开始摒弃FLASH，导致基于WEB的RTMP协议流播放被大家诟病，这时候客户端又逐渐被大家捡起来使用。这两天就有一个用户需要定制一个RTMP低延迟的播放器，需求如下：

1、界面简洁，支持窗体大小控制；
2、功能按钮通过右键给出菜单；
3、播放流地址、缓存设置、OSD叠加功能等放到配置文件中；
4、最主要的是低延迟播放；

根据需求内容，我们打算用EasyPlayer-RTMP进行改造，因为EasyPlayer-RTMP底层是基于EasyRTMPClient做的低延迟播放器，EasyRTMPClient可以提供稳定的拉流，回调数据清晰，兼容H264和H265。

我们先看下改造后的界面如下图：

对比下改造前的页面：

 接下来介绍改造过程：
1、将界面的配置项全部修改到配置文件中去，增加一个XML读写的类XMLOperate（尾部附加），如下，可以读写配置文件：

2、将播放、截图、录像、OSD显示等功能做到右键菜单中，增加contextMenuStrip控件：

 播放功能实现：

private void 播放ToolStripMenuItem_Click(object sender, EventArgs e)
        {
            switch (XMLOperate.RENDER_FORMAT)
            {
                case "GDI":
                    RENDER_FORMAT = PlayerSdk.RENDER_FORMAT.DISPLAY_FORMAT_RGB24_GDI; break;
                case "RGB565":
                    RENDER_FORMAT = PlayerSdk.RENDER_FORMAT.DISPLAY_FORMAT_RGB565; break;
                case "YV12":
                    RENDER_FORMAT = PlayerSdk.RENDER_FORMAT.DISPLAY_FORMAT_YV12; break;
                case "YUY2":
                    RENDER_FORMAT = PlayerSdk.RENDER_FORMAT.DISPLAY_FORMAT_YUY2; break;
                default:
                    break;
            }
            var isPlay = false;
            if (this.播放ToolStripMenuItem.Text == "播放")
            { isPlay = true; }
            else
            { isPlay = false; }
           
            if (isPlay)
            {
                string RTSPStreamURI = XMLOperate.PlayerURL;// "rtsp://184.72.239.149/vod/mp4://BigBuckBunny_175k.mov";
                channelID = PlayerSdk.EasyPlayer_OpenStream(RTSPStreamURI, this.panel1.Handle, RENDER_FORMAT, isTCP ? 1 : 0, "", "", callBack, IntPtr.Zero, isHardEncode);
                if (channelID > 0)
                {
                    PlayerSdk.EasyPlayer_SetFrameCache(channelID, 3);
                    this.播放ToolStripMenuItem.Text = "停止";
                    this.DecodeType.Enabled = false;
                }
            }
            else
            {
                int ret = PlayerSdk.EasyPlayer_CloseStream(channelID);
                if (ret == 0)
                {
                    this.播放ToolStripMenuItem.Text = "播放";
                    this.DecodeType.Enabled = true;
                    channelID = -1;
                    this.panel1.Refresh();
                }
            }
        }
 

截图功能实现：

/// <summary>
        /// 截图.
        /// </summary>
        /// <param name="sender">The source of the event.</param>
        /// <param name="e">The <see cref="EventArgs"/> instance containing the event data.</param>
        private void Snop_MenuItem_Click(object sender, EventArgs e)
        {
            if (channelID <= 0)
                return;
            int ret = PlayerSdk.EasyPlayer_PicShot(channelID);
        }
 

其它功能类似实现。最后我们来看下效果：

配置参数如下：

<?xml version="1.0" encoding="utf-8"?>
<启动配置参数>
  <URL>rtmp://183.224.164.130:10085/hls/hhsx2</URL>
  <渲染模式>GDI</渲染模式>
  <硬解>false</硬解>
  <缓存值>3</缓存值>
  <校验KEY值>59615A67426F69576B5A7541306C74676E3651744A663478567778576F502B6C2F32566863336B3D</校验KEY值>
  <备用参数A>RTMPMediaPlayer</备用参数A>
  <备用参数B>这是EasyPlayer-RTMP-Win播放器的字幕叠加接口的效果！</备用参数B>
</启动配置参数>
 

XMLOperate类实现如下：

class XMLOperate
    {
       /// <summary>
       /// 播放的URL
       /// </summary>
        public static string PlayerURL = "";
        /// <summary>
        /// 渲染模式
        /// </summary>
        public static string RENDER_FORMAT = "";
        /// <summary>
        /// 是否硬解
        /// </summary>
        public static string isHardEncode = "";
        /// <summary>
        /// 缓存帧数
        /// </summary>
        public static string CacheFream = "";
        /// <summary>
        /// 授权KEY
        /// </summary>
        public static string KEY = "";
        /// <summary>
        /// 窗体名称
        /// </summary>
        public static string BYCSA = "";
        /// <summary>
        /// OSD叠加内容
        /// </summary>
        public static string BYCSB = "";
        
        public static void InitAppsettings()
        {
            CreateAndInitParamFileAppSettings();
            ReadAppSettingParamsFromConfigFile();
        }
 
        private static void CreateAndInitParamFileAppSettings()
        {
            try
            {
                //创建缺省文件
                XmlDocument XmlDoc = new XmlDocument();
                string FileContent = "<?xml version='1.0' encoding='utf-8' ?>";
                FileContent += "<启动配置参数>";
                FileContent += @"<URL>rtmp://183.224.164.130:10085/hls/df8</URL>";
                FileContent += "<渲染模式>1</渲染模式>";
                FileContent += "<硬解>false</硬解>";
                FileContent += "<缓存值>3</缓存值>";
                FileContent += "<校验KEY值>59615A67426F69576B5A7541306C74676E3651744A663478567778576F502B6C2F32566863336B3D</校验KEY值>";
                
                FileContent += "<备用参数A>500</备用参数A>";
                FileContent += "<备用参数B>500</备用参数B>";
                FileContent += "</启动配置参数>";
                XmlDoc.LoadXml(FileContent);
                //判断文件是否存在，如果不存在则创建
                if (!System.IO.File.Exists("./EasyPlayerConfig.xml"))
                {
                    //判断路径是否存在，如果不存在则创建
                    if (!System.IO.Directory.Exists(System.IO.Path.GetDirectoryName("./EasyPlayerConfig.xml")))
                        System.IO.Directory.CreateDirectory(System.IO.Path.GetDirectoryName("./EasyPlayerConfig.xml"));
                    //创建文件
                    System.IO.File.Create("./EasyPlayerConfig.xml").Dispose();
                    XmlDoc.Save("./EasyPlayerConfig.xml");
                }
 
            }
            catch (Exception e)
            {
                //写异常日志
                throw new Exception("创建配置文件时发生异常!
" + e.Message);
            }
        }
 
        private static bool ReadAppSettingParamsFromConfigFile()
        {
            string fileName = "./EasyPlayerConfig.xml";
            if (fileName == "")
                return false;
            try
            {
                string xPath = @"//启动配置参数";
                XmlDocument XmlDoc = new XmlDocument();
                XmlDoc.Load(fileName);
                XmlDocumentFragment DocFrag = XmlDoc.CreateDocumentFragment();
                XmlNode RootNode = XmlDoc.DocumentElement;
                XmlNode ReadingNode = RootNode.SelectSingleNode(xPath);
                if (Object.Equals(ReadingNode, null))
                {
                }
                else
                {
                    xPath = @"//启动配置参数//URL";
                    ReadingNode = RootNode.SelectSingleNode(xPath);
                    string path = ReadingNode != null ? ReadingNode.InnerText : @"";
                    try
                    {
                        PlayerURL = path;
                    }
                    catch
                    {
                        PlayerURL = "";
                    }
 
                    xPath = @"//启动配置参数//渲染模式";
                    ReadingNode = RootNode.SelectSingleNode(xPath);
                    path = ReadingNode != null ? ReadingNode.InnerText : @"1";
                    try
                    {
                        RENDER_FORMAT = path;
                    }
                    catch
                    {
                        RENDER_FORMAT = @"1";
                    }
 
                    xPath = @"//启动配置参数//硬解";
                    ReadingNode = RootNode.SelectSingleNode(xPath);
                    string nRet = ReadingNode != null ? ReadingNode.InnerText : "false";
                    try
                    {
 
                        isHardEncode = nRet;
 
                    }
                    catch
                    {
                        isHardEncode = "";
                    }
 
                    xPath = @"//启动配置参数//缓存值";
                    ReadingNode = RootNode.SelectSingleNode(xPath);
                    nRet = ReadingNode != null ? ReadingNode.InnerText : "2";
                    try
                    {
 
                        CacheFream = nRet;
 
                    }
                    catch
                    {
                        CacheFream = "2";
                    }
 
                    xPath = @"//启动配置参数//校验KEY值";
                    ReadingNode = RootNode.SelectSingleNode(xPath);
                    path = ReadingNode != null ? ReadingNode.InnerText : "false";
                    try
                    {
                        KEY = path;
                    }
                    catch
                    {
                        KEY = "";
                    }
 
                   
                    xPath = @"//启动配置参数//备用参数A";
                    ReadingNode = RootNode.SelectSingleNode(xPath);
                    path = ReadingNode != null ? ReadingNode.InnerText : "500";
                    try
                    {
                        BYCSA = path;
                    }
                    catch
                    {
                        BYCSA = "500";
                    }
 
                    xPath = @"//启动配置参数//备用参数B";
                    ReadingNode = RootNode.SelectSingleNode(xPath);
                    path = ReadingNode != null ? ReadingNode.InnerText : "500";
                    try
                    {
                        BYCSB = path;
                    }
                    catch
                    {
                        BYCSB = "500";
                    }
                }
                return true;
            }
            catch
            {
                return false;
            }
        }
    }