iOS Upgrade Guide

See what changed between your current SDK version and the latest, with the exact steps to migrate.

查看你目前的 SDK 版本與最新版本之間的變更，以及確切的遷移步驟。

查看你当前的 SDK 版本与最新版本之间的变更，以及确切的迁移步骤。

The public analytics facade no longer exposes AppsFlyer’s MediationNetworkType. It now wraps it in PassSDK’s own PassAdRevenueMediationNetworkType so integrator code no longer depends on the AppsFlyer enum directly.

公開的 Analytics facade 不再直接暴露 AppsFlyer 的 MediationNetworkType，而是包裝為 PassSDK 自有的 PassAdRevenueMediationNetworkType，讓接入方程式碼不再直接相依於 AppsFlyer 的列舉。

公开的 Analytics facade 不再直接暴露 AppsFlyer 的 MediationNetworkType，而是包装为 PassSDK 自有的 PassAdRevenueMediationNetworkType，让接入方代码不再直接依赖 AppsFlyer 的枚举。

↪ This form is deprecated in 3.18.0, see: Per-provider analytics events consolidated onto VGSDKAnalytics

↪ 此寫法於 3.18.0 已棄用，請參見： 各平台分析事件整合至 VGSDKAnalytics

↪ 此写法于 3.18.0 已弃用，请参见： 各平台分析事件整合到 VGSDKAnalytics

Switch each call to the replacement shown in the table above.

將每個呼叫改為上表所示的替代項目。

将每个调用改为上表所示的替代项。

See the usage and full signature in the Integration guide:

請在整合指南中查看用法與完整簽名：

请在集成指南中查看用法与完整签名：

The old API no longer exists, so your project stops compiling until you migrate.

舊 API 已不存在，未完成遷移前你的專案將無法編譯。

旧 API 已不存在，未完成迁移前你的工程将无法编译。

The Data Platform event name is now a separate, required parameter. The SDK writes it into the “EventType” field internally.

Data Platform 事件名稱現在是獨立的必填參數。SDK 會在內部將其寫入 “EventType” 欄位。

Data Platform 事件名称现在是独立的必填参数。SDK 会在内部将其写入 “EventType” 字段。

1. Replace every PassSDKAnalytics.sendLog(data:) call with dataPlatformCustomEvent(name:data:).
2. Move the event name, previously the EventType entry inside data, into the new required name parameter.

1. 將每個 PassSDKAnalytics.sendLog(data:) 呼叫改為 dataPlatformCustomEvent(name:data:)。
2. 把事件名稱（原本放在 data 的 EventType 欄位）改用新的必填 name 參數傳入。

1. 将每个 PassSDKAnalytics.sendLog(data:) 调用改为 dataPlatformCustomEvent(name:data:)。
2. 把事件名称（原本放在 data 的 EventType 字段）改用新的必填 name 参数传入。

The old API no longer exists, so your project stops compiling until you migrate.

舊 API 已不存在，未完成遷移前你的專案將無法編譯。

旧 API 已不存在，未完成迁移前你的工程将无法编译。

3.1.0 adds CleverTap analytics, available once CleverTap is enabled for your game in its SDK configuration.

3.1.0 加入 CleverTap 分析。只要在遊戲的 SDK 設定中啟用 CleverTap 即可使用。

3.1.0 加入 CleverTap 分析。只要在游戏的 SDK 配置中启用 CleverTap 即可使用。

Keep CleverTap enabled for the game, then record custom CleverTap events with this call.

為遊戲啟用 CleverTap，然後以此方法記錄自訂 CleverTap 事件。

为游戏启用 CleverTap，然后以此方法记录自定义 CleverTap 事件。

See the usage and full signature in the Integration guide:

請在整合指南中查看用法與完整簽名：

请在集成指南中查看用法与完整签名：

This addition is opt-in. Nothing breaks if you skip it: your existing integration keeps working, you just don’t gain this capability.

此新增功能為選用。略過不會造成任何問題：你現有的整合仍可正常運作，只是不會獲得此功能。

此新增功能为可选。跳过不会造成任何问题：你现有的集成仍可正常运行，只是不会获得此功能。

The tapped button’s customExtras dictionary is passed to the closure.

被點擊按鈕的 customExtras 字典會傳入該閉包。

被点击按钮的 customExtras 字典会传入该闭包。

↪ This form is deprecated in 3.18.0, see: Legacy PassSDK* facades deprecated in favor of VGSDK* equivalents

↪ 此寫法於 3.18.0 已棄用，請參見： 舊版 PassSDK* 門面已棄用，改用 VGSDK* 對應類別

↪ 此写法于 3.18.0 已弃用，请参见： 旧版 PassSDK* 门面已弃用，改用 VGSDK* 对应类

Register a PassCleverTapListener through PassSDKCleverTap.setListener(_:) so your closure runs when a CleverTap in-app notification button is tapped.

透過 PassSDKCleverTap.setListener(_:) 註冊 PassCleverTapListener，使用者點擊 CleverTap 應用內通知按鈕時即會執行你的閉包。

通过 PassSDKCleverTap.setListener(_:) 注册 PassCleverTapListener，用户点击 CleverTap 应用内通知按钮时即会执行你的闭包。

See the usage and full signature in the Integration guide:

請在整合指南中查看用法與完整簽名：

请在集成指南中查看用法与完整签名：

This addition is opt-in. Nothing breaks if you skip it: your existing integration keeps working, you just don’t gain this capability.

此新增功能為選用。略過不會造成任何問題：你現有的整合仍可正常運作，只是不會獲得此功能。

此新增功能为可选。跳过不会造成任何问题：你现有的集成仍可正常运行，只是不会获得此功能。

3.3.0 adds a dedicated Quick Login entry point, separate from the standard login(with:) flow.

3.3.0 新增獨立於標準 login(with:) 流程的專用快速登入進入點。

3.3.0 新增独立于标准 login(with:) 流程的专用快速登录入口。

1. Call PassSDK.shared.quickLogin to launch the VGA Quick Login flow.
2. Read the PassUserInfo or NSError from its completion.

1. 呼叫 PassSDK.shared.quickLogin 以啟動 VGA 快速登入流程。
2. 從完成回呼取得 PassUserInfo 或 NSError。

1. 调用 PassSDK.shared.quickLogin 以启动 VGA 快速登录流程。
2. 从完成回调取得 PassUserInfo 或 NSError。

See the usage and full signature in the Integration guide:

請在整合指南中查看用法與完整簽名：

请在集成指南中查看用法与完整签名：

This addition is opt-in. Nothing breaks if you skip it: your existing integration keeps working, you just don’t gain this capability.

此新增功能為選用。略過不會造成任何問題：你現有的整合仍可正常運作，只是不會獲得此功能。

此新增功能为可选。跳过不会造成任何问题：你现有的集成仍可正常运行，只是不会获得此功能。

3.3.0 adds account management (bind / switch / delete / close) surfaced through a new public PassManageAccountAction enum and the manageAccount(_:) completion.

3.3.0 新增帳號管理（綁定 / 切換 / 刪除 / 關閉），透過新的公開 PassManageAccountAction 列舉與 manageAccount(_:) 回呼提供。

3.3.0 新增账号管理（绑定 / 切换 / 删除 / 关闭），通过新的公开 PassManageAccountAction 枚举与 manageAccount(_:) 回调提供。

