跳到主要内容

抖音合作 SDK 接入指南

添加 SDK

当前仅支持 Unity SDK 接入

提示

需要升级 XDSDK 到 6.23.1 或更高版本

如果当前正在使用广告 ADS SDK,需要升级到 3.6.1 或更高版本

{
"dependencies": {
"com.xd.sdk.douyincps": "1.0.1",
},
"scopedRegistries": [
{
// NPMJS 访问不通时可以切换到淘宝源试试 https://registry.npmmirror.com
// 公司内网可使用 http://npm.xindong.com
"name": "NPMJS",
"url": "https://registry.npmjs.org/",
"scopes": [
"com.xd",
"com.tapsdk",
"com.leancloud"
]
}
]
}

添加配置文件

请联系平台同事获取 iOS(UOPSDKConfig.json) 和 Android(config.json) 的配置文件,然后按照如下结构将文件放在指定的文件夹内。

project-root/

└─ Assets/
└─ Plugins/
├─ Android/
│ └─ config.json

└─ iOS/
└─ UOPSDKConfig.json

添加配置支持从抖音拉起游戏

抖音打开游戏功能会通过 scheme 拉起游戏。Unity SDK 会自动配置 iOS 的 Info.plist,Android 则需要游戏侧增加相应 Activiy 配置以响应该scheme。参考格式如下:

  • com.xxx.GameLaunchActivity 为游戏的 UnityPlayerActivity
  • "android:exported" 必须设置为 true。
  • ${applicationId} 不需要修改
  • dygame{appId} 中的 {appId} 需要替换为前文拿到的 config.json 中的 app_id

有疑问可以咨询平台同事。

<activity
android:name="com.xxx.GameLaunchActivity"
android:exported="true"
android:launchMode="singleTask"
android:taskAffinity="${applicationId}">
<intent-filter>
<action android:name="android.intent.action.VIEW" />
<category android:name="android.intent.category.DEFAULT" />
<category android:name="android.intent.category.BROWSABLE" />
<data
android:host="${applicationId}"
android:path="/jump_to_game"
android:scheme="dygame{appId}" />
</intent-filter>
</activity>

完成上述操作后,正常打包即可,出包后请联系平台同事验收。