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

导入 SDK 到 iOS 项目

最近更新时间:2025-05-09 14:46:22

我的收藏
本文介绍如何快速的将GME SDK(iOS版本)集成到您的iOS项目中。

开发环境要求

Xcode 13.0+。
iOS 9.0 以上的 iPhone 或者 iPad 真机。
项目已配置有效的开发者签名。

通过 Xcode 项目集成 iOS SDK

步骤1:下载SDK

下载SDK,解压并打开,解压后的文件目录如下:


步骤2:新建 Xcode 项目

打开 Xocde,创建一个名为 GME_Sample 的 iOS 项目。


步骤3:导入 GME SDK 拷贝到 iOS 项目中



步骤4:配置项目

1. 打开 .xcworkspace 工程文件后,在 Xcode 的导航栏中单击左侧的 Project Navigator,单击您的项目名称并确保在编辑区域选择正确的 TARGETS
2. 在 General 选项卡中 Frameworks, Libraries, and Embedded Content 部分添加 GMESDK.frameworkTXFFmpeg.frameworkTXSoundTouch.framework,确保在 Embed 中选择 Embed & Sign

3. Build Settings 选项卡中搜索 User Script Sandboxing,将其值置为 No,以允许用户脚本访问更广泛的系统资源和文件。

4. Info 选项卡中添加 Privacy-Microphone Usage Description,并填入 Microphone 使用的目标提示语,获取麦克风的使用权限。

5. Signing & Capabilities 选项卡中添加 Background Modes,并勾选 Audio,AirPlay and Picture in Picture,以允许应用在后台运行音频。


步骤5:验证 SDK 是否导入成功

在界面上放置一个 Label,调用如果代码获取 SDK 的版本号。
ITMGContext* gme_context = [ITMGContext GetInstance];
NSString *sdkVersion = [gme_context GetSDKVersion];
如果可以正常调用并且获取版本号,说明 SDK 导入并配置成功,效果如下:



常见问题

您可以在 API 概览 查看所有函数列表及其描述。