文档中心>游戏多媒体引擎

导入 SDK 到项目

最近更新时间:2026-05-20 14:54:27

我的收藏
为方便 CocosCreator 开发者调试和接入腾讯云游戏多媒体引擎产品 API,本文档主要为您介绍适用于 CocosCreator 开发的工程配置指引。

支持的平台

GME CocosCreator SDK 支持 iOS、Android 、Windows、Mac 平台。

引入 SDK

步骤1:下载 GME CocosCreator SDK

SDK 3.X 下载指引 中下载 SDK 文件,该版本中包括 GME Plugin,请将 SDK 文件解压到本地目录里。
解压后的文件主要分为以下几个部分:

文件
说明
gme_plugin
存放 ts 语言层与 gme native 层各平台库文件及桥接层代码
GMESDK
存放 CocosCreator ts 层头文件与实现层文件

步骤2:导入 SDK

将解压后的 GMESDK 目录放在工程 assets 目录下,gme_plugin 目录放在 CocosCreator 工程 > Assets 目录外的 native 目录下即可,如图所示。



步骤3:Android 工程配置 SDK

1. 在 build.gradle 文件中,添加库代码的引用:
sourceSets.main {
jniLibs {
// Vulkan validation layer
// srcDir "${android.ndkDirectory}/sources/third_party/vulkan/src/build-android/jniLibs"
srcDir "../../../gme_plugin/android/libs"
}
}

2. 在 dependencies 中添加相应依赖:
dependencies {
implementation fileTree(dir: "../../../gme_plugin/android/libs", include: ['*.jar'])
}


步骤3:配置必要权限

1. 要使用实时语音功能,Android 平台还需要在 AndroidManifest.xml 文件中添加以下权限:
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />
2. 要使用实时语音功能,Mac/iOS 平台还需要在 Xcode 工程 Info.plist 添加隐私权限如下:
Required background modes:允许后台运行(可选)。
Microphone Usage Description:允许麦克风权限。