工程配置

最近更新时间:2020-03-03 18:13:23

操作场景

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

下载 SDK

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

工程配置步骤

导入 Plugins 文件

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

说明:

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

导入代码文件

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

音频设置

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

如果设置为下图这种模式,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 进行接入

工程导出配置

从 Unity 引擎导出不同平台,需要做相应的工程配置:

平台 工程配置
Android Android 工程配置文档
iOS iOS 工程配置文档
macOS macOS 工程配置文档
说明:

GME Unity SDK 支持 il2cpp 编译。

导出 iOS 平台

  1. 确保 Xcode 版本在10.0以上,此处示例为 Xcode 11.3 版本。
  2. 如果编译过程中提示下图错误,请关闭 bitcode。
    关闭此设置,只需在 Targets - Build Settings 中搜索 Bitcode 即可,找到相应选项,设置为 NO。
  3. 在编译过程中出现如下图错误,请将库文件补全。

    库文件列表示例:

导出 Android 平台

  1. GME Unity SDK 默认提供 arm64-v8a、armeabi-v7a 及 x86 的 lib 文件,请根据工程项目所需进行删减。
  2. 导出 Android 可执行文件需要在 AndroidManifest.xml 中配置好相关权限,以免出现音频错误或者权限错误。所需权限请参考 Android 工程配置文档
  3. 如果导出可执行文件 apk 文件后,打开后黑屏闪退,一般为缺少相应架构的 lib 文件,请根据工程进行添加或者删减。
目录