1. Call PassSDK.shared.manageAccount to present account management.
2. Branch on the returned PassManageAccountAction and refresh from the updated PassUserInfo.

1. 呼叫 PassSDK.shared.manageAccount 以顯示帳號管理介面。
2. 依回傳的 PassManageAccountAction 分支處理，並以更新後的 PassUserInfo 刷新狀態。

1. 调用 PassSDK.shared.manageAccount 以显示账号管理界面。
2. 根据返回的 PassManageAccountAction 分支处理，并以更新后的 PassUserInfo 刷新状态。

See the usage and full signature in the Integration guide:

請在整合指南中查看用法與完整簽名：

请在集成指南中查看用法与完整签名：

This addition is opt-in. Nothing breaks if you skip it: your existing integration keeps working, you just don’t gain this capability.

此新增功能為選用。略過不會造成任何問題：你現有的整合仍可正常運作，只是不會獲得此功能。

此新增功能为可选。跳过不会造成任何问题：你现有的集成仍可正常运行，只是不会获得此功能。

3.3.0 integrates the ThinkingData analytics SDK (ThinkingSDK 3.0.3). appId and serverUrl are read from game info, and the new PassSDKThinkingData class exposes role identification.

3.3.0 整合 ThinkingData 分析 SDK（ThinkingSDK 3.0.3）。appId 與 serverUrl 由遊戲設定讀取，新增的 PassSDKThinkingData 類別提供角色識別。

3.3.0 集成 ThinkingData 分析 SDK（ThinkingSDK 3.0.3）。appId 与 serverUrl 从游戏配置读取，新增的 PassSDKThinkingData 类提供角色识别。

↪ This form is deprecated in 3.4.0, see: Legacy analytics facades deprecated

↪ 此寫法於 3.4.0 已棄用，請參見： 舊版分析門面已標記為棄用

↪ 此写法于 3.4.0 已弃用，请参见： 旧版分析门面已标记为弃用

Bind the current role after login with PassSDKThinkingData.setRole(id:name:).

於登入後以 PassSDKThinkingData.setRole(id:name:) 綁定目前角色。

在登录后以 PassSDKThinkingData.setRole(id:name:) 绑定当前角色。

See the usage and full signature in the Integration guide:

請在整合指南中查看用法與完整簽名：

请在集成指南中查看用法与完整签名：

This addition is opt-in. Nothing breaks if you skip it: your existing integration keeps working, you just don’t gain this capability.

此新增功能為選用。略過不會造成任何問題：你現有的整合仍可正常運作，只是不會獲得此功能。

此新增功能为可选。跳过不会造成任何问题：你现有的集成仍可正常运行，只是不会获得此功能。

3.3.0 adds a public static entry point on the existing PassSDKAnalytics facade for ThinkingData custom events.

3.3.0 在既有的 PassSDKAnalytics 門面上新增用於 ThinkingData 自訂事件的公開靜態進入點。

3.3.0 在既有的 PassSDKAnalytics 门面上新增用于 ThinkingData 自定义事件的公开静态入口。

Send custom ThinkingData events with this call, once ThinkingData is enabled for your game.

在遊戲已啟用 ThinkingData 後，以此方法送出自訂 ThinkingData 事件。

在游戏已启用 ThinkingData 后，以此方法发送自定义 ThinkingData 事件。

See the usage and full signature in the Integration guide:

請在整合指南中查看用法與完整簽名：

请在集成指南中查看用法与完整签名：

This addition is opt-in. Nothing breaks if you skip it: your existing integration keeps working, you just don’t gain this capability.

此新增功能為選用。略過不會造成任何問題：你現有的整合仍可正常運作，只是不會獲得此功能。

此新增功能为可选。跳过不会造成任何问题：你现有的集成仍可正常运行，只是不会获得此功能。

3.4.0 adds VGSDKAnalytics, a typed game-event facade: one call reports a game event to every analytics provider your game has configured, instead of wiring the same event up per provider. It is an addition, not a replacement. The per-provider PassSDKAnalytics event methods are unchanged by this release.

3.4.0 新增 VGSDKAnalytics，一個型別化的遊戲事件門面：單一呼叫即可將遊戲事件回報給遊戲已設定的所有分析平台，不必再為每個平台分別接上同一個事件。這是新增而非取代。各平台的 PassSDKAnalytics 事件方法在本版並未變動。

3.4.0 新增 VGSDKAnalytics，一个类型化的游戏事件门面：单一调用即可将游戏事件上报给游戏已配置的所有分析提供商，不必再为每个提供商分别接上同一个事件。这是新增而非取代。各提供商的 PassSDKAnalytics 事件方法在本版并未变动。

Report game events through the typed VGSDKAnalytics static events (the sc, misc, iap, mda, nru and reg families) instead of wiring the same event up per analytics provider.

改用 VGSDKAnalytics 的型別化靜態事件（sc、misc、iap、mda、nru 與 reg 系列）回報遊戲事件，不必再為每個分析平台分別接上同一個事件。

改用 VGSDKAnalytics 的类型化静态事件（sc、misc、iap、mda、nru 与 reg 系列）上报游戏事件，不必再为每个分析提供商分别接上同一个事件。

See the usage and full signature in the Integration guide:

請在整合指南中查看用法與完整簽名：

请在集成指南中查看用法与完整签名：

This addition is opt-in. Nothing breaks if you skip it: your existing integration keeps working, you just don’t gain this capability.

此新增功能為選用。略過不會造成任何問題：你現有的整合仍可正常運作，只是不會獲得此功能。

此新增功能为可选。跳过不会造成任何问题：你现有的集成仍可正常运行，只是不会获得此功能。

PassSDKThinkingData and the legacy analytics classes are now deprecated and scheduled for removal in a future release.

PassSDKThinkingData 與舊版分析類別現已標記為棄用，並將於未來版本移除。

PassSDKThinkingData 与旧版分析类现已标记为弃用，并将在未来版本中移除。

↪ This form is deprecated in 3.18.0, see: Legacy PassSDK* facades deprecated in favor of VGSDK* equivalents

↪ 此寫法於 3.18.0 已棄用，請參見： 舊版 PassSDK* 門面已棄用，改用 VGSDK* 對應類別

↪ 此写法于 3.18.0 已弃用，请参见： 旧版 PassSDK* 门面已弃用，改用 VGSDK* 对应类

Migrate PassSDKThinkingData and the legacy GT analytics functions to the equivalent VGSDKAnalytics events.

將 PassSDKThinkingData 及舊版 GT 分析函式遷移至對應的 VGSDKAnalytics 事件。

将 PassSDKThinkingData 及旧版 GT 分析函数迁移至对应的 VGSDKAnalytics 事件。

It still works today, but is scheduled for removal. Your build breaks once a later release deletes it.

目前仍可運作，但已列入移除計畫。待日後版本刪除後，你的建置將失敗。

目前仍可运行，但已列入移除计划。待日后版本删除后，你的构建将失败。

PassSDKAnalytics no longer exposes its four public logging methods. They were removed, so existing calls no longer compile.

PassSDKAnalytics 不再提供其四個公開日誌方法。這些方法已移除，因此原有呼叫將無法編譯。

PassSDKAnalytics 不再提供其四个公开日志方法。这些方法已移除，因此原有调用将无法编译。

Switch each call to the replacement shown in the table above.

將每個呼叫改為上表所示的替代項目。

将每个调用改为上表所示的替代项。

The old API no longer exists, so your project stops compiling until you migrate.

