示例源码运行指引

本文介绍如何快速跑通示例源码，体验基础的音视频流录制功能。

前提条件

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

运行示例源码

假定将本地服务端录制 Demo 放到 “/root” 目录下，Demo 的目录如下：

.
├─ libs
    ├─ commons-cli-1.4.jar        # 命令参数解析 jar 包
    ├─ commons-codec-1.15.jar     # 通用工具 jar 包
    ├─ libzegoliveroomrecorder.so # 录制 SDK so
    ├─ ZegoLiveRoom.jar           # 录制 SDK jar 包
├─ LiveRoomDemo.iml
├─ out                            # demo 产物输出目录
├─ src                            # 源码

1. 执行 cd ～/ZegoServerRecordingDemo 命令，切换到 “ZegoServerRecordingDemo” 目录。

2. 执行 cd out/artifacts/playrecorder_demo_jar 命令，切换到 “playrecorder_demo_jar” 目录。

3. 执行 java -Djava.library.path=./../../../libs -cp playrecorder-demo.jar com.zego.record.LiveRoomRecorder -a {app_id} -k {token} -r {room_id} -u {user_id} 命令，运行 demo，开启单流录制。其中，

• “app_id”，指您在 前提条件 获取到的 AppID。
• “room_id”，指您需要进行数据流录制的房间 ID。
• “user_id”，指您登录房间所对应的用户 ID。
• “token”，指登录录制流所属房间的鉴权 Token。
• 如果您不设置其它附加参数，默认录制时长为 20s，录制单流，生成一个 .mp4 音视频文件。

命令行参数说明

可选命令行附加参数如下：

• -a：项目的 AppID。
• -r：录制流所属的房间 ID。
• -u：登录录制流所属房间的用户 ID。
• -k：登录录制流所属房间的鉴权 Token。
• -d：录制时长，单位为分钟。
• -m：录制模式。
  • 1 表示只录制单流。
  • 2 表示只录制混流。
  • 3 表示同时录制单流和混流。
• -s：单流录制类型。
  • 1 表示只录制音频。
  • 2 表示只录制视频。
  • 3 表示录制音、视频。
• -x：混流录制类型。
  • 1 表示只录制音频。
  • 2 表示只录制视频。
  • 3 表示录制音、视频。
• -o：录制输出方式。
  • 1 表示只生成录制文件。
  • 2 表示只返回音视频数据。
• -t：输出的录制文件类型。
• -g：生成 mp4 文件同时生成 mp3 文件。
• -b：缓存大小，取值范围是 64KB ~ 1 MB，默认是 1 MB。