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

The VNGGames SDK ships as an Unreal plugin that compiles from source: there is no binary drop-in. You add it to a C++ project, enable it, and let the engine’s per-platform build steps stage the native SDKs for you.

VNGGames SDK 以 Unreal 外掛原始碼形式發佈，沒有預先編譯的版本可直接放入專案。請將它加入 C++ 專案並啟用，引擎的各平台建置步驟就會自動為你部署原生 SDK。

VNGGames SDK 以 Unreal 插件源码形式发布，没有预编译版本可直接放入项目。请将它加入 C++ 项目并启用，引擎的各平台构建步骤就会自动为你部署原生 SDK。

The plugin exports no API macro, so its C++ entry points do not link from a separate game module in a modular build. Drive the SDK from Blueprint, which is what the shipped demo does. The C++ tab on each method documents the real signatures for reading the API and for plugin-internal or monolithic builds.

此外掛未匯出 API 巨集，因此在模組化建置中，其 C++ 進入點無法從獨立的遊戲模組連結。請改用 Blueprint 呼叫 SDK，隨附的示範專案也是這樣做。各方法的 C++ 分頁用於閱讀真實簽章，以及外掛內部或單體式建置的情境。

此插件未导出 API 宏，因此在模块化构建中，其 C++ 入口点无法从独立的游戏模块链接。请改用 Blueprint 调用 SDK，随附的演示项目也是这样做的。各方法的 C++ 选项卡用于阅读真实签名，以及插件内部或单体式构建的场景。

• Unreal Engine 5.5 or newer. The plugin declares no engine floor of its own, and the shipped docs are inconsistent: the Windows integration doc states 5.5+ validated on 5.7, while the demo project is associated with 5.7. Treat 5.5 as the minimum and 5.7 as the validated version.
• A C++ project. The plugin builds from source, so a Blueprint-only project must be converted first.
• The VNGGames SDK plugin package for your title, obtained from VNGGames.
• Per-title configuration assets, also from VNGGames: the Android service JSON files and signing keystore, the iOS property lists, and the Windows vnggamessdk.dat.
• Windows builds: Visual Studio 2022 with the Windows 10 or 11 SDK.
• iOS builds: macOS with Xcode.
• Android builds: network access from the build machine to the VNGGames Maven repository, which the plugin’s Gradle injection resolves its native dependency from.

• Unreal Engine 5.5 以上。 外掛本身未宣告引擎版本下限，且隨附文件說法不一致：Windows 整合文件寫 5.5 以上、在 5.7 驗證，而示範專案關聯的是 5.7。請以 5.5 為最低版本、5.7 為已驗證版本。
• C++ 專案。 外掛需要從原始碼建置，純 Blueprint 專案必須先轉換。
• 由 VNGGames 提供、對應你遊戲的 VNGGames SDK 外掛套件。
• 同樣由 VNGGames 提供的各遊戲設定檔：Android 的服務 JSON 檔與簽章 keystore、iOS 的 property list，以及 Windows 的 vnggamessdk.dat。
• Windows 建置：Visual Studio 2022 搭配 Windows 10 或 11 SDK。
• iOS 建置：macOS 搭配 Xcode。
• Android 建置：建置機器需能連線至 VNGGames Maven 儲存庫，外掛的 Gradle 注入會由此解析原生相依套件。

• Unreal Engine 5.5 以上。 插件本身未声明引擎版本下限，且随附文档说法不一致：Windows 集成文档写 5.5 以上、在 5.7 验证，而演示项目关联的是 5.7。请以 5.5 为最低版本、5.7 为已验证版本。
• C++ 项目。 插件需要从源码构建，纯 Blueprint 项目必须先转换。
• 由 VNGGames 提供、对应你游戏的 VNGGames SDK 插件包。
• 同样由 VNGGames 提供的各游戏配置文件：Android 的服务 JSON 文件与签名 keystore、iOS 的 property list，以及 Windows 的 vnggamessdk.dat。
• Windows 构建：Visual Studio 2022 搭配 Windows 10 或 11 SDK。
• iOS 构建：macOS 搭配 Xcode。
• Android 构建：构建机器需能连接 VNGGames Maven 仓库，插件的 Gradle 注入会由此解析原生依赖包。

Every third-party library the plugin brings into your build, one tab per build target. The iOS frameworks ship inside the plugin and are embedded by VNGGamesSDK.Build.cs. The Android target resolves its libraries through the vgsdk-service Gradle plugin from your pass-services.json, and the Windows target links one self-contained DLL.

