本文主要介绍星云开放平台“微信小游戏SDK”封装的微信小游戏登录、支付、客服以及游戏礼包服务的业务表现及对接要点。
使用前提
- 登录星云开放平台 → 游戏中心 → 选择游戏 → 对接中心 → 渠道打包 → 渠道配置,添加微信小游戏渠道,完成星云渠道参数配置。
- 而后“下载配置文件”,根据 微信小游戏SDK对接文档 完成对接。
- 同时,您还需根据“微信配置信息”或 微信小游戏渠道配置指引 完成微信公众平台的参数配置。
- 至此,即可使用微信小游戏的登录、支付、客服、礼包服务。
登录服务
使用微信静默授权登录,即无需玩家输入账号密码或同意授权、直接进入游戏。
支付服务
概述
- 星云封装的微信小游戏支付服务,包含移动端、PC端多端支付能力,支持Android/iOS、Windows/Mac 不同操作系统的差异化配置;可通过 对接中心 → 渠道打包 → 渠道配置 → 微信小游戏渠道参数配置 自助开关或切换支付模式,提交后将即时生效。
- 面向移动端的Android设备,一般使用“微信内购”模式;面向移动端的iOS设备,一般使用“唤起客服支付”模式;面向PC端的Windows设备,一般使用“微信内购”模式,面向PC端的Mac设备,一般使用“扫码支付”模式。
微信内购流程
Android 移动端设备
- 支付流程
Windows PC端设备
- 支付流程
- 扫码支付效果演示
唤起客服支付流程
- 支付流程
- 视频演示
- 特殊说明
- 若开启微信小程序客服中的“在官方客服工作台收发消息”,会导致唤起客服支付流程中的点击指引卡片回复充值链接的功能不可用。
- 48h内首次进入此小游戏客服会话或48h内玩家首发言后已推送5次消息,将无法自动推送支付链接,需玩家点击卡片后获取。
- 非上述情况且订单未失效时,进入此小游戏客服会话 或 在此小游戏客服会话输入关键词“cz”(大小写字母均适用)或“充值”或“支付”,将自动推送最新一笔未支付订单链接。
- 获取支付链接的卡片,其中的图片可于 对接中心 → 渠道打包 → 渠道配置 → 微信小游戏渠道参数配置 自定义配置。
- 若开启微信小程序客服中的“在官方客服工作台收发消息”,会导致唤起客服支付流程中的点击指引卡片回复充值链接的功能不可用。
扫码支付流程
- 支付流程
- 特殊说明:点击商品后新窗口打开付款码,付款二维码生成后2小时内有效,超时自动过期。
关闭支付
若于星云关闭支付,即渠道参数配置中对应终端支付模式(xxx_pay_mode)选0,则玩家选中商品准备支付时,将出现提示无法支付。
客服服务
- 若需正常使用上文提及的“唤起客服支付流程”,请关闭 微信公众后台 → 功能 → 客服 → 小程序客服 → 在官方客服工作台收发消息 。
- 游戏若内置客服入口,请调用微信接口打开微信客服会话,详见 微信小游戏客服消息API 。
- 玩家若于微信客服会话中发送“cz”或“充值”关键词,将自动推送最新一笔未支付订单链接;
发送其余关键词、或无待支付订单时发送充值等关键词,均将自动推送星云客服链接。
- 星云客服链接说明
- 点击星云客服链接,可查看于星云工单系统维护的常见问题、提问表单及服务记录,详见 星云客服中心介绍 。
- 当前星云客服链接将在微信小游戏渠道创建时默认生成并接入、以实现关键词自动回复星云客服链接功能,无需研发额外对接。
游戏礼包服务
前言
- 本文所述的游戏礼包服务,特指作用于微信生态中的 游戏圈、发现-游戏-福利中心 等场景的微信公众平台“游戏礼包”开放能力,详见 微信小游戏礼包。
- 另外,星云开放平台有独立提供面向游戏全渠道的 通用礼包码管理 及 邮件管理 等功能,若需使用可前往查看: 星云礼包码管理、星云邮件管理。
礼包配置及推送说明
- 游戏礼包服务,默认使用 星云开放平台 → 对接中心 → GM接口管理 → 预置接口 的 “获取角色信息”及“发送角色邮件”接口进行礼包奖励推送;故请先确保此二者已配置上线;详见预置接口对接文档。
- 当同游戏账号存在多角色时,可于 星云开放平台 → 对接中心 → 渠道打包 → 渠道配置管理 → 微信小游戏渠道参数配置 选择角色发送模式。
- 推送礼包奖励的邮件,可于 星云开放平台 → 对接中心 → 渠道打包 → 渠道配置管理 → 微信小游戏渠道参数配置 自定义 邮件标题、发件人、邮件内容。
- 关于游戏礼包配置,需于 微信公众平台 → 功能 → 游戏运营工具箱 → 游戏礼包道具,进行“道具配置”及“礼包配置”并完成发布;请注意,此处配置的道具ID,需确保与 星云开放平台 → 对接中心 → GM接口管理 → 预置接口 中“发送角色邮件”接口的“prop_list”参数枚举值对应的道具ID保持一致。
领取演示
注:是否符合领取条件由星云及微信判断并提示,而游戏内的邮件提示、邮件列表及详情展示需研发处理。