集成 SDK

最近更新时间:2021-12-31 17:04:11

为方便 Unity 开发者调试和接入腾讯云游戏多媒体引擎产品 API,这里向您介绍适用于 Unity 开发的工程配置。

下载 SDK

  1. 请先下载相关 Demo 及 SDK。详细下载链接请查看 SDK 下载指引
  2. 在界面中找到 Unity 版本的 SDK 资源。
  3. 单击下载。下载完的 SDK 资源解压后有以下几个部分。文件说明如下表:
    文件名 说明 作用
    Plugins SDK 库文件 存放导出各个平台的库文件
    GMESDK SDK 代码文件 提供 API 接口
Unity SDK 平台支持

Unity SDK 已同时集成 Windows、Mac、Android、iOS 平台架构。

工程配置步骤

步骤1:导入 Plugins 文件

将开发工具包中 Plugins 文件夹中的文件复制在 Unity 工程>Assets>Plugins 文件夹中,如图所示。

说明

如果不需要导出 win32 架构的可执行文件,请删除 Plugins 文件夹下的 x86 文件夹。

步骤2:导入代码文件

将开发工具包中 Scripts 文件夹中的文件复制在 Unity 工程中存放代码的文件夹中,如图所示:

Unity 2021配置

如果使用的 Unity Editor 是 Unity 2021 及以上版本,需要将 Plugins > Android > Opensdk.plugin 下的 lib 文件夹,剪切后放在工程中 Plugins 文件中的 Android 目录下,与 Opensdk.plugin 同一级。

音频设置

在 Unity 编辑器中,Edit>Project Setting>Audio 使用系统默认即可。如果进行修改,Unity 播放音效会因为在 iOS 上设置硬件缓存区受影响,表现为音效被打断。如图所示。

Unity Audio Setting

禁止设置 Project Setting 中的 Audio 模块。

若按照下图进行配置,则 Unity 播放音效会因为在 iOS 上设置硬件缓存区受影响,表现为音效被打断。如图所示。

MacOS 平台使用操作

若在 MacOS 10.15.x 版本使用 Unity 集成 GME SDK,执行运行操作时报错显示文件已损坏,原因为 com.apple.quarantine 属性导致。

最直接的解决方案是删除 com.apple.quarantine 属性,具体操作步骤如下。

  1. 通过终端执行 cd 命令快速定位到工程中的文件夹下:Unity_OpenSDK_Audio/Assets/Plugins/
  2. 执行以下命令。
    $ xattr -d com.apple.quarantine gmesdk.bundle
说明

此操作有风险,建议使用低版本的 MacOS 进行接入。

目录