iOS Integration Guide

Everything you need to bring VNGGames to your game: sign-in, in-app purchase, analytics, ads, and player engagement: in one complete reference. Every method spells out its inputs and outputs field by field, and each one is directly linkable so you can jump straight to the call you need.

打造遊戲接入 VNGGames 所需的一切: 登入、應用程式內購買、分析、廣告與玩家互動: 全部整合於一份完整參考中。每個方法都逐一欄位說明其輸入與輸出，且每個方法都可直接連結，讓你能快速跳到所需的呼叫。

打造游戏接入 VNGGames 所需的一切: 登录、应用内购买、分析、广告与玩家互动: 全部整合于一份完整参考中。每个方法都逐一字段说明其输入与输出，且每个方法都可直接链接，让你能快速跳到所需的调用。

Integrate the VNGGames SDK for iOS. Complete the prerequisites, then install either with Swift Package Manager or manually. Follow the steps for your chosen method below.

整合 iOS 版 VNGGames SDK。請先完成先決條件，然後選擇以 Swift Package Manager 或手動方式安裝，再依照下方所選方式的步驟操作。

集成 iOS 版 VNGGames SDK。请先完成前提条件，然后选择以 Swift Package Manager 或手动方式安装，再按照下方所选方式的步骤操作。

• VNGGames SDK package: obtain the latest VNGGames SDK zip file.
• Xcode: version 26 or later. Use the iOS / iPadOS SDK that ships with it.
• Minimum iOS version: iOS 13.
• Device support: physical devices and the Simulator.
• Configuration files: VGSDKService-Info.plist, VGSDKIronSource-Info.plist, and GoogleService-Info.plist.

• VNGGames SDK 套件: 取得最新的 VNGGames SDK zip 檔案。
• Xcode: 版本 26 或以上。使用其隨附的 iOS / iPadOS SDK。
• 最低 iOS 版本: iOS 13。
• 裝置支援: 實體裝置與模擬器。
• 設定檔: VGSDKService-Info.plist、VGSDKIronSource-Info.plist 與 GoogleService-Info.plist。

• VNGGames SDK 包: 获取最新的 VNGGames SDK zip 文件。
• Xcode: 版本 26 或更高。使用其随附的 iOS / iPadOS SDK。
• 最低 iOS 版本: iOS 13。
• 设备支持: 物理设备与模拟器。
• 配置文件: VGSDKService-Info.plist、VGSDKIronSource-Info.plist 与 GoogleService-Info.plist。

Every third-party library the SDK brings into your build. Swift Package Manager resolves them when you add the VNGGames SDK package, and the SDK links all of them whatever your game enabled. Check this list before adding any of these libraries yourself.

SDK 帶進你建置中的所有第三方函式庫。當你加入 VNGGames SDK 套件時，Swift Package Manager 會一併解析它們，而且無論你的遊戲啟用了哪些功能，SDK 都會全部連結。在自行加入這些函式庫之前請先查看本清單。

SDK 带进你构建中的所有第三方库。当你加入 VNGGames SDK 包时，Swift Package Manager 会一并解析它们，而且无论你的游戏启用了哪些功能，SDK 都会全部链接。在自行加入这些库之前请先查看本清单。

Never add IronSource, UnityAds, AppsFlyer, or Firebase Crashlytics as separate frameworks. They are statically baked into PassSDK.xcframework. Adding any of them again double-links the same archive and causes a duplicate-symbol / duplicate-class crash.

切勿將 IronSource、UnityAds、AppsFlyer 或 Firebase Crashlytics 另外當作獨立 framework 加入。 它們已靜態合併進 PassSDK.xcframework。再次加入其中任何一個都會重複連結同一份封存檔，導致重複符號／重複類別（duplicate-symbol / duplicate-class）當機。

切勿将 IronSource、UnityAds、AppsFlyer 或 Firebase Crashlytics 另外当作独立 framework 添加。 它们已静态合并进 PassSDK.xcframework。再次添加其中任何一个都会重复链接同一份归档，导致重复符号／重复类别（duplicate-symbol / duplicate-class）崩溃。

Install the SDK with Swift Package Manager or manually with the frameworks.

