抖音合作 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>
完成上述操作后,正常打包即可,出包后请联系平台同事验收。