跑通 API 示例项目

  • Unreal C++

更新时间

了解如何快速接入游戏语音,完成环境准备、参数配置、示例运行和核心流程验证。

本文介绍如何跑通游戏语音使用的音频 SDK 配套的 API 示例项目,体验实时音频互动:

前提条件

  • Unreal Engine 4.27 及以上版本
  • 两台设备,不可使用虚拟机。参考下方列出的 Unreal Engine 官方文档,根据你的目标平台和引擎版本准备开发环境:
    开发平台参考文档备注
    AndroidAndroid 开发环境要求无
    iOSiOS 开发环境要求有效的 Apple 开发者签名。
    macOSmacOS 开发环境要求有效的 Apple 开发者签名。
    WindowsWindows 开发环境要求32 位 Windows 仅支持 Unreal Engine 4 及以下版本,你需要在 AgoraPluginLibrary.Build.cs 文件中将 Windows 32 相关的代码取消注释。
    表格内容超出当前宽度,可横向滚动查看更多列。
  • 可以访问互联网的计算机。如果你的网络环境部署了防火墙,参考应对防火墙限制以正常使用声网服务。
  • 一个有效的声网账号以及声网项目。请参考开通 RTC 服务从声网控制台获得以下信息:
    • App ID:声网随机生成的字符串,用于识别你的项目。
    • 临时 Token:Token 也称为动态密钥,在客户端加入频道时对用户鉴权。临时 Token 的有效期为 24 小时。
    • 频道名:用于标识频道的字符串。

操作步骤

获取示例项目

  1. 运行以下命令克隆仓库到本地:

    Shell
    git clone git@github.com:AgoraIO-Extensions/Agora-Unreal-RTC-SDK.git
  2. 示例项目中包含如下:

    路径描述
    /Agora-Unreal-SDK-CPP-Example/Content/API-Example/Basic基础功能 API 示例。
    /Agora-Unreal-SDK-CPP-Example/Content/API-Example/Advance进阶功能 API 示例。
    表格内容超出当前宽度,可横向滚动查看更多列。

配置示例项目

参考以下步骤集成声网实时互动 Unreal SDK:

  1. 前往下载下载最新版本的 Unreal 视频 SDK,并解压缩。
  2. 在 /Agora-Unreal-SDK-CPP-Example 路径下,创建名为 Plugins 的文件夹。
  3. 将 Unreal SDK 文件夹中的 AgoraPlugin 拷贝到 Plugins 中。

编译并运行示例项目

在 Unreal Editor 中,你可以在主关卡中编译并运行示例项目。

  1. 在 C++ API 示例的路径下,双击 AgoraExample.uproject 打开项目。

  2. 双击 MainLevel,然后点击 编译按钮 编译并运行示例项目。

  3. 以 Windows 为例,运行成功后,你会看到如下界面,在文本框中填入你从控制台获取的 App ID、临时 Token 以及生成 Token 时使用的频道名。

  1. 此时,你可以点击左侧按钮,从主关卡导航到 API 示例的子关卡,体验指定的场景。以 BasicAudioCallScene 为例,点击 JoinChannel 加入频道。邀请一位朋友通过另一台设备来使用相同的 App ID、频道名和 Token 加入频道。你们可以体验音频通话。