使用 Swift Package Manager 或手動加入 frameworks 來安裝 SDK。

使用 Swift Package Manager 或手动添加 frameworks 来安装 SDK。

The SDK integrates with Swift Package Manager: the SDK ships as an Exported/ bundle: add the Swift Package, run VGSDK Configure, then build. The bundle contains:

此 SDK 透過 Swift Package Manager 整合：SDK 以 Exported/ bundle 形式提供: 加入 Swift Package、執行 VGSDK Configure，然後建置。此 bundle 包含：

该 SDK 通过 Swift Package Manager 集成：SDK 以 Exported/ bundle 形式提供: 添加 Swift Package、运行 VGSDK Configure，然后构建。该 bundle 包含：

Keep the folder layout intact. VGSDKResources/ must stay next to VGSDKPackages/: the configure plugin reads your config from there.

請保持資料夾結構完整。 VGSDKResources/ 必須與 VGSDKPackages/ 並排放置: configure 外掛程式會從該處讀取你的設定。

请保持文件夹结构完整。 VGSDKResources/ 必须与 VGSDKPackages/ 相邻放置: configure 插件会从那里读取你的配置。

Do this one of two ways: the automated script (recommended) or by hand in Xcode:

有兩種方式可完成此步驟: 自動化指令碼（建議）或在 Xcode 中手動操作：

有两种方式可完成此步骤: 自动化脚本（推荐）或在 Xcode 中手动操作：

SwiftPM fetches the binary frameworks (PassSDK + 3rd-party) from the VNGGames Nexus at build time, so the first resolve needs network access.

SwiftPM 會在建置時從 VNGGames Nexus 取得二進位 frameworks（PassSDK 與第三方），因此首次解析需要網路連線。

SwiftPM 会在构建时从 VNGGames Nexus 获取二进制 frameworks（PassSDK 与第三方），因此首次解析需要网络连接。

Adding the package does not auto-configure your app: SwiftPM has no install hook. Run the bundled VGSDK Configure command plugin once. It:

• Copies your config plists from VGSDKResources/ into your app’s source folder (VGSDKService-Info.plist, VGSDKIronSource-Info.plist, GoogleService-Info.plist).
• Writes your Info.plist: URL schemes (Facebook / Google / VGA), LSApplicationQueriesSchemes, App Transport Security, SKAdNetworkItems, GADApplicationIdentifier, NSUserTrackingUsageDescription, the social-sharing privacy prompts, and: for push: the remote-notification UIBackgroundModes entry. Your own usage-description strings are never overwritten.
• Edits project.pbxproj: adds the config plists to Copy Bundle Resources, adds the Firebase Crashlytics dSYM-upload Run Script phase, and enables the SDK’s capabilities (aps-environment for Push, com.apple.developer.applesignin for Sign in with Apple), creating <app>/<Target>.entitlements if absent. It is idempotent: safe to re-run after editing your config.

加入套件並不會自動設定你的 App: SwiftPM 沒有安裝掛鉤。請執行隨附的 VGSDK Configure command plugin 一次。它會：

• 複製你的設定 plist: 從 VGSDKResources/ 複製到你 App 的原始碼資料夾（VGSDKService-Info.plist、VGSDKIronSource-Info.plist、GoogleService-Info.plist）。
• 寫入你的 Info.plist: URL schemes（Facebook / Google / VGA）、LSApplicationQueriesSchemes、App Transport Security、SKAdNetworkItems、GADApplicationIdentifier、NSUserTrackingUsageDescription、社群分享隱私提示，以及: 針對推播: remote-notification 的 UIBackgroundModes 項目。你自己的 usage-description 字串永遠不會被覆寫。
• 編輯 project.pbxproj: 將設定 plist 加入 Copy Bundle Resources、加入 Firebase Crashlytics dSYM-upload Run Script 階段，並啟用 SDK 的功能（Push 使用 aps-environment、Sign in with Apple 使用 com.apple.developer.applesignin），若 <app>/<Target>.entitlements 不存在則建立它。 它具有幂等性: 在編輯設定後可安全地重新執行。

添加包不会自动配置你的 App: SwiftPM 没有安装钩子。请运行随附的 VGSDK Configure command plugin 一次。它会：

