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

导入 SDK 到 Mac 项目

最近更新时间:2026-06-09 11:46:11

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

开发环境要求

Xcode 13.0+。
Mac OS X10.10+ 的 Mac 真机。

通过 Xcode 项目集成 Mac SDK

步骤1:下载 SDK

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


步骤2:新建 Xcode 项目

打开 Xcode,创建一个名为 GME_Sample 的 Mac 项目。


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



步骤4:配置项目

1. 打开 .xcodeproj 工程文件后,在 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 选项卡中 App Sandbox 部分勾选以下内容。


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

在界面上放置一个 Label,调用如下代码获取 SDK 的版本号。
NSString *sdkVersion = [[ITMGContext GetInstance] GetSDKVersion];
NSString *display = [NSString stringWithFormat:@"GME SDK Version: %@", sdkVersion ?: @"(unknown)"];
self.versionLabel.stringValue = display;