舊 API 已不存在，未完成遷移前你的專案將無法編譯。

旧 API 已不存在，未完成迁移前你的工程将无法编译。

The public PassSDKPayment facade, PassIAPStatus enum, and the public PassIAPInfo model were removed (PassIAPInfo is now internal). Products are surfaced as VGSDKPaymentProduct wrappers rather than raw StoreKit SKProduct.

公開的 PassSDKPayment 門面、PassIAPStatus 列舉與公開的 PassIAPInfo 模型皆已移除（PassIAPInfo 改為內部）。商品以 VGSDKPaymentProduct 包裝呈現，而非原生 StoreKit 的 SKProduct。

公开的 PassSDKPayment 门面、PassIAPStatus 枚举与公开的 PassIAPInfo 模型均已移除（PassIAPInfo 改为内部）。商品以 VGSDKPaymentProduct 包装呈现，而非原生 StoreKit 的 SKProduct。

1. Replace PassSDKPayment with VGSDKPayment.
2. Change getProducts(items:completion:) to getProducts(ids:listener:), which returns [VGSDKPaymentProduct] instead of [SKProduct].
3. Change purchase(with:completion:) to purchase(info:listener:), passing VGSDKPaymentInfo instead of PassIAPInfo.
4. Update your status switch from PassIAPStatus to VGSDKPaymentPurchaseStatus.

1. 以 VGSDKPayment 取代 PassSDKPayment。
2. 將 getProducts(items:completion:) 改為 getProducts(ids:listener:)，其回傳 [VGSDKPaymentProduct] 而非 [SKProduct]。
3. 將 purchase(with:completion:) 改為 purchase(info:listener:)，並傳入 VGSDKPaymentInfo 而非 PassIAPInfo。
4. 將狀態 switch 由 PassIAPStatus 改為 VGSDKPaymentPurchaseStatus。

1. 以 VGSDKPayment 取代 PassSDKPayment。
2. 将 getProducts(items:completion:) 改为 getProducts(ids:listener:)，其返回 [VGSDKPaymentProduct] 而非 [SKProduct]。
3. 将 purchase(with:completion:) 改为 purchase(info:listener:)，并传入 VGSDKPaymentInfo 而非 PassIAPInfo。
4. 将状态 switch 由 PassIAPStatus 改为 VGSDKPaymentPurchaseStatus。

The old API no longer exists, so your project stops compiling until you migrate.

舊 API 已不存在，未完成遷移前你的專案將無法編譯。

旧 API 已不存在，未完成迁移前你的工程将无法编译。

The recipients: [String]? parameter was dropped from the public inviteFriend signature (the ‘Remove recipient list in Facebook invite friend’ change).

公開的 inviteFriend 簽章移除了 recipients: [String]? 參數（對應「Remove recipient list in Facebook invite friend」變更）。

公开的 inviteFriend 签名移除了 recipients: [String]? 参数（对应「Remove recipient list in Facebook invite friend」变更）。

↪ This form is deprecated in 3.18.0, see: Legacy PassSDK* facades deprecated in favor of VGSDK* equivalents

↪ 此寫法於 3.18.0 已棄用，請參見： 舊版 PassSDK* 門面已棄用，改用 VGSDK* 對應類別

↪ 此写法于 3.18.0 已弃用，请参见： 旧版 PassSDK* 门面已弃用，改用 VGSDK* 对应类

Remove the recipients: argument from every PassSDKFacebook.inviteFriend call to match the new inviteFriend(_:message:filter:completion:) signature.

移除所有 PassSDKFacebook.inviteFriend 呼叫中的 recipients: 參數，以符合新的 inviteFriend(_:message:filter:completion:) 簽章。

移除所有 PassSDKFacebook.inviteFriend 调用中的 recipients: 参数，以符合新的 inviteFriend(_:message:filter:completion:) 签名。

The old API no longer exists, so your project stops compiling until you migrate.

舊 API 已不存在，未完成遷移前你的專案將無法編譯。

旧 API 已不存在，未完成迁移前你的工程将无法编译。

3.5.0 introduces a new public VGSDKMetaAds facade. It supports interstitial, rewarded-video, and rewarded-interstitial ads. The ad module is only wired up when the game config enables the metaAds module.

3.5.0 新增公開的 VGSDKMetaAds facade。支援插頁廣告、獎勵影片與獎勵插頁廣告。只有在遊戲設定啟用 metaAds 模組時才會載入該廣告模組。

3.5.0 新增公开的 VGSDKMetaAds facade。支持插页广告、激励视频与激励插页广告。只有在游戏配置启用 metaAds 模块时才会加载该广告模块。

Show each ad format through VGSDKMetaAds and handle the result on its matching listener.

透過 VGSDKMetaAds 顯示各種廣告格式，並以對應的 listener 處理結果。

通过 VGSDKMetaAds 展示各种广告格式，并以对应的 listener 处理结果。

See the usage and full signature in the Integration guide:

請在整合指南中查看用法與完整簽名：

请在集成指南中查看用法与完整签名：

This addition is opt-in. Nothing breaks if you skip it: your existing integration keeps working, you just don’t gain this capability.

此新增功能為選用。略過不會造成任何問題：你現有的整合仍可正常運作，只是不會獲得此功能。

此新增功能为可选。跳过不会造成任何问题：你现有的集成仍可正常运行，只是不会获得此功能。

3.6.0 adds VGSDKAnalytics.sendCustomEvent, which takes the provider as data (a VGSDKAnalyticsPlatform built from a VGSDKAnalyticsProvider case) rather than making you pick a different method name per provider, and delivers one call to every provider you list. This is now the way to send a custom event. Expect two differences from the per-provider methods: the prefix you pass is prepended to your event name, and the SDK merges its own default data into your parameters.

3.6.0 新增 VGSDKAnalytics.sendCustomEvent，改以資料形式指定平台（由 VGSDKAnalyticsProvider 列舉值建立的 VGSDKAnalyticsPlatform），不必再依平台選用不同的方法名稱，單一呼叫即可送達你列出的所有平台。這是現在發送自訂事件的方式。與各平台專屬方法相比有兩點不同：你傳入的 prefix 會加在事件名稱前面，且 SDK 會把自身的預設資料併入你的 parameters。

3.6.0 新增 VGSDKAnalytics.sendCustomEvent，改以数据形式指定提供商（由 VGSDKAnalyticsProvider 枚举值构建的 VGSDKAnalyticsPlatform），不必再按提供商选用不同的方法名，单一调用即可送达你列出的所有提供商。这是现在发送自定义事件的方式。与各提供商专属方法相比有两点不同：你传入的 prefix 会加在事件名称前面，且 SDK 会把自身的默认数据并入你的 parameters。

Switch each call to the replacement shown in the table above.

將每個呼叫改為上表所示的替代項目。

将每个调用改为上表所示的替代项。

See the usage and full signature in the Integration guide:

請在整合指南中查看用法與完整簽名：

请在集成指南中查看用法与完整签名：

Nothing breaks and your existing per-provider custom-event calls keep working, but you keep a separate call site for every provider and your events go out without the default data sendCustomEvent merges in.

不會有任何中斷，你現有的各平台自訂事件呼叫仍可運作，但你仍需為每個平台維護獨立的呼叫點，且事件送出時不會帶上 sendCustomEvent 併入的預設資料。

不会有任何中断，你现有的各提供商自定义事件调用仍可使用，但你仍需为每个提供商维护独立的调用点，且事件发送时不会带上 sendCustomEvent 并入的默认数据。