• 复制你的配置 plist: 从 VGSDKResources/ 复制到你 App 的源码文件夹（VGSDKService-Info.plist、VGSDKIronSource-Info.plist、GoogleService-Info.plist）。
• 写入你的 Info.plist: URL schemes（Facebook / Google / VGA）、LSApplicationQueriesSchemes、App Transport Security、SKAdNetworkItems、GADApplicationIdentifier、NSUserTrackingUsageDescription、社交分享隐私提示，以及: 针对推送: remote-notification 的 UIBackgroundModes 项。你自己的 usage-description 字符串永远不会被覆盖。
• 编辑 project.pbxproj: 将配置 plist 添加到 Copy Bundle Resources、添加 Firebase Crashlytics dSYM-upload Run Script 阶段，并启用 SDK 的能力（Push 使用 aps-environment、Sign in with Apple 使用 com.apple.developer.applesignin），若 <app>/<Target>.entitlements 不存在则创建它。 它具有幂等性: 在编辑配置后可安全地重新运行。

Provisioning is still yours. The plugin declares the capabilities, but you must enable Push Notifications and Sign in with Apple for your App ID in the Apple Developer portal and use a matching provisioning profile. Xcode resolves the live APNs environment from the signing profile at build time.

佈建仍由你負責。 此外掛程式會宣告這些功能，但你必須在 Apple Developer portal 中為你的 App ID 啟用 Push Notifications 與 Sign in with Apple，並使用相符的佈建描述檔（provisioning profile）。Xcode 會在建置時從簽署描述檔解析出實際的 APNs 環境。

预置描述文件仍由你负责。 该插件会声明这些能力，但你必须在 Apple Developer portal 中为你的 App ID 启用 Push Notifications 与 Sign in with Apple，并使用相匹配的预置描述文件（provisioning profile）。Xcode 会在构建时从签名描述文件解析出实际的 APNs 环境。

Run the VGSDK Configure plugin from the command line. The destination (your app folder + .xcodeproj) is outside the package, so grant your project directory in addition to the package directory:

從命令列執行 VGSDK Configure 外掛程式。目的地（你的 App 資料夾 + .xcodeproj）位於套件之外，因此除了套件目錄外，還需授予你的專案目錄權限：

从命令行运行 VGSDK Configure 插件。目标位置（你的 App 文件夹 + .xcodeproj）位于包之外，因此除了包目录之外，还需授予你的项目目录权限：

If a write is denied, the plugin prints the exact command (with the resolved path) to re-run.

若某次寫入被拒絕，外掛程式會印出（含已解析路徑的）確切指令供你重新執行。

若某次写入被拒绝，插件会打印（含已解析路径的）确切命令供你重新运行。

Reopen the project in Xcode (or let it reload) so it picks up the edited project.pbxproj (a backup is saved at project.pbxproj.vgsdk-bak), then build and run. Confirm:

• App target → Build Phases → Copy Bundle Resources contains the three config plists.
• App target → Build Phases has a [VGSDK] Run Firebase Crashlytics Run Script phase.
• Info.plist has the VNGGames URL schemes / queried schemes / SKAdNetwork entries.

在 Xcode 中重新開啟專案（或讓它重新載入），使其套用已編輯的 project.pbxproj（備份會儲存在 project.pbxproj.vgsdk-bak），然後建置並執行。請確認：

• App target → Build Phases → Copy Bundle Resources 包含這三個設定 plist。
• App target → Build Phases 有一個 [VGSDK] Run Firebase Crashlytics Run Script 階段。
• Info.plist 已包含 VNGGames 的 URL schemes / queried schemes / SKAdNetwork 項目。

在 Xcode 中重新打开项目（或让它重新加载），使其应用已编辑的 project.pbxproj（备份会保存在 project.pbxproj.vgsdk-bak），然后构建并运行。请确认：

• App target → Build Phases → Copy Bundle Resources 包含这三个配置 plist。
• App target → Build Phases 有一个 [VGSDK] Run Firebase Crashlytics Run Script 阶段。
• Info.plist 已包含 VNGGames 的 URL schemes / queried schemes / SKAdNetwork 项。

