Unreal Engine 音视频通话示例源码

Unreal Engine，又名虚幻引擎(UE)，它是由 Epic Games 开发，业界最强大且使用最广泛的游戏引擎之一。对于希望在 Unreal Engine 添加实时音视频通话或聊天以及游戏内提醒等实时功能的开发者，Unreal Engine 可与即构音视频 SDK 集成。本文介绍如何快速跑通示例源码，体验基础的音频/音视频通话服务。

准备环境

请确保开发环境满足以下技术要求：

安装 Unreal Engine 4.25 或以上版本。安装完成后，可根据需要配置选项。

根据示例代码需要运行到的平台，选择对应的开发环境或设备：
- 运行 Android 示例源码要求：Android 5.0 或以上版本，且支持音视频的 Android 设备或模拟器（推荐使用真机），如果是真机，请开启“允许调试”选项，详情请参考 Android 开发要求。
- 运行 iOS 示例源码要求：Xcode 15.0 或以上版本，iOS 12.0 或以上版本且支持音视频的 iOS 设备或模拟器（推荐使用真机）。
- 运行 macOS 示例源码要求：macOS 11 或以上版本，且支持音视频的 macOS 设备。注意：Unreal Engine 4.25 版本，与 M1 或以上系列处理器的 macOS 系统不兼容。
- 运行 Windows 示例源码要求：Windows 7 或以上版本，且支持音视频的 Windows 设备，并安装了 Visual Studio 2019 或以上版本，详情请参考硬件和软件规格。
- 确保所运行设备网络连接正常。

前提条件

已在 ZEGO 控制台创建项目，并申请有效的 AppID 和 AppSign，详情请参考控制台 – 项目管理中的“项目信息”。

示例源码目录结构

下列结构为工程目录的文件结构，下文所涉及的文件路径均为相对于此目录的路径。

.
├─ Config               # Unreal 配置文件夹
│  ├─ DefaultEditor.ini # Unreal Engine Editor 默认配置
│  ├─ DefaultEngine.ini # Unreal Engine 默认配置
│  └─ DefaultGame.ini   # Unreal Engine 游戏默认配置
├─ Content
│  └─ ZegoExpressExample # 关卡、蓝图文件
│     ├─ AdvancedAudioProcessing
│     │  └─ RangeAudio
│     │     ├─ BP_RangeAudio.uasset
│     │     └─ RangeAudioMap.umap
│     ├─ Blueprints
│     │  ├─ BP_MainWidget.uasset
│     │  ├─ BP_ZegoActor.uasset
│     │  ├─ BP_ZegoExpressExampleGameModeBase.uasset
│     │  ├─ BP_ZegoTileViewEntry.uasset
│     │  └─ ZegoUserWidgetEntry.uasset
│     ├─ MainMap.umap
│     └─ QuickStart
│        └─ CommonUsage
│           ├─ BP_CommonUsageWidget.uasset
│           └─ CommonUsageMap.umap
├─ Plugins  # SDK 插件
|
├─ README.md
├─ README_zh.md
├─ Source   # 源文件
│  ├─ ZegoExpressExample
│  │  ├─ AdvancedAudioProcessing
│  │  ├─ android_permission.xml
│  │  ├─ Config
│  │  ├─ EventHandler
│  │  ├─ KeyCenter.cpp  # 填写申请的 AppID 和 AppSign
│  │  ├─ KeyCenter.h    
│  │  ├─ LevelSwitchItem.cpp
│  │  ├─ LevelSwitchItem.h
│  │  ├─ QuickStart
│  │  ├─ Utils
│  │  ├─ ZegoActor.cpp
│  │  ├─ ZegoActor.h
│  │  ├─ ZegoExpressExample.Build.cs    # build 文件
│  │  ├─ ZegoExpressExample.cpp
│  │  ├─ ZegoExpressExample.h
│  │  ├─ ZegoExpressExampleGameModeBase.cpp
│  │  ├─ ZegoExpressExampleGameModeBase.h
│  │  ├─ ZegoLevelScriptActor.cpp
│  │  ├─ ZegoLevelScriptActor.h
│  │  ├─ ZegoMainUserWidget.cpp
│  │  ├─ ZegoMainUserWidget.h
│  │  ├─ ZegoUserWidget.cpp
│  │  └─ ZegoUserWidget.h
│  ├─ ZegoExpressExample.Target.cs  # target 文件
│  └─ ZegoExpressExampleEditor.Target.cs    # editor target 文件
└─ ZegoExpressExample.uproject  # Unreal 工程文件