Skip to content
/ ZLMediaKit Public
forked from ZLMediaKit/ZLMediaKit

A lightweight RTSP, RTMP, HTTP-FLV, WebSocket, HTTP server and client framework based on C++11

License

MIT license
18 stars 3.4k forks Branches Tags Activity
Star
Notifications You must be signed in to change notification settings

chenxiaolei/ZLMediaKit

BranchesTags
 
 

Repository files navigation

A lightweight ,high performance and stable stream server and client framework based on C++11.

Build Status

中文

chenxiaolei 二次开发改进

  • 内置了 sqlite数据库来保存 推送配置
  • 增加了对 推送配置的 实时快超截图
  • FFmpeg拉的流, 也可以录像
  • 录像可以设置最多保留录像天数
  • 增加了对应推送配置的一系列api
  • 新增了一套 WEB UI界面来管理

安装

    //1, 安装 docker,docker-compose 
    ...
    
    //2, 制作docker镜像
    git clone https://github.com/chenxiaolei/ZLMediaKit
    docker build -t cl-zlmedia -f ./docker/Dockerfile .
    
    //3, 找个地方运行 docker 容器
    cp  ZLMediaKit/docker/docker-compose.example.yml  any_dir/docker-compose.yml
    cd  any_dir 
    docker-compose up -d
    
    //4, 访问管理页面
    open browser: http://127.0.0.1:10800

Why ZLMediaKit?

  • Developed based on C++ 11, the code is stable and reliable, avoiding the use of raw pointers, cross-platform porting is simple and convenient, and the code is clear and concise.
  • Support rich streaming media protocols(RTSP/RTMP/HLS/HTTP-FLV),and support Inter-protocol conversion.
  • Multiplexing asynchronous network IO based on epoll and multi thread，extreme performance.
  • Well performance and stable test,can be used commercially.
  • Support linux, macos, ios, android, Windows Platforms.
  • Very low latency(lower then one second), video opened immediately.

Features

  • RTSP

    • RTSP[S] server,support rtsp push.
    • RTSP player and pusher.
    • RTP Transport : rtp over udp rtp over tcp rtp over http rtp udp multicast .
    • Basic/Digest/Url Authentication.
    • H265/H264/AAC codec.
    • Recorded as mp4.
    • Vod of mp4.

  • RTMP

    • RTMP server,support player and pusher.
    • RTMP player and pusher.
    • Support HTTP-FLV player.
    • H264/AAC codec.
    • Recorded as flv or mp4.
    • Vod of mp4.

  • HLS

    • RTSP RTMP can be converted into HLS,built-in HTTP server.
    • Play authentication based on cookie.

  • HTTP[S]

    • HTTP server,suppor directory meun、RESTful http api.
    • HTTP client,downloader,uploader,and http api requester.
    • Cookie supported.
    • WebSocket Server.
    • File access authentication.

  • Others

    • Support stream proxy by ffmpeg.
    • RESTful http api and http hook event api.
    • Config file hot loading.
    • Vhost supported.
    • Auto close stream when nobody played.
    • Play and push authentication.
    • Pull stream on Demand.

  • Protocol conversion:

protocol/codec H264 H265 AAC other
RTSP[S] --> RTMP/HTTP[S]-FLV/FLV Y N Y N
RTMP --> RTSP[S] Y N Y N
RTSP[S] --> HLS Y Y Y N
RTMP --> HLS Y N Y N
RTSP[S] --> MP4 Y N Y N
RTMP --> MP4 Y N Y N
MP4 --> RTSP[S] Y N Y N
MP4 --> RTMP Y N Y N
  • Stream generation：
feature/codec H264 H265 AAC other
RTSP[S] push Y Y Y Y
RTSP proxy Y Y Y N
RTMP push Y Y Y Y
RTMP proxy Y N Y N
  • RTP transport:
feature/transport tcp udp http udp_multicast
RTSP[S] Play Server Y Y Y Y
RTSP[S] Push Server Y Y N N
RTSP Player Y Y N Y
RTSP Pusher Y Y N N
  • Server supported:
Server Y/N
RTSP[S] Play Server Y
RTSP[S] Push Server Y
RTMP Y
HTTP[S]/WebSocket Y
  • Client supported:
Client Y/N
RTSP Player Y
RTSP Pusher Y
RTMP Player Y
RTMP Pusher Y
HTTP[S] Y

System Requirements

  • Compiler support c++11，GCC4.8/Clang3.3/VC2015 or above.
  • cmake3.1 or above.
  • All Linux , both 32 and 64 bits
  • Apple OSX(Darwin), both 32 and 64bits.
  • All hardware with x86/x86_64/arm/mips cpu.
  • Windows.
  • You must use git to clone the complete code. Do not download the source code by downloading zip package. Otherwise, the sub-module code will not be downloaded by default.

