TikTok 发奖账号绑定

Important

请勿自行接入。TikTok 渠道需与 TikTok 侧建立正式合作后方可注册应用、获取用于接入的配置。如需接入，请先咨询业务接口人。

TikTok 发奖账号绑定允许玩家从 TikTok 发奖活动中打开游戏，将游戏账号绑定到 TikTok，然后返回 TikTok 以完成发奖。

支持的平台

发奖账号绑定支持：

• iOS
• Android

配置发奖绑定 URI

打开项目 INTLConfig.ini 文件，添加发奖绑定 URI：

INTLConfig.ini

[TikTok]
TIKTOK_APP_ID = {INTL_TIKTOK_APP_ID}
TIKTOK_CLIENT_KEY = {INTL_TIKTOK_CLIENT_KEY}
TIKTOK_REDIRECT_URI = {INTL_TIKTOK_REDIRECT_URI}
TIKTOK_REWARD_BIND_URI = {INTL_TIKTOK_REWARD_BIND_URI}

• 将 {INTL_TIKTOK_REWARD_BIND_URI} 替换为在 TikTok 开发者控制台中配置的发奖绑定 URI。路径必须以 /pnt/tiktok/rewardsbind 结尾，例如 https://example.com/pnt/tiktok/rewardsbind。

在 Android 上，构建流程还需要将 host 和 path 作为 manifest 占位符：

build.gradle

android {
    defaultConfig {
        manifestPlaceholders = [
            "TIKTOK_REDIRECT_URI_HOST"      : "{INTL_TIKTOK_REDIRECT_URI_HOST}",
            "TIKTOK_REDIRECT_URI_PATH"      : "{INTL_TIKTOK_REDIRECT_URI_PATH}",
            "TIKTOK_REWARD_BIND_URI_HOST"   : "{INTL_TIKTOK_REWARD_BIND_URI_HOST}",
            "TIKTOK_REWARD_BIND_URI_PATH"   : "{INTL_TIKTOK_REWARD_BIND_URI_PATH}",
        ]
    }
}

• 将 {INTL_TIKTOK_REWARD_BIND_URI_HOST} 和 {INTL_TIKTOK_REWARD_BIND_URI_PATH} 替换为 TIKTOK_REWARD_BIND_URI 的 host 和 path。例如，若 TIKTOK_REWARD_BIND_URI = https://example.com/pnt/tiktok/rewardsbind，则分别填入 example.com 和 pnt/tiktok/rewardsbind。

完整流程

下图展示了完整的发奖账号绑定流程：

Android 深度链接处理

SDK 插件声明了一个中转 Activity 来捕获发奖绑定 App Link。

请确保宿主应用提供 INTL_GAME_ACTIVITY_CLASS_NAME 元数据，以便 SDK 能够返回到正确的 Activity：

AndroidManifest.xml

<application ...>
    <meta-data
        android:name="INTL_GAME_ACTIVITY_CLASS_NAME"
        android:value="com.yourgame.YourMainActivity" />
</application>

iOS Universal Link 处理

在 iOS 上，发奖绑定 URI 使用与登录重定向 URI 相同的 HTTPS 协议和域名。iOS 通过 Universal Link 路由回调，而非自定义 URL Scheme。

将发奖绑定域名添加到应用的 Associated Domains 权限中：

YourApp.entitlements

<key>com.apple.developer.associated-domains</key>
<array>
    <string>applinks:{INTL_TIKTOK_REWARD_BIND_URI_HOST}</string>
</array>

将 {INTL_TIKTOK_REWARD_BIND_URI_HOST} 替换为 TIKTOK_REWARD_BIND_URI 的 host。

已通过 TikTok 登录的路径

如果玩家在发奖链接到达时已通过 TikTok 登录，SDK 会完全跳过绑定步骤，并排队延迟跳转回 TikTok。无需额外的游戏代码。

提前终止与循环防护

SDK 会防止同一发奖链接的绑定流程重复执行。如果绑定已在进行中，重复的深度链接到达会被忽略。

绑定流程会在任何 TikTok 绑定结果（成功、失败或取消）后自动终止。无需游戏代码处理终止逻辑。

返回 TikTok 行为

绑定流程终止后，SDK 会自动打开 TikTok 并将玩家返回到活动页面。你无需手动触发返回。这适用于所有结果——绑定成功、绑定失败、用户取消或"已通过 TikTok 登录"的快速路径。

发奖（可选）

TikTok 发奖账号绑定仅建立游戏账号与 TikTok 账号之间的身份关联。如果你的游戏还使用 Level Infinite 发奖服务在绑定后发奖（游戏内礼包），请在游戏代码中单独调用 SendBindReward。该 API 独立于发奖绑定返回流程，不影响用户何时被送回 TikTok。

测试与故障排查

1. 确认 INTLConfig.ini 中已设置 TIKTOK_REWARD_BIND_URI，且与 TikTok 开发者控制台中的值一致。
2. 在 Android 上，验证 TIKTOK_REWARD_BIND_URI_HOST 和 TIKTOK_REWARD_BIND_URI_PATH 已作为 manifest 占位符填入。
3. 在 iOS 上，验证 Associated Domains 权限和 apple-app-site-association 文件中包含发奖绑定路径。
4. 确认深度链接到达后登录或自动登录已完成；绑定流程会等待成功的登录事件。
5. 如果绑定未触发或返回 TikTok 失败，请查看原生日志中 TikTok 发奖绑定模块的相关信息。