Giter Club home page Giter Club logo

zlmediakit2's Introduction

一个基于C++11简单易用的轻量级流媒体库

平台 编译状态
Linux Build Status
macOS Build Status
iOS Build Status
Android Build Status
Windows 已经完成移植

项目特点

  • 基于C++11开发，避免使用裸指针，代码稳定可靠；同时跨平台移植简单方便，代码清晰简洁。
  • 打包多种流媒体协议(RTSP/RTMP/HLS），支持协议间的互相转换，提供一站式的服务。
  • 使用epoll+线程池+异步网络IO模式开发，并发性能优越。
  • 只实现主流的的H264+AAC流媒体方案，代码精简,脉络清晰，适合学习。

功能清单

  • RTSP

    • RTSP 服务器，支持RTMP/MP4转RTSP。
    • RTSP 播放器，支持RTSP代理。
    • 支持 rtp over udp rtp over tcp rtp over http rtp组播 四种RTP传输方式 。

  • RTMP

    • RTMP 播放服务器，支持RTSP/MP4转RTMP。
    • RTMP 发布服务器，支持录制发布流。
    • RTMP 播放器，支持RTMP代理。
    • RTMP 推流客户端。

  • HLS

    • 支持HLS文件生成，自带HTTP文件服务器。

  • HTTP[S]

    • 服务器支持目录索引生成,文件下载,表单提交请求。
    • 客户端提供文件下载器(支持断点续传),接口请求器。

  • 其他

    • 支持输入YUV+PCM自动生成RTSP/RTMP/HLS/MP4.
    • 支持简单的telnet调试。
    • 支持H264的解析，支持B帧的POC计算排序。

后续任务

  • 提供更多的示例代码

编译(Linux)

  • 我的编译环境

    • Ubuntu16.04 64 bit + gcc5.4(最低gcc4.7)
    • cmake 3.5.1

  • 编译

    cd ZLMediaKit
./build_for_linux.sh

编译(macOS)

  • 我的编译环境

    • macOS Sierra(10.12.1) + xcode8.3.1
    • Homebrew 1.1.3
    • cmake 3.8.0

  • 编译

    cd ZLMediaKit
./build_for_mac.sh

编译(iOS)

  • 编译环境:请参考macOS的编译指导。

  • 编译

    cd ZLMediaKit
./build_for_ios.sh

  • 你也可以生成Xcode工程再编译：

    cd ZLMediaKit
mkdir -p build
cd build
# 生成Xcode工程，工程文件在build目录下
cmake .. -DCMAKE_TOOLCHAIN_FILE=../cmake/iOS.cmake -DIOS_PLATFORM=SIMULATOR64 -G "Xcode"

编译(Android)

  • 我的编译环境

    • macOS Sierra(10.12.1) + xcode8.3.1
    • Homebrew 1.1.3
    • cmake 3.8.0
    • android-ndk-r14b

  • 编译

    cd ZLMediaKit
export ANDROID_NDK_ROOT=/path/to/ndk
./build_for_android.sh

编译(Windows)

  • 我的编译环境

  • 编译

   1 请先编译[ZLToolKit](https://github.com/xiongziliang/ZLToolKit)
   2 使用vs2017打开ZLMediaKit源码根目录文件夹,然后自动生成工程文件，工程文件路径请查看cmake输出.
   3 找到工程文件(ZLMediaKit.sln),双击用vs2017打开.
   4 编译 ALL_BUILD 项目.
   5 找到目标文件并运行测试用例.

使用方法

  • 作为服务器：

     TcpServer<RtspSession>::Ptr rtspSrv(new TcpServer<RtspSession>());
 TcpServer<RtmpSession>::Ptr rtmpSrv(new TcpServer<RtmpSession>());
 TcpServer<HttpSession>::Ptr httpSrv(new TcpServer<HttpSession>());
 TcpServer<HttpsSession>::Ptr httpsSrv(new TcpServer<HttpsSession>());
 
 rtspSrv->start(mINI::Instance()[Config::Rtsp::kPort]);
 rtmpSrv->start(mINI::Instance()[Config::Rtmp::kPort]);
 httpSrv->start(mINI::Instance()[Config::Http::kPort]);
 httpsSrv->start(mINI::Instance()[Config::Http::kSSLPort]);
 EventPoller::Instance().runLoop();

  • 作为播放器：

     MediaPlayer::Ptr player(new MediaPlayer());
 player->setOnPlayResult([](const SockException &ex) {
 	InfoL << "OnPlayResult:" << ex.what();
 });
 player->setOnShutdown([](const SockException &ex) {
 	ErrorL << "OnShutdown:" << ex.what();
 });
 player->setOnVideoCB([&](const H264Frame &frame){
 	//在这里解码H264并显示
 });
 player->setOnAudioCB([&](const AdtsFrame &frame){
 	//在这里解码AAC并播放
 });
 //支持rtmp、rtsp
 (*player)[RtspPlayer::kRtpType] = PlayerBase::RTP_TCP;
 player->play("rtsp://admin:[email protected]/");
 EventPoller::Instance().runLoop();

  • 作为代理服务器：

     //support rtmp and rtsp url
 //just support H264+AAC
 auto urlList = {"rtmp://live.hkstv.hk.lxdns.com/live/hks",
 		"rtsp://184.72.239.149/vod/mp4://BigBuckBunny_175k.mov"};
 map<string , PlayerProxy::Ptr> proxyMap;
 int i=0;
 for(auto url : urlList){
 	//PlayerProxy构造函数前两个参数分别为应用名（app）,流id（streamId）
 	//比如说应用为live，流id为0，那么直播地址为：
 	//http://127.0.0.1/live/0/hls.m3u8
 	//rtsp://127.0.0.1/live/0
 	//rtmp://127.0.0.1/live/0
 	//录像地址为：
 	//http://127.0.0.1/record/live/0/2017-04-11/11-09-38.mp4
 	//rtsp://127.0.0.1/record/live/0/2017-04-11/11-09-38.mp4
 	//rtmp://127.0.0.1/record/live/0/2017-04-11/11-09-38.mp4
 	PlayerProxy::Ptr player(new PlayerProxy("live",to_string(i++).data()));
 	player->play(url);
 	proxyMap.emplace(string(url),player);
 }

  • 作为推流客户端器：

     PlayerProxy::Ptr player(new PlayerProxy("app","stream"));
 //拉一个流，生成一个RtmpMediaSource，源的名称是"app/stream"
 //你也可以以其他方式生成RtmpMediaSource，比如说MP4文件（请研读MediaReader代码）
 player->play("rtmp://live.hkstv.hk.lxdns.com/live/hks");

 RtmpPusher::Ptr pusher;
 //监听RtmpMediaSource注册事件,在PlayerProxy播放成功后触发。
 NoticeCenter::Instance().addListener(nullptr,Config::Broadcast::kBroadcastRtmpSrcRegisted,
 		[&pusher](BroadcastRtmpSrcRegistedArgs){
 	//媒体源"app/stream"已经注册，这时方可新建一个RtmpPusher对象并绑定该媒体源
 	const_cast<RtmpPusher::Ptr &>(pusher).reset(new RtmpPusher(app,stream));

 	//推流地址，请改成你自己的服务器。
 	//这个范例地址（也是基于mediakit）是可用的，但是带宽只有1mb，访问可能很卡顿。
 	pusher->publish("rtmp://jizan.iok.la/live/test");
 });

 EventPoller::Instance().runLoop();

QA

  • 为什么VLC播放一段时间就停止了？

    由于ZLMediaKit在实现RTSP协议时，采用OPTIONS命令作为心跳包（在RTP over UDP时有效），如果播放器不持续发送OPTIONS指令，那么ZLMediaKit会断开连接。如果你要用第三方播放器测试，你可以改RTP over TCP方式或者修改ZLMediaKit的源码，修改位置位置为src/Rtsp/RtspSession.cpp RtspSession::onManager函数,修改成如下所示：

     void RtspSession::onManager() {
 	if (m_ticker.createdTime() > 10 * 1000) {
 		if (m_strSession.size() == 0) {
 			WarnL << "非法链接:" << getPeerIp();
 			shutdown();
 			return;
 		}
 		if (m_bListenPeerUdpPort) {
 			UDPServer::Instance().stopListenPeer(getPeerIp().data(), this);
 			m_bListenPeerUdpPort = false;
 		}
 	}
 	/*if (m_rtpType != PlayerBase::RTP_TCP && m_ticker.elapsedTime() > 15 * 1000) {
 		WarnL << "RTSP会话超时:" << getPeerIp();
 		shutdown();
 		return;
 	/*}
 }

  • 怎么测试服务器性能？

    ZLMediaKit提供了测试性能的示例，代码在tests/test_benchmark.cpp。由于ZLToolKit默认关闭了tcp客户端多线程的支持，如果需要提高测试并发量，需要在编译ZLToolKit时启用ENABLE_ASNC_TCP_CLIENT宏，具体操作如下：

     #编译ZLToolKit
 cd ZLToolKit
 mkdir -p build
 cd build 
 cmake .. -DENABLE_ASNC_TCP_CLIENT
 make -j4
 sudo make install

  • github下载太慢了，有其他下载方式吗？

    你可以在通过开源**获取最新的代码，地址为：

    ZLToolKit

    ZLMediaKit

联系方式

zlmediakit2's People

Contributors

xia-chu avatar

Watchers

James Cloos avatar LiaoQingfu avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.