The minimum supported iOS version is now 13.0 (was 12.0). Raise your app’s deployment target. The public API surface is otherwise unchanged in this release.

最低支援的 iOS 版本現為 13.0（原為 12.0）。請提升你 App 的部署目標。本次發佈的公開 API 介面並無其他變更。

最低支持的 iOS 版本现为 13.0（原为 12.0）。请提升你 App 的部署目标。本次发布的公开 API 接口并无其他变更。

Raise your app’s iOS Deployment Target to 13.0 or later before upgrading to SDK 3.8.0.

升級至 SDK 3.8.0 前，請將 App 的 iOS Deployment Target 提升至 13.0 或以上。

升级至 SDK 3.8.0 前，请将 App 的 iOS Deployment Target 提升至 13.0 或以上。

Unless the iOS Deployment Target is raised to 13.0 or later, the app cannot build against SDK 3.8.0, and iOS 12 is no longer supported.

除非將 iOS Deployment Target 提升至 13.0 或以上，否則 App 無法對 SDK 3.8.0 進行建置，且不再支援 iOS 12。

除非将 iOS Deployment Target 提升至 13.0 或以上，否则 App 无法对 SDK 3.8.0 进行构建，且不再支持 iOS 12。

3.9.0 adds a dedicated Quick Auth facade, separate from the existing quickLogin callback, exposing show-login, play-as-guest, and channel-selection flows through a single listener object.

3.9.0 新增獨立的 Quick Auth 門面，與既有的 quickLogin 回呼分開，透過單一監聽器物件提供顯示登入、以訪客身分遊玩與頻道選擇等流程。

3.9.0 新增独立的 Quick Auth 门面，与既有的 quickLogin 回调分开，通过单一监听器对象提供显示登录、以访客身份游玩与频道选择等流程。

1. Start each Quick Auth flow through VGSDKQuickAuth.
2. Pass a VGSDKAuthenticationListener to receive the signed-in PassUserInfo or an NSError.

1. 透過 VGSDKQuickAuth 啟動各項 Quick Auth 流程。
2. 傳入 VGSDKAuthenticationListener 以接收登入後的 PassUserInfo 或 NSError。

1. 通过 VGSDKQuickAuth 启动各项 Quick Auth 流程。
2. 传入 VGSDKAuthenticationListener 以接收登录后的 PassUserInfo 或 NSError。

See the usage and full signature in the Integration guide:

請在整合指南中查看用法與完整簽名：

请在集成指南中查看用法与完整签名：

This addition is opt-in. Nothing breaks if you skip it: your existing integration keeps working, you just don’t gain this capability.

此新增功能為選用。略過不會造成任何問題：你現有的整合仍可正常運作，只是不會獲得此功能。

此新增功能为可选。跳过不会造成任何问题：你现有的集成仍可正常运行，只是不会获得此功能。

For PII compliance, 3.9.0 no longer includes the email in the user info returned by login, quickLogin, and manageAccount callbacks. The field remains but is always empty.

為符合 PII 合規，3.9.0 不再於 login、quickLogin 與 manageAccount 回呼所回傳的使用者資訊中包含電子郵件。該欄位保留但一律為空。

为符合 PII 合规，3.9.0 不再于 login、quickLogin 与 manageAccount 回调所返回的用户信息中包含电子邮件。该字段保留但一律为空。

1. Stop depending on PassUserInfo.email.
2. Retrieve the email from your own backend if you still need it.

1. 請勿再依賴 PassUserInfo.email。
2. 若仍需要電子郵件，請改由自家後端取得。

1. 请勿再依赖 PassUserInfo.email。
2. 若仍需要电子邮件，请改由自家后端获取。

Code that reads PassUserInfo.email keeps compiling but now receives an empty string for every login type, so any email-dependent logic silently breaks.

讀取 PassUserInfo.email 的程式碼仍可編譯，但現在不論何種登入類型都會取得空字串，因此任何依賴電子郵件的邏輯都會悄悄失效。

读取 PassUserInfo.email 的代码仍可编译，但现在无论何种登录类型都会得到空字符串，因此任何依赖邮箱的逻辑都会悄悄失效。

3.11.0 initializes the SDK automatically and reads its configuration from a bundled VGSDKService-Info.plist, so the old manual AppDelegate entry points were removed.

3.11.0 會自動初始化 SDK，並從內建的 VGSDKService-Info.plist 讀取設定，因此移除了舊的手動 AppDelegate 進入點。

3.11.0 会自动初始化 SDK，并从内置的 VGSDKService-Info.plist 读取配置，因此移除了旧的手动 AppDelegate 入口。

1. Delete your calls to PassSDK.shared.application(_:didFinishLaunchingWithOptions:) and PassSDK.shared.applicationDidBecomeActive().
2. Place the VGSDKService-Info.plist you were given in your project folder and add it to the app target.

1. 刪除對 PassSDK.shared.application(_:didFinishLaunchingWithOptions:) 與 PassSDK.shared.applicationDidBecomeActive() 的呼叫。
2. 將你收到的 VGSDKService-Info.plist 放入專案資料夾，並加入 App target。

1. 删除对 PassSDK.shared.application(_:didFinishLaunchingWithOptions:) 与 PassSDK.shared.applicationDidBecomeActive() 的调用。
2. 将你收到的 VGSDKService-Info.plist 放入工程文件夹，并加入 App target。

The removed application(_:didFinishLaunchingWithOptions:) and applicationDidBecomeActive() calls no longer compile. If VGSDKService-Info.plist is not in the app bundle, the SDK crashes on launch.

已移除的 application(_:didFinishLaunchingWithOptions:) 與 applicationDidBecomeActive() 呼叫將無法編譯。若 App 套件中沒有 VGSDKService-Info.plist，SDK 會在啟動時崩潰。

已移除的 application(_:didFinishLaunchingWithOptions:) 与 applicationDidBecomeActive() 调用将无法编译。若 App 包中没有 VGSDKService-Info.plist，SDK 会在启动时崩溃。

Adds an in-app message inbox with a styleable UI (VGSDKAppInboxCleverTapStyle: title, tabs, and colors) plus the VGSDKAppInboxProvider protocol and VGSDKAppInboxMessage/VGSDKAppInboxMessageContent model protocols.

新增應用程式內訊息收件匣，提供可自訂樣式的介面（VGSDKAppInboxCleverTapStyle：標題、分頁與顏色），以及 VGSDKAppInboxProvider 協定與 VGSDKAppInboxMessage/VGSDKAppInboxMessageContent 模型協定。

新增应用内消息收件箱，提供可自定义样式的界面（VGSDKAppInboxCleverTapStyle：标题、标签页与颜色），以及 VGSDKAppInboxProvider 协议与 VGSDKAppInboxMessage/VGSDKAppInboxMessageContent 模型协议。

↪ This form is replaced in 3.12.0, see: AppInbox onItemClicked now passes raw CleverTap types

↪ 此寫法於 3.12.0 已被取代，請參見： AppInbox onItemClicked 現在直接傳回原生 CleverTap 型別

↪ 此写法于 3.12.0 已被取代，请参见： AppInbox onItemClicked 现在直接传回原生 CleverTap 类型

Open the inbox with VGSDKAppInbox.open(provider:listener:), passing a styled VGSDKAppInboxCleverTapProvider and a listener that handles the tapped item.

