高起播低延时RTSP网页无插件流媒体播放器EasyPlayer-RTSP-win播放库接口调用说明

本文主要是介绍高起播低延时RTSP网页无插件流媒体播放器EasyPlayer-RTSP-win播放库接口调用说明,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

需求分析

一般对于一个播放器,应该支持如下几种显示模式:

  • 等比例,最大化区域显示,不裁剪
  • 等比例,最大区域显示,裁剪
  • 拉伸显示,铺满全屏

要实现这几种显示模式。其实只要对播放控件的布局进行些许调整即可。那EasyPlayer是怎么实现的呢?

应用场景

EasyPlayer-RTSP在多年与VLC的对标过程中,积累了广泛的应用场景,EasyPlayer-RTSP底层与上层全部自主开发,自主知识产权,可以说在RTSP播放器领域,目前最可靠、最可控的当属EasyPlayer-RTSP,可实战测试。

EPT09056.png

EasyPlayer-RTSP-win播放库接口调用说明

libEasyPlayer-RTSP实现对RTSP直播流进行实时采集和解码显示,稳定,高效,低延时;解码可采用intel硬件解码和软件解码两种方式,能实时进行录像和快照抓图,OSD叠加等功能。

API接口函数定义
 int EasyPlayer_Init();

函数说明:
播放器初始化,播放器使用之前调用;
参数说明:
 void EasyPlayer_Release();

函数说明:
播放器资源释放,播放器不再使用以后调用;
参数说明:

int EasyPlayer_OpenStream(const char *url, HWND hWnd, RENDER_FORMAT renderFormat, int rtpovertcp, const char *username, const char *password, MediaSourceCallBack callback, void *userPtr, bool bHardDecode);

函数说明:
播放器开始进行流播放;返回值为当前播放的通道ID,该ID在停止推流时需要用到;
参数说明:

Url:[IN] 字符串类型,表示当前要播放的流地址,Eg: rtsp://127.0.0.1:554/stream.sdp
HWnd: [IN] 窗口句柄类型,表示为当前播放器将显示的窗口的句柄;
renderFormat:[IN] 播放渲染类型,详见RENDER_FORMAT结构;
Rtpovertcp:[IN] 整数型,拉取流的传输模式,0=udp, 1=tcp
Username:[IN] 字符串,访问流的用户名(如果存在)
Password:[IN] 字符串,访问流的用户名(如果存在)
Callback:[IN] 播放器回调音视频数据回调函数
userPtr:[IN] 用户自定义传入数据
bHardDecode:[IN] 是否采用硬件解码 1=是,0=否
void EasyPlayer_CloseStream(int channelId);

函数说明:
播放器停止流播放;
参数说明:
channelId [IN] 当前播放的流通道ID,该ID是EasyPlayer_OpenStream函数打开流的返回值;
int EasyPlayer_SetFrameCache(int channelId, int cache);

函数说明:
播放器设置当前流播放缓存帧数;
参数说明:
channelId [IN] 当前播放的流通道ID,该ID是EasyPlayer_OpenStream()函数打开 流的返回值;
cache [IN] 当前通道的流播放设置的缓存的视频帧数,Eg: 缓存10帧,则cache = 10;
int EasyPlayer_SetShownToScale(int channelId, int shownToScale);

函数说明:
播放器按比例进行显示;
参数说明:
channelId [IN] 当前播放的流通道ID,该ID是EasyPlayer_OpenStream()函数打开 流的返回值;
shownToScale [IN] 0=整个窗口区域显示,1=按比例显示;
int EasyPlayer_SetDecodeType(int channelId, int decodeKeyframeOnly);<不常用>

函数说明:
播放器设置解码类型;分为所有帧解码和只解码关键帧;
参数说明:
channelId [IN] 当前播放的流通道ID,该ID是EasyPlayer_OpenStream()函数打开 流的返回值;
decodeKeyframeOnly [IN] 0=所有帧解码,1=只解码关键帧;
int EasyPlayer_SetRenderRect(int channelId, LPRECT lpSrcRect);<不常用>

