抖音直玩能力

业务场景

  1. 查询指定用户存在待促活事件的场景列表，以便激活推荐流直出游戏能力。
  2. 当用户符合直玩游戏出卡条件时，抖音平台会调用接口来拉取场景列表，根据一定策略排序选取最优场景，将结合厂家信息的游戏分发到推荐流中。

注意事项

  1. 游戏方需要提供一个服务端接口地址，单次查询耗时不能超过200毫秒
  2. 查询耗时太长会导致不出直玩游戏，开发人员需要做好接口的性能优化和测试工作
  3. 必须保证返回的场景在游戏内一定是就绪状态（如：若该用户游戏内无离线收益，则不可返回表示离线收益就绪的状态），如果因为”货不对板“引起客诉，抖音平台会封禁游戏的直玩能力
  4. gameid 值，是益世界的项目ID标识，不是出包的 appid

流程图

接口地址

地址由CP提供

接口说明

  1. 协议：HTTPS
  2. 方式：POST
  3. ContentType：application/json;charset=utf-8
  4. 请求报文：
字段类型必需参与签名说明
gameidlong是是游戏项目ID(并非出包的 appId)
openidstring是是SDK用户唯一标识
extrastring否不一定扩展字段，json 字符串
timestamplong是是毫秒时间戳
signstring是否签名
  1. 响应报文：
字段类型必需说明
codeint是状态码：0代表成功，非0代表错误
msgstring是响应描述
dataobject否结果数据

data结构体

字段类型必需说明
scenesarray是就绪状态的场景对象列表，场景值定义见下述scene结构章节

scenes结构体

字段类型必需说明
sceneint是就绪的场景值：1、离线收益场景, 2、体力恢复场景, 3、重要事件掉落
contentIdsarray是就绪场景对应的自定义文案ID列表，由CP向抖音开放平台申请生成
extrastring是每个场景可携带的扩展信息，字符串长度不能超过100

请求示例

{
        "gameid": 123456,
        "openid": "12345678912345678912345",
        "extra": "",
        "timestamp": 1654142913840,
        "sign": "8ef6513ba5412ee3c7c5b394daa1e76f"
}

响应示例

{
	"code": 0,
	"msg": "success",
	"data": {
		"scenes": [{
			"scene": 1,
			"contentIds": ["CONTENT123", "CONTENT456"],
			"extra": "test1"
		}, {
			"scene": 2,
			"contentIds": ["CONTENT789"],
			"extra": "test2"
		}]
	}
}

签名规则

  1. 参数名区分大小写，按 ASCII 码从小到大排序（字典序）
  2. 只有值为 null 和名为 sign 的键值对，才不参与签名
  3. 使用 URL 键值对的格式，拼接成待签名字符串，签名 key 在最后拼接
  4. 将生成的签名与入参 sign 值作校验，验签忽略大小写
String sign = md5(k1=v1&k2=v2&k3=v3...&key=appKey);

调试示例

import cn.hutool.crypto.SecureUtil;

import java.util.HashMap;
import java.util.Map;
import java.util.TreeMap;

public class SignExample {

    public static String getMd5Sign(Map<String, Object> params, String appKey) {
        TreeMap<String, Object> sortedParams = new TreeMap(params);
        StringBuilder builder = new StringBuilder(512);
        sortedParams.forEach((k, v) -> {
            if (v != null) {
                builder.append(k).append("=").append(v).append("&");
            }
        });
        builder.append("key=").append(appKey);
        return SecureUtil.md5(builder.toString());
    }

    public static void main(String[] args) {
        String appKey = "AaBbCcDdEeFfGgHh";
        Map<String, Object> reqMap = new HashMap<>();
        reqMap.put("gameid", 123456L);
        reqMap.put("openid", "12345678912345678912345");
        reqMap.put("extra", "");
        reqMap.put("timestamp", 1654142913840L);
        System.out.println(String.format("直玩签名:%s", getMd5Sign(reqMap, appKey)));
    }
}