使用 VGSDKAppInbox.open(provider:listener:) 開啟收件匣，傳入已設定樣式的 VGSDKAppInboxCleverTapProvider 與處理點擊項目的 listener。

使用 VGSDKAppInbox.open(provider:listener:) 打开收件箱，传入已设置样式的 VGSDKAppInboxCleverTapProvider 与处理点击项目的 listener。

See the usage and full signature in the Integration guide:

請在整合指南中查看用法與完整簽名：

请在集成指南中查看用法与完整签名：

This addition is opt-in. Nothing breaks if you skip it: your existing integration keeps working, you just don’t gain this capability.

此新增功能為選用。略過不會造成任何問題：你現有的整合仍可正常運作，只是不會獲得此功能。

此新增功能为可选。跳过不会造成任何问题：你现有的集成仍可正常运行，只是不会获得此功能。

The IronSource in-app-ads module now reads its configuration from VGSDKIronSource-Info.plist instead of PassIronSourceConfig.json.

IronSource 應用內廣告模組現在改由 VGSDKIronSource-Info.plist 讀取設定，不再使用 PassIronSourceConfig.json。

IronSource 应用内广告模块现在改由 VGSDKIronSource-Info.plist 读取配置，不再使用 PassIronSourceConfig.json。

1. Delete PassIronSourceConfig.json from your project.
2. Add the VGSDKIronSource-Info.plist you were given to your project folder and the app target.

1. 從專案中刪除 PassIronSourceConfig.json。
2. 將你收到的 VGSDKIronSource-Info.plist 加入專案資料夾與 App target。

1. 从工程中删除 PassIronSourceConfig.json。
2. 将你收到的 VGSDKIronSource-Info.plist 加入工程文件夹与 App target。

If you use the IronSource in-app-ads module and don’t migrate the config, IronSource initialization fails: a missing VGSDKIronSource-Info.plist reports ironSourceMissingConfig and a malformed one reports ironSourceConfigInvalidFormat.

若你使用 IronSource 應用內廣告模組卻未遷移設定，IronSource 初始化會失敗：缺少 VGSDKIronSource-Info.plist 會回報 ironSourceMissingConfig，格式錯誤則回報 ironSourceConfigInvalidFormat。

若你使用 IronSource 应用内广告模块却未迁移配置，IronSource 初始化会失败：缺少 VGSDKIronSource-Info.plist 会报告 ironSourceMissingConfig，格式错误则报告 ironSourceConfigInvalidFormat。

The entire GVoice module (the PassSDKGVoice facade plus its GTSDKVoiceChatDelegate / GTSDKVoiceMessageDelegate delegates and the GTSDKVoiceErrorCode enum) was deleted in 3.12.0.

整個 GVoice 模組（PassSDKGVoice 門面連同其 GTSDKVoiceChatDelegate / GTSDKVoiceMessageDelegate 委派與 GTSDKVoiceErrorCode 列舉）已在 3.12.0 中刪除。

整个 GVoice 模块（PassSDKGVoice 门面连同其 GTSDKVoiceChatDelegate / GTSDKVoiceMessageDelegate 委托与 GTSDKVoiceErrorCode 枚举）已在 3.12.0 中删除。

Remove every call to PassSDKGVoice and its GTSDKVoiceChatDelegate, GTSDKVoiceMessageDelegate and GTSDKVoiceErrorCode types.

移除所有對 PassSDKGVoice 及其 GTSDKVoiceChatDelegate、GTSDKVoiceMessageDelegate 與 GTSDKVoiceErrorCode 型別的呼叫。

移除所有对 PassSDKGVoice 及其 GTSDKVoiceChatDelegate、GTSDKVoiceMessageDelegate 与 GTSDKVoiceErrorCode 类型的调用。

The old API no longer exists, so your project stops compiling until you migrate.

舊 API 已不存在，未完成遷移前你的專案將無法編譯。

旧 API 已不存在，未完成迁移前你的工程将无法编译。

The PassSDKAIHelp facade and its PassAIHelpUser / PassAIHelpApiConfig models were deleted.

PassSDKAIHelp 門面及其 PassAIHelpUser / PassAIHelpApiConfig 模型已刪除。

PassSDKAIHelp 门面及其 PassAIHelpUser / PassAIHelpApiConfig 模型已删除。

1. Remove every call to PassSDKAIHelp.setUser(with:) and PassSDKAIHelp.show(with:).
2. Delete every use of the PassAIHelpUser and PassAIHelpApiConfig models.

1. 移除所有對 PassSDKAIHelp.setUser(with:) 與 PassSDKAIHelp.show(with:) 的呼叫。
2. 刪除所有使用 PassAIHelpUser 與 PassAIHelpApiConfig 模型的程式碼。

1. 移除所有对 PassSDKAIHelp.setUser(with:) 与 PassSDKAIHelp.show(with:) 的调用。
2. 删除所有使用 PassAIHelpUser 与 PassAIHelpApiConfig 模型的代码。

The old API no longer exists, so your project stops compiling until you migrate.

舊 API 已不存在，未完成遷移前你的專案將無法編譯。

旧 API 已不存在，未完成迁移前你的工程将无法编译。

The completion signature changed from ([String: Any]?, Error?) to ([String: VGSDKFirebaseRemoteConfigValue]?, Error?) with a new VGSDKFirebaseRemoteConfigValue wrapper, and the callback is now delivered on the main thread.

完成回呼簽章由 ([String: Any]?, Error?) 變更為 ([String: VGSDKFirebaseRemoteConfigValue]?, Error?)，並新增 VGSDKFirebaseRemoteConfigValue 包裝型別，且回呼現在於主執行緒上派送。

完成回调签名由 ([String: Any]?, Error?) 变更为 ([String: VGSDKFirebaseRemoteConfigValue]?, Error?)，并新增 VGSDKFirebaseRemoteConfigValue 包装类型，且回调现在在主线程上派发。

Switch each call to the replacement shown in the table above.

將每個呼叫改為上表所示的替代項目。

将每个调用改为上表所示的替代项。

The old API no longer exists, so your project stops compiling until you migrate.

舊 API 已不存在，未完成遷移前你的專案將無法編譯。

旧 API 已不存在，未完成迁移前你的工程将无法编译。

The VGSDKAppInboxMessage / VGSDKAppInboxMessageContent wrapper protocols were removed and the callback now exposes CleverTap’s own message objects directly.

VGSDKAppInboxMessage / VGSDKAppInboxMessageContent 包裝協定已移除，回呼現在直接暴露 CleverTap 自身的訊息物件。

VGSDKAppInboxMessage / VGSDKAppInboxMessageContent 包装协议已移除，回调现在直接暴露 CleverTap 自身的消息对象。

Switch each call to the replacement shown in the table above.

將每個呼叫改為上表所示的替代項目。

将每个调用改为上表所示的替代项。

The old API no longer exists, so your project stops compiling until you migrate.

舊 API 已不存在，未完成遷移前你的專案將無法編譯。

旧 API 已不存在，未完成迁移前你的工程将无法编译。

3.12.0 adds the VGSDK facade with setGameContext(context:) and the VGSDKGameContext(roleId:serverId:) model. A context with an empty roleId or serverId is ignored.

3.12.0 新增 VGSDK 門面的 setGameContext(context:) 與 VGSDKGameContext(roleId:serverId:) 模型。roleId 或 serverId 為空的情境會被忽略。

