跑通 API 示例项目

  • Unity

更新时间

了解如何快速接入实时互动 RTC,完成环境准备、参数配置、示例运行和核心流程验证。

声网提供了开源的 SDK 示例项目,展示了各种基础和进阶的场景。本文以跑通视频通话示例项目为例,帮助你快速体验声网视频通话效果。

前提条件

  • 已下载 Unity Hub。

  • Unity 2018.4.0 或以上版本。

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

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

    开发平台操作系统版本编译器版本
    AndroidAndroid 4.1 或以上Android Studio 3.0 或以上
    iOSiOS 9.0 或以上Xcode 9.0 或以上
    macOSmacOS 10.10 或以上Xcode 9.0 或以上
    WindowsWindows 7 或以上Microsoft Visual Studio 2017 或以上
    表格内容超出当前宽度,可横向滚动查看更多列。
  • 计算机可以访问互联网。请确保你的网络环境未部署防火墙,否则可能无法正常使用声网服务。

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

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

操作步骤

获取示例项目

  1. 前往下载页面,下载最新版的 Unity 视频 SDK,下载完成后你会看到一个 .unitypackage 文件。

    信息

    你也可以直接将上文提到的 API-Examples 示例项目克隆到你的项目路径下,以获取示例项目。

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

配置示例项目

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

编译并运行示例项目

  1. API-Example 文件夹下包含 Basic 和 Advanced 两个文件,分别包含了声网 Unity SDK 的基础和进阶场景的使用示例(如下图所示)。选择一个你想要尝试的场景,点击 Play 进行编译。

  2. 以视频通话为例,编译成功后你可以看到自己本地的视频预览。

  3. 为更好地体验各种音视频互动场景,你可以邀请一位朋友使用另一台设备运行该示例项目(需确保 App ID、临时 Token 和频道名与你配置示例项目时填入的一致)。当你们输入相同的频道名加入频道后,即可在同一频道中体验各种互动场景。