跑通示例源码

前提条件

• 已在 ZEGO 控制台 创建项目，并申请有效的 AppID，详情请参考 控制台 - 项目管理 中的“项目信息”。

• 开发和运行环境需满足以下要求：

  • 操作系统与架构：x86_64 架构的 Linux 操作系统
  • C 运行库：glibc 2.18 或以上
  • C++ 编译器：GCC / G++ 4.8.5 或以上，启用 C++11
  • 构建工具：CMake 3.21.2 或以上、Make
  • 命令行工具：Bash、curl、unzip
  • 底层依赖库：libasound(ALSA)、libv4l2(v4l utils)
  • 操作系统与架构：x86_64 架构的 Linux 操作系统
  • C 运行库：glibc 2.18 或以上
  • Java 开发工具： 64 位 JDK 8 或以上，包含 java、javac 和 jar 命令
  • 命令行工具：Bash、curl、unzip
  • 底层依赖库：libasound(ALSA)、libv4l2(v4l utils)
  说明

  • SDK 依赖 libasound (ALSA) 和 libv4l2 (v4l utils)。
  • CentOS (RHEL/Fedora) 可以通过执行 yum install alsa-lib-devel libv4l-devel 命令安装。
  • Ubuntu (Debian/Deepin) 可以通过执行 apt install libasound2-dev libv4l-dev 命令安装。
  • 其他平台和系统请自行安装。
  • 若需要交叉编译，请参考 如何交叉编译 Linux alsa-lib 依赖库？ 和 如何交叉编译 Linux v4l-utils 依赖库？ 两篇文档，同时目标机器需安装好 libasound 和 libv4l2 依赖库。

  可通过以下命令检查服务器的运行环境是否符合要求：

  uname -m                         # 应输出 x86_64
  getconf GNU_LIBC_VERSION          # 应为 glibc 2.18 或以上
  g++ --version
  cmake --version
  make --version

  uname -m                         # 应输出 x86_64
  getconf GNU_LIBC_VERSION          # 应为 glibc 2.18 或以上
  g++ --version
  cmake --version
  make --version

  uname -m                         # 应输出 x86_64
  getconf GNU_LIBC_VERSION          # 应为 glibc 2.18 或以上
  java -version
  javac -version

  uname -m                         # 应输出 x86_64
  getconf GNU_LIBC_VERSION          # 应为 glibc 2.18 或以上
  java -version
  javac -version

下载示例源码

示例源码目录结构

.
├──docs
└──cpp
    ├── CMakeLists.txt
    ├── README.md
    ├── build.sh
    ├── demo_config.yaml
    ├── run.sh
    ├── sdk
    │   ├── Document
    │   ├── Library
    │   └── VERSION.txt
    └── src
        ├── CommandLine.h
        ├── LiveRoomRecorder.cpp
        ├── LiveRoomRecorder.h
        ├── RecorderConfig.h
        ├── Yaml.cpp
        ├── Yaml.hpp
        └── main.cpp

.
├──docs
└──cpp
    ├── CMakeLists.txt
    ├── README.md
    ├── build.sh
    ├── demo_config.yaml
    ├── run.sh
    ├── sdk
    │   ├── Document
    │   ├── Library
    │   └── VERSION.txt
    └── src
        ├── CommandLine.h
        ├── LiveRoomRecorder.cpp
        ├── LiveRoomRecorder.h
        ├── RecorderConfig.h
        ├── Yaml.cpp
        ├── Yaml.hpp
        └── main.cpp

.
├──docs
└──java
    ├── README.md
    ├── build.sh
    ├── demo_config.yaml
    ├── libs
    │   └── snakeyaml-1.33.jar
    ├── run.sh
    ├── sdk
    │   ├── Document
    │   ├── Library
    │   └── VERSION.txt
    └── src
        └── com/zego
            ├── CommandLine.java
            ├── Main.java
            ├── config
            └── record

.
├──docs
└──java
    ├── README.md
    ├── build.sh
    ├── demo_config.yaml
    ├── libs
    │   └── snakeyaml-1.33.jar
    ├── run.sh
    ├── sdk
    │   ├── Document
    │   ├── Library
    │   └── VERSION.txt
    └── src
        └── com/zego
            ├── CommandLine.java
            ├── Main.java
            ├── config
            └── record

运行示例源码

bash build.sh

bash build.sh

# 复制配置文件模版
cp demo_config.yaml local_config.yaml

# 复制配置文件模版
cp demo_config.yaml local_config.yaml

bash run.sh start --config ./local_config.yaml

bash run.sh start --config ./local_config.yaml

ffprobe -v error -show_entries format=duration,size \
  -show_entries stream=codec_type,codec_name,width,height \
  -of json /absolute/path/to/recording.mp4

ffprobe -v error -show_entries format=duration,size \
  -show_entries stream=codec_type,codec_name,width,height \
  -of json /absolute/path/to/recording.mp4

常见问题