3.12.0 新增 VGSDK 门面的 setGameContext(context:) 与 VGSDKGameContext(roleId:serverId:) 模型。roleId 或 serverId 为空的上下文会被忽略。

Call VGSDK.setGameContext(context:) with a VGSDKGameContext once the player has picked a role and server.

在玩家選好角色與伺服器後，以 VGSDKGameContext 呼叫 VGSDK.setGameContext(context:)。

在玩家选好角色与服务器后，以 VGSDKGameContext 调用 VGSDK.setGameContext(context:)。

See the usage and full signature in the Integration guide:

請在整合指南中查看用法與完整簽名：

请在集成指南中查看用法与完整签名：

This addition is opt-in. Nothing breaks if you skip it: your existing integration keeps working, you just don’t gain this capability.

此新增功能為選用。略過不會造成任何問題：你現有的整合仍可正常運作，只是不會獲得此功能。

此新增功能为可选。跳过不会造成任何问题：你现有的集成仍可正常运行，只是不会获得此功能。

Previously a thrown StoreKit error inside the purchase task left the completion unfired, so the listener never returned and the flow appeared to hang. The purchase now reports .failed with the underlying error.

先前購買任務中拋出的 StoreKit 錯誤會導致完成回呼不被觸發，監聽器永遠不會回傳，流程看似卡住。購買現在會以底層錯誤回報 .failed。

此前购买任务中抛出的 StoreKit 错误会导致完成回调不被触发，监听器永远不会回传，流程看似卡住。购买现在会以底层错误回报 .failed。

Handle the .failed status wherever you switch over VGSDKPaymentPurchaseStatus, treating it as a purchase that failed with the underlying StoreKit error.

在所有對 VGSDKPaymentPurchaseStatus 進行 switch 的位置處理 .failed 狀態，並將其視為因底層 StoreKit 錯誤而失敗的購買。

在所有对 VGSDKPaymentPurchaseStatus 进行 switch 的位置处理 .failed 状态，并将其视为因底层 StoreKit 错误而失败的购买。

See the usage and full signature in the Integration guide:

請在整合指南中查看用法與完整簽名：

请在集成指南中查看用法与完整签名：

If your VGSDKPayment.purchase listener doesn’t handle the .failed status, StoreKit purchase errors that now surface (previously the flow silently hung) are ignored, so a failed purchase produces no reaction in your game.

若你的 VGSDKPayment.purchase 監聽器未處理 .failed 狀態，現在會浮現的 StoreKit 購買錯誤（先前流程會靜默卡住）將被忽略，導致購買失敗時你的遊戲毫無反應。

若你的 VGSDKPayment.purchase 监听器未处理 .failed 状态，现在会浮现的 StoreKit 购买错误（此前流程会静默卡住）将被忽略，导致购买失败时你的游戏毫无反应。

PassSDKFirebase.fetchRemoteConfig is deprecated and will be removed in a future release. Its completion still returns [String: VGSDKFirebaseRemoteConfigValue]?, whose wrapper objects are replaced by plain strings in the new VGSDKFirebase API.

PassSDKFirebase.fetchRemoteConfig 已棄用，並將於未來版本移除。其回呼仍回傳 [String: VGSDKFirebaseRemoteConfigValue]?，新的 VGSDKFirebase API 已用純字串取代這些包裝物件。

PassSDKFirebase.fetchRemoteConfig 已弃用，并将在未来版本中移除。其回调仍返回 [String: VGSDKFirebaseRemoteConfigValue]?，新的 VGSDKFirebase API 已用纯字符串取代这些包装对象。

1. Replace every PassSDKFirebase.fetchRemoteConfig call with VGSDKFirebase.fetchRemoteConfig.
2. Read each value directly as a String and remove the .boolValue, .stringValue, .numberValue and .jsonValue accessors.

1. 將每個 PassSDKFirebase.fetchRemoteConfig 呼叫改為 VGSDKFirebase.fetchRemoteConfig。
2. 直接以 String 讀取每個值，並移除 .boolValue、.stringValue、.numberValue 與 .jsonValue 等存取器。

1. 将每个 PassSDKFirebase.fetchRemoteConfig 调用改为 VGSDKFirebase.fetchRemoteConfig。
2. 直接以 String 读取每个值，并移除 .boolValue、.stringValue、.numberValue 与 .jsonValue 等访问器。

See the usage and full signature in the Integration guide:

請在整合指南中查看用法與完整簽名：

请在集成指南中查看用法与完整签名：

PassSDKFirebase.fetchRemoteConfig still works today, but it is deprecated and scheduled for removal. Your build breaks once a later release deletes it, and you keep unwrapping VGSDKFirebaseRemoteConfigValue objects instead of reading strings.

PassSDKFirebase.fetchRemoteConfig 目前仍可運作，但已棄用並列入移除計畫。待日後版本刪除後你的建置將失敗，而且你仍需拆解 VGSDKFirebaseRemoteConfigValue 物件，而非直接讀取字串。

PassSDKFirebase.fetchRemoteConfig 目前仍可运行，但已弃用并列入移除计划。待日后版本删除后你的构建将失败，而且你仍需拆解 VGSDKFirebaseRemoteConfigValue 对象，而非直接读取字符串。

In 3.15.0 PassSDK.shared.showCustomerSupport(with:completion:) is deprecated. Use the equivalent function in the new VGSDKSupport module for continued support and its listener-based callbacks.

在 3.15.0 中，PassSDK.shared.showCustomerSupport(with:completion:) 已棄用。請改用新 VGSDKSupport 模組中的對應函式，以獲得持續支援與其 listener 回呼機制。

在 3.15.0 中，PassSDK.shared.showCustomerSupport(with:completion:) 已弃用。请改用新 VGSDKSupport 模块中的对应函数，以获得持续支持与其 listener 回调机制。

Migrate calls of PassSDK.shared.showCustomerSupport(with:completion:) to VGSDKSupport.openSupportCenter(info:listener:).

將 PassSDK.shared.showCustomerSupport(with:completion:) 的呼叫遷移到 VGSDKSupport.openSupportCenter(info:listener:)。

将 PassSDK.shared.showCustomerSupport(with:completion:) 的调用迁移到 VGSDKSupport.openSupportCenter(info:listener:)。

See the usage and full signature in the Integration guide:

請在整合指南中查看用法與完整簽名：

请在集成指南中查看用法与完整签名：

PassSDK.shared.showCustomerSupport(with:completion:) still works today, but it is deprecated and scheduled for removal. Your build breaks once a later release deletes it, and you keep the old completion callback instead of the listener callbacks.

PassSDK.shared.showCustomerSupport(with:completion:) 目前仍可運作，但已棄用並列入移除計畫。待日後版本刪除後你的建置將失敗，而且你仍使用舊的 completion 回呼，而非 listener 回呼。

PassSDK.shared.showCustomerSupport(with:completion:) 目前仍可运行，但已弃用并列入移除计划。待日后版本删除后你的构建将失败，而且你仍使用旧的 completion 回调，而非 listener 回调。

3.15.0 removes the public scene(_:openURLContexts:) forwarding method from PassSDK. The SDK now handles scene URL opens automatically. Any integrator still calling the old method will fail to compile.

3.15.0 從 PassSDK 移除了公開的 scene(_:openURLContexts:) 轉發方法。SDK 現在會自動處理 scene 的 URL 開啟。仍呼叫舊方法的接入方將無法通過編譯。

