跑通 API 示例项目

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

API-Examples

API-Examples

前提条件

• 已下载 Unity Hub。

• Unity 2018.4.0 或以上版本。

• 一个 Unity 项目，你可以参考 Unity 官方文档来创建一个项目。

• 操作系统与编译器要求：

  开发平台	操作系统版本	编译器版本
  Android	Android 4.1 或以上	Android Studio 3.0 或以上
  iOS	iOS 9.0 或以上	Xcode 9.0 或以上
  macOS	macOS 10.10 或以上	Xcode 9.0 或以上
  Windows	Windows 7 或以上	Microsoft Visual Studio 2017 或以上

• 计算机可以访问互联网。请确保你的网络环境未部署防火墙，否则可能无法正常使用声网服务。

• 一个有效的声网账号以及声网项目。请参考开通服务从声网控制台获得以下信息：

  • App ID：声网随机生成的字符串，用于识别你的项目。
  • 临时 Token：Token 也称为动态密钥，在客户端加入频道时对用户鉴权。临时 Token 的有效期为 24 小时。

操作步骤

获取示例项目

1. 你可以通过本文开头的 API 示例项目链接或通过下载最新版的 Unity SDK 来获取示例项目。获取后，你会看到一个 .unitypackage 文件。

2. 点击 .unitypackage 文件，会弹出一个 Import Unity Package 窗口，点击右下角的 Import 按钮把 Unity SDK 导入到你的 Unity 项目中。导入完成后，你可以在 Project 面板看到 Agora-RTC-PLUGIN 文件夹。

   

配置示例项目

在 Agora-RTC-PLUGIN/API-Example/AppIdInput.asset 中，填入你从声网控制台获取到的 App ID、临时 Token，以及在获取临时 Token 时填入的频道名。

编译并运行示例项目

API-Example 文件夹下包含 Basic 和 Advanced 两个文件，分别包含了声网 Unity SDK 的基础和进阶的使用示例（如下图所示）。

你可以邀请一位朋友使用另一台设备一起运行该示例项目（需确保 App ID、临时 Token 和频道名与你配置示例项目时填入的一致）。此处以你和朋友进行音频通话为例：你们选择 Basic 文件夹下的 JoinChannelAudio 场景，点击 Play 进行编译。编译成功后，你们可以体验音频通话。