事件消息推送 - 维亚开放平台

功能介绍

终端的某些操作与微亚服务器消息会在微亚服务器通过事件推送的形式通知到开发者在开发者中心处设置的服务器地址，从而开发者可以获取到该信息

开发者服务器接收到事件消息后需响应 httpstatus 为 200，否则将重复推送，最多推送10次

接入步骤

通过更新事件回调地址接口设定推送地址

url 参数必须是以 http 或 https 开头，可通过公网访问的地址

aesKey 参数长度固定32位，用于解密接受到的消息

验证接收到消息

微亚服务器将以json的格式向开发者推送如下信息：

{
  "id": "2c0224d2-0184-8d2d-4a05-3a0be5582ad7",
  "nonce": "AYvyNwIYe0RtUnuQVUYMf",
  "timeStamp": 1687170011,
  "ciphertext": "0jTOv5j72hCB2EF8LIXntw==",
  "signature": "546a1cceb14dbe3353b86f7cf9b2785b1e028c82"
}

参数	说明
id	消息Id，如果消息发送失败，会重试发送。可用于消息去重
nonce	随机字符
timeStamp	消息生成时间，utc
ciphertext	消息密文
signature	消息签名

签名验证步骤
1.通过 sha1(AesKey+timeStamp+nonce+ciphertext) 计算出 dev_signature
2.比较 dev_signature 与消息体中的 signature 一致则验证通过，否则验证不通过

消息解密

C# 解密代码示例

Java 解密代码示例

依据消息内容实现业务

密文内容 ciphertext 通过解密后，将得到如下消息体

{
   eventType = 20001
}

事件列表

30003 游戏对局结束

{
   eventType: 30002,
   gameBattle: {}
}

gameBattle 说明

标题

字段	类型	说明
id	string	推送记录Id

提示

如果在游戏对局中途（游戏启动时、游戏进行中）被退出，可能不会推送30003 游戏对局结束事件。可参考如下实现方式：

实现游戏排行可监听30003 游戏对局结束，并查询游戏对局成绩

查询游戏成绩

可通过游戏结束事件消息中的 id 调用各游戏 api 查询游戏对局成绩
无限之战：查询无限之战游戏成绩

接收事件消息推送

功能介绍#

接入步骤#

验证接收到消息#

消息解密#

依据消息内容实现业务#

事件列表#

30003 游戏对局结束#

查询游戏成绩#