3.15.0 从 PassSDK 移除了公开的 scene(_:openURLContexts:) 转发方法。SDK 现在会自动处理 scene 的 URL 打开。仍调用旧方法的接入方将无法通过编译。

Delete every PassSDK.shared.scene(_:openURLContexts:) call from your UISceneDelegate.

從你的 UISceneDelegate 中刪除所有 PassSDK.shared.scene(_:openURLContexts:) 呼叫。

从你的 UISceneDelegate 中删除所有 PassSDK.shared.scene(_:openURLContexts:) 调用。

The old API no longer exists, so your project stops compiling until you migrate.

舊 API 已不存在，未完成遷移前你的專案將無法編譯。

旧 API 已不存在，未完成迁移前你的工程将无法编译。

The SDK ships two Firebase variants and the minimum iOS version follows the one you take. Firebase 12.12.1 requires an iOS 15 deployment target. Firebase 11.15.0 still supports iOS 13. No public SDK facade or model changed in this release.

SDK 提供兩種 Firebase 版本，最低 iOS 版本取決於你採用的版本。Firebase 12.12.1 需要 iOS 15 部署目標。Firebase 11.15.0 仍支援 iOS 13。本版本未變更任何公開的 SDK facade 或 model。

SDK 提供两种 Firebase 版本，最低 iOS 版本取决于你采用的版本。Firebase 12.12.1 需要 iOS 15 部署目标。Firebase 11.15.0 仍支持 iOS 13。本版本未变更任何公开的 SDK facade 或 model。

1. Raise your app’s iOS deployment target to 15.0 or higher if your build takes Firebase 12.12.1.
2. Stay on the Firebase 11.15.0 variant if you must keep supporting iOS 13 or 14.

1. 若你的建置採用 Firebase 12.12.1，請將 App 的 iOS 部署目標提升至 15.0 或以上。
2. 若你必須繼續支援 iOS 13 或 14，請維持使用 Firebase 11.15.0 版本。

1. 若你的构建采用 Firebase 12.12.1，请将 App 的 iOS 部署目标提升至 15.0 或以上。
2. 若你必须继续支持 iOS 13 或 14，请保持使用 Firebase 11.15.0 版本。

An app still targeting iOS 13 or 14 will not build against the Firebase 12.12.1 variant. It continues to build against Firebase 11.15.0.

仍以 iOS 13 或 14 為目標的 App 無法與 Firebase 12.12.1 版本建置，但仍可使用 Firebase 11.15.0 版本建置。

仍以 iOS 13 或 14 为目标的 App 无法与 Firebase 12.12.1 版本构建，但仍可使用 Firebase 11.15.0 版本构建。

3.17.0 adds the deep-link listener the integrator must register to receive deep links from Apollo in-app messages: without it, a deep link carried by an in-app message is not delivered to the game.

3.17.0 新增了整合方必須註冊的 deep-link 監聽器，用以接收來自 Apollo 應用內訊息的 deep link：若未註冊，應用內訊息所攜帶的 deep link 不會傳遞給遊戲。

3.17.0 新增了接入方必须注册的 deep-link 监听器，用以接收来自 Apollo 应用内消息的 deep link：若未注册，应用内消息所携带的 deep link 不会传递给游戏。

1. Register a VGSDKInAppMessageDeepLinkListener with VGSDKAppInbox.setInAppMessageDeepLinkListener(listener:).
2. Route the deep link your onDeepLink closure receives.

1. 以 VGSDKAppInbox.setInAppMessageDeepLinkListener(listener:) 註冊 VGSDKInAppMessageDeepLinkListener。
2. 在 onDeepLink closure 收到 deep link 時於遊戲內導頁。

1. 以 VGSDKAppInbox.setInAppMessageDeepLinkListener(listener:) 注册 VGSDKInAppMessageDeepLinkListener。
2. 在 onDeepLink closure 收到 deep link 时于游戏内跳转。

See the usage and full signature in the Integration guide:

請在整合指南中查看用法與完整簽名：

请在集成指南中查看用法与完整签名：

This addition is opt-in. Nothing breaks if you skip it: your existing integration keeps working, you just don’t gain this capability.

此新增功能為選用。略過不會造成任何問題：你現有的整合仍可正常運作，只是不會獲得此功能。

此新增功能为可选。跳过不会造成任何问题：你现有的集成仍可正常运行，只是不会获得此功能。

3.18.0 adds Swift Package Manager as an integration option alongside the existing manual framework embedding. You can add the SDK as a Swift Package instead of embedding the VNGGames SDK frameworks by hand. The manual-framework path is still fully supported, so adopting SPM is opt-in.

3.18.0 新增 Swift Package Manager 作為整合方式，與既有的手動嵌入 framework 並存。你可以改用 Swift Package 加入 SDK，而不必手動嵌入 VNGGames SDK framework。手動嵌入 framework 的方式仍完整支援，因此採用 SPM 為選用。

3.18.0 新增 Swift Package Manager 作为集成方式，与既有的手动嵌入 framework 并存。你可以改用 Swift Package 添加 SDK，而不必手动嵌入 VNGGames SDK framework。手动嵌入 framework 的方式仍完整支持，因此采用 SPM 为可选。

Integrate the SDK via Swift Package Manager by following the Get Started section of the Integration guide.

依照整合指南的 Get Started 章節，以 Swift Package Manager 整合 SDK。

按照集成指南的 Get Started 章节，以 Swift Package Manager 集成 SDK。

This addition is opt-in. Nothing breaks if you skip it: your existing integration keeps working, you just don’t gain this capability.

此新增功能為選用。略過不會造成任何問題：你現有的整合仍可正常運作，只是不會獲得此功能。

此新增功能为可选。跳过不会造成任何问题：你现有的集成仍可正常运行，只是不会获得此功能。

3.18.0 introduces the VGSDK-prefixed facade layer. The legacy Pass* classes are deprecated (they still work) and are slated for removal in a future release.

3.18.0 導入 VGSDK 前綴的門面層。舊版 Pass* 類別已棄用（仍可運作），並將於未來版本移除。

3.18.0 引入 VGSDK 前缀的门面层。旧版 Pass* 类已弃用（仍可使用），并将在未来版本中移除。

Switch each call to the replacement shown in the table above.

將每個呼叫改為上表所示的替代項目。

将每个调用改为上表所示的替代项。

It still works today, but is scheduled for removal. Your build breaks once a later release deletes it.

目前仍可運作，但已列入移除計畫。待日後版本刪除後，你的建置將失敗。

目前仍可运行，但已列入移除计划。待日后版本删除后，你的构建将失败。

3.18.0 mirrors every AppsFlyer/Facebook/Firebase/CleverTap/DataPlatform/ThinkingData event method onto the single VGSDKAnalytics facade.

3.18.0 將所有 AppsFlyer/Facebook/Firebase/CleverTap/DataPlatform/ThinkingData 事件方法鏡射到單一的 VGSDKAnalytics 門面。

3.18.0 将所有 AppsFlyer/Facebook/Firebase/CleverTap/DataPlatform/ThinkingData 事件方法镜像到单一的 VGSDKAnalytics 门面。

Switch each call to the replacement shown in the table above.

將每個呼叫改為上表所示的替代項目。

将每个调用改为上表所示的替代项。

It still works today, but is scheduled for removal. Your build breaks once a later release deletes it.

目前仍可運作，但已列入移除計畫。待日後版本刪除後，你的建置將失敗。

