需要访问旧版文档站？前往旧版文档官网首页。 (在新标签页打开)
声网文档中心

跑通示例项目

更新时间不可用

了解如何跑通平行操控示例项目，完成环境准备、参数配置、示例运行和核心流程验证。

声网平行操控 SDK 支持主流的 Linux、Android 设备端平台，Windows、Web、Linux、Android、iOS、macOS 操控端平台。

本文以 Linux 设备端和 Linux 操控端为例，介绍如何快速跑通平行操控示例项目，体验实时互通效果。

信息

如需体验其他设备端和操控端的示例项目，请联系 sales@shengwang.cn 获取，并参照 README.md 的步骤跑通。

准备开发环境

参考如下要求分别准备硬件环境和软件环境。

硬件环境

请确保你的 Linux 设备上有可用的摄像头。可通过 ls /dev/video* 命令查看全部可用摄像头。

操作系统

你的操作系统需要满足如下要求：

  • Ubuntu（14.04 版本及以上）
  • CentOS（6.6 版本及以上）

CPU 架构

x86-64。如需支持其他架构，请联系 sales@shengwang.cn。

性能要求

设备性能需要满足以下要求：

  • CPU：8 核，1.8 GHz 主频
  • 内存：4 GB 或更高

网络要求

  • 服务器接入公网，有公网 IP
  • 服务器允许访问 .agora.io 以及 .agoralab.co

软件环境

安装如下软件或依赖库：

  • glibc 2.18 或更高版本
  • gcc 4.8 或更高版本
  • 根据设备的操作系统，安装需要的依赖：
Shell
# 安装 aptitude
sudo apt install aptitude
# 安装 build-essential libx11-dev libxcomposite-dev libxext-dev libxfixes-dev libxdamage-dev cmake
sudo aptitude install libx11-dev libxcomposite-dev libxext-dev libxfixes-dev libxdamage-dev cmake

获取 SDK

联系销售 sales@shengwang.cn 获取平行操控 Linux SDK。

编译示例项目

参考如下步骤编译示例项目。

  1. 解压 SDK 包，其中包含的示例项目如下：

    Shell
    ├── agora_sdk   # 声网的 SDK 库文件和头文件
└── example     # 示例代码
    └── out
        ├── capture_time_test          # 测试摄像头采集延时
        ├── sample_audio               # 单独发送音频流
        ├── sample_receive_h264_pcm    # 接收 H.264 数据
        ├── sample_receive_rtm_message # 接收实时控制信令
        ├── sample_receive_yuv_pcm     # 接收 YUV 数据
        ├── sample_send_capture_yuv    # 采集并发送 YUV 数据
        ├── sample_send_h264_pcm       # 发送 H.264 数据
        ├── sample_send_rtm_message    # 发送实时控制信令
        └── sample_send_yuv_pcm        # 发送 YUV 数据

  2. 运行如下命令行，进入示例项目目录。

    Shell
    cd agora_rtc_sdk/example/

  3. （可选）如果你对源码进行了更改，则需运行 build.sh 脚本将更新后的源码编译成可执行文件。

    Shell
    ./build.sh

  4. 将 SDK 中的库导出到 LD_LIBRARY_PATH。

    Shell
    export LD_LIBRARY_PATH=./../agora_sdk/

体验音视频流互通

本章节演示 Linux 设备端和 Linux 操控端之间的音视频流互通。

信息

本章节仅演示 YUV 原始视频数据的采集和收发。如需体验收发编码后的 H.264 格式的视频数据，请先运行 ./sync-data.sh 命令获取相应的音频和视频文件。

设备端采集并发送音视频流

以 sample_send_capture_yuv 为例，演示设备端采集并发送音视频流。命令行示例如下：

Shell
# 在 example 目录下运行 sample_send_capture_yuv，采集并发送 YUV 数据
./out/sample_send_capture_yuv --channelId hellortc --token 00xxxxxxxxxxwY= --device /dev/video1

该可执行文件使用 Linux 设备上的摄像头进行视频的采集传输，有如下参数可供设置：

参数描述数据类型是否必须
token传入 App ID 或 Token。如果项目已开启 App 证书，则必须传 Token。详见开通平行操控服务。String必填
channelId频道名。String必填
userId

设备端的用户 ID，默认值为 0，表示声网随机分配一个用户 ID。如需自行指定，需满足以下条件：

  • 仅支持传入内容为数值的字符串
  • 用户 ID 在频道内唯一
String选填
fps摄像头采集的视频帧率 (fps)，默认值为 30。该值需要根据实际的摄像头规格进行调整。Integer选填
width视频宽 (px)，默认值为 640。该值需要根据实际的摄像头规格进行调整。Integer选填
height视频高 (px)，默认值为 480。该值需要根据实际的摄像头规格进行调整。Integer选填
bitrate视频码率 (Mbps)，默认值为 1。该值可根据实际的视频属性和网络状况进行调整。Integer选填
device摄像头名称，默认采集 /dev/video0。你可以通过 ls /dev/video* 命令查看当前设备上所有摄像头的名称。String选填
表格内容超出当前宽度，可横向滚动查看更多列。

