# 实现音视频互动 (/zh-CN/realtime-media/rtc/get-started/quick-start/unity) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). 本文介绍如何集成声网实时互动 SDK,通过少量代码从 0 开始实现一个简单的实时互动 App,适用于互动直播和视频通话场景。 首先,你需要了解以下有关音视频实时互动的基础概念: - 声网实时互动 SDK:由声网开发的、帮助开发者在 App 中实现实时音视频互动的 SDK。 - 频道:用于传输数据的通道,在同一个频道内的用户可以进行实时互动。 - 主播:可以在频道内**发布**音视频,同时也可以**订阅**其他主播发布的音视频。 - 观众:可以在频道内**订阅**音视频,不具备**发布**音视频权限。 更多概念详见[关键概念](/zh-CN/realtime-media/rtc/reference/key-concept)。 下图展示在 App 中实现音视频互动的基本工作流程: 1. 所有用户调用 `joinChannel` 方法加入频道,并根据需要设置用户角色: - 互动直播:如果用户需要在频道中发流,则设为主播;如果用户只需要收流,则设为观众。 - 视频通话:将所有用户的角色都设为主播。 2. 加入频道后,不同角色的用户具备不同的行为: - 所有用户默认都可以接收频道中的音视频流。 - 主播可以在频道内发布音视频流。 - 观众如果需要发流,可在频道内调用 `setClientRole` 方法修改用户角色,使其具备发流权限。 ## 前提条件 [#前提条件-8] 在实现功能以前,请按照以下要求准备开发环境: - 已下载 [Unity Hub](https://unity.com/download)。 - Unity 2018.4.0 或以上版本。 - 可以访问互联网的计算机。如果你的网络环境部署了防火墙,参考[应对防火墙限制](/zh-CN/realtime-media/rtc/build/setup-and-access/firewall)以正常使用声网服务。 - 不同开发平台的操作系统与编译器需满足下列版本要求: | 开发平台 | 操作系统版本 | 编译器版本 | | --- | --- | --- | | 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 或以上 | - 一个有效的声网账号以及声网项目。请参考 [开通 RTC 服务](/zh-CN/realtime-media/rtc/build/setup-and-access/enable-service),从声网控制台获得 App ID 和临时 Token。 :::warning[注意] 临时 Token 的有效期是 24 小时。Token 过期会导致加入频道失败。 ::: ## 创建项目 [#创建项目-7] 参考以下步骤或 [Unity 官方文档](https://docs.unity.com/en-us/hub/project-create)创建一个 **Unity** 项目。若已有 **Unity** 项目,可略过此步骤至下一步[集成 SDK](#integrate)。 1. 开始前确保你已安装 Unity。若未安装,点击[此处](https://unity.com/cn/products#plans-individual)下载。 2. 打开 Unity Editor,点击 **New** 新建一个项目。 3. 依次填入以下内容后,点击 **Create project** 创建一个 Unity 项目。 - **Project name**:项目名称。 - **Location**:项目存储路径。 - **Template**:项目类型。选择 **3D**。 ## 集成 SDK [#集成-sdk-7] 参考下列步骤来集成声网实时互动 SDK: 1. 前往[下载](/zh-CN/realtime-media/rtc/reference/downloads)页面,下载最新版的 Unity SDK。 2. 下载完成后在你的 Unity 编辑器中打开下载好的 SDK 包并取消勾选不需要的插件(默认会勾选 SDK 包含的所有插件),然后点击 **Import** 来导入 SDK。 ## 创建用户界面 [#创建用户界面-6] 根据应用场景为你的项目创建一个用户界面(UI)。 例如,你可以在 UI 上添加以下控件: - 本地视图窗口 - 远端视图窗口 - 加入/离开频道按钮 创建好的用户界面如下图所示: ![Unity 用户界面示意图](https://web-cdn.agora.io/docs-files/1657121618456) 你可以参考以下步骤创建 UI。若你的项目中已有用户界面可略过此步骤。 1. 创建加入/离开频道按钮。 1. 在你的 Unity 项目中,右击 **Sample Scene**,选择 **Game Object** > **UI** > **Button**。此时你可以在场景画布中看到你刚刚创建的按钮。 2. 在右侧的 **Inspector** 面板中,将 **Button** 重命名为 **Leave**。选中 **Button** 按钮的 **Text** 控件,将 **Text** 的文本内容修改为 **Leave**,并调整按钮的位置,例如: - **Pos X**:`- 350` - **Pos Y**:`- 172` 3. 重复上述步骤来创建一个 **Join** 按钮。 2. 创建本地及远端视图窗口。 1. 右击 **Canvas**,选择 **UI** > **Raw Image**。 2. 创建本地视图窗口。在右侧的 **Inspector** 面板中,将 **Raw Image** 重命名为 **LocalView**,并调整在画布中位置,例如: - **Pos X**:`-250` - **Pos Y**:`0` - **Width**:`250` - **Height**:`250` 3. 重复上述步骤创建远端视图窗口,将其命名为 **RemoteView**,并调整在画布中的位置,例如: - **Pos X**:`250` - **Pos Y**:`0` - **Width**:`250` - **Height**:`250` 3. 保存上述步骤的更改。 ## 实现步骤 [#实现步骤-8] 本小节介绍如何实现一个实时音视频互动 App。你可以先复制完整的示例代码到你的项目中,快速体验实时音视频互动的基础功能,再按照实现步骤了解核心 API 调用。 下图展示了使用声网 RTC SDK 实现音视频互动的基本流程: :::info[信息] 在 `_appId`、`_token` 和 `_channelName` 字段中传入你在控制台获取到的 App ID、临时 Token,以及生成临时 Token 时填入的频道名。 ::: ```csharp using System.Collections; using System.Collections.Generic; using UnityEngine; using UnityEngine.UI; using Agora.Rtc; #if (UNITY_2018_3_OR_NEWER && UNITY_ANDROID) using UnityEngine.Android; #endif public class JoinChannelVideo : MonoBehaviour { // 填入你的 app ID private string _appID= ""; // 填入你的频道名 private string _channelName = ""; // 填入 Token private string _token = ""; internal VideoSurface LocalView; internal VideoSurface RemoteView; internal IRtcEngine RtcEngine; #if (UNITY_2018_3_OR_NEWER && UNITY_ANDROID) private ArrayList permissionList = new ArrayList() { Permission.Camera, Permission.Microphone }; #endif void Start() { SetupVideoSDKEngine(); InitEventHandler(); SetupUI(); PreviewSelf(); } void Update() { CheckPermissions(); } void OnApplicationQuit() { if (RtcEngine != null) { Leave(); // 销毁 IRtcEngine RtcEngine.Dispose(); RtcEngine = null; } } private void CheckPermissions() { #if (UNITY_2018_3_OR_NEWER && UNITY_ANDROID) foreach (string permission in permissionList) { if (!Permission.HasUserAuthorizedPermission(permission)) { Permission.RequestUserPermission(permission); } } #endif } private void PreviewSelf() { // 启用视频模块 RtcEngine.EnableVideo(); // 开启本地视频预览 RtcEngine.StartPreview(); // 设置本地视频显示 LocalView.SetForUser(0, ""); // 渲染视频 LocalView.SetEnable(true); } private void SetupUI() { GameObject go = GameObject.Find("LocalView"); LocalView = go.AddComponent(); go.transform.Rotate(0.0f, 0.0f, -180.0f); go = GameObject.Find("RemoteView"); RemoteView = go.AddComponent(); go.transform.Rotate(0.0f, 0.0f, -180.0f); go = GameObject.Find("Leave"); go.GetComponent