How to build

It is recommended to compile on Ubuntu or MacOS，compiling on windows is cumbersome, and some features are not compiled by default.

Build on linux

  • My environment

    • Ubuntu16.04 64 bit and gcc5.4
    • cmake 3.5.1

  • Guidance

      # If it is on centos6.x, you need to install the newer version of GCC and cmake first, 
  # and then compile manually according to the script "build_for_linux.sh".
  # If it is on a newer version of a system such as Ubuntu or Debain,
  # step 4 can be manipulated directly.
  
  # 1、Install GCC5.2 (this step can be skipped if the GCC version is higher than 4.7)
  sudo yum install centos-release-scl -y
  sudo yum install devtoolset-4-toolchain -y
  scl enable devtoolset-4 bash
  
  # 2、Install cmake (this step can be skipped if the cmake version is higher than 3.1)
  tar -xvf cmake-3.10.0-rc4.tar.gz #you need download cmake source file manually
  cd cmake-3.10.0-rc4
  ./configure
  make -j4
  sudo make install
  
  # 3、Switch to high version GCC
  scl enable devtoolset-4 bash
  
  # 4、build
  cd ZLMediaKit
  ./build_for_linux.sh

Build on macOS

  • My environment

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

  • Guidance

    cd ZLMediaKit
./build_for_mac.sh

Build on iOS

This build method is no longer recommended.It is recommended that make Xcode project by yourself.

  • My environment

    Same with Build on macOS

  • Guidance

    cd ZLMediaKit
./build_for_ios.sh

  • You can also generate Xcode projects and recompile them:

    cd ZLMediaKit
mkdir -p build
cd build
# Generate Xcode project, project file is in build directory
cmake .. -DCMAKE_TOOLCHAIN_FILE=../cmake/iOS.cmake -DIOS_PLATFORM=SIMULATOR64 -G "Xcode"

Build on Android

Now you can open android sudio project in Android folder,this is a aar library and damo project.

  • My environment

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

  • Guidance

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

Build on Windows

  • My environment

  • Guidance

1 Enter the ZLMediaKit directory and execute git submodule update -- init downloads the code for ZLToolKit
2 Open the project with cmake-gui and generate the vs project file.
3 Find the project file (ZLMediaKit.sln), double-click to open it with vs2017.
4 Choose to compile Release version. Find the target file and run the test case.

Usage

  • As server：

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

  • As player：

     MediaPlayer::Ptr player(new MediaPlayer());
 weak_ptr<MediaPlayer> weakPlayer = player;
 player->setOnPlayResult([weakPlayer](const SockException &ex) {
     InfoL << "OnPlayResult:" << ex.what();
     auto strongPlayer = weakPlayer.lock();
     if (ex || !strongPlayer) {
         return;
     }

     auto viedoTrack = strongPlayer->getTrack(TrackVideo);
     if (!viedoTrack) {
         WarnL << "none video Track!";
         return;
     }
     viedoTrack->addDelegate(std::make_shared<FrameWriterInterfaceHelper>([](const Frame::Ptr &frame) {
         //please decode video here
     }));
 });

 player->setOnShutdown([](const SockException &ex) {
     ErrorL << "OnShutdown:" << ex.what();
 });

 //rtp transport over tcp
 (*player)[Client::kRtpType] = Rtsp::RTP_TCP;
 player->play("rtsp://admin:[email protected]/");

  • As proxy server：

     //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::Ptr player(new PlayerProxy("live",to_string(i++).data()));
 	player->play(url);
 	proxyMap.emplace(string(url),player);
 }

  • As puser：

     PlayerProxy::Ptr player(new PlayerProxy("app","stream"));
 player->play("rtmp://live.hkstv.hk.lxdns.com/live/hks");
 
 RtmpPusher::Ptr pusher;
 NoticeCenter::Instance().addListener(nullptr,Config::Broadcast::kBroadcastRtmpSrcRegisted,
 		[&pusher](BroadcastRtmpSrcRegistedArgs){
 	const_cast<RtmpPusher::Ptr &>(pusher).reset(new RtmpPusher(app,stream));
 	pusher->publish("rtmp://jizan.iok.la/live/test");
 });

Mirrors

ZLToolKit

ZLMediaKit

Licence

MIT License

Copyright (c) 2016-2019 xiongziliang <[email protected]>

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

Contact

About

A lightweight RTSP, RTMP, HTTP-FLV, WebSocket, HTTP server and client framework based on C++11

Resources

Readme

License

MIT license
Activity

Stars

18 stars

Watchers

1 watching

Forks

2 forks
Report repository

Releases

No releases published

Packages

No packages published

Languages

  • C 85.0%
  • C++ 13.6%
  • CMake 1.3%
  • Other 0.1%