运行成功后，你的终端会打印如下信息表明设备端正在采集并发送视频数据：

Shell
[ APP_LOG_INFO ] Start sending video data ...

操控端接收音视频流

以 sample_receive_yuv_pcm 为例，演示操控端接收视频流。命令行示例如下：

Shell
# 在 example 目录下运行 sample_receive_yuv_pcm，接收 YUV 数据
./out/sample_receive_yuv_pcm --channelId hellortc --token 00xxxxxxxxxxY=

该可执行文件在 Linux 操控端接收音视频流，有如下参数可供设置：

参数描述数据类型是否必须
token传入与发送端相同的 App ID 或 Token。String必填
channelId传入与发送端相同的频道名。String必填
userId

操控端的用户 ID，默认值为 0，表示声网随机分配一个用户 ID。如需自行指定，需满足以下条件：

  • 仅支持传入内容为数值的字符串
  • 用户 ID 在频道内唯一
String选填
remoteUserId默认为空，表示接收频道内全部设备端的音视频流。如果你只想接收指定设备端的音视频流，则需将该字段设置为对应设备端的用户 ID。String选填
audioFile接收音频流的存储文件，默认为 received_audio.pcm。String选填
videoFile接收视频流的存储文件，默认为 received_video.yuv。String选填
sampleRate音频帧的采样率 (Hz)，默认值为 16000。Integer选填
numOfChannels音频的声道数，默认值为 1。Integer选填
streamType视频流类型。默认值为 STREAM_TYPE_HIGH，使用大流，分辨率和码率较高。如需使用分辨率和码率较低的小流，可以指定 VIDEO_STREAM_LOW。String选填
表格内容超出当前宽度，可横向滚动查看更多列。

运行成功后，你的终端会打印如下信息表明操控端正在接收设备端发送的音视频流：

Shell
[ APP_LOG_INFO ] Subscribe streams from all remote users
[ APP_LOG_INFO ] Start receiving audio & video data ...

体验控制信令互通

在实际场景中，设备端和操控端会互相收发控制信令。本章节演示 Linux 设备端和 Linux 操控端之间的控制信令互通。

发送控制信令

以 sample_send_rtm_message 为例，演示发送控制信令。命令行示例如下：

Shell
# 在 example 目录下运行 sample_send_rtm_message 发送控制信令
./out/sample_send_rtm_message --token cdxxxxxxxxxxb1 --channelId hellortm --topic rtm --userId 123 --remoteUserId 321

运行该可执行文件发送控制指令，有如下参数可供设置：

参数描述数据类型是否必须
token传入 App ID 或 Token。如果项目已开启 App 证书，则必须传 Token。详见开通平行操控服务。String必填
channelId频道名。String必填
topic频道内的 Topic 名称。String必填
userId当前用户的用户 ID，仅支持传入内容为数值的字符串。String必填
remoteUserId远端用户的用户 ID，仅支持传入内容为数值的字符串。String必填
receive是否订阅远端消息。Boolean选填
表格内容超出当前宽度，可横向滚动查看更多列。

运行成功后，你的终端会打印如下信息表明正在发送控制信令：

Shell
[ APP_LOG_INFO ] join channel 0
[ APP_LOG_INFO ] it is join topic 0

接收控制信令

以 sample_receive_rtm_message 为例，演示接收对端发送的控制信令。命令行示例如下：

Shell
# 在 example 目录下运行 sample_receive_rtm_message 接收控制信令
./out/sample_receive_rtm_message --token cdxxxxxxxxxxb1 --channelId hellortm --topic rtm --userId 321 --remoteUserId 123

运行该可执行文件接收控制信令，有如下参数可供设置：

参数描述数据类型是否必须
token传入与发送端相同的 App ID 或 Token。String必填
channelId传入与发送端相同的频道名。String必填
topic传入与发送端相同的 Topic。String必填
userId当前用户的用户 ID，即发送端的 remoteUserId。String必填
remoteUserId远端用户的用户 ID，即发送端的 userId。String必填
answer是否订阅远端消息。Boolean选填
表格内容超出当前宽度，可横向滚动查看更多列。

运行成功后，你的终端会打印如下信息表明正在接收对端发送的控制信令：

Shell
[ APP_LOG_INFO ] join channel is 0
[ APP_LOG_INFO ] join topic is 0
sub is 0
send ts: 11:35:28.053, receive ts: 11:35:28.080
send ts: 11:35:28.073, receive ts: 11:35:28.096
send ts: 11:35:28.094, receive ts: 11:35:28.113
send ts: 11:35:28.115, receive ts: 11:35:28.134
send ts: 11:35:28.135, receive ts: 11:35:28.154

咨询电话

400 632 6626

上海声网科技有限公司

Copyright © 2026 声网保留所有权利