SkeyeLive是OpenSKEYE开源流媒体团队开发的一款功能丰富的开源PC端流媒体推流拉流直播软件项目,目前支持Windows、Android版本,后续将支持ios版本,其中Windows版本的SkeyeLive支持多种源接入,包括Windows摄像头、麦克风、RTSP摄像机、屏幕桌面等,采集后经过x264编码、SkeyePusher推送到OpenSKEYE流媒体服务器进行转发,同时SkeyeLive还支持通过SkeyeRTSPClient拉取OpenSKEYE直播流,进行显示、播放,非常稳定、易用,用户可以基于SkeyeLive项目,开发类似于课堂直播、视频对讲等项目!
功能讲解
一、程序框架
SkeyeLive主要包括三个模块:采集、推送和直播,主要功能封装管理类Class CSourceManager中实现,接口非常简单,各模块分别提供开始和结束接口函数,方便界面调用;
界面调用接口:
代码语言:txt复制 //开始捕获(采集)
int StartCapture(SOURCE_TYPE eSourceType, int nCamId, int nAudioId, HWND hCapWnd, char* szURL, int nVideoWidth, int nVideoHeight, int nFps=, int nBitRate);
//停止采集
void StopCapture();
//开始推流
int StartPush(char* ServerIp, int nPushPort, char* sPushName, int nPushBufSize = 1024);
//停止推流
void StopPush();
//开始播放
int StartPlay(char* szURL, HWND hShowWnd);
//停止播放
void StopPlay();
1、采集模块
采集分为本地音视频采集和RTSP流采集
本地音视频主要通过DShow进行采集,函数如下:
代码语言:txt复制int CSourceManager::StartDSCapture(int nCamId, int nAudioId,HWND hShowWnd,int nVideoWidth, int nVideoHeight, int nFps, int nBitRate)
该函数主要实现本地音视频采集和音视频编码器的初始化(详见SkeyeLive源码),需要注意的是这里的参数设置:
(1) 本地采集的视频宽高和x264编码器的宽高需一致,数据格式建议设为YUY2(程序中默认为“YUY2"),因为在DShow的数据采集线程中需要进行编码前的格式转换(YUY2->I420),如果格式不统一,这里将要重写转换函数;
(2) 本地音频采样率默认为16000,这个设置在SkeyePusher中表现最佳,其他采样率还有待测试;
(3) 其他设置请参照DEVICE_CONFIG_INFO结构和Encoder_Config_Info结构的详细说明;
细心的童鞋应该已经发现RTSP流采集和流播放采用的是同一个类Class SkeyeLiveManager实现,如下:
代码语言:txt复制 //接收网络RTSP流进行推流
SkeyeLiveManager m_netStreamCapture;
//接收OpenSKEYE推出的RTSP流进行播放
SkeyeLiveManager m_netStreamPlayer;
这个类封装了libSkeyeLive库提供的接口,方便调用;这个库集成在SkeyeLive源码中,也是SkeyeLive的核心;她主要实现了从网络接收RTSP流进行解析,获取H264编码数据和AAC编码数据分别进行解码并呈现和播放,当然,作为Capturer而言,我们只需要用她获取到编码数据即可。
2、推送模块
推送则显得异常简单,直接调用原生态的SkeyePusher接口,即可实现:
代码语言:txt复制//开始推流
int CSourceManager::StartPush(char* ServerIp, int nPushPort, char* sPushName, int nPushBufSize)
{
//创建推送器指针
m_sPushInfo.pusherHandle = SkeyePusher_Create();
strcpy(m_sPushInfo.pushServerAddr, ServerIp);
m_sPushInfo.pushServerPort = nPushPort;
strcpy(m_sPushInfo.sdpName, sPushName);
Skeye_U32 nRet = 0;
if (NULL != m_sPushInfo.pusherHandle )
{
//设置推送回调,可以获取推送器反馈的信息
SkeyePusher_SetEventCallback(m_sPushInfo.pusherHandle, __SkeyePusher_Callback, 0, NULL);
//开启流推送
Skeye_U32 nRet = SkeyePusher_StartStream(m_sPushInfo.pusherHandle ,
ServerIp, nPushPort, sPushName, "admin", "admin", (Skeye_MEDIA_INFO_T*)&m_mediainfo, nPushBufSize, 0);//512-2048
if(nRet>=0)
{
m_bPushing = TRUE;
}
else
{
StopPush();
}
}
return nRet;
}
//停止推流
void CSourceManager::StopPush()
{
//Close Pusher
if (NULL != m_sPushInfo.pusherHandle)
{
SkeyePusher_StopStream(m_sPushInfo.pusherHandle);
SkeyePusher_Release(m_sPushInfo.pusherHandle);
m_sPushInfo.pusherHandle = NULL;
}
m_bPushing = FALSE;
m_bAVSync = FALSE;
}
唯一需要注意的是推送标志m_bPushing,这个标志将在数据回调函数中起到真正的推送开关的作用(严格的说在StartPush中也应该调用m_bPushing判断是否推送已经进行)。
3、直播模块
直播在采集模块中采集网络流时提到过,也是直接调用类Class SkeyeLiveManager接口实现:
代码语言:txt复制//开始播放
int CSourceManager::StartPlay(char* szURL, HWND hShowWnd)
{
m_sPlayInfo.rtspSourceId = m_netStreamPlayer.Start(szURL, hShowWnd, DISPLAY_FORMAT_RGB24_GDI, 0x01, "", "");
m_netStreamPlayer.Config(3, TRUE, TRUE);
return m_sPlayInfo.rtspSourceId ;
}
//停止播放
void CSourceManager::StopPlay()
{
m_netStreamPlayer.Close();
}
源码下载:https://gitee.com/visual-opening/skeylive