文档中心 | 一键联接，全心服务

更新日期：2026年 01月 16日海外版iOS UE接入文档

<h3> 1. 概述 </h3> <h4> 1.1 ⽂档说明 </h4> 本⽂档介绍如何将 QuickGameSDK海外版集成到 Unreal Engine iOS 项⽬中。SDK 提供了初始化、登录、退出登录、⽀付和上传⻆⾊信息等功能 接⼊时可参考 UE Demo，配合 iOS 原⽣接⼊⽂档： GameSDK/⽂档(Document)/iOS-SDK接⼊⽂档(核心篇).pdf（在下载的SDK资源获取此文档） <h4> 1.2 SDK简介 </h4> SDK 提供以下核心功能： ⽤户登录：⽀持多种登录⽅式（邮箱、游客、Facebook、Google、Apple 等） ⽀付系统：⽀持 App Store 内购 数据分析：集成 Firebase、Adjust、AppsFlyer 等分析⼯具 社交登录：⽀持 Facebook、Google 等第三方登录 <h4> 1.3 版本信息 </h4> SDK 版本: JYouLoginKit（v2.0.7.8） UE 版本: 5.7+ ⽀持平台: iOS 10.0+ ⽀持 Xcode: 16.0+   <h3> 2. 快速开始 </h3> <h4> 2.1 最⼩集成步骤 </h4> 1. 复制 SDK ⽂件到项⽬ GameSDK/SDK/ ⽬录 2. 配置 Info.plist（见下⽅详细说明） 3. 获取 Product Code（从 SDK 后台创建产品后获取） 4. 调⽤初始化接⼝： UGameSDKManager::GetInstance()->InitializeSDK(ProductCode) 5. 绑定回调并调⽤登录： SDKManager->Login() 详细步骤请参考下⽅"集成步骤"章节 <h4> 2.2 参考资源 </h4> SDK 原生接入文档目录: GameSDK/⽂档(Document)/ <ul> <li> 核⼼接⼊⽂档: iOS-SDK接⼊⽂档(核⼼篇).pdf </li> <li> Facebook 登录: iOS-SDK接⼊⽂档(Facebook登录篇).pdf </li> <li> Google 登录: iOS-SDK接⼊⽂档(Google登录篇).pdf </li> <li> Firebase 配置: iOS-SDK接⼊⽂档(Firebase数据篇).pdf </li> </ul> 原生 Demo 项目: GameSDK/Demo/ <h3> 3. 架构说明 </h3> <h4> 3.1 分层架构设计 </h4> 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 实现 - 协议回调模式 <h4> 3.2 各层功能说明 </h4> UGameSDKManager：UE 对象封装，提供蓝图⽀持，处理类型转换和线程切换 QuickGameSDK::SDK：标准 C++ 接⼝，提供类型安全的接⼝封装 GameSDKBridge：C 接⼝层，提供跨语⾔调⽤的桥梁 GameSDKBridge.mm：Objective-C++ 实现，处理 SDK 协议回调和主线程调⽤ JYouLoginKit：原⽣ SDK，提供实际的业务功能   <h3> 4. ⽂件结构 </h3> <h4> 4.1 SDK⽂件位置（GameSDK/SDK/） </h4> SDK ⽂件应放置在项⽬根⽬录下的 GameSDK/SDK/ 目录： QuickGameIOS/ └── GameSDK/   └── SDK/       ├── JYouLoginKit.framework       # 主 SDK 框架（必需）       ├── SSBundle.bundle              # SDK 资源包（必需）       ├── AdjustSdk.framework         # Adjust SDK（数据分析）       ├── AdjustSigSdk.framework       # Adjust 签名 SDK       ├── AppsFlyerLib.framework       # AppsFlyer SDK（数据分析）       ├── FBAEMKit.framework           # Facebook AEM Kit       ├── FBSDKCoreKit_Basics.framework # Facebook SDK 基础       ├── FBSDKCoreKit.framework       # Facebook SDK 核⼼       ├── FBSDKLoginKit.framework      # Facebook 登录 SDK       ├── FirebaseAnalytics/            # Firebase Analytics 框架⽬录       │   ├── FirebaseAnalytics.framework       │   ├── FirebaseCore.framework       │   ├── FirebaseMessaging.framework       │   └── ... (其他 Firebase 框架)       ├── FirebaseMessaging/           # Firebase Messaging 框架⽬录       │   └── FirebaseMessaging.framework       └── google/                      # Google Sign-In SDK ⽬录           ├── GoogleSignIn.framework           ├── GoogleSignIn.bundle           ├── AppAuth.framework           └── ... (其他 Google 框架) <div> </div> <h4> 4.2 源代码⽂件结构（Source/QuickGameIOS/IOS/） </h4> Source/QuickGameIOS/IOS/ ├── QuickGameSDK.h         # 标准 C++ 接⼝头⽂件 ├── QuickGameSDK.cpp      # 标准 C++ 接⼝实现 ├── GameSDKBridge.h       # C 接⼝头⽂件 ├── GameSDKBridge.mm      # Objective-C++ 桥接实现 ├── GameSDKManager.h      # UE C++ 接⼝类（暴露给蓝图） ├── GameSDKManager.cpp    # UE C++ 接⼝实现 └── GameSDKAppDelegate.mm # AppDelegate URL回调处理 <h4> 4.3 主要框架和资源包说明 </h4> 主 SDK： <ul> <li> JYouLoginKit.framework  - 主 SDK 框架（静态框架） </li> <li> SSBundle.bundle  - SDK 资源包，包含 UI 资源、图⽚等 </li> </ul> 第三方 SDK 框架： <ul> <li> Facebook SDK： FBSDKCoreKit.framework , FBSDKLoginKit.framework 等（动态框架） </li> <li> Google Sign-In： GoogleSignIn.framework , AppAuth.framework 等（静态框架） </li> <li> Firebase： FirebaseAnalytics.framework , FirebaseMessaging.framework 等（静态框架） </li> <li> Adjust： AdjustSdk.framework , AdjustSigSdk.framework （动态框架） </li> <li> AppsFlyer： AppsFlyerLib.framework （静态框架） </li> </ul> <h4> 4.4 第三方SDK依赖 </h4> SDK 集成了以下第三方 SDK： <ul> <li> Adjust SDK：用于归因分析和数据追踪 </li> <li> AppsFlyer：用于移动归因和营销分析 </li> <li> Facebook SDK：⽤于 Facebook 登录和数据追踪 </li> <li> Firebase：用于数据分析、推送通知等 </li> <li> Google Sign-In：用于 Google 账号登录 </li> </ul> <h3> 5. 集成步骤 </h3> <h4> 5.1 ⽂件准备 </h4> 5.1.1 SDK文件复制 1. 将 SDK 文件复制到项⽬根⽬录下的 GameSDK/SDK/ 目录 2. 确保所有框架⽂件完整，特别是： <ul> <li> JYouLoginKit.framework </li> <li> SSBundle.bundle </li> <li> 所有第三⽅ SDK 框架 </li> </ul> 5.1.2 目录结构检查 确认目录结构如下： QuickGameIOS/ ├── GameSDK/ │   ├── SDK/                    # SDK ⽂件⽬录 │   │   ├── JYouLoginKit.framework │   │   ├── SSBundle.bundle │   │   └── ... (其他框架) │   ├── Demo/                   # Demo 项⽬（参考） │   └── ⽂档(Document)/         # SDK ⽂档 └── Source/   └── QuickGameIOS/       └── IOS/                # SDK 集成代码 <h4> 5.2 编译配置 </h4> 5.2.1 Build.cs配置说明 SDK 框架和资源需要配置到 Source/QuickGameIOS/QuickGameIOS.Build.cs 中，可参考Demo 关键配置点： 1. SDK 路径设置 <pre class="brush:js;toolbar:false">string SDKRoot = Path.GetFullPath(Path.Combine(ModuleDirectory, "../../GameSDK/SDK"));</pre> 2. 主 SDK 框架 JYouLoginKit.framework  - 静态框架 SSBundle.bundle  - 资源包 3. 第三⽅框架分类 动态框架（需要嵌⼊）：Facebook SDK、Adjust SDK 静态框架（仅链接）：Firebase、Google Sign-In、AppsFlyer 5.2.2 框架链接配置 在 QuickGameIOS.Build.cs 中，框架通过 PublicAdditionalFrameworks 添加： <pre class="brush:js;toolbar:false">// 静态框架示例 PublicAdditionalFrameworks.Add(    new Framework(        "JYouLoginKit",        JYouLoginKitFrameworkPath,        ""   ) ); // 动态框架示例（需要在 Xcode 中嵌⼊） PublicAdditionalFrameworks.Add(    new Framework(        "FBSDKCoreKit",        FBSDKCoreKitFrameworkPath,        ""   ) );</pre> 5.2.3 资源包配置 资源包通过 AdditionalBundleResources 添加： <pre class="brush:js;toolbar:false">AdditionalBundleResources.Add( new BundleResource(SSBundlePath) );</pre> 5.2.4 系统框架依赖 需要添加的系统框架： <pre class="brush:js;toolbar:false">PublicFrameworks.AddRange(new string[] {    "Foundation",    "UIKit",    "StoreKit",    "CoreTelephony",    "SystemConfiguration",    "Network",    "Security",    "UserNotifications",      // Firebase 推送需要    "AdSupport",              // Facebook SDK 需要    "AppTrackingTransparency", // Facebook SDK 需要    "AuthenticationServices",  // Google登录需要    "SafariServices",         // Google登录需要    // ... 其他框架 });</pre> 5.2.5 宏定义 确保定义了 WITH_GAMESDK 宏： <pre class="brush:js;toolbar:false">PublicDefinitions.Add("WITH_GAMESDK=1");</pre> <h4> 5.3 Info.plist配置 </h4> 5.3.1 ⽹络访问权限（NSAppTransportSecurity） SDK 需要访问⽹络接⼝，需要允许 HTTP 连接： <pre class="brush:js;toolbar:false"><key>NSAppTransportSecurity</key> <dict>    <key>NSAllowsArbitraryLoads</key>    <true/> </dict></pre> 5.3.2 URL Schemes⽩名单（LSApplicationQueriesSchemes） ⽤于⽀持第三⽅登录，需要在⽩名单中声明： <pre class="brush:js;toolbar:false"><key>LSApplicationQueriesSchemes</key> <array>        <string>fbapi</string>    <string>fb-messenger-api</string>    <string>fbauth2</string>    <string>fbshareextension</string>        <string>googlegmail</string>    <string>googlechrome</string>           </array></pre>     5.3.3 第三⽅登录URL Schemes（CFBundleURLTypes） Facebook URL Scheme： <pre class="brush:js;toolbar:false"><key>CFBundleURLTypes</key> <array>    <dict>        <key>CFBundleTypeRole</key>        <string>Editor</string>        <key>CFBundleURLSchemes</key>        <array>            <string>fbYOUR_FACEBOOK_APP_ID</string>        </array>    </dict> </array></pre> Google URL Scheme： <pre class="brush:js;toolbar:false"><dict>    <key>CFBundleTypeRole</key>    <string>Editor</string>    <key>CFBundleURLSchemes</key>    <array>        <string>com.googleusercontent.apps.YOUR_CLIENT_ID</string>    </array> </dict></pre> 5.3.4 权限描述 相册权限： <pre class="brush:js;toolbar:false"><key>NSPhotoLibraryUsageDescription</key> <string>需要访问相册以保存和选择图⽚</string> <key>NSPhotoLibraryAddUsageDescription</key> <string>需要访问相册以保存图⽚</string></pre> 相机权限： <pre class="brush:js;toolbar:false"><key>NSCameraUsageDescription</key> <string>上传头像等场景需要使⽤到您的相机</string></pre> 通知权限（Firebase 推送需要）： <pre class="brush:js;toolbar:false"><key>NSUserNotificationsUsageDescription</key> <string>需要通知权限以接收推送消息</string></pre> IDFA 追踪权限（App Tracking Transparency / Facebook SDK 需要）： <pre class="brush:js;toolbar:false"><key>NSUserTrackingUsageDescription</key> <string>⽤于提供个性化⼴告体验和数据分析</string></pre> 重要说明： 此权限是 Facebook SDK 和⼴告追踪功能所必需的 如果应⽤需要获取 IDFA（⼴告标识符），必须配置此权限描述 描述⽂字必须清晰说明为什么需要追踪权限，Apple 审核会检查 建议描述⽂字要符合应⽤的实际⽤途，避免审核被拒 5.3.5 Facebook配置项 <pre class="brush:js;toolbar:false"><key>FacebookAppID</key> <string>YOUR_FACEBOOK_APP_ID</string> <key>FacebookClientToken</key> <string>YOUR_FACEBOOK_CLIENT_TOKEN</string> <key>FacebookDisplayName</key> <string>您的应⽤名称</string></pre> 5.3.6 Google配置项 <pre class="brush:js;toolbar:false"><key>GIDClientID</key> <string>YOUR_GOOGLE_CLIENT_ID.apps.googleusercontent.com</string></pre> <h4> 5.4 Xcode配置 </h4> 5.4.1 动态框架嵌⼊ 重要：以下动态框架需要在 Xcode 中⼿动添加到 "Embed Frameworks" 阶段： FBSDKCoreKit.framework FBAEMKit.framework FBSDKCoreKit_Basics.framework FBSDKLoginKit.framework AdjustSdk.framework AdjustSigSdk.framework 配置步骤： 1. 打开 Xcode 项目： QuickGameIOS (IOS).xcworkspace 2. 选择 Target： QuickGameIOS 3. 进⼊ "Build Phases" 标签 4. 展开 "Embed Frameworks" 5. 点击 "+" 添加上述动态框架 6. 确保 "Code Sign On Copy" 已勾选 如下图： <img src="https://staticsite.quickapi.net/data/newFiles/20260108/202601081427534djG656.png" alt="" /> 5.4.2 静态框架链接 静态框架（如 JYouLoginKit、Firebase、Google Sign-In）会⾃动链接，⽆需⼿动嵌⼊ 5.4.3 资源⽂件检查 确认以下资源⽂件已正确添加到项目中： SSBundle.bundle  - SDK 资源包 GoogleSignIn.bundle  - Google Sign-In 资源 5.4.4 GoogleService-Info.plist配置 如果使⽤了 Firebase 或 Google 登录，需要： 1. 从 Firebase 控制台下载 GoogleService-Info.plist 2. 将⽂件复制到 Source/ 目录或 GameSDK/Demo/目录 3. 在 Build.cs 中配置路径： <pre class="brush:js;toolbar:false">string GoogleServiceInfoPath = Path.Combine(Path.GetFullPath(Path.Combine(ModuleDirectory, "../../GameSDK/Demo")), "GoogleService-Info.plist"); if (File.Exists(GoogleServiceInfoPath)) {    AdditionalBundleResources.Add(        new BundleResource(GoogleServiceInfoPath)   ); }</pre> <h3> 6. 接⼝调⽤ </h3> <h4> 6.1 在蓝图中使⽤ </h4> 6.1.1 初始化SDK 1. 获取 GameSDKManager 实例： 在蓝图中调⽤ Get Instance 节点（类型：GameSDKManager） 2. 初始化 SDK： 调⽤ Initialize SDK 节点 输⼊参数： Product Code （产品Code，从 GameSDK 后台获取） 3. 绑定初始化回调： 绑定 On Init Complete 委托 检查返回的 Status ： InitSuccess (2000)  - 初始化成功 InitFail (2001)  - 初始化失败 示例流程： <pre class="brush:js;toolbar:false">Event BeginPlay → Get Instance (GameSDKManager) → Bind Event to On Init Complete → Initialize SDK (Product Code: "your_product_code")</pre> 6.1.2 登录 1. 调⽤登录 调⽤ Login 节点 2. 绑定登录回调 绑定 On Login Complete 委托 回调参数： Status  - 登录状态码（1000 表示成功） UserId  - ⽤户ID Token  - ⽤户Token（⽤于服务器验证） Message  - 消息 注意：登录会弹出 SDK 的登录界⾯，⽤户可以选择不同的登录⽅式 6.1.3 退出登录 调⽤退出登录 调用 Logout 节点 退出登录后，SDK 会隐藏悬浮球并清除登录状态 注意：退出登录后，⽤户需要重新登录才能使⽤需要登录的功能 6.1.4 ⽀付 1. 调⽤⽀付： 调⽤ Pay 节点 输⼊参数： Product Id  - 商品ID（必填，App Store 商品ID） Product Name  - 商品名称（必填） Product Desc  - 商品描述（可选） Price  - 价格（必填，单位：元，如 6.00） Order No  - 游戏订单号（必填，必须唯⼀） Url  - 回调通知地址（可选，服务器回调URL） Extras  - 透传参数（可选，JSON 字符串） 2. 绑定⽀付回调 绑定 On Pay Complete 委托 回调参数： Status  - ⽀付状态码： OrderSuccess (3000)  - ⽀付成功 OrderFail (3001)  - ⽀付失败 OrderCancel (3002)  - ⽀付取消 OrderUnknown (3003)  - ⽀付未知状态 Order No  - 订单号 Product Id  - 商品ID Transaction Id  - 交易ID Message  - 消息 6.1.5 上传⻆⾊信息 1. 调⽤上传⻆⾊ 调⽤ Update Role Info 节点 2. 必填参数 Role Id  - ⻆⾊ID Role Name  - ⻆⾊名称 Server Id  - 区服ID Server Name  - 区服名称 3. 可选参数 Role Level  - ⻆⾊等级 Vip Level  - VIP等级 Role Power  - ⻆⾊战力 Game Role Balance  - ⻆⾊余额 Party Name  - 工会名称 6.1.6 获取用户信息 Get User Id  - 获取⽤户ID（返回 FString） Get User Token  - 获取⽤户Token（返回 FString） Is Logined  - 是否已登录（返回 bool） Is Guest  - 是否为游客（返回 bool） 6.1.7 回调处理 所有回调都在游戏线程（Game Thread）执⾏，可以直接更新 UI 回调绑定示例： <pre class="brush:js;toolbar:false">Event BeginPlay → Get Instance (GameSDKManager) → Bind Event to On Init Complete → Bind Event to On Login Complete → Bind Event to On Pay Complete</pre> <h4> 6.2 在C++中使⽤ </h4> 6.2.1 使⽤UGameSDKManager（推荐） 这是推荐的⽅式，⽀持蓝图，使⽤简单： <pre class="brush:js;toolbar:false">#include "IOS/GameSDKManager.h" // 获取实例 UGameSDKManager* SDKManager = UGameSDKManager::GetInstance(); // 初始化 SDKManager->InitializeSDK(TEXT("YOUR_PRODUCT_CODE")); // 绑定回调 SDKManager->OnInitComplete.AddDynamic(this, &AMyGameMode::HandleInitComplete); SDKManager->OnLoginComplete.AddDynamic(this, &AMyGameMode::HandleLoginComplete); SDKManager->OnPayComplete.AddDynamic(this, &AMyGameMode::HandlePayComplete); // 登录 SDKManager->Login(); // 退出登录 SDKManager->Logout(); // ⽀付 SDKManager->Pay(    TEXT("product_id"),    TEXT("商品名称"),    TEXT("商品描述"),    6.00f,  // 价格    TEXT("order_12345"),    TEXT(""),  // ⽀付回调地址URL    TEXT("")   // Extras ); // 上传⻆⾊ SDKManager->UpdateRoleInfo(    TEXT("role_123"),    TEXT("⻆⾊名"),    TEXT("server_1"),    TEXT("服务器1"),    TEXT("10"),  // Level    TEXT("1"),   // VIP    TEXT(""),    // Power    TEXT(""),    // Balance    TEXT("")     // Party ); // 获取⽤户信息 FString UserId = SDKManager->GetUserId(); FString Token = SDKManager->GetUserToken(); bool bIsLogined = SDKManager->IsLogined(); bool bIsGuest = SDKManager->IsGuest();</pre> 回调函数示例： <pre class="brush:js;toolbar:false">void AMyGameMode::HandleInitComplete(EGameSDKStatus Status) {    if (Status == EGameSDKStatus::InitSuccess)   {        UE_LOG(LogTemp, Log, TEXT("SDK initialized successfully"));        // 初始化成功，可以调⽤登录        SDKManager->Login();   }    else   {        UE_LOG(LogTemp, Error, TEXT("SDK initialization failed"));   } } void AMyGameMode::HandleLoginComplete(EGameSDKStatus Status, const FString& UserId, const FString& Token, const FString& Message) {    if (Status == EGameSDKStatus::ErrorNone)   {        UE_LOG(LogTemp, Log, TEXT("Login success: UserId=%s"), *UserId);        // 登录成功，保存⽤户信息   } } void AMyGameMode::HandlePayComplete(EGameSDKStatus Status, const FString& OrderNo, const FString& ProductId, const FString& TransactionId, const FString& Message) {    if (Status == EGameSDKStatus::OrderSuccess)   {        UE_LOG(LogTemp, Log, TEXT("Pay success: OrderNo=%s, ProductId=%s"), *OrderNo, *ProductId);        // ⽀付成功   } }</pre> 6.2.2 使⽤QuickGameSDK::SDK标准接⼝ 如果需要使⽤标准 C++ 接⼝（不依赖 UE 对象系统） <pre class="brush:js;toolbar:false">#include "IOS/QuickGameSDK.h" using namespace QuickGameSDK; // 获取实例 SDK& sdk = SDK::GetInstance(); // 初始化（使⽤ lambda 回调） sdk.Initialize("YOUR_PRODUCT_CODE", [](Status status) {    if (status == Status::InitSuccess) {        // 初始化成功        UE_LOG(LogTemp, Log, TEXT("SDK initialized"));   } }); // 登录 sdk.Login([](Status status, const std::string& userId, const std::string& token, const std::string& message) {    if (status == Status::Success) {        // 登录成功        FString UserIdStr = UTF8_TO_TCHAR(userId.c_str());        UE_LOG(LogTemp, Log, TEXT("Login success: %s"), *UserIdStr);   } }); // ⽀付 sdk.Pay(    "product_id",    "商品名称",    "商品描述",    6.00f,    "order_12345",    "",  // ⽀付回调地址URL    "",  // Extras   [](Status status, const std::string& orderNo, const std::string& productId,       const std::string& transactionId, const std::string& message) {        if (status == Status::OrderSuccess) {            // ⽀付成功       }   } ); // 上传⻆⾊ sdk.UpdateRoleInfo(    "role_123",    "⻆⾊名",    "server_id",    "服务器名",    "10",  // ⻆⾊等级    "1",   // VIP等级    "",    // Power    "",    // Balance    ""     // Party );</pre> <h3> 7. API参考 </h3> <h4> 7.1 UGameSDKManager类 </h4> 7.1.1 静态⽅法 static UGameSDKManager* GetInstance() 获取单例实例 返回值： UGameSDKManager*  - SDK Manager 实例 说明：⾸次调⽤会创建实例，后续调⽤返回同⼀实例 7.1.2 初始化与登录 void InitializeSDK(const FString& ProductCode) 初始化 SDK 参数： ProductCode  - 产品Code，从 GameSDK 后台获取 回调： OnInitComplete 委托 void Login() 调⽤登录，会弹出 SDK 登录界⾯ 回调： OnLoginComplete 委托 void Logout() 退出登录，清除登录状态 7.1.3 ⽀付接口 void Pay(const FString& ProductId, const FString& ProductName, const FString& ProductDesc,float Price, const FString& OrderNo, const FString& Url, const FString& Extras) 发起⽀付 参数： ProductId  - 商品ID（必填，App Store 商品ID） ProductName  - 商品名称（必填） ProductDesc  - 商品描述（可选） Price  - 价格（必填，单位：元） OrderNo  - 游戏订单号（必填，必须唯⼀） Url  - 回调通知地址（可选） Extras  - 透传参数（可选） 回调： OnPayComplete 委托 7.1.4 角色信息接口 void UpdateRoleInfo(const FString& RoleId, const FString& RoleName, const FString& ServerId,const FString& ServerName, const FString& RoleLevel = TEXT(""), const FString& VipLevel =TEXT(""), const FString& RolePower = TEXT(""), const FString& GameRoleBalance = TEXT(""),const FString& PartyName = TEXT(""), const FString& RoleActive = TEXT(""), const FString&RoleOnline = TEXT(""), const FString& RoleTask = TEXT("")) 上传角色信息 必填参数： RoleId  - ⻆⾊ID RoleName  - ⻆⾊名称 ServerId  - 区服ID ServerName  - 区服名称 可选参数： RoleLevel  - ⻆⾊等级 VipLevel  - VIP等级 RolePower  - ⻆⾊战力 GameRoleBalance  - ⻆⾊余额 PartyName  - ⼯会名称 7.1.5 ⽤户信息查询 FString GetUserId() 获取⽤户 ID 返回值：⽤户ID字符串，未登录时返回空字符串 FString GetUserToken() 获取⽤户 Token 返回值：⽤户Token字符串，⽤于服务器验证 bool IsLogined() 是否已登录 返回值： true 表示已登录， false 表示未登录 bool IsGuest() 是否为游客账号 返回值： true 表示是游客， false 表示已绑定账号 7.1.6 回调委托 FOnInitComplete OnInitComplete 初始化完成回调 参数： EGameSDKStatus Status  - 初始化状态 FOnLoginComplete OnLoginComplete 登录完成回调 参数： EGameSDKStatus Status  - 登录状态 const FString& UserId  - ⽤户ID const FString& Token  - ⽤户Token const FString& Message  - 消息 FOnPayComplete OnPayComplete ⽀付完成回调 参数： EGameSDKStatus Status  - ⽀付状态 const FString& OrderNo  - 订单号 const FString& ProductId  - 商品ID const FString& TransactionId  - 交易ID const FString& Message  - 消息 <h4> 7.2 QuickGameSDK::SDK类 </h4> 7.2.1 标准C++接⼝ static SDK& GetInstance() 获取单例实例 void Initialize(const std::string& productCode, InitCallback callback = nullptr) 初始化 SDK void Login(LoginCallback callback = nullptr) 调⽤登录 void Logout() 退出登录 void Pay(const std::string& productId, const std::string& productName, const std::string&productDesc, float price, const std::string& orderNo, const std::string& url = "", conststd::string& extras = "", PayCallback callback = nullptr) 发起⽀付 void UpdateRoleInfo(...) 上传⻆⾊信息 std::string GetUserId() 获取⽤户ID std::string GetUserToken() 获取⽤户Token bool IsLogined() 是否已登录 bool IsGuest() 是否为游客 7.2.2 回调函数类型 using InitCallback = std::function<void(Status status)>; 初始化回调 using LoginCallback = std::function<void(Status status, const std::string& userId, conststd::string& token, const std::string& message)>; 登录回调 using PayCallback = std::function<void(Status status, const std::string& orderNo, conststd::string& productId, const std::string& transactionId, const std::string& message)>; ⽀付回调 <h4> 7.3 状态码说明 </h4> 7.3.1 状态码枚举 <pre class="brush:js;toolbar:false">enum class EGameSDKStatus : uint8 {    Unknown = 0,           // 未知状态    ErrorNone = 1000,      // 事件成功（登录成功）    InitSuccess = 2000,    // 初始化成功    InitFail = 2001,       // 初始化失败    OrderSuccess = 3000,   // ⽀付成功    OrderFail = 3001,      // ⽀付失败    OrderCancel = 3002,    // ⽀付取消    OrderUnknown = 3003    // ⽀付未知状态 };</pre> 7.3.2 状态码含义 ErrorNone (1000) ：事件成功，通常⽤于登录成功 InitSuccess (2000) ：SDK 初始化成功 InitFail (2001) ：SDK 初始化失败，检查 ProductCode 是否正确 OrderSuccess (3000) ：⽀付成功，需要服务器验证订单 OrderFail (3001) ：⽀付失败，可能是⽹络问题或参数错误 OrderCancel (3002) ：⽤户取消⽀付 OrderUnknown (3003) ：⽀付状态未知，需要查询订单状态 7.3.3 错误处理 初始化失败处理： <pre class="brush:js;toolbar:false">if (Status == EGameSDKStatus::InitFail) { // 检查 ProductCode 是否正确 // 检查⽹络连接 // 检查 SDK ⽂件是否完整 }</pre> ⽀付失败处理： <pre class="brush:js;toolbar:false">if (Status == EGameSDKStatus::OrderFail) { // 检查⽹络连接 // 检查商品ID是否正确 // 检查订单号是否唯⼀ }</pre> <h3> 8. 第三⽅登录配置 </h3> <h4> 8.1 Facebook登录 </h4> 8.1.1 App ID配置 1. 访问 <a href="https://developers.facebook.com/" target="_blank">Facebook for Developers</a> 2. 创建应⽤并获取 App ID 3. 在 Info.plist 中配置： <pre class="brush:js;toolbar:false"><key>FacebookAppID</key> <string>YOUR_FACEBOOK_APP_ID</string> <key>FacebookClientToken</key> <string>YOUR_FACEBOOK_CLIENT_TOKEN</string> <key>FacebookDisplayName</key> <string>您的应⽤名称</string></pre> 8.1.2 URL Scheme配置 在 CFBundleURLTypes 中添加： <pre class="brush:js;toolbar:false"><dict> <key>CFBundleTypeRole</key> <string>Editor</string> <key>CFBundleURLSchemes</key> <array> <string>fbYOUR_FACEBOOK_APP_ID</string> </array> </dict></pre> 8.1.3 Info.plist配置项 确保在 LSApplicationQueriesSchemes 中包含： <pre class="brush:js;toolbar:false"><string>fbapi</string> <string>fb-messenger-api</string> <string>fbauth2</string> <string>fbshareextension</string></pre> <h4> 8.2 Google登录 </h4> 8.2.1 Client ID配置 1. 访问<a href="https://console.cloud.google.com/" target="_blank"> Google Cloud Console</a> 2. 创建 OAuth 2.0 客户端 ID 3. 在 Info.plist 中配置： <pre class="brush:js;toolbar:false"><key>GIDClientID</key> <string>YOUR_CLIENT_ID.apps.googleusercontent.com</string></pre> 8.2.2 URL Scheme配置 在 CFBundleURLTypes 中添加： <pre class="brush:js;toolbar:false"><dict> <key>CFBundleTypeRole</key> <string>Editor</string> <key>CFBundleURLSchemes</key> <array> <string>com.googleusercontent.apps.YOUR_CLIENT_ID</string> </array> </dict></pre> 8.2.3 GoogleService-Info.plist配置 如果使⽤ Firebase，需要： 1. 从 Firebase 控制台下载 GoogleService-Info.plist 2. 将⽂件复制到 Source/ 或 GameSDK/Demo/ ⽬录 3. 在 Build.cs 中配置路径（⻅ 5.4.4 节） <h4> 8.3 Apple登录 </h4> 8.3.1 配置要求 1. 在 Apple Developer 后台启⽤ Sign in with Apple 功能 2. 在 Xcode 中启⽤ Capability：Sign in with Apple 3. 确保 Bundle ID 已勾选配置 Sign in with Apple 8.3.2 权限说明 Apple 登录不需要额外的 Info.plist 配置，但需要： 在 Xcode 中启⽤ Capability 确保应⽤已正确签名 <h4> 8.4 其他登录⽅式 </h4> SDK 可能还⽀持其他登录⽅式（如Naver、Line 等），具体配置请参考： SDK ⽂档： GameSDK/⽂档(Document)/iOS-SDK接⼊⽂档(核⼼篇).pdf Demo 项目： GameSDK/Demo/ <h3> 9. 第三⽅SDK集成说明 </h3> <h4> 9.1 Firebase </h4> 9.1.1 Analytics配置 Firebase Analytics ⽤于数据分析，需要： 1. 在 Firebase 控制台创建项目 2. 下载 GoogleService-Info.plist 3. 配置到项⽬中（⻅ 5.4.4 节） 9.1.2 Firebase推送配置 Firebase Messaging ⽤于推送通知，需要： 1. 在 Firebase 控制台配置 APNs 证书 2. 在 Info.plist 中添加通知权限： <pre class="brush:js;toolbar:false"><key>NSUserNotificationsUsageDescription</key> <string>需要通知权限以接收推送消息</string></pre> 3. 在 Xcode 中启⽤ Push Notifications Capability 9.1.3 GoogleService-Info.plist 这是 Firebase 和 Google Sign-In 的配置⽂件，必须正确配置才能使⽤相关功能 <h4> 9.2 Adjust </h4> 9.2.1 配置说明 Adjust SDK ⽤于归因分析和数据追踪 集成要求： 1. 框架已包含在 SDK 中： AdjustSdk.framework 、 AdjustSigSdk.framework 2. 需要在 Xcode 中嵌⼊（动态框架） 3. 在 Adjust 后台配置应⽤信息 配置步骤： 1. 在 Adjust 后台创建应⽤ 2. 获取 App Token 3. 在 SDK 初始化时调⽤Adjust初始化接⼝ 9.2.2 集成要求 确保 AdjustSdk.framework 和 AdjustSigSdk.framework 已嵌⼊到应⽤中 确保调⽤了Adjust初始化接⼝，可放到SDK初始化接⼝的地⽅⼀起 <h4> 9.3 AppsFlyer </h4> 9.3.1 配置说明 AppsFlyer SDK ⽤于移动归因和营销分析 集成要求： 1. 框架已包含： AppsFlyerLib.framework （静态框架） 2. 在 AppsFlyer 后台配置应⽤信息，获取 Dev Key 3. 确保调⽤了SDK提供的AppsFlyer初始化接⼝，可放到SDK初始化接⼝的地⽅⼀起 9.3.2 集成要求 确保 AppsFlyerLib.framework 已正确链接 检查网络权限配置 <h4> 9.4 Facebook SDK </h4> 9.4.1 配置说明 Facebook SDK ⽤于 Facebook 登录和数据追踪 已包含的框架： FBSDKCoreKit.framework  - 核⼼功能 FBSDKLoginKit.framework  - 登录功能 FBAEMKit.framework  - AEM 功能 FBSDKCoreKit_Basics.framework  - 基础功能 配置要求： 1. 在 Facebook for Developers 创建应⽤ 2. 配置 App ID 和 Client Token（见 8.1 节） 3. 确保动态框架已嵌⼊（见 5.4.1 节） 9.4.2 数据追踪配置 如果需要使⽤ Facebook 数据追踪功能 1. 在 Facebook 后台启⽤相应功能 2. 配置事件追踪（通常由 GameSDK 内部处理） 3. 必须配置 IDFA 权限（见5.3.4 节）： 在 Info.plist 中添加 NSUserTrackingUsageDescription 描述⽂字必须清晰说明为什么需要追踪权限 重要：从 iOS 14.5 开始，应⽤必须获得⽤户同意才能访问 IDFA。如果没有配置NSUserTrackingUsageDescription ，数据 SDK 将⽆法获取 IDFA，可能导致数据追踪功能异常 <h3> 10. 常见问题 </h3> <h4> 10.1 编译问题 </h4> 10.1.1 框架找不到 问题：编译时提示找不到框架⽂件 解决⽅案： 1. 检查 SDK ⽂件路径是否正确： GameSDK/SDK/ 2. 检查 Build.cs 中的路径配置 3. 确认框架⽂件完整，没有被损坏 4. 清理并重新⽣成 Xcode 项⽬ 10.1.2 链接错误 问题：链接时出现符号未定义错误。 解决⽅案： 1. 检查所有必需的框架是否都已添加到 Build.cs 2. 检查系统框架依赖是否完整 3. 确认动态框架已在 Xcode 中嵌⼊（⻅ 5.4.1 节） 4. 检查框架的架构是否匹配（arm64） 10.1.3 资源⽂件缺失 问题：运⾏时找不到资源⽂件 解决⽅案： 1. 检查 SSBundle.bundle 是否已添加到 AdditionalBundleResources 2. 检查 GoogleSignIn.bundle 是否已配置 3. 确认资源⽂件路径正确 4. 清理并重新编译 <h4> 10.2 运⾏时问题 </h4> 10.2.1 初始化失败 问题：SDK 初始化返回 InitFail (2001)  可能原因和解决⽅案： 1. ProductCode 错误： 检查 ProductCode 是否正确 确认在 SDK 后台已创建产品 2. ⽹络问题： 检查设备⽹络连接 检查 Info.plist 中的⽹络权限配置 3. SDK ⽂件不完整： 检查所有框架⽂件是否完整 重新复制 SDK ⽂件 10.2.2 登录失败 问题：登录回调返回失败状态 可能原因和解决⽅案： 1. ⽹络问题： 检查⽹络连接 2. 第三⽅登录配置错误： 检查 Facebook/Google 的 App ID 配置 检查 URL Scheme 配置 3. 权限问题： 检查 Info.plist 中的权限描述 检查系统权限设置 10.2.3 ⽀付问题 问题：⽀付失败或⽆法完成。 可能原因和解决⽅案： 1. 商品ID错误： 检查 App Store Connect 中的商品配置 确认商品ID与代码中⼀致 2. 订单号重复： 确保每次⽀付的订单号唯⼀ 检查订单号⽣成逻辑 3. 沙盒环境问题： 确认使⽤沙盒测试账号 检查 App Store 内购配置 10.2.4 URL回调问题 问题：第三⽅登录后⽆法回调到应⽤。 解决⽅案： 1. 检查 URL Scheme 配置是否正确 2. 检查 LSApplicationQueriesSchemes ⽩名单 3. 确认 GameSDKAppDelegate.mm 中的回调处理正确 4. 检查第三⽅应⽤的 URL Scheme 格式 <h4> 10.3 配置问题 </h4> 10.3.1 Info.plist配置 问题：某些功能不⼯作，可能是 Info.plist 配置问题。 检查清单： ⽹络权限（NSAppTransportSecurity） URL Schemes ⽩名单（LSApplicationQueriesSchemes） 第三⽅登录 URL Schemes（CFBundleURLTypes） 权限描述（相册、相机、通知等） Facebook 配置项 Google 配置项 10.3.2 URL Scheme配置 问题：URL Scheme 配置后仍⽆法回调。 解决⽅案： 1. 检查 URL Scheme 格式是否正确 2. Facebook： fb[AppID] 3. Google： com.googleusercontent.apps.[ClientID] 4. 确认在 Xcode 的 Info 标签中已正确配置 5. 清理并重新编译 10.3.3 权限问题 问题：应⽤请求权限时崩溃或⽆法使⽤。 解决方案： 1. 检查 Info.plist 中是否有对应的权限描述 2. 确保描述⽂字不为空 3. 检查权限描述是否符合 Apple 审核要求 <div> </div>