函数说明:
设置视频显示时渲染区域
参数说明:
channelId [IN] 当前播放的流通道ID,该ID是EasyPlayer_OpenStream函数打开 流的返回值;
lpSrcRect [IN] 矩形框结构体指针,指向设置渲染区域的矩形结构体;
int EasyPlayer_ShowStatisticalInfo(int channelId, int show);

函数说明:
播放器设置是否显示码流信息;
参数说明:
channelId [IN] 当前播放的流通道ID,该ID是EasyPlayer_OpenStream()函数打开 流的返回值;
Show [IN] 0=不显示,1=显示;
int EasyPlayer_ShowOSD(int channelId, int show, EASY_PALYER_OSD osd);

函数说明:
播放器设置自定义显示OSD信息;
参数说明:
channelId [IN] 当前播放的流通道ID,该ID是EasyPlayer_OpenStream()函数打开 流的返回值;
Show [IN] 0=不显示,1=显示;
Osd [IN] osd显示信息填充结构,定义如下:

typedef struct tagEASY_PALYER_OSD
{
char stOSD[1024]; //OSD字幕信息
DWORD alpha; //透明通到0-255
DWORD color; //RGB(0xf9,0xf9,0xf9)
DWORD shadowcolor; //OSD背景颜色RGB(0x4d,0x4d,0x4d) 全为0背景透明
RECT rect; //OSD基于图像右上角显示区域
int size; //OSD字体的大小
}EASY_PALYER_OSD;

注意:osd字幕叠加通过”\r\n“结束符进行换行,一行的长度不能超过128个字节,总的OSD叠加不能超过1024个字节。其中OSD大小设置只有D3D渲染模式才能生效;
int EasyPlayer_SetDragStartPoint(int channelId, POINT pt);<不可用>
函数说明:
参数说明:
int EasyPlayer_SetDragEndPoint(int channelId, POINT pt);<不可用>
函数说明:
参数说明:
int EasyPlayer_ResetDragPoint(int channelId);<不可用>
函数说明:
参数说明:
int EasyPlayer_StartManuRecording(int channelId);
函数说明:
播放器开始将流音视频数据进行录制,录制格式为MP4;
参数说明:
channelId [IN] 当前播放的流通道ID,该ID是EasyPlayer_OpenStream函数打开 流的返回值;
int EasyPlayer_StopManuRecording(int channelId);
函数说明:
播放器停止录制MP4;
参数说明:
channelId [IN] 当前播放的流通道ID,该ID是EasyPlayer_OpenStream函数打开 流的返回值;
int EasyPlayer_PlaySound(int channelId);
函数说明:
播放器开始播放音频;
参数说明:
channelId [IN] 当前播放的流通道ID,该ID是EasyPlayer_OpenStream函数打开 流的返回值;
int EasyPlayer_StopSound();
函数说明:
播放器停止播放音频;
int EasyPlayer_GetMediaInfo(int channelId, MEDIA_INFO& mediaInfo);
函数说明:
播放器获取流媒体信息;
注意:该函数需要在拉到流信息以后才能准确的返回流媒体信息,否则返回数据均为空值。
参数说明:
channelId [IN] 当前播放的流通道ID,该ID是EasyPlayer_OpenStream()函数打开 流的返回值;
mediaInfo[OUT] 获取的媒体信息结构,参考MEDIA_INFO的声明如下:

typedef struct tagMEDIA_INFO
{unsigned int	video_codec;		/* 视频编码格式 */unsigned char	fps;				/* 视频帧率 */unsigned short	width;				/* 视频宽 */unsigned short  height;				/* 视频高 */unsigned int	audio_codec;		/* 音频编码格式 */unsigned int	sample_rate;		/* 音频采样率 */unsigned int	channels;			/* 音频声道数 */unsigned int	bits_per_sample;	/* 音频采样精度 */unsigned int	reserved1;			/* 保留参数1 */unsigned int	reserved2;			/* 保留参数2 */
}MEDIA_INFO;

这篇关于高起播低延时RTSP网页无插件流媒体播放器EasyPlayer-RTSP-win播放库接口调用说明的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/930877

