文章目录
- 本文主要介绍星云开放平台“微信小游戏SDK”封装的微信小游戏登录、支付、客服服务,以及游戏礼包、腾讯问卷、转发、订阅消息、广告、游戏圈等微信生态拓展能力的业务表现及对接要点。
- 微信小游戏支撑服务,
仅面向“内部版”企业开放。
使用前提
- 登录星云开放平台 → 游戏中心 → 选择游戏 → 对接中心 → 渠道打包 → 渠道配置,添加微信小游戏渠道,完成星云渠道参数配置。
- 而后“下载配置文件”,根据 微信小游戏SDK对接文档 、 微信小游戏服务端对接文档 完成所需接口对接。
- 同时,您还需根据“微信配置信息”或 微信小游戏渠道配置指引 完成微信公众平台的参数配置。
- 至此,即可使用微信小游戏SDK提供的登录、支付、客服服务及其余拓展能力。
登录服务
- 星云封装的登录服务,使用的是微信静默授权登录,即无需玩家输入账号密码或同意授权、直接进入游戏。
- 另外,星云实现了国内官方渠道与微信小游戏在同一个应用下的账号互通:玩家于微信小游戏、官方Apple渠道、官方Android渠道、官方Android微端渠道等不同端使用同一微信进行账号登录,将关联相同的微信UnionID,基于此星云提供相同的账号标识(聚合OpenID)以实现账号互通;针对同一聚合OpenID的操作(如封禁等),不同端将同步生效。
具体说明详见 官方渠道与微信小游戏渠道互通介绍、小游戏与官方账号互通/隔离最佳实践方案。 - 若需使用登录服务,需完成微信小游戏SDK的
“登录”接口
对接。
支付服务
前言
- 星云封装的微信小游戏支付服务,对接的是微信小游戏的直购模式,包含移动端、PC端多端支付能力,支持Android/iOS、Windows/Mac 不同操作系统的差异化配置;可通过 对接中心 → 渠道打包 → 渠道配置 → 微信小游戏渠道参数配置 自助开关或切换支付模式,提交后将即时生效。
- 面向移动端的Android设备,一般使用“微信内购”模式;面向移动端的iOS设备,一般使用“唤起客服支付”模式;面向PC端的Windows设备,一般使用“微信内购”模式,面向PC端的Mac设备,一般使用“扫码支付”模式。
- 若需使用支付服务,需完成微信小游戏SDK的
“支付”接口
对接。
微信内购流程
Android 移动端设备
- 支付流程
Windows PC端设备
- 支付流程
- 扫码支付效果演示
唤起客服支付流程
- 支付流程
- 视频演示
- 特殊说明
- 若开启微信小程序客服中的“在官方客服工作台收发消息”,会导致唤起客服支付流程中的点击指引卡片回复充值链接的功能不可用。
- 订单未失效时,进入此小游戏客服会话 或 在此小游戏客服会话输入关键词“cz”(大小写字母均适用)或“充值”或“支付”,将自动推送最新一笔未支付订单链接。
- 订单支付成功后,同聚合OpenID同商品的历史未支付订单将自动失效。
- 获取支付链接的卡片,其中的图片可于 对接中心 → 渠道打包 → 渠道配置 → 微信小游戏渠道参数配置 自定义配置。
- 若开启微信小程序客服中的“在官方客服工作台收发消息”,会导致唤起客服支付流程中的点击指引卡片回复充值链接的功能不可用。
扫码支付流程
PC端设备
- 支付流程
- 特殊说明:点击商品后将新窗口打开付款码,付款二维码生成后2小时内有效,超时自动过期。
移动端设备
- 支付流程
- 特殊说明:点击商品后将当前页打开付款码,需玩家手动保存图片,并使用微信“扫一扫”识别后支付。支付完成后,需玩家手动返回小游戏。
关闭支付
- 若于星云关闭支付,即渠道参数配置中对应终端支付模式(xxx_pay_mode)选0,则玩家选中商品准备支付时,将出现提示无法支付。
- 不同端的关闭支付提示,支持差异化设置;若需使用此功能,需完成
V3.3.60及以上版本
的微信小游戏SDK对接。
其他
微信公众平台的虚拟支付道具配置,可参考 微信小游戏道具配置 。
客服服务
前言
- 若需正常使用上文提及的“唤起客服支付流程”,请关闭 微信公众后台 → 功能 → 客服 → 小程序客服 → 在官方客服工作台收发消息 。
- 游戏若内置客服入口,预期点击打开微信客服会话,请调用
V3.3.64及以上版本
的微信小游戏SDK的“打开客服会话”接口
。 - 星云封装的客服服务,覆盖微信客服会话中的星云客服链接推送,及客服链接点击后的C端客服中心&B端客服工单系统的客服通道闭环管理。
客服功能介绍及演示
- 客服会话消息推送说明
- 玩家若于微信客服会话中发送“cz”或“充值”关键词,将自动推送最新一笔未支付订单链接.
- 玩家若发送其余关键词、或无待支付订单时发送充值等关键词,均将自动推送星云客服链接。
- 星云客服链接说明
- 点击星云客服链接,可查看于星云工单系统维护的常见问题、提问表单及服务记录,详见 星云客服中心介绍 。
- 当前星云客服链接将在微信小游戏渠道创建时默认生成并接入、以实现关键词自动回复星云客服链接功能,无需研发额外对接。
游戏礼包服务
前言
- 星云封装的游戏礼包服务,特指作用于微信生态中的 游戏圈、发现-游戏-福利中心 等场景的微信公众平台“游戏礼包”开放能力,详见 微信小游戏礼包。
- 另外,星云开放平台有独立提供面向游戏全渠道的 通用礼包码管理 及 邮件管理 等功能,若需使用可前往查看: 星云礼包码管理、星云邮件管理。
礼包配置及推送说明
- 游戏礼包服务,默认使用 星云开放平台 → 对接中心 → GM接口管理 → 预置接口 的
“获取角色信息”及“发送角色邮件”接口
进行礼包奖励推送;故请先确保此二者已配置上线;详见预置接口对接文档。 - 当同游戏账号存在多角色时,可于 星云开放平台 → 对接中心 → 渠道打包 → 渠道配置管理 → 微信小游戏渠道参数配置 选择角色发送模式;默认“发送最近登录角色”。
- 推送礼包奖励的邮件,可于 星云开放平台 → 对接中心 → 渠道打包 → 渠道配置管理 → 微信小游戏渠道参数配置 自定义 邮件标题、发件人、邮件内容。
- 关于游戏礼包配置,需于 微信公众平台 → 功能 → 运营功能管理 → 游戏礼包道具,进行“道具配置”及“礼包配置”并完成发布;请注意,此处配置的道具ID,需确保与 星云开放平台 → 对接中心 → GM接口管理 → 预置接口 中“发送角色邮件”接口的“prop_list”参数枚举值对应的道具ID保持一致。
领取演示
注:是否符合领取条件由星云及微信判断并提示,而游戏内的邮件提示、邮件列表及详情展示需研发处理。
腾讯问卷服务
前言
- 星云封装的腾讯问卷服务,支持设置腾讯问卷于游戏内的展示逻辑:可配置发送游戏服,实现不同游戏服展示不同问卷;可配置有效时间,实现不同问卷不同时间展示。
玩家于游戏内点击问卷入口可跳转填写问卷,问卷提交后可返回微信小游戏。 - 若需使用腾讯问卷服务,需完成
V3.3.62及以上版本
的微信小游戏SDK的“问卷”接口
对接。
问卷配置
一个腾讯问卷从设置问卷内容到玩家于游戏内可见可填写,需进行腾讯问卷后台配置、星云GM系统“腾讯问卷”配置、游戏研发处理等多方操作才可达成;操作说明详见 GM腾讯问卷使用手册 。
问卷演示
转发服务
前言
- 星云封装的转发服务,支持针对不同场景设置不同转发卡片内容,分享给微信用户或群聊。
- 若需于小游戏右上角“…”使用转发服务,需完成
V3.3.62及以上版本
的微信小游戏SDK的“显示被动转发按钮”、“绑定被动转发事件”接口
对接;
若需于小游戏内自定义转发入口使用转发服务,需完成V3.3.62及以上版本
的微信小游戏SDK的“主动转发”接口
对接。
转发卡片配置
- 若转发内容为固定图文,需结合星云GM系统“微信转发”配置及游戏研发处理;操作说明详见 GM微信转发使用手册 。
- 若需根据游戏场景动态生成转发内容,则需调用主动或被动转发接口中的“自定义参数”方法,由游戏研发处理触发场景及转发入口,无需于GM系统操作。
转发演示
订阅消息服务
前言
- 星云封装的订阅消息服务,目前仅覆盖微信小游戏的“一次性订阅消息”。玩家在游戏中订阅指定的消息内容,游戏开发者可在对应游戏场景向玩家下发一条模版消息。
- 若需使用订阅消息服务,需完成
V3.3.62及以上版本
的微信小游戏SDK的“订阅消息”接口
对接。
消息配置
需于 微信公众平台 → 功能 → 订阅消息 完成“我的模板”添加,而后通知游戏研发处理消息触发时机及具体消息内容。
订阅及推送演示
广告服务
前言
- 星云封装的广告服务,覆盖微信小游戏支持的“Banner广告”、“激励视频广告”、“插屏广告”、“原生模板广告”全部形态。游戏内提供广告展示位,玩家通过观看广告获得游戏奖励,以实现流量变现。
- 若需使用广告服务,需完成
V3.3.62及以上版本
的微信小游戏SDK的“创建Banner/激励视频/插屏/原生模版广告”接口
对接。
广告配置
需于 微信公众平台 → 推广 → 流量主 → 广告管理 完成广告位等信息配置,而后通知游戏研发处理游戏内广告展示位、微信广告位&游戏内展示位的映射关系、广告观看任务设计及奖励发放等
广告演示
游戏圈跳转服务
前言
- 星云封装的游戏圈跳转服务,实现的是游戏内跳转微信游戏圈,且默认跳转至游戏圈首页。
- 若需使用游戏圈跳转服务,需完成
V3.3.62及以上版本
的微信小游戏SDK的“游戏圈”接口
对接。
游戏圈演示
内容风控
- 星云封装的内容风控服务,对接微信内容安全接口2.0,能够识别游戏领域常见的文本违规内容,帮助构建健康的游戏环境。
- 内容风控服务,应在服务端调用;若需使用,需完成星云的
微信小游戏文本内容安全识别接口
对接。