Use this path only when Swift Package Manager isn’t an option, for example a build that vendors the frameworks or must resolve them offline.

只有在無法使用 Swift Package Manager 時才採用此路徑，例如需要隨附（vendor）frameworks 或必須離線解析相依項的建置。

仅在无法使用 Swift Package Manager 时才采用此路径，例如需要随附（vendor）frameworks 或必须离线解析依赖项的构建。

The dependency .xcframeworks are already provided in the bundle’s VGSDKResources/Frameworks folder.

相依的 .xcframework 已包含在 bundle 的 VGSDKResources/Frameworks 資料夾中。

依赖的 .xcframework 已包含在 bundle 的 VGSDKResources/Frameworks 文件夹中。

In Xcode, select your app target → General → Frameworks, Libraries & Embedded Content. Add every .xcframework from VGSDKResources/Frameworks and set each one to Embed & Sign (the SDK framework is dynamic, so it must be embedded and signed).

在 Xcode 中選取你的 App target → General → Frameworks, Libraries & Embedded Content。將 VGSDKResources/Frameworks 中的每一個 .xcframework 加入，並將每一個都設為 Embed & Sign（SDK framework 為動態，因此必須嵌入並簽署）。

在 Xcode 中选择你的 App target → General → Frameworks, Libraries & Embedded Content。将 VGSDKResources/Frameworks 中的每一个 .xcframework 添加进来，并将每一个都设为 Embed & Sign（SDK framework 为动态，因此必须嵌入并签名）。

On your app target → Build Settings, set:

• Minimum Deployments (iOS) = 13.0.
• Other Linker Flags = -ObjC -weak_framework AdServices.
• Add libsqlite3.tbd under Frameworks, Libraries & Embedded Content.
• DEBUG_INFORMATION_FORMAT = dwarf-with-dsym (every configuration): lets Firebase Crashlytics generate dSYMs to upload (Run-Script phase in the Firebase Crashlytics step).
• ENABLE_USER_SCRIPT_SANDBOXING = NO: lets that Crashlytics Run-Script access the dSYM.

在你的 App target → Build Settings 設定：

• Minimum Deployments (iOS) = 13.0。
• Other Linker Flags = -ObjC -weak_framework AdServices。
• 在 Frameworks, Libraries & Embedded Content 中加入 libsqlite3.tbd。
• DEBUG_INFORMATION_FORMAT = dwarf-with-dsym（每個 configuration）：讓 Firebase Crashlytics 產生可上傳的 dSYM（Run-Script 階段見 Firebase Crashlytics 步驟）。
• ENABLE_USER_SCRIPT_SANDBOXING = NO：讓該 Crashlytics Run-Script 能存取 dSYM。

在你的 App target → Build Settings 设置：

• Minimum Deployments (iOS) = 13.0。
• Other Linker Flags = -ObjC -weak_framework AdServices。
• 在 Frameworks, Libraries & Embedded Content 中添加 libsqlite3.tbd。
• DEBUG_INFORMATION_FORMAT = dwarf-with-dsym（每个 configuration）：让 Firebase Crashlytics 生成可上传的 dSYM（Run-Script 阶段见 Firebase Crashlytics 步骤）。
• ENABLE_USER_SCRIPT_SANDBOXING = NO：让该 Crashlytics Run-Script 能访问 dSYM。

Copy the three configuration plists from the bundle’s VGSDKResources/Resources into your app’s source folder, then add them to the app target’s Build Phases → Copy Bundle Resources:

• VGSDKService-Info.plist
• VGSDKIronSource-Info.plist
• GoogleService-Info.plist

The SDK reads them from Bundle.main at runtime, so they must be members of the app target. Copy Bundle Resources flattens them to the bundle root.

將三個設定 plist 從 bundle 的 VGSDKResources/Resources 複製到你 App 的原始碼資料夾，然後將它們加入 App target 的 Build Phases → Copy Bundle Resources：

• VGSDKService-Info.plist
• VGSDKIronSource-Info.plist
• GoogleService-Info.plist

SDK 會在執行階段從 Bundle.main 讀取它們，因此它們必須是 App target 的成員。Copy Bundle Resources 會將它們平整化到 bundle 根目錄。