相关文章

Linux join命令的使用及说明

《Linuxjoin命令的使用及说明》`join`命令用于在Linux中按字段将两个文件进行连接,类似于SQL的JOIN,它需要两个文件按用于匹配的字段排序,并且第一个文件的换行符必须是LF,`jo... 目录一. 基本语法二. 数据准备三. 指定文件的连接key四.-a输出指定文件的所有行五.-o指定输出

Redis中Hash从使用过程到原理说明

《Redis中Hash从使用过程到原理说明》RedisHash结构用于存储字段-值对,适合对象数据,支持HSET、HGET等命令,采用ziplist或hashtable编码,通过渐进式rehash优化... 目录一、开篇:Hash就像超市的货架二、Hash的基本使用1. 常用命令示例2. Java操作示例三

Redis中Set结构使用过程与原理说明

《Redis中Set结构使用过程与原理说明》本文解析了RedisSet数据结构,涵盖其基本操作(如添加、查找)、集合运算(交并差)、底层实现(intset与hashtable自动切换机制)、典型应用场... 目录开篇:从购物车到Redis Set一、Redis Set的基本操作1.1 编程常用命令1.2 集

Vue3视频播放组件 vue3-video-play使用方式

《Vue3视频播放组件vue3-video-play使用方式》vue3-video-play是Vue3的视频播放组件,基于原生video标签开发,支持MP4和HLS流,提供全局/局部引入方式,可监听... 目录一、安装二、全局引入三、局部引入四、基本使用五、事件监听六、播放 HLS 流七、更多功能总结在 v

MySQL中C接口的实现

《MySQL中C接口的实现》本节内容介绍使用C/C++访问数据库,包括对数据库的增删查改操作,主要是学习一些接口的调用,具有一定的参考价值,感兴趣的可以了解一下... 目录准备mysql库使用mysql库编译文件官方API文档对象的创建和关闭链接数据库下达sql指令select语句前言:本节内容介绍使用C/

Python sys模块的使用及说明

《Pythonsys模块的使用及说明》Pythonsys模块是核心工具,用于解释器交互与运行时控制,涵盖命令行参数处理、路径修改、强制退出、I/O重定向、系统信息获取等功能,适用于脚本开发与调试,需... 目录python sys 模块详解常用功能与代码示例获取命令行参数修改模块搜索路径强制退出程序标准输入

MyBatis/MyBatis-Plus同事务循环调用存储过程获取主键重复问题分析及解决

《MyBatis/MyBatis-Plus同事务循环调用存储过程获取主键重复问题分析及解决》MyBatis默认开启一级缓存,同一事务中循环调用查询方法时会重复使用缓存数据,导致获取的序列主键值均为1,... 目录问题原因解决办法如果是存储过程总结问题myBATis有如下代码获取序列作为主键IdMappe

使用Go调用第三方API的方法详解

《使用Go调用第三方API的方法详解》在现代应用开发中,调用第三方API是非常常见的场景,比如获取天气预报、翻译文本、发送短信等,Go作为一门高效并发的编程语言,拥有强大的标准库和丰富的第三方库,可以... 目录引言一、准备工作二、案例1:调用天气查询 API1. 注册并获取 API Key2. 代码实现3

基于Go语言开发一个 IP 归属地查询接口工具

《基于Go语言开发一个IP归属地查询接口工具》在日常开发中,IP地址归属地查询是一个常见需求,本文将带大家使用Go语言快速开发一个IP归属地查询接口服务,有需要的小伙伴可以了解下... 目录功能目标技术栈项目结构核心代码(main.go)使用方法扩展功能总结在日常开发中,IP 地址归属地查询是一个常见需求:

MySQL之复合查询使用及说明

《MySQL之复合查询使用及说明》文章讲解了SQL复合查询中emp、dept、salgrade三张表的使用,涵盖多表连接、自连接、子查询(单行/多行/多列)及合并查询(UNION/UNIONALL)等... 目录复合查询基本查询回顾多表查询笛卡尔积自连接子查询单行子查询多行子查询多列子查询在from子句中使