音视频通话

跑通示例项目

本文介绍如何快速跑通多人音视频通话的示例项目 API-Demo(基于 Qt),体验音视频通话的基本/进阶功能。

账号申请

点此注册 一个账号,或者联系商务代为开通,或在网站咨询客服。

创建项目

可以在 管理平台 中创建新的项目(系统有一个默认项目,可以直接使用),如下图:
GetAPPID

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

防火墙开通

在使用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

  1. 将 API-Demo 仓库拉取到本地。

  2. 访问 SDK 下载中心 将 Linux SDK 下载到本地,解压后将 include 目录和 lib 目录复制到 API-Demo/CRVideoSDK 目录下。

编译步骤

  1. 在 API-Demo 目录下,用 Qt Creator 打开 APIDemo.pro 文件。在项目配置页面的开发环境选择中,选择 Desktop Qt 5.x.x GCC 64bit

selectKits

  1. 在 Qt Creator 左边的项目管理器中,右键 APIDemo 并选择构建

  2. 构建完成后,按 Ctrl + R 或点击左下角运行按钮运行程序

loginDlg

mainDlg

示例项目结构

下表列出示例项目在 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

资源文件

至此,准备工作已经完成,可以开始实现音视频通话了。