1. 概述

1.1 ⽂档说明

本⽂档介绍如何将 QuickGameSDK海外版集成到 Unreal Engine iOS 项⽬中。SDK 提供了初始化、登录、退出登录、⽀付和上传⻆⾊信息等功能

接⼊时可参考 UE Demo，配合 iOS 原⽣接⼊⽂档： GameSDK/⽂档(Document)/iOS-SDK接⼊⽂档(核心篇).pdf（在下载的SDK资源获取此文档）

1.2 SDK简介

SDK 提供以下核心功能：
⽤户登录：⽀持多种登录⽅式（邮箱、游客、Facebook、Google、Apple 等）
⽀付系统：⽀持 App Store 内购

数据分析：集成 Firebase、Adjust、AppsFlyer 等分析⼯具

社交登录：⽀持 Facebook、Google 等第三方登录

1.3 版本信息

SDK 版本: JYouLoginKit（v2.0.7.8）
UE 版本: 5.7+
⽀持平台: iOS 10.0+
⽀持 Xcode: 16.0+

 

2. 快速开始

2.1 最⼩集成步骤

1. 复制 SDK ⽂件到项⽬ GameSDK/SDK/ ⽬录
2. 配置 Info.plist（见下⽅详细说明）
3. 获取 Product Code（从 SDK 后台创建产品后获取）
4. 调⽤初始化接⼝： UGameSDKManager::GetInstance()->InitializeSDK(ProductCode)
5. 绑定回调并调⽤登录： SDKManager->Login()

详细步骤请参考下⽅"集成步骤"章节

2.2 参考资源

SDK 原生接入文档目录: GameSDK/⽂档(Document)/

• 核⼼接⼊⽂档: iOS-SDK接⼊⽂档(核⼼篇).pdf
• Facebook 登录: iOS-SDK接⼊⽂档(Facebook登录篇).pdf
• Google 登录: iOS-SDK接⼊⽂档(Google登录篇).pdf
• Firebase 配置: iOS-SDK接⼊⽂档(Firebase数据篇).pdf

原生 Demo 项目: GameSDK/Demo/

3. 架构说明

3.1 分层架构设计

SDK 接⼝采⽤分层架构设计，接⼝调⽤层次如下：

UE 代码层（蓝图/C++）
↓
UGameSDKManager (UE 封装层)
- 类型转换: FString ↔ std::string
- 委托系统: UE 委托 ↔ std::function
- 线程安全: 确保回调在游戏线程执⾏
↓
QuickGameSDK::SDK (标准 C++ 接⼝层)
- 纯 C++ 接⼝
- 使⽤标准库类型（std::string, std::function）
- 单例模式
↓
GameSDKBridge (C 接⼝层)
- C ⻛格接⼝
- 回调函数指针
↓
GameSDKBridge.mm (Objective-C++ 桥接层)
- Objective-C 与 C++ 桥接
- 协议回调处理
- 主线程调⽤保证
↓
JYouLoginKit.framework (原⽣ iOS SDK)
- Objective-C 实现
- 协议回调模式

3.2 各层功能说明

UGameSDKManager：UE 对象封装，提供蓝图⽀持，处理类型转换和线程切换
QuickGameSDK::SDK：标准 C++ 接⼝，提供类型安全的接⼝封装
GameSDKBridge：C 接⼝层，提供跨语⾔调⽤的桥梁
GameSDKBridge.mm：Objective-C++ 实现，处理 SDK 协议回调和主线程调⽤
JYouLoginKit：原⽣ SDK，提供实际的业务功能

 

4. ⽂件结构

4.1 SDK⽂件位置（GameSDK/SDK/）

SDK ⽂件应放置在项⽬根⽬录下的 GameSDK/SDK/ 目录：

QuickGameIOS/
└── GameSDK/
  └── SDK/
      ├── JYouLoginKit.framework  &nb