实时音视频
实时音视频
文档指南
请输入
实时音视频
快速入门
场景方案
开发指南
Token 鉴权
音频管理
视频管理
屏幕共享
SDK 升级指南
客户端 API 参考
服务端 API 参考
房间管理
转推直播
输入在线媒体流
WTN 流（原公共流）
实时数据监控
历史数据查询
业务标识管理
实时消息通信
历史版本（文档停止维护）
2023-08-01
2023-06-01
转推直播
2022-06-01
2020-12-01
转推直播
输入在线媒体流
获取数据指标
常见问题
集成相关
质量相关
AI 音视频互动方案
开发指南
配置 ASR/LLM/TTS 服务
API 参考
硬件对话智能体
用户指南
服务端 API
智能体
实时信令
互动白板
客户端 API 参考
服务端 API 参考
- 文档首页
实时音视频实时音视频快速入门跑通示例项目macOS
复制全文
下载 pdfmacOS
文档反馈
问问助手火山引擎 RTC 提供了开源示例项目 API Example Demo。获取该项目后，你可以参照本文进行跑通，体验实时音视频功能；也能通过阅读代码，了解最佳实践。
前提条件
在开始集成 RTC SDK 前，请确保满足以下要求：
- macOS 11.0 或以上版本设备，且可以正常访问互联网
- Qt 6 或以上版本，详细操作参看如何在 macOS 上安装 Qt？
- Xcode 14.0 或以上版本
- 麦克风、摄像头等音视频设备
获取示例项目
你可以从以下方式中选择一种获取示例项目：
- 下载离线包。
- 通过 GitHub 获取示例项目，具体指令如下：
- git clone https://github.com/volcengine/VolcEngineRTC.gitcd VolcEngineRTCgit checkout maincd Windows
示例项目的目录结构如下：
.
├── 3rd
│ ├── Windows
│ └── mac
├── API_Example.pro
├── CMakeLists.txt
├── README.md
├── Resources
├── bin
├── resources.qrc
└── src
├── Basic // 快速开始 https://www.volcengine.com/docs/6348/1169314
│ ├── QuickStartWidget.cpp
│ ├── QuickStartWidget.h
│ └── QuickStartWidget.ui
├── Advanced
│ ├── AudioMixing // 播放音乐文件 https://www.volcengine.com/docs/6348/70141、播放音效 https://www.volcengine.com/docs/6348/1178326
│ ├── ByteBeauty // 智能美化特效（付费版） https://www.volcengine.com/docs/6348/114717
│ ├── CDNStream // 推流到 CDN https://www.volcengine.com/docs/6348/69817
│ ├── CrossRoomPK // 跨房 PK https://www.volcengine.com/docs/6348/104398
│ ├── FuBeauty // 自定义视频处理（相芯美颜） https://www.volcengine.com/docs/6348/79888
│ ├── Message // 发送和接收媒体补充增强信息(SEI) https://www.volcengine.com/docs/6348/70140
│ ├── MultiRoom // 多房间 https://www.volcengine.com/docs/6348/196844
│ ├── RawAudioData // 原始音频数据 https://www.volcengine.com/docs/6348/1178324
│ ├── SoundEffects // 变声、混响、降噪 https://www.volcengine.com/docs/6348/1178327
│ └── VideoConfig // 视频参数配置 https://www.volcengine.com/docs/6348/70122、视频采集旋转方向 https://www.volcengine.com/docs/6348/106458
├── Info.plist
├── Public
├── app.ico
├── main.cpp
├── mainwindow.cpp
├── mainwindow.h
├── mainwindow.ui
└── resources.rc
配置示例项目
- 在控制台上获取 AppID 和 AppKey，并将其分别填入 src/Public/Config.h 中的 g_appid 和 g_appkey。请正确填写信息，否则编译无法成功。
- （可选）示例项目中智能美化特效、相芯美颜、美声与特效功能需要单独填写鉴权信息。不填写鉴权信息不会影响 Demo 的编译运行，但你将无法体验相关功能。
- 智能美化特效：在 src/Public/Config.h 填写 g_byte_beauty_key 和 g_byte_secret，请联系智能美化特效商务团队获取相关信息。
- 相芯美颜：在 src/Advanced/FuBeauty/authpack.h 填写 g_auth_package，请发送邮件至 marketing@faceunity.com 进行咨询。
编译并运行示例项目
- 打开 Qt 安装路径下的 Qt Creator。使用 Qt Creator 打开 API_Example.pro，并选择已安装的构建套件。
-
- 单击 Qt Creator 窗口左下角的运行按钮（或使用 Command ⌘ + R 快捷键），运行效果如下：
-
体验音视频通话功能
为更好地体验实时音视频互动效果，你可以邀请一位朋友使用另一台设备运行该示例项目（需确保两个设备配置示例项目时填入的 App ID 和 AppKey 一致）。当你们输入相同的房间名加入房间后，即可在同一房间中体验音视频通话。
后续步骤
在完成音视频互动后，你可以阅读以下文档进一步了解：
- 在测试或生产环境中，你需要使用 Token 进行鉴权。为保证通信安全，推荐从服务器中获取 Token，详情请参考使用 Token 完成鉴权。
- 在实现不同的视频通话场景时，你需要配置不同的视频发布参数以达到最佳效果，详情请参考设置视频发布参数。
常见问题
相关文档
- 发版说明
- 高级功能
- 最佳实践
- 场景方案
最近更新时间：2026.08.04 14:28:55
这个页面对您有帮助吗？
有用
有用
无用
无用