跑通示例项目
本文介绍如何快速跑通多人音视频通话的示例项目 API-Demo(基于 Qt),体验音视频通话的基本/进阶功能。
账号申请
点此注册 一个账号,或者联系商务代为开通,或在网站咨询客服。
创建项目
可以在 管理平台 中创建新的项目(系统有一个默认项目,可以直接使用),如下图:

为了保障接口安全,后台不再显示 App Secret,所以请在创建项目成功显示 App Secret 时妥善保存好。 如果遗忘只能如下图更换 App Secret:

防火墙开通
在使用SDK 提供的相关服务之前,您需要打开下面这些特定的端口:
| 协议类型 | 端口 | 端口用途 | 适用SDK平台 | ||||
|---|---|---|---|---|---|---|---|
| Windows, macOS, Linux, Android, iOS | Web | 小程序 | 直播观看 | Web管理页面 | |||
| TCP | 2725 | Web管理后台端口 | √ | ||||
| 2726 | 信令端口1 | √ | √ | √ | √ | ||
| 2728 | 信令端口2 | √ | |||||
| 1935 | RTMP端口 | √ | √ | ||||
| UDP | 2698 | 音视频流媒体端口 | √ | ||||
| 2699 | 音视频流媒体端口(Web) | √ | |||||
编译示例代码
开发工具
Linux:
操作系统:CentOS 7+、Ubuntu 14+ 等 Linux(64 位)操作系统
编译器:g++4.8.5+
IDE:Qt Creator 4.11.0+, Qt 5.9.9+
Windows:
操作系统:Vista+
IDE:Qt Creator 4.0.3+, Qt 5.6.3+
macOS:
操作系统:macOS 10.15+
IDE:Qt Creator 4.0.3+, Qt 5.9.9+, Xcode 14.0+
以下以 Linux 平台为例进行说明。
集成SDK
-
将 API-Demo 仓库拉取到本地。
-
访问 SDK 下载中心 将 Linux SDK 下载到本地,解压后将 include 目录和 lib 目录复制到 API-Demo/CRVideoSDK 目录下。
编译步骤
- 在 API-Demo 目录下,用 Qt Creator 打开 APIDemo.pro 文件。在项目配置页面的开发环境选择中,选择 Desktop Qt 5.x.x GCC 64bit

-
在 Qt Creator 左边的项目管理器中,右键 APIDemo 并选择构建
-
构建完成后,按 Ctrl + R 或点击左下角运行按钮运行程序


示例项目结构
下表列出示例项目在 Qt Creator 项目管理器中的代码结构,你可以参考示例项目的代码,根据自己的需求进行调整。
| 文件夹 |
描述 |
|---|---|
| src |
应用的主要逻辑。包括: src/Common : 通用文件 src/Controls : 通用控件 src/TestAudioSetting : 音频设置功能 src/TestCustomAudioCapture : 自定义音频采集功能 src/TestCustomVideoCaptureRender : 自定义视频采集/渲染功能 src/TestEchoTest : 声音环回测试功能 src/TestLocRecord : 本地录制功能 src/TestScreenShare : 屏幕共享功能 src/TestMediaPlay : 影音共享功能 src/TestRoomMsg : 房间消息功能 src/TestRoomUsrAttrs : 房间/成员属性功能 src/TestSvrRecord : 云端录制功能 src/TestVideoSetting : 视频设置功能 src/TestVideoWall : 视频墙功能 src/TestVoiceChange : 变声功能 src/Dlgxxx.h src/Dlgxxx.cpp : 主要对话框 |
| Forms |
用户界面,包括对话框、窗口、控件的定义 |
| Resources |
资源文件 |
至此,准备工作已经完成,可以开始实现音视频通话了。