将三个配置 plist 从 bundle 的 VGSDKResources/Resources 复制到你 App 的源码文件夹，然后将它们添加到 App target 的 Build Phases → Copy Bundle Resources：

• VGSDKService-Info.plist
• VGSDKIronSource-Info.plist
• GoogleService-Info.plist

SDK 会在运行时从 Bundle.main 读取它们，因此它们必须是 App target 的成员。Copy Bundle Resources 会将它们平整化到 bundle 根目录。

Add these keys to your app’s Info.plist. The feature groups below are only needed if your game uses that feature. Each value marked derived names the exact key to copy from your VGSDKService-Info.plist (e.g. Features.VGA.ClientID): use your game’s real values and never copy a placeholder id.

將以下鍵加入你 App 的 Info.plist。下方的功能分組僅在你的遊戲使用該功能時才需要。每個標示為 derived（衍生）的值都會指明要從你的 VGSDKService-Info.plist 複製的確切鍵（例如 Features.VGA.ClientID）：請使用你遊戲的真實值，切勿複製任何佔位 id。

将以下键添加到你 App 的 Info.plist。下方的功能分组仅在你的游戏使用该功能时才需要。每个标记为 derived（衍生）的值都会指明要从你的 VGSDKService-Info.plist 复制的确切键（例如 Features.VGA.ClientID）：请使用你游戏的真实值，切勿复制任何占位 id。

Core (always)

核心（一律需要）

核心（始终需要）

In Xcode, select your app target → Signing & Capabilities → + Capability, and add the ones your build needs. Xcode creates and manages the .entitlements file and its code-signing setting for you.

在 Xcode 中選取你的 App target → Signing & Capabilities → + Capability，加入你的建置所需的功能。Xcode 會為你建立並管理 .entitlements 檔案及其程式碼簽署設定。

在 Xcode 中选择你的 App target → Signing & Capabilities → + Capability，添加你的构建所需的能力。Xcode 会为你创建并管理 .entitlements 文件及其代码签名设置。

• Add Push Notifications and Background Modes (check Remote notifications).

• 加入 Push Notifications 與 Background Modes（勾選 Remote notifications）。

• 添加 Push Notifications 与 Background Modes（勾选 Remote notifications）。

Provisioning is still yours. Enable the capabilities you added for your App ID in the Apple Developer portal and use a matching provisioning profile. The entitlements alone don’t grant them.

佈建仍由你負責。 請在 Apple Developer portal 中為此 App ID 啟用你所加入的功能，並使用相符的佈建描述檔（provisioning profile）。僅有 entitlements 並不會授予這些功能。

预置描述文件仍由你负责。 请在 Apple Developer portal 中为此 App ID 启用你所添加的能力，并使用相匹配的预置描述文件（provisioning profile）。仅有 entitlements 并不会授予这些能力。

Crashlytics is baked into the SDK binary, but its dSYM upload needs a Run-Script phase. On the app target → Build Phases:

• Copy the tooling: copy the bundle’s VGSDKResources/FirebaseCrashlytics/ folder into your project root (next to the .xcodeproj), matching the $SRCROOT path in the Run Script below.
• Add a Run Script phase: click the + at the top-left of the phases list and choose New Run Script Phase, then drag it so it runs last. It must come after linking, because it consumes the dSYM and the linked executable.

Point the Run Script at the copied run script:

Crashlytics 已合併進 SDK 二進位檔，但其 dSYM 上傳需要一個 Run-Script 階段。在 App target → Build Phases：

• 複製工具： 將 bundle 的 VGSDKResources/FirebaseCrashlytics/ 資料夾複製到你的專案根目錄（與 .xcodeproj 同層），對應下方 Run Script 中的 $SRCROOT 路徑。
• 加入 Run Script 階段： 點按階段列表左上角的 +，選擇 New Run Script Phase，再將它拖曳至最後執行。它必須排在連結之後，因為它會使用 dSYM 與已連結的執行檔。

將 Run Script 指向複製過來的 run 指令碼：

Crashlytics 已合并进 SDK 二进制文件，但其 dSYM 上传需要一个 Run-Script 阶段。在 App target → Build Phases：

