淘宝小游戏接入配置

WARNING

如果您还没有完成接口的调用，请参考API接入文档：小游戏接口调用

通过淘宝小游戏SDK后，游戏登录使用的是淘宝授权登录，暂不支持其他登录方式。

淘宝小游戏的初始化接口，需要传额外参数：

//初始化聚合SDK（在其他接口调用之前初始化）
const initParams = {
appID: '1',
appKey: '855237c757b7420bb932110efa41263b',
channelID: '5107',
useAD: true,
extraParams: {
                cloudAppID:"58148",
                cloudEnv: "online"
             }
}

u8sdk.init(initParams).then(()=>{
    console.log('init success.')
}).catch(err=>{
console.log('init failed with err:', err)
})

参数名称	说明
cloudAppId	淘宝小游戏后台创建一个空应用，添加外部域名后，生成的cloudAppId
cloudEnv	云环境，test或online， 正式上线时设置为online

淘宝小游戏特殊说明

淘宝所有的服务端协议都经过淘宝网关，网关转发协议会携带sign、openId等字段， 和U8统一协议中的字段和签名规则冲突。

所以针对淘宝小游戏，将涉及到的小游戏相关协议单独重写， 在u8sdk.js中，原先/inner开头的协议，都变成了 /inner/taobao/xxx协议。

添加渠道配置

在接入淘宝小游戏时，初始化参数中，需要传入当前淘宝小游戏渠道的渠道号。 所以，我们需要在SDK后台添加好渠道配置。 在游戏控制台->配置管理->渠道配置菜单中，添加一个渠道：

配置说明：

渠道商： 选择【淘宝小游戏】；
渠道号： 生成或输入渠道号，并将该参数给到研发这边，传入初始化接口；
支持平台： 选择H5；
互通渠道号： 不设置或设置为0；
渠道别名： 随意

淘宝小游戏参数申请

上面渠道配置添加后， 需要在渠道参数配置中，按说明配置好淘宝小游戏对应的参数，比如小游戏appSecret等。 这些参数可以在淘宝小游戏控制台获取：

1、 申请cloudAppId，可以参考：淘宝小游戏外部域名配置 ；

2、 如果您还没有注册淘宝小游戏，可以参考： 淘宝小游戏申请注册指南 ；

3、 淘宝小游戏的虚拟支付开通，可以参考：淘宝小游戏虚拟支付 ；

4、 淘宝小游戏支付完成后，会通过支付回调通知给SDK服务端。 需要通过奇门API(外部服务商接口)的方式，配置商家服务地址。 可能有如下三个地址需要配置：

配置信息	值	说明
订单查询接口（taobao.game.charge.zc.query）	https://{U8Server URL}/partner/pay/taobao/query/U8渠道号	将{U8Server URL}替换为正式的U8Server URL；将{U8渠道号}替换为U8后台淘宝小游戏渠道的渠道号
订单充值接口（taobao.game.charge.zc.order）	https://{U8Server URL}/partner/pay/taobao/callback	将{U8Server URL}替换为正式的U8Server URL
订单取消接口（taobao.game.charge.zc.cancel）	https://{U8Server URL}/partner/pay/taobao/cancel/U8渠道号	将{U8Server URL}替换为正式的U8Server URL；将{U8渠道号}替换为U8后台淘宝小游戏渠道的渠道号

设置完成后，点击调试，调试没问题后， 进行发布。 发布后才能进行小游戏的支付测试。