外掛帶進你建置中的所有第三方函式庫，每個建置目標一個分頁。iOS framework 隨外掛一併發佈，並由 VNGGamesSDK.Build.cs 嵌入。Android 目標會透過 vgsdk-service Gradle 外掛依你的 pass-services.json 解析其函式庫，而 Windows 目標則連結單一自足的 DLL。

插件带进你构建中的所有第三方库，每个构建目标一个标签页。iOS framework 随插件一并发布，并由 VNGGamesSDK.Build.cs 嵌入。Android 目标会通过 vgsdk-service Gradle 插件依你的 pass-services.json 解析其库，而 Windows 目标则链接单一自足的 DLL。

Copy the VNGGamesSDK folder into your project’s Plugins directory, so it sits at <YourProject>/Plugins/VNGGamesSDK/. The package ships Source/, Docs/ and the .uplugin descriptor. It deliberately contains no Binaries/ or Intermediate/, which is why the first build compiles the plugin.

將 VNGGamesSDK 資料夾複製到專案的 Plugins 目錄下，路徑為 <YourProject>/Plugins/VNGGamesSDK/。套件內含 Source/、Docs/ 與 .uplugin 描述檔，並刻意不包含 Binaries/ 或 Intermediate/，因此第一次建置會編譯外掛。

将 VNGGamesSDK 文件夹复制到项目的 Plugins 目录下，路径为 <YourProject>/Plugins/VNGGamesSDK/。安装包内含 Source/、Docs/ 与 .uplugin 描述文件，并刻意不包含 Binaries/ 或 Intermediate/，因此第一次构建会编译插件。

Add the plugin to the Plugins array of your .uproject, listing the target platforms you ship.

在 .uproject 的 Plugins 陣列中加入此外掛，並列出你要發佈的目標平台。

在 .uproject 的 Plugins 数组中加入此插件，并列出你要发布的目标平台。

Add VNGGamesSDK to your game module’s dependencies in its Build.cs.

在遊戲模組的 Build.cs 中，將 VNGGamesSDK 加入相依模組。

在游戏模块的 Build.cs 中，将 VNGGamesSDK 加入依赖模块。

On an installed (Launcher) engine, set both of these in your Target.cs and TargetEditor.cs. Without them Unreal Build Tool fails with Targets with unique build environment cannot be built with installed engine. A source-built engine may keep its own unique environment.

使用安裝版（Launcher）引擎時，請在 Target.cs 與 TargetEditor.cs 中同時設定以下兩項。若未設定，Unreal Build Tool 會出現 Targets with unique build environment cannot be built with installed engine 錯誤。自行編譯的引擎則可維持其獨立環境。

使用安装版（Launcher）引擎时，请在 Target.cs 与 TargetEditor.cs 中同时设置以下两项。若未设置，Unreal Build Tool 会出现 Targets with unique build environment cannot be built with installed engine 错误。自行编译的引擎则可保持其独立环境。

Regenerate your project files and build. The SDK initializes itself as soon as its module loads, so there is nothing to call at startup. Gate your first feature call on the Wait for initialization signal instead, because on the Windows target initialization is asynchronous.

重新產生專案檔並建置。SDK 會在模組載入時自行初始化，因此啟動時不需要呼叫任何項目。請改以 等待初始化完成 訊號作為第一個功能呼叫的前置條件，因為在 Windows 目標上初始化是非同步的。

重新生成项目文件并构建。SDK 会在模块加载时自行初始化，因此启动时不需要调用任何内容。请改以 等待初始化完成 信号作为第一个功能调用的前置条件，因为在 Windows 目标上初始化是异步的。

The build script globs every .framework under Source/ThirdParty/iOS/Frameworks and every file under Source/ThirdParty/iOS/Resources, so the link set follows the folder rather than a hard-coded list. The property lists in Resources are part of your title’s export, so there is nothing to swap in by hand.

One item is NOT per-title and ships wrong in every package:

1. Replace the NSUserTrackingUsageDescription text. The plugin injects it into Info.plist as the literal placeholder Put description here, and App Store review rejects builds that keep it.
2. Keep the -ObjC shipping linker flag set, which the SDK’s static frameworks require.

One trap worth knowing: the build script RETURNS EARLY if Frameworks or Resources is missing, silently skipping the rest of the iOS setup including the system frameworks. A missing folder gives you a half-configured link rather than an error.