• 复制工具： 将 bundle 的 VGSDKResources/FirebaseCrashlytics/ 文件夹复制到你的项目根目录（与 .xcodeproj 同层），对应下方 Run Script 中的 $SRCROOT 路径。
• 添加 Run Script 阶段： 点击阶段列表左上角的 +，选择 New Run Script Phase，再将它拖到最后执行。它必须排在链接之后，因为它会使用 dSYM 与已链接的可执行文件。

将 Run Script 指向复制过来的 run 脚本：

Then add these five Input Files to the Run Script phase:

接著將以下五個 Input Files 加入該 Run Script 階段：

接着将以下五个 Input Files 添加到该 Run Script 阶段：

CleverTap notification extensions (NSE + NCE)

Import the SDK module:

匯入 SDK 模組：

导入 SDK 模块：

Sign the player in through the SDK’s channel picker or a specific channel, and delete the signed-in account. Every login callback delivers the signed-in player’s info on success, or an error on cancel/failure. Zero-interaction quick login and VGA account management live in the Quick Authentication section.

透過 SDK 的頻道選擇器或指定頻道讓玩家登入，並可刪除已登入的帳號。每次登入回呼在成功時會傳回已登入玩家的資訊，在取消或失敗時則傳回錯誤。零互動的快速登入與 VGA 帳號管理位於 Quick Authentication 區段。

通过 SDK 的渠道选择器或指定渠道让玩家登录，并可删除已登录的账号。每次登录回调在成功时会返回已登录玩家的信息，在取消或失败时则返回错误。零交互的快速登录与 VGA 账号管理位于 Quick Authentication 部分。

Show the login form

[[PassSDK shared] showLoginForm:^(PassUserInfo *info, NSError *error) {
    if (error != nil) {
        // handle failure
    } else {
        // info.userID, info.displayName, info.sessionID
    }
}];

PassSDK.shared.showLoginForm { info, error in
    guard let info = info, error == nil else { return /* handle failure */ }
    // Signed in: info.userID, info.displayName, info.sessionID
}

Auto login

[[PassSDK shared] autoLogin:^(PassUserInfo *info, NSError *error) {
    // Same result fields as showLoginForm
}];

PassSDK.shared.autoLogin { info, error in
    // Same result fields as showLoginForm
}

Direct login to a channel

[[PassSDK shared] directLogin:PassLoginTypeGoogle completion:^(PassUserInfo *info, NSError *error) {
    // Handle result
}];

PassSDK.shared.directLogin(.google) { info, error in
    // Handle result
}

Log out

[[PassSDK shared] logout];

PassSDK.shared.logout()

Check the login session (server-side only)

# Domain and secret key come from your server's environment, never from a literal.
TIMESTAMP=$(date +%s)
SIG=$(printf '%s%s%s%s%s' "$VGA_SECRET_KEY" "$GAME_ID" "$USER_ID" "$TIMESTAMP" "$SESSION_ID" | md5sum | cut -d' ' -f1)
 
curl -X POST "$VGA_DOMAIN/api/login/checkSession" \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode "gameID=$GAME_ID" \
  --data-urlencode "userID=$USER_ID" \
  --data-urlencode "sessionID=$SESSION_ID" \
  --data-urlencode "timestamp=$TIMESTAMP" \
  --data-urlencode "sig=$SIG"

Is delete-account enabled

if ([[PassSDK shared] deleteAccountEnabled]) {
    // Show the delete-account entry point
}

if PassSDK.shared.deleteAccountEnabled() {
    // Show the delete-account entry point
}

Delete account

[[PassSDK shared] deleteAccount:^(BOOL success) {
    // YES when the account was deleted
}];

PassSDK.shared.deleteAccount { success in
    // true when the account was deleted
}

Zero-interaction sign-in and VGA account management: available only with VGA login. v1 (PassSDK.shared) is the first-generation API: quick login resolves on the login callback. v2 (VGSDKQuickAuth) is the listener-based facade: the listener’s onSuccess delivers the player’s info, onError the failure reason. Manage account opens the VGA account-management screen and applies to accounts signed in with either version.

