Appearance
微信小游戏接入配置
WARNING
如果您还没有完成接口的调用,请参考API接入文档:小游戏接口调用
通过微信小游戏SDK后,游戏登录使用的是微信登录,暂不支持其他登录方式。
Android平台支付支持米大师虚拟支付(游戏币或道具直购模式)和跳转客服窗口支付;iOS平台只支持跳转客服窗口支付。
添加渠道配置
在接入微信小游戏时,初始化参数中,需要传入当前微信小游戏渠道的渠道号。 所以,我们需要现在SDK后台添加好渠道配置。 在游戏控制台->配置管理->渠道配置菜单中,添加一个渠道:
配置说明:
渠道商: 选择【微信小游戏】或【微信小游戏(官网互通)】;
渠道号: 生成或输入渠道号,并将该参数给到研发这边,传入初始化接口;
支持平台: 选择H5;
互通渠道号: 如果渠道商选择了【微信小游戏(官网互通)】 ,那需要将互通渠道号和官网渠道上的互通渠道号设置为同一值;
渠道别名: 随意
微信小游戏参数申请
上面渠道配置添加后, 需要在渠道参数配置中,按说明配置好微信小游戏对应的参数,比如小游戏appID、secretKey等。 这些参数可以在微信小游戏控制台、微信公众平台、微信开放平台、微信商户平台获取:
1、 如果您还没有注册微信小游戏,可以参考: 微信小游戏申请注册指南;
2、 如果要和官网SDK的微信账号互通,微信小游戏的账号必须使用UnionID, 需要在微信开放平台绑定关联微信小游戏,之后微信小游戏的登录授权才会返回UnionID;
3、 微信iOS采用跳转客服窗口支付,所以需要开通小游戏的消息推送功能, 在小游戏控制台-》管理-》开发管理-》开发设置页签中,消息推送模块中进行配置:
配置信息 | 值 | 说明 |
---|---|---|
URL(服务器地址) | https://{U8Server URL}/partner/pay/wechat/mini/notify/渠道号 | 将{U8Server URL}替换为正式的U8Server URL,将{渠道号}替换为微信小游戏的渠道号 |
Token(令牌) | 自定义 | 记录好,需要配置到SDK后台渠道配置中 |
EncodingAESKey(消息加密密钥) | 自定义 | 记录好,需要配置到SDK后台渠道配置中 |
消息加密方式 | 安全模式 | 微信返回的消息会进行加密 |
数据格式 | JSON | 微信返回的消息格式为JSON格式 |
4、 跳转到客服窗口后, 会给玩家发送充值小卡片, 玩家点击时,使用的是微信公众号支付方式(JSAPI)进行支付。 所以需要在微信商户平台开通 JSPAI支付 权限,并在其支付授权目录中添加SDK服务的访问URL;
5、 为了支持微信公众号支付方式,需要将JSAPI支付中关联到微信公众号(必须是企业服务号),在JSAPI支付-》AppID账号管理中, 关联服务号的AppID;
6、 微信服务号控制台-》设置与开发-》账号设置-》功能设置中, 在JS接口安全域名和网页授权域名中,都添加上SDK服务的访问URL;添加界面中,将MP_verify开头的文件,放在Web服务能访问到的服务器上,并进行配置。 比如Nginx配置:
java
server{
listen 80;
server_name uniapi.u8sdk.com; #绑定域名
index index.htm index.html index.php; #默认文件
location /MP_verify_GGdU0Ek9aCHWv457.txt {
root /www/mp_verify;
}
location / {
root html;
#默认都代理到web_app对应的U8Server上
proxy_pass http://u8sdk_server;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header Host $host;
proxy_set_header X-Forward-For $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
client_max_body_size 100m;
}
}