libEasyPlayer RTSP windows播放器SDK API接口设计说明

摘要:
API接口函数定义 intEasyPlayer_Init();返回值是当前播放频道ID,表示要播放的当前流地址,并表示当前播放器要显示的窗口的句柄;[IN]回放渲染类型,[IN]播放器回声视频数据回调函数userPtr:播放器设置当前流回放缓存帧;缓存[IN]当前频道的流播放设置的缓存视频帧数,以及设置视频显示时渲染区域的参数描述:播放器设置是否显示码流信息;

概述
libEasyPlayer实现对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字幕叠加通过” “结束符进行换行,一行的长度不能超过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();
函数说明:
播放器停止播放音频;

EasyPlayer

EasyPlayer是由EasyDarwin开源团队开发和维护的一个流媒体播放器项目,目前有RTSP版和Pro版两个版本,RTSP支持Windows(支持多窗口、包含ActiveXnpAPI Web插件)、Android平台,iOS平台,视频支持H.264H.265MPEG4MJPEG,音频支持G711AG711UG726AAC,支持RTSP over TCP/UDP,支持硬解码,是一套极佳的RTSP流播放组件;

EasyPlayer Pro版支持RTSP、RTMP、HTTP、HLS等各种流媒体协议播放,稳定、高效、可靠,支持Windows、Android、iOS!

获取更多信息

邮件:support@easydarwin.org

WEB:www.EasyDarwin.org

Copyright © EasyDarwin.org 2012-2017

EasyDarwin

免责声明:文章转载自《libEasyPlayer RTSP windows播放器SDK API接口设计说明》仅用于学习参考。如对内容有疑问,请及时联系本站处理。

上篇03[转Cognos8第四讲]权限配置(1)GatewayWorker + LayIM实现即时聊天下篇

宿迁高防,2C2G15M,22元/月;香港BGP,2C5G5M,25元/月 雨云优惠码:MjYwNzM=

相关文章

Basler相机外部触发设置(Halcon)

一、相机硬件接线图2号引脚接传感器的触发信号引脚,5号与传感器共地连接。 二、pylon软件设置 三、halcon软触发相机拍照Halcon采集助手设置软触发: 1.set_framegrabber_param (AcqHandle, 'TriggerMode', 'On')2.set_framegrabber_param (AcqHandle, 'T...

LoadRunner系列之—-01 接口压力测试脚本

 LoadRunner中一般用如下函数进行接口测试: <一>. http或soap协议下的get请求接口,样例如下: web_url("integrated_query.jsp", "URL=http://{UrlAddress}/pcis/policy/query/integrated_query.jsp?CASOPDPT=00&...

FreeRTOS学习及移植笔记之二:在IAR和STM32F103VET上移植FreeRTOS

上一次,我们简单的测试了FreeRTOS的基于IAR EWARM v6.4和STM32F103VET6平台的Demo,对其有了一个基本认识。接下来我们开始自己移植FreeRTOS的过程。 1、创建一个“FreeRTOSTestProject”项目文件夹,并在其下创建FreeRTOS、Libraries、Project、User文件夹。 与无操作系统的项目...

程序设计与算法(三)C++面向对象程序设计 (北大MOOC)

  C++中有两方面体现重用:1、面向对象的思想:继承和多态,标准类库  2、泛型程序设计的思想:模板机制,以及标准模板库STL   标准模板库(Standard Template Library)就是一些常用数据结构和算法的模板的集合,有了STL,不必再写太多的标准数据结构和算法,并且可以获得非常高的性能     STL六大部件:容器(Container...

oracle查询数据中包含字段替换其他内容

有个需求,三个页面类型的表单调用同一个数据表(反馈、计划、汇总三大类),为了区分三大类,我在表单加了反馈类型字段。 计划表单手动维护,反馈表单的时候,自动填充数据(需要查询计划表单维护的数据,反馈类型是计划了,但是现在是做反馈表单) 通过sql的函数replace,实现查询的时候如果是计划的,替换成反馈汉字,这样查询的数据返回表单是反馈类型了,用户维护其...

【笨嘴拙舌WINDOWS】GDI绘制区域

在默认情况下,Gdi绘画操作的使用白纸(窗口的客户区)黑字(Pen的颜色)!前面我们已经讲过如何改笔,现在来学习改变白纸(GDI的绘制区域) 正常的纸为一个矩形形状!有时候小孩不小心撕掉纸的一角,不小心被纸中间掏空了,又或者纸被剪成了艺术品,比如: 如果在这样的图片上垂直方向的中央划一根4个像素的黑色的线条讲呈现出下面的效果     黑色的线条被纸分...