目前仍可运行，但已列入移除计划。待日后版本删除后，你的构建将失败。

3.18.0 adds case pending to the public @objc enum VGSDKPaymentPurchaseStatus, so integrators gain a distinct pending outcome and any exhaustive switch over the enum must be updated.

3.18.0 於公開的 @objc enum VGSDKPaymentPurchaseStatus 新增 case pending，因此整合方多了一個獨立的待處理結果，且所有窮舉式 switch 都必須更新。

3.18.0 在公开的 @objc enum VGSDKPaymentPurchaseStatus 新增 case pending，因此接入方多了一个独立的待处理结果，且所有穷举式 switch 都必须更新。

Handle the new .pending case wherever you switch over VGSDKPaymentPurchaseStatus, treating it as a purchase that is accepted but not yet completed.

在任何對 VGSDKPaymentPurchaseStatus 進行 switch 的地方處理新的 .pending 狀態，並將它視為已被接受但尚未完成的交易。

在任何对 VGSDKPaymentPurchaseStatus 进行 switch 的地方处理新的 .pending 状态，并将它视为已被接受但尚未完成的交易。

See the usage and full signature in the Integration guide:

請在整合指南中查看用法與完整簽名：

请在集成指南中查看用法与完整签名：

A Swift exhaustive switch with no default won’t compile until .pending is handled. Objective-C keeps building, so an unhandled .pending is silently treated as another outcome.

沒有 default 的 Swift 窮舉式 switch 在處理 .pending 之前無法編譯。Objective-C 仍可建置，因此未處理的 .pending 會被靜默當成其他結果。

没有 default 的 Swift 穷举式 switch 在处理 .pending 之前无法编译。Objective-C 仍可构建，因此未处理的 .pending 会被静默当成其他结果。

3.19.0 hands the App Inbox floating button over to the game, so it can be taken off a cutscene or a full-screen shop and put back in the lobby. The first call in either direction takes control for the rest of the session, and the SDK stops showing or hiding the button on its own.

3.19.0 將 App Inbox 浮動按鈕交由遊戲控制，可在過場動畫或全螢幕商店中移除，並在大廳重新顯示。任一方向的第一次呼叫即會取得本次工作階段的控制權，SDK 不再自行顯示或隱藏該按鈕。

3.19.0 将 App Inbox 浮动按钮交由游戏控制，可在过场动画或全屏商店中移除，并在大厅重新显示。任一方向的第一次调用即会取得本次会话的控制权，SDK 不再自行显示或隐藏该按钮。

1. Call VGSDKAppInbox.hideFloatingButton() when your game enters a screen the button must stay off.
2. Call VGSDKAppInbox.showFloatingButton() when the player reaches a screen where it may appear again.
3. Re-issue the call your screen needs after a logout, because the next session starts with the SDK deciding again.
4. Read the SDK log for the outcome of each call, because neither method returns a value.

1. 在遊戲進入不應顯示按鈕的畫面時呼叫 VGSDKAppInbox.hideFloatingButton()。
2. 在玩家回到允許顯示按鈕的畫面時呼叫 VGSDKAppInbox.showFloatingButton()。
3. 登出後重新發出該畫面所需的呼叫，因為下一個工作階段會交回 SDK 決定。
4. 從 SDK 日誌確認每次呼叫的結果，因為兩個方法都不會回傳值。

1. 在游戏进入不应显示按钮的界面时调用 VGSDKAppInbox.hideFloatingButton()。
2. 在玩家回到允许显示按钮的界面时调用 VGSDKAppInbox.showFloatingButton()。
3. 登出后重新发出该界面所需的调用，因为下一个会话会交回 SDK 决定。
4. 从 SDK 日志确认每次调用的结果，因为两个方法都不会返回值。

See the usage and full signature in the Integration guide:

請在整合指南中查看用法與完整簽名：

请在集成指南中查看用法与完整签名：

Nothing breaks and the App Inbox keeps working, but the SDK alone decides when the floating button is on screen, so it can sit over a cutscene or a full-screen shop with no way for your game to move it out of the way.

不會有任何中斷，App Inbox 仍照常運作，但浮動按鈕何時出現完全由 SDK 決定，因此它可能疊在過場動畫或全螢幕商店上，而遊戲無法將它移開。

不会有任何中断，App Inbox 仍照常运作，但浮动按钮何时出现完全由 SDK 决定，因此它可能叠在过场动画或全屏商店上，而游戏无法将它移开。

The same two App Inbox visibility calls now also decide whether in-app messages may appear, so a hide keeps banners and modals off a match screen with no second API to call. Content that becomes eligible while hidden is kept and released one at a time after the next show call, in its existing priority order.

同樣的兩個 App Inbox 顯示與隱藏呼叫，現在也決定 In-App Message 是否能出現，因此隱藏即可讓橫幅與彈窗不出現在戰鬥畫面，不需要另一個 API。隱藏期間符合條件的內容會被保留，並在下一次顯示呼叫後依原本的優先順序逐一釋出。

同样的两个 App Inbox 显示与隐藏调用，现在也决定 In-App Message 是否能出现，因此隐藏即可让横幅与弹窗不出现在战斗界面，不需要另一个 API。隐藏期间符合条件的内容会被保留，并在下一次显示调用后按原本的优先顺序逐一释出。

1. Review every VGSDKAppInbox.hideFloatingButton() call site, because each one now also stops in-app messages from appearing.
2. Keep the hide calls only on screens where holding back banners and modals is also what you want.
3. Call VGSDKAppInbox.showFloatingButton() as soon as the player reaches a safe screen, so held content is released one at a time.
4. Re-test your in-app message flow across a hide and show round trip, including content that arrives while hidden.

1. 檢視每一處 VGSDKAppInbox.hideFloatingButton() 呼叫，因為現在每一次都會同時讓 In-App Message 不再出現。
2. 只在同時希望暫停橫幅與彈窗的畫面保留隱藏呼叫。
3. 玩家一回到安全畫面就呼叫 VGSDKAppInbox.showFloatingButton()，讓保留的內容逐一釋出。
4. 重新測試隱藏與顯示往返的 In-App Message 流程，包含隱藏期間送達的內容。

1. 检视每一处 VGSDKAppInbox.hideFloatingButton() 调用，因为现在每一次都会同时让 In-App Message 不再出现。
2. 只在同时希望暂停横幅与弹窗的界面保留隐藏调用。
3. 玩家一回到安全界面就调用 VGSDKAppInbox.showFloatingButton()，让保留的内容逐一释出。
4. 重新测试隐藏与显示往返的 In-App Message 流程，包含隐藏期间送达的内容。

See the usage and full signature in the Integration guide:

請在整合指南中查看用法與完整簽名：

请在集成指南中查看用法与完整签名：

Your existing calls keep compiling and the button still hides, but any screen where you hid it purely for layout now also holds back in-app messages, so content piles up until you call show again and anything whose own validity window closes while hidden is never seen.

現有呼叫仍可正常編譯，按鈕也照樣隱藏，但凡是僅為版面而隱藏的畫面，現在也會一併暫停 In-App Message，內容會持續累積到再次呼叫顯示為止，而在隱藏期間就過期的內容將永遠不會被看到。

现有调用仍可正常编译，按钮也照样隐藏，但凡是仅为版面而隐藏的界面，现在也会一并暂停 In-App Message，内容会持续累积到再次调用显示为止，而在隐藏期间就过期的内容将永远不会被看到。