零互動登入與 VGA 帳號管理: 僅在使用 VGA 登入時可用。v1（PassSDK.shared）為第一代 API：快速登入透過登入回呼回傳結果。v2（VGSDKQuickAuth）為以監聽器為基礎的門面：監聽器的 onSuccess 會傳回玩家資訊，onError 則傳回失敗原因。管理帳號 會開啟 VGA 帳號管理畫面，且適用於以任一版本登入的帳號。

零交互登录与 VGA 账号管理: 仅在 VGA 登录时可用。v1（PassSDK.shared）为第一代 API：快速登录在登录回调上返回结果。v2（VGSDKQuickAuth）为基于监听器的门面：监听器的 onSuccess 返回玩家信息，onError 返回失败原因。管理账号 会打开 VGA 账号管理界面，且适用于以任一版本登录的账号。

Quick login

[[PassSDK shared] quickLogin:^(PassUserInfo *info, NSError *error) {
    // Signed in, or error on failure
}];

PassSDK.shared.quickLogin { info, error in
    // Signed in, or error on failure
}

Sign in

VGSDKAuthenticationListener *listener = [[VGSDKAuthenticationListener alloc]
    initWithOnSuccess:^(PassUserInfo * _Nonnull info) { /* signed in */ }
    onError:^(NSError * _Nonnull error) { /* failed */ }];
[VGSDKQuickAuth showLoginWithListener:listener];

let listener = VGSDKAuthenticationListener(
    onSuccess: { info in /* signed in */ },
    onError: { error in /* failed */ })
VGSDKQuickAuth.showLogin(listener: listener)

Play as guest

[VGSDKQuickAuth playAsGuestWithListener:listener];

VGSDKQuickAuth.playAsGuest(listener: listener)

Show channel selection

[VGSDKQuickAuth showChannelSelectionWithListener:listener];

VGSDKQuickAuth.showChannelSelection(listener: listener)

Open account management

[[PassSDK shared] manageAccount:^(PassManageAccountAction action, PassUserInfo *info) { }];

PassSDK.shared.manageAccount { action, info in }

Query the sellable products, then run a purchase through Google Play Billing / App Store In-App Purchase. Products and purchase status are delivered on listener closures.

查詢可販售的商品，然後透過 Google Play Billing／App Store In-App Purchase 執行購買。商品與購買狀態會透過監聽器閉包傳回。

先查询可售商品，然后通过 Google Play Billing / App Store In-App Purchase 执行购买。商品与购买状态在监听器闭包上返回。

Get products

[VGSDKPayment getProductsWithIds:@[@"item-1"] listener:^(NSArray<VGSDKPaymentProduct *> *products, NSError *error) {
    if (products == nil || error != nil) { return; }
    // Use product.displayPrice to render the price
}];

VGSDKPayment.getProducts(ids: ["item-1"]) { products, error in
    guard let products = products, error == nil else { return }
    // Use product.displayPrice to render the price
}

Purchase

VGSDKPaymentInfo *info = [[VGSDKPaymentInfo alloc]
    initWithUserId:@"user-1" itemId:@"item-1" serverId:@"server-1"
    roleId:@"role-1" appTransactionId:@"txn-1" addInfo:@""];
[VGSDKPayment purchaseWithInfo:info listener:^(VGSDKPaymentPurchaseStatus status, NSError *error) {
    switch (status) {
        case VGSDKPaymentPurchaseStatusSuccess: break; // granted
        case VGSDKPaymentPurchaseStatusPending: break; // awaiting external confirmation
        default: break;
    }
}];

let info = VGSDKPaymentInfo(userId: "user-1", itemId: "item-1",
                           serverId: "server-1", roleId: "role-1",
                           appTransactionId: "txn-1", addInfo: "")
VGSDKPayment.purchase(info: info) { status, error in
    switch status {
    case .success:    break // granted
    case .pending:    break // awaiting external confirmation
    default:          break
    }
}

One facade for every analytics provider, organised by use case. Configure analytics first, then send ad-hoc custom events or the structured use-case funnels (Conversion Rate = app launch → play, Onboarding = new user → early monetization, Main & Daily Activities, Social & Communities). Providers: AppsFlyer, Firebase, Data Platform, Facebook, CleverTap, ThinkingData. Every call is fire-and-forget. Every event also carries a set of default parameters the SDK fills in automatically: see Analytics default parameters.

