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

需求分析

通常对于一个播放器，应该支持以下几种显示模式:缓存

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

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

应用场景

EasyPlayer-RTSP在多年与VLC的对标过程当中，积累了普遍的应用场景，EasyPlayer-RTSP底层与上层所有自主开发，自主知识产权，能够说在RTSP播放器领域，目前最可靠、最可控的当属EasyPlayer-RTSP，可实战测试。app

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

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

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

函数说明：
播放器初始化，播放器使用以前调用；
参数说明：
 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;