---
description: 适于使用creator引擎开发的抖音小游戏参考
---

# 接入文档-抖音小游戏

### 对接流程

{% hint style="danger" %}
SDK接入完毕后请发送二维码到对接群，测试验收通过后再提审发布！！！
{% endhint %}

### 接入准备

**域名加白**

接入前请检查下述域名是否已加进域名配置白名单，配置项有request合法域名、socket合法域名、uploadFile合法域名、downloadFile合法域名等（根据具体使用到那些域名项进行配置，也可以通配）。

{% code lineNumbers="true" %}
```C#
https://c.vigame.cn
https://p.vigame.cn
https://x.vimedia.cn
https://u.vigame.cn
https://r.vigame.cn
https://x.vigame.cn
```
{% endcode %}

**配置抖音登录参数（抖音资质审核通过后才可以获取正式的openid）以及支付回调参数**

> 联系运营同学配置

**动能参数**

> 联系运营同学提供

```
H5动能内部appid
H5动能内部appKey
```

**广告位配置**

> 联系运营同学配置

```
游戏的广告位埋点
```

### 接入步骤与常用接口

#### 下载SDK与Wb插件

```
将下载好的Wb插件放入assets目录下
```

<figure><img src="https://3109237457-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpGDLwHS4NGOCL3SVgTBf%2Fuploads%2Fgit-blob-5bcffc62813e833792ad9b59a0d79c89ebdb57fc%2Fwb.png?alt=media" alt=""><figcaption></figcaption></figure>

```
将下载好的dnsdk.js文件放入Wb目录下
```

<figure><img src="https://3109237457-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpGDLwHS4NGOCL3SVgTBf%2Fuploads%2Fgit-blob-40458ce8513ce05d4cfe8f907b93e55310451469%2Fdnsdk.png?alt=media" alt=""><figcaption></figcaption></figure>

### 常用接口

参考常用接口文档接入：[常用接口](chang-yong-jie-kou)

### 平台能力

#### 侧边栏（抖音必接）

> 抖音必接，不接入审核被拒

```typescript
//命名空间 CoreManager 侧边栏需要使用到的接口

// 生命周期回到前台监听
onShow(callBack: Function): void

// 检测是否支持跳转侧边栏（抖小专用）
checkScene(callBack: Function): void

// 跳转侧边栏（抖小专用）
navigateToScene(): void
```

示例代码：

```typescript
// 一：进入游戏后选择合适的时机添加onShow监听
Wb.Core.onShow((res) => {
    console.log("creator onShow回调", res);
})

// 二：当用户点击侧边栏相关按钮时 先检测版本是否支持 后跳转
Wb.Core.checkScene((isSupport: boolean) => {
    console.log("先检测是否支持: ", isSupport);
    if (isSupport) {
        Wb.Core.navigateToScene();
    }
})

// 三：当用户从侧边栏回到游戏时 onShow会收到回调（第一步监听的打印里），
//事件的回调参数中，scene值为021036，launch_from为homepage，location为sidebar_card
//通过这些参数判断是否是从侧边栏返回并进行发奖逻辑等，具体参考上方文档
```