Notice: Every event the VNGGames SDK APIs trigger starts with the vgsdk_ prefix and follows the formula vgsdk_{prefix}_{event name}: for example, vgsdk_af_app_open. See Analytics platform prefixes.

涵蓋所有分析供應商的單一門面，依使用情境組織。請先設定分析，然後傳送臨時的自訂事件，或使用結構化的使用情境漏斗（Conversion Rate＝應用程式啟動 → 遊玩、Onboarding＝新使用者 → 早期營利、Main & Daily Activities、Social & Communities）。供應商：AppsFlyer、Firebase、Data Platform、Facebook、CleverTap、ThinkingData。每個呼叫都是 fire-and-forget。每個事件還會帶有一組由 SDK 自動填入的預設參數: 請參閱 分析預設參數。

注意： VNGGames SDK API 觸發的每個事件都以 vgsdk_ 前綴開頭，並遵循 vgsdk_{prefix}_{event name} 公式: 例如 vgsdk_af_app_open。請參閱 分析平台前綴。

面向所有分析提供方的统一门面，按使用场景组织。先配置分析，然后发送临时自定义事件或结构化的使用场景漏斗（Conversion Rate = 应用启动 → 游玩，Onboarding = 新用户 → 早期变现，Main & Daily Activities，Social & Communities）。提供方：AppsFlyer、Firebase、Data Platform、Facebook、CleverTap、ThinkingData。每次调用都是 fire-and-forget。每个事件还会携带一组由 SDK 自动填充的默认参数: 请参阅 分析默认参数。

注意： VNGGames SDK API 触发的每个事件都以 vgsdk_ 前缀开头，并遵循公式 vgsdk_{prefix}_{event name}: 例如 vgsdk_af_app_open。请参阅 分析平台前缀。

Configure analytics

[VGSDKAnalytics miscConfigAnalytics:@"role-1" roleName:@"Hero"];

VGSDKAnalytics.miscConfigAnalytics("role-1", roleName: "Hero")

Rules & limits

Send a custom event

VGSDKAnalyticsPlatform *facebook = [[VGSDKAnalyticsPlatform alloc]
    initWithProvider:VGSDKAnalyticsProviderFacebook prefix:@""];
[VGSDKAnalytics sendCustomEvent:@"level_up" parameters:@{@"level": @5} platforms:@[facebook]];

let facebook = VGSDKAnalyticsPlatform(provider: .facebook, prefix: "")
VGSDKAnalytics.sendCustomEvent("level_up", parameters: ["level": 5], platforms: [facebook])

Misc: custom event

[VGSDKAnalytics miscCustomEvent:@"my_event" parameters:@{@"k": @"v"}];

VGSDKAnalytics.miscCustomEvent("my_event", parameters: ["k": "v"])

1. App open

[VGSDKAnalytics regAppOpen:@{}];

VGSDKAnalytics.regAppOpen([:])

2. Get configuration

[VGSDKAnalytics regGetConfiguration:@{}];

VGSDKAnalytics.regGetConfiguration([:])

3. Check configuration start

[VGSDKAnalytics regCheckConfigurationStart:@{}];

VGSDKAnalytics.regCheckConfigurationStart([:])

4. Check configuration end

[VGSDKAnalytics regCheckConfigurationEnd:@{}];

VGSDKAnalytics.regCheckConfigurationEnd([:])

5. CDN download start

[VGSDKAnalytics regCDNDownloadStart:@"10MB" extraData:@{}];

VGSDKAnalytics.regCDNDownloadStart("10MB", extraData: [:])

6. CDN download 25%

[VGSDKAnalytics regCDNDownload25:@"10MB" extraData:@{}];

VGSDKAnalytics.regCDNDownload25("10MB", extraData: [:])

6. CDN download 50%

[VGSDKAnalytics regCDNDownload50:@"10MB" extraData:@{}];

VGSDKAnalytics.regCDNDownload50("10MB", extraData: [:])