文档中心

实时音视频

请输入

跑通示例项目

Linux 命令行版

快速开始 Demo 是 RTC 提供的包含基本功能的开源示例工程文件。获取该工程文件后，你可以快速构建应用，实现基本音视频通话功能；也能通过阅读代码，了解基本音视频通话的最佳实践。

前提条件

已获取 AppID 和临时 Token。参看开通服务。

安装在 x86 架构上的 Linux 系统。其中 glibc 版本不低于 2.27。

已安装以下音视频相关的库：

OpenGL

PulseAudio

已安装 CMake 3.13+。

已获取 RTC Demo 工程文件。

如果未安装 OpenGL 和 PulseAudio，参考以下方式安装：

sudo apt-get install build-essential​
sudo apt-get install libgl1-mesa-dev libglu1-mesa-dev​
sudo apt install pulseaudio libpulse-dev libva-dev​

编译通话应用

参考以下操作步骤，编译并运行音视频通话应用。

1. 构建 Demo 工程

在终端窗口下，进入 QuickStart_Terminal_Demo 目录，执行 cmake -B build 命令。命令成功执行后，将在 build 目录下生成工程。

2. 编译 Demo 工程

执行 cmake --build build 命令，进行编译。

3. 修改 Demo 配置

进入 build 目录，修改 config.json 文件。必填参数如下：

app_id 和 app_key：用于生成 Token，可在控制台获取。关于 Token参看使用 Token 完成鉴权。

room_id：自定义房间 ID。此后运行应用加入房间时，填写的房间 ID 应和此处的值完全一致。

user_id：自定义用户 ID。此后运行应用加入房间时，填写的用户 ID 应和此处的值完全一致。

你也可以修改其他参数：

字段	含义
enable_audio	打开或者关闭音频采集模块
enable_video	打开或者关闭视频采集模块
enable_external_audio	取值 false，表示开启内部音频采集。Linux SDK 暂不支持外部音频采集。
enable_external_video	是否开启外部视频采集。默认为 false 表示开启内部视频采集，这个也是 SDK 默认行为；true 表示开启外部视频采集，对应调用 setVideoSourceType，并设置主流 type=kVideoSourceTypeExternal。该字段只在打开视频采集模块功能即 enable_video=true 时生效。
audio_file	无需设置，Linux SDK 暂不支持外部音频采集。用于指定外部音频采集时使用到的 pcm 原始音频文件。
video_file	用于指定外部视频采集时使用到的 yuv 原始视频文件。当开启外部视频采集功能后，会读取文件 yuv 文件数据，然后每隔 1000/fps 毫秒循环调用 pushExternalVideoFrame 将原始视频数据编码后推送给远端用户。
video_capture_config	设置视频采集相关参数，包括分辨率、帧率。该字段只在视频内部采集开启情形下才会生效，对应 setVideoCaptureConfig。
video_encoder_config	设置视频编码相关参数，包括分辨率、帧率、码率，对应 setVideoEncoderConfig。码率默认推荐如下，取值范围是 [1000, 10000]。 19201080@60fps，推荐 6000kbps 19201080@30fps，推荐 4000kbps 19201080@15fps，推荐 2500kbps 1280720@60fps，推荐 4000kbps 1280720@30fps，推荐 3000kbps（默认码率） 1280720@15fps，推荐 2000kbps 640480@30fps, 推荐 1500kbps 640480@15fps, 推荐 1000kbps
audio_device_index	设置音频内部采集时使用的音频设备的索引值。设置索引值后，Demo 会根据此值，通过 setAudioCaptureDevice 设置音频设备。Demo 每次运行时，会调用 enumerateAudioCaptureDevices 枚举所有音频设备的索引、ID、和名称，并输出到终端。你可以根据终端日志，在此参数中设置索引值，再次重启后生效。
video_device_index	设置音频内部采集时使用的视频设备的索引值。设置索引值后，Demo 会根据此值，通过 setVideoCaptureDevice 设置视频设备。Demo 每次运行时，会调用 enumerateVideoCaptureDevices 枚举所有视频设备的索引、ID、和名称，并输出到终端。你可以根据终端日志，在此参数中设置索引值，再次重启后生效。

4. 运行 Demo

创建单个 RTC 应用后，进入应用目录，输入 ./rtccli，启动 Demo。

如果你创建了多个 RTC 应用，你可以打开多个终端，分别进入不同的应用目录，启动进程，推送视频流。

体验音视频通话功能

为更好地体验实时音视频互动效果，你可以邀请一位朋友使用另一台设备运行该示例项目（需确保两个设备配置示例项目时填入的 App ID 和 AppKey 一致）。当你们输入相同的房间名加入房间后，即可在同一房间中体验音视频通话。

后续步骤

在完成音视频互动后，你可以阅读以下文档进一步了解：

在测试或生产环境中，你需要使用 Token 进行鉴权。为保证通信安全，推荐从服务器中获取 Token，详情请参考使用 Token 完成鉴权。

在实现不同的视频通话场景时，你需要配置不同的视频发布参数以达到最佳效果，详情请参考设置视频发布参数。

最近更新时间：2026.08.04 14:28:55

这个页面对您有帮助吗？

有用

无用