Tencent Cloud

Recent Pages

Unity

最后更新时间：2024-03-20 17:45:04

这个示例项目演示了如何在 Unity 中快速集成 TRTC SDK，实现在游戏中的音视频通话。
在这个示例项目中包含了以下功能：
加入通话和离开通话。
自定义视频渲染。
设备管理、音乐特效和人声特效。
说明：
具体 API 功能参数说明，请参见 Unity API 概览。
Unity 建议版本： 2020.2.1f1c1。
目前支持 Android、iOS、Windows、Mac(Mac 还在内测中)平台。
需要包含 Android Build Support、iOS Build Support、Windows Build Support 和 MacOS Build Support 模块。
其中 iOS 端开发还需要：
Xcode 11.0及以上版本。
请确保您的项目已设置有效的开发者签名。
操作步骤
步骤 1：创建新的应用
1. 登录 实时音视频控制台总览页，单击创建应用。
2. 在弹窗页面中选择 RTC Engine，输入应用名称，然后单击创建。
﻿
﻿
﻿
步骤2：获取 SDKAppID 和 SecretKey
在应用创建成功后，您可以在基本信息中获取到您的 SDKAppID 和 SDKSecretKey，体验 Demo 需要用到这两个信息。
﻿
﻿
﻿
步骤 3：下载示例代码
1. 您可以根据自己的业务平台，前往Github下载相关 SDK 及配套的 Demo 源码。
git clone https://github.com/LiteAVSDK/TRTC_Unity.git
2. 导入SDK的步骤可以参考：Unity 导入SDK。
步骤 4：配置工程
1. 打开下载完成的示例代码，找到并打开TRTC-Simple-Demo/Assets/TRTCSDK/Demo/Tools/GenerateTestUserSig.cs文件，设置GenerateTestUserSig.cs文件中的相关参数：
SDKAPPID：默认为 PLACEHOLDER ，请设置为实际的 SDKAppID。
SDKSECRETKEY：默认为 PLACEHOLDER ，请设置为实际的 Secret key。
2. 此时工程配置已经完成，您可以单击下一步。
说明：
本文提到的生成 UserSig 的方案是在客户端代码中配置 SDKSECRETKEY，该方法中 SDKSECRETKEY 很容易被反编译逆向破解，一旦您的密钥泄露，攻击者就可以盗用您的腾讯云流量，因此该方法仅适合本地跑通 TRTC-Simple-Demo 和功能调试。
正确的 UserSig 签发方式是将 UserSig 的计算代码集成到您的服务端，并提供面向 App 的接口，在需要 UserSig 时由您的 App 向业务服务器发起请求获取动态 UserSig。更多详情请参见 服务端生成 UserSig。
步骤 5：编译运行
Android 平台
1. 配置 Unity Editor，单击File > Build Setting，切换至 Android。
﻿
﻿
2. 连接 Android 真机，单击Build And Run，Demo 就能跑起来。
3. 接口测试，需要先点击调用 enterRoom ，然后自行测试其他相关，数据展示窗口显示点击调用成功，另外一个窗口显示回调信息。
iOS 平台
1. 打开TRTC 构建配置工具（可在 Unity 编辑器顶部导航栏找到）
2. 点击构建&配置 IOS，等待项目生成完成
﻿
﻿
3. 使用 xcode 打开生成好的 Unity-iPhone.xcodeproj 项目
4. 下载TRTC 底层 sdk，单击 General，选择 Frameworks,Libraries,and Embedded Content，单击底下的“+”号图标依次添加所需要动态库 FFmpeg.xcframework、SoundTouch.xcframework，选择 Embed & Sign。
﻿
﻿
5. 连接 iOS 真机进行调试
Windows 平台
1. 配置 Unity Editor，单击File > Build Setting，切换至 PC, Mac & Linux Standalone，Target Platform 选择 Windows。
﻿
﻿
2. 单击Build And Run，Demo 就能跑起来。
macOS 平台
1. 配置 Unity Editor，单击File > Build Setting，切换至 PC, Mac & Linux Standalone，Target Platform 选择 macOS。
﻿
﻿
2. 单击 Build And Run，Demo 就能跑起来。
3. 使用 Unity Editor 模拟器运行，先要安装 Device Simulator Package。
4. 单击 Window > General > Device Simulator
﻿
﻿
Demo示例
Demo 里面包含了已上线的大部分 API，可以测试和作为调用参考，API 文档参见 SDK API（Unity）。
说明：
UI 可能会有部分调整更新，请以最新版为准。
目录结构
├─Assets
├── Editor                        // Unity 编辑器脚本
│   ├── BuildScript.cs            // Unity 编辑器build菜单
│   ├── IosPostProcess.cs         // Unity 编辑器构建ios应用脚本
├── Plugins
│   ├── Android                   
│   │   ├── AndroidManifest.xml   //Android应用配置文件
├── StreamingAssets               // Unity Demo 音视频流文件
├── TRTCSDK
    ├── Demo                      // Unity 示例 Demo
    ├── SDK                       // TRTC Unity SDK
        ├── Implement             // TRTC Unity SDK 实现
        ├── Include               // TRTC Unity SDK 头文件
        └── Plugins               // TRTC Unity SDK 不同平台底层实现
﻿