建置指令碼會掃描 Source/ThirdParty/iOS/Frameworks 下所有 .framework 與 Source/ThirdParty/iOS/Resources 下所有檔案，因此連結清單取決於資料夾內容而非寫死的列表。Resources 中的 property list 屬於你遊戲匯出內容的一部分，因此不需要手動替換。

有一項設定並非各遊戲專屬，且在每個套件中都是錯的：

1. 替換 NSUserTrackingUsageDescription 文字。 外掛會將它以字面上的預留字串 Put description here 注入 Info.plist，若未修改，App Store 審核會退件。
2. 保留 -ObjC 發佈連結器旗標，SDK 的靜態 framework 需要它。

另有一個值得注意的陷阱：若 Frameworks 或 Resources 資料夾不存在，建置指令碼會提前返回，靜默略過其餘的 iOS 設定（包含系統 framework）。缺少資料夾時得到的是設定不完整的連結結果，而不是明確錯誤。

构建脚本会扫描 Source/ThirdParty/iOS/Frameworks 下所有 .framework 与 Source/ThirdParty/iOS/Resources 下所有文件，因此链接列表取决于文件夹内容而非写死的列表。Resources 中的 property list 属于你游戏导出内容的一部分，因此不需要手动替换。

有一项配置并非各游戏专属，且在每个包中都是错的：

1. 替换 NSUserTrackingUsageDescription 文本。 插件会将它以字面上的占位字符串 Put description here 注入 Info.plist，若未修改，App Store 审核会拒绝。
2. 保留 -ObjC 发布链接器标志，SDK 的静态 framework 需要它。

另有一个值得注意的陷阱：若 Frameworks 或 Resources 文件夹不存在，构建脚本会提前返回，静默跳过其余的 iOS 配置（包含系统 framework）。缺少文件夹时得到的是配置不完整的链接结果，而不是明确错误。

The build script stages VNGGamesSDK.dll and vnggamessdk.dat next to your game executable, and the DLL is delay-loaded and resolved at runtime, so there is no import library to link.

The .dat is your title’s encrypted config and ships inside the export, so there is nothing to swap in by hand. What you do need to do:

1. Declare the init config in your project’s DefaultGame.ini. This is the one genuinely manual step on Windows, and the plugin ships it EMPTY. PackageName is the only source for the package name here, because the engine has no equivalent setting, and initialization logs an error and falls back to the project name when it is blank.
2. Check the staged launcher matches your title. Deep-link registration keys off the launcher’s exact filename, and packages have shipped carrying a launcher named for a different game. If the .exe beside the DLL is not yours, deep links will not resolve.

建置指令碼會將 VNGGamesSDK.dll 與 vnggamessdk.dat 部署到遊戲執行檔旁邊。該 DLL 採延遲載入並於執行期解析，因此不需要連結匯入函式庫。

.dat 是你遊戲的加密設定檔，已包含在匯出內容中，因此不需要手動替換。你需要做的是：

1. 在專案的 DefaultGame.ini 中宣告初始化設定。 這是 Windows 上唯一真正需要手動處理的步驟，而外掛提供的是空白值。在此 PackageName 是套件名稱的唯一來源，因為引擎沒有對應設定。若留空，初始化會記錄錯誤並改用專案名稱。
2. 確認部署的啟動器與你的遊戲相符。 深層連結註冊會依據啟動器的確切檔名，而曾有套件隨附的啟動器是以其他遊戲命名。若 DLL 旁的 .exe 不是你的，深層連結將無法解析。

构建脚本会将 VNGGamesSDK.dll 与 vnggamessdk.dat 部署到游戏可执行文件旁边。该 DLL 采用延迟加载并在运行时解析，因此不需要链接导入库。

.dat 是你游戏的加密配置文件，已包含在导出内容中，因此不需要手动替换。你需要做的是：

1. 在项目的 DefaultGame.ini 中声明初始化配置。 这是 Windows 上唯一真正需要手动处理的步骤，而插件提供的是空白值。在此 PackageName 是包名的唯一来源，因为引擎没有对应设置。若留空，初始化会记录错误并改用项目名称。
2. 确认部署的启动器与你的游戏匹配。 深度链接注册会依据启动器的确切文件名，而曾有包随附的启动器是以其他游戏命名。若 DLL 旁的 .exe 不是你的，深度链接将无法解析。

Turn on the SDK’s log category, then run the game and confirm initialization reports success.

開啟 SDK 的記錄類別，接著執行遊戲並確認初始化回報成功。

开启 SDK 的日志类别，然后运行游戏并确认初始化报告成功。

Editor and other non-packaged builds fall back to the plugin’s default platform helper, which only logs. No SDK call reaches a native SDK there, so verify on a packaged build for the target you care about.

編輯器與其他未打包的建置會退回外掛的預設平台輔助程式，該程式僅輸出記錄。在這類環境中沒有任何 SDK 呼叫會到達原生 SDK，因此請在你關注之目標平台的打包版本上進行驗證。

编辑器与其他未打包的构建会回退到插件的默认平台辅助程序，该程序仅输出日志。在这类环境中没有任何 SDK 调用会到达原生 SDK，因此请在你关注的目标平台的打包版本上进行验证。

The plugin initializes the SDK for you: its module calls into the native SDK as soon as it loads, so there is no init call to make. On the Android and iOS build targets that is synchronous. On the Windows target it is asynchronous, so wait for the signal below before calling any other feature.

外掛會自行初始化 SDK：模組載入時就會呼叫原生 SDK，因此你不需要自行呼叫初始化。在 Android 與 iOS 建置目標上，這個過程是同步的。在 Windows 目標上則為非同步，因此請先等待下方的訊號，再呼叫其他任何功能。

插件会自行初始化 SDK：模块加载时就会调用原生 SDK，因此你不需要自行调用初始化。在 Android 与 iOS 构建目标上，这个过程是同步的。在 Windows 目标上则为异步，因此请先等待下方的信号，再调用其他任何功能。

Wait for initialization

// The plugin auto-initializes on module load, so you only register for the result.
// Late-subscriber safe: if init already finished, this fires immediately.
VGSDKWrapper::GetInstance()->SetOnInitCompletedListener(
    [](bool bSuccess, const FVGSDKError& Error)
    {
        if (bSuccess)
        {
            // Safe to call any SDK feature from here on.
        }
    });
 
// Or poll, if you would rather gate a tick:
const bool bReady = VGSDKWrapper::GetInstance()->IsInitialized();

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

if (IVGSDKPlatformHelper* Helper = VGSDKWrapper::GetInstance()->GetAndroidHelper())
{
    Helper->ShowLoginForm(
        [](const TVariant<FVGSDKUserInfo, FVGSDKError>& Result)
        {
            // Same result shape as Auto login.
        });
}

Auto login

VGSDKWrapper::GetInstance()->AutoLogin(
    [](const TVariant<FVGSDKUserInfo, FVGSDKError>& Result)
    {
        if (Result.IsType<FVGSDKUserInfo>())
        {
            const FVGSDKUserInfo& User = Result.Get<FVGSDKUserInfo>();
            // Signed in: User.UserId, User.DisplayName, User.SessionId
        }
        else
        {
            const FVGSDKError& Error = Result.Get<FVGSDKError>();
        }
    });

Log out

VGSDKWrapper::GetInstance()->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"

Get account

if (IVGSDKPlatformHelper* Helper = VGSDKWrapper::GetInstance()->GetAndroidHelper())
{
    Helper->GetAccount(
        [](const TVariant<FVGSDKUserInfo, FVGSDKError>& Result)
        {
            // Signed in with the Launcher's account, or Error on failure.
        });
}

Select account

if (IVGSDKPlatformHelper* Helper = VGSDKWrapper::GetInstance()->GetAndroidHelper())
{
    Helper->SelectAccount(
        [](const TVariant<FVGSDKUserInfo, FVGSDKError>& Result)
        {
            // Result carries the newly selected account.
        });
}

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

TArray<FString> ProductIds = { TEXT("item-1"), TEXT("item-2") };
 
VGSDKWrapper::GetInstance()->FetchPaymentProductList(ProductIds,
    [](const TVariant<TArray<FVGSDKPaymentProduct>, FVGSDKError>& Result)
    {
        if (Result.IsType<TArray<FVGSDKPaymentProduct>>())
        {
            for (const FVGSDKPaymentProduct& Product : Result.Get<TArray<FVGSDKPaymentProduct>>())
            {
                // Show Product.DisplayPrice in your shop UI.
            }
        }
    });

Purchase

FVGSDKPaymentInfo PaymentInfo;
PaymentInfo.UserID     = TEXT("user-1");
PaymentInfo.ServerID   = TEXT("server-1");
PaymentInfo.ItemID     = TEXT("item-1");
PaymentInfo.RoleID     = TEXT("role-1");
PaymentInfo.AppTransID = TEXT("txn-1");
PaymentInfo.Amount     = 10000.0;
 
VGSDKWrapper::GetInstance()->Pay(PaymentInfo,
    []()                        { /* granted */ },
    []()                        { /* processing */ },
    []()                        { /* player canceled */ },
    [](const FString& Message)  { /* failed */ });

Check item reward

VGSDKWrapper::GetInstance()->CheckItemReward(
    [](bool bIsHasReward)
    {
        if (bIsHasReward)
        {
            // Show the claim entry point, then call Verify reward.
        }
    },
    [](const FString& Message) { /* check failed */ });

Verify reward

FVGSDKRewardInfo RewardInfo;
RewardInfo.UserID     = TEXT("user-1");
RewardInfo.ServerID   = TEXT("server-1");
RewardInfo.RoleID     = TEXT("role-1");
RewardInfo.AppTransID = TEXT("txn-1");
 
VGSDKWrapper::GetInstance()->VerifyReward(RewardInfo,
    [](const FString& Message) { /* granted */ },
    [](const FString& Message) { /* retry later */ },
    [](const FString& Message) { /* do not retry */ });

One facade for every analytics provider. The plugin exposes the custom-event calls only: Send a custom event, where you name the providers, and Misc: custom event, which sends to the SDK’s default provider set. The native SDKs’ structured use-case funnels (conversion rate, onboarding, main and daily activities, social and communities) have no plugin entry point, so report those moments as custom events of your own. 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.

涵蓋所有分析供應商的單一門面。外掛僅提供自訂事件呼叫：Send a custom event 由你自行指定供應商，Misc: custom event 則傳送至 SDK 的預設供應商集合。原生 SDK 的結構化使用情境漏斗（conversion rate、onboarding、main and daily activities、social and communities）在外掛中沒有對應的進入點，因此請以你自己的自訂事件回報這些時機。供應商：AppsFlyer、Firebase、Data Platform、Facebook、CleverTap、ThinkingData。每個呼叫都是 fire-and-forget。每個事件還會帶有一組由 SDK 自動填入的預設參數: 請參閱 分析預設參數。

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

面向所有分析提供方的统一门面。插件仅提供自定义事件调用：Send a custom event 由你自行指定提供方，Misc: custom event 则发送到 SDK 的默认提供方集合。原生 SDK 的结构化使用场景漏斗（conversion rate、onboarding、main and daily activities、social and communities）在插件中没有对应的入口，因此请用你自己的自定义事件回报这些时机。提供方：AppsFlyer、Firebase、Data Platform、Facebook、CleverTap、ThinkingData。每次调用都是 fire-and-forget。每个事件还会携带一组由 SDK 自动填充的默认参数: 请参阅 分析默认参数。

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

Send a custom event

TMap<FString, FString> Parameters;
Parameters.Add(TEXT("level"), TEXT("10"));
 
TArray<FVGSDKAnalyticsPlatform> Platforms;
Platforms.Add(FVGSDKAnalyticsPlatform(EVGSDKAnalyticsProvider::AppsFlyer, TEXT("af")));
 
VGSDKWrapper::GetInstance()->SendCustomEvent(TEXT("level_up"), Parameters, Platforms);

Misc: custom event

TMap<FString, FString> Parameters;
Parameters.Add(TEXT("level"), TEXT("10"));
 
VGSDKWrapper::GetInstance()->MiscCustomEvent(TEXT("level_up"), Parameters);

Open the in-app support center, signed in and pre-filled with the player’s context. Results arrive on the listener’s closures.

開啟應用程式內的支援中心，已登入並預先填入玩家的情境資料。結果會透過監聽器的閉包傳回。

打开应用内客户支持中心，已登录并预填了玩家的上下文。结果在监听器的闭包上返回。

Open support center

FCustomerSupportInfo SupportInfo;
SupportInfo.UserId    = TEXT("user-1");
SupportInfo.ServerId  = TEXT("server-1");
SupportInfo.RoleName  = TEXT("role");
SupportInfo.Level     = TEXT("10");
SupportInfo.Guild     = TEXT("guild");
SupportInfo.LoginType = TEXT("GG");
SupportInfo.Content   = TEXT("Need help");
 
VGSDKWrapper::GetInstance()->ShowCustomerSupport(SupportInfo,
    [](const TVariant<bool, FVGSDKError>& Result) { });

Re-engagement, grouped by provider. CleverTap covers in-app messaging and the app inbox. Apollo messaging/inbox is backend-driven, so the client’s only touchpoint is the game context it targets on. Firebase Remote Config and the in-app WebView round it out. Firebase Cloud Messaging, local push, Apollo (push / in-app / inbox), and Firebase in-app messages are delivered server-side and expose no client call.

再行銷，依供應商分組。CleverTap 涵蓋應用程式內訊息與應用程式收件匣。Apollo 的訊息／收件匣由後端驅動，因此用戶端唯一的接觸點是它所鎖定的遊戲情境。Firebase Remote Config 與應用程式內 WebView 補足其餘部分。Firebase Cloud Messaging、本機推播、Apollo（推播／應用程式內／收件匣）以及 Firebase 應用程式內訊息皆由伺服器端傳遞，不提供任何用戶端呼叫。

按提供方分组的再互动能力。CleverTap 负责应用内消息和应用收件箱。Apollo 的消息 / 收件箱由后端驱动，因此客户端唯一的接触点是它所定位的游戏上下文。此外还有 Firebase Remote Config 和应用内 WebView。Firebase Cloud Messaging、本地推送、Apollo（推送 / 应用内 / 收件箱）以及 Firebase 应用内消息均由服务端下发，不暴露客户端调用。

Fetch Firebase Remote Config

VGSDKWrapper::GetInstance()->FetchFirebaseConfig(
    [](const TVariant<TMap<FString, FString>, FVGSDKError>& Result)
    {
        if (Result.IsType<TMap<FString, FString>>())
        {
            const TMap<FString, FString>& Config = Result.Get<TMap<FString, FString>>();
            // Read Config["your_key"]
        }
    });

Show in-app WebView

VGSDKWrapper::GetInstance()->ShowWebView(TEXT("https://example.com"),
    [](const TVariant<bool, FVGSDKError>& Result) { });

Read Facebook profile/friends and share to Facebook or Instagram. Facebook results are the raw Graph JSON (no typed model). Instagram callbacks return only an error (none = success).

讀取 Facebook 個人檔案／好友，並分享到 Facebook 或 Instagram。Facebook 的結果為原始的 Graph JSON（沒有型別化模型）。Instagram 的回呼僅傳回一個錯誤（不存在＝成功）。

读取 Facebook 资料 / 好友，并分享到 Facebook 或 Instagram。Facebook 结果是原始的 Graph JSON（没有类型化模型）。Instagram 回调仅返回一个错误（不存在 = 成功）。

Share photo to Facebook

VGSDKWrapper::GetInstance()->ShareFacebookPhoto(Base64Image,
    [](const FString& Message) { /* shared */ },
    [](const FString& Message) { /* failed */ },
    []()                       { /* canceled */ });

Native store rating prompt and in-chat Google Translate.

原生商店評分提示與聊天內的 Google Translate。

原生商店评分提示，以及聊天内的 Google Translate。

Store rating (in-app review)

VGSDKWrapper::GetInstance()->Rating();

Read-only accessors for SDK, device, and current-user information: SDK version, active language, detected country, device id, and the signed-in user. All are static accessors. None take input.

用於讀取 SDK、裝置與目前使用者資訊的唯讀存取器: SDK 版本、使用中的語言、偵測到的國家／地區、裝置 ID，以及已登入的使用者。全部皆為靜態存取器。均不需輸入。

SDK、设备与当前用户信息的只读访问器: SDK 版本、当前语言、检测到的国家 / 地区、设备 id 以及已登录的用户。它们都是静态访问器。均不接受输入。

Get current user

const FVGSDKUserInfo User = VGSDKWrapper::GetInstance()->GetCurrentUserInfo();
if (!User.UserId.IsEmpty())
{
    // Signed in.
}

Shared objects and enums referenced by multiple methods, documented once here. For enums, each row is one case: Field = the case, Type = its raw value.

由多個方法參考的共用物件與列舉，於此處統一說明一次。對於列舉，每一列代表一個 case: Field＝該 case，Type＝其原始值。

被多个方法引用的共享对象与枚举，在此统一记录一次。对于枚举，每一行是一个枚举项: Field = 该枚举项，Type = 其原始值。

VGSDKAnalyticsProvider

Analytics default parameters

Analytics platform prefixes

FVGSDKUserInfo

FVGSDKLoginChannel