• 
• 开发者中心
• >
• 云游戏
• >
• OpenAPI文档
• >
• 游戏服务端回调

文档版本：20220218-100

变更历史：

1 简介

本文阅读对象：接入方集成海马云游戏服务系统涉及的开发、测试及运维等相关人员，以下统一称为“接入方”。

海马云游戏服务在游戏开始、游戏切换分辨率、游戏结束时，会通过回调接口将相关信息主动通知给接入方。在本接口中，海马云游戏服务为主动发起方，接入方为被动接收方，报文采用明文方式进行传输。若需使用本接口，接入方需：

• 提前准备一个能接受post请求的服务接口。
• 将服务的URL地址提供给海马云游戏。
• 保证所提供服务的可用性、稳定性和约定的服务能力。

⚠注意：
接入方收到海马云回调通知报文后，应先进行日志记录，再根据自身业务需要对报文做相应的处理。

2 云游戏服务端回调接口

2.1 请求信息

表2-1 请求消息头

表2-2 请求信息参数

表2-3 StreamingStarted：游戏开始事件

表2-4 StreamingStopped：游戏结束事件

表2-5 StreamingResolutionChanged：游戏切换分辨率事件

表2-6 stopCode & stopMessage说明

StreamingStarted报文示例：

{
  "bid": "455r66e7e3", 
  "cid": "5641105047", 
  "clientType": "2", 
  "event": {
    "timestamp": 1575648241051
  }, 
  "ip": "11.11.11.11", 
  "pkgName": "com.xx.yy.zz", 
  "pkgVersion": "16.0.37060", 
  "protoData": "eyJhZGRyZXNzIjoiIiwiYXBwVHlwZSI6IjEiLCJicmFuZCI6Ikxlbm92
  byIsImNhcnJpZXIiOiIiLCJjaGFubmVsSWQiOiI0MDI1Nzc0MzE1MyIsImNpdHkiOiIiLC
  JjbGllbnRJcCI6IjE5sdfMi4xNjguMS4zIiwiZGV2aWNlSWQiOiJiNmVkOWE3NDZjODMyN
  GRjIiwiZ2FtZUsdflkIjoiNjAwMDA0MTk0IiwiZ2FtZVNlc3Npb25JZCI6IjE1NzU2NDgy
  MzE1MjE1NmRlODVlOC02M2ZmLTQxYjMtYjg5ZC00ODlhNWRmNTM0MGMiLCJnYW1lVHlwZS
  I6IjEiLCJpbWVpIjoiMDAwMDAwMDAwMDAwIiwibW9kZWwiOiJMZW5vdm8gVEItODgwNEYi
  LCJuZXR3bsdf3JrIjoiNCIsInBob25lIjoiIiwicmVhbEFwcFZlcnNpb24iOiIxLjEwLjE
  uMSIsInJlc2U1IjoiMCIsInJlc2U2IjoiLTEiLCJyZXNlNyI6IjE1NzU2NDgyMzE1MjE1N
  mRlODVlOC02M2ZmLTQxYjMtYjg5ZC00ODlhNWRmNTM0MGMiLCJzY3JlZW4iOiIxOTIwKjE
  xMDQiLCJzeXN0ZW1WZXJzaW9uIjoiNy4xLjEiLCJ1aWQiOiIiLCJ1c2VySWRUeXBlIjoiM
  CIsInZlcnNpb24iOiIxLjAuMS4zIn0=", 
  "type": "StreamingStarted"
}

StreamingStopped报文示例：

{
  "bid": "1e2153666c3", 
  "cid": "5435074621", 
  "clientType": "2", 
  "event": {
    "playInterval": 3821, 
    "timestamp": 1575648094342, 
    "stopCode": "0000", 
    "stopMessage": "用户正常退出"
  }, 
  "ip": "11.11.11.11", 
  "pkgName": "com.xx.yy.zz", 
  "pkgVersion": "1.1.62", 
  "protoData": "eyJhZGRyZXNzIjoiIiwiYXBwVHlwZSI6IjEiLCJicmFuZCI6IkhPTk9S
  IiwiY2FycmllciI6IuS4reWbveenu+WKqCIsImNoYW5uZWxJZCI6IjQwsdfsMjk2NTM0Nj
  gxIiwiY2l0eSI6IiIsImNsaWVudElwIjoiMTkyLjE2OC4wLjEwNCIsImRldmljZUlkIjoi
  NGVlMDQ5NTk4YWYxMWVkYSIsImdhbWVJZCI6IjUwMDAwMDAzNSIsImdhbWVTZXNzaW9uSW
  QiOiIxNTc1NjQ0MjYzMjg5NjM4MmNmMDgtYzZhOS00MjI4LWI2MmYtZTA1YjlmYTBkYzZj
  IiwiZ2FtZVR5cGUiOiIxIiwiaW1laSI6Ijg2MTAxMjAzMzc0NjAxMCIsIm1vZGVsIjoiQ0
  FNLUFMMDAiLCJuZXR3asdfb3JrIjoiNCIsInBob25lIjoiMTM5NzIxNjY3NjEiLCJyZWFs
  QXBwVmVyc2lvbiI6IjEuMTEuMS4yIiwicmVzZTUiOiIwIiwicmVzZTYiOiIyOCIsInJlc2
  U3IjoiMTU3NTY0NDI2MzI4OTYzODJjZjA4LWM2YTktNDIyOC1iNjJmLWUwNWI5ZmEwZGM2
  YyIsInNjcmVlbiI6IjExOTYqNzIwIiwic3lzdGVtVmVyc2lvbiI6IjYuMCIsInVpZCI6Ij
  E3NzQ2MzAxNjc5NyIsInVzZXJJZFR5cGUiOiIwIiwidmVyc2lvbiI6IjEuMC4xLjQifQ==", 
  "type": "StreamingStopped"
}

StreamingResolutionChanged报文示例：

{
  "bid": "54136667ec3", 
  "cid": "985110081", 
  "clientType": "2", 
  "event": {
    "from": "3", 
    "result": true, 
    "to": "6"
  }, 
  "ip": "11.11.11.11", 
  "pkgName": "com.xx.yy.zz", 
  "pkgVersion": "1.1.6", 
  "protoData": "adefaGRyZXNzIjoiIiwiYXBwVHlwZSI6IjEiLCJicmFuZCI6InhpYW9t
  aSIsImNhcnJpZXIiOiLkuK3lm73np7vliqgiLCJjaGFubmVsSWQiOiI0MDI5NjUzNDY4NS
  IsImNpdHkiOiIiLCJjbGllbnRJcCI6ImZlODA6OmYwODE6MjdmZjpmZTBhOjgzNDUiLCJk
  ZXZpY2VJZCI6IjZlMjMyYjQxYzA2Yzc2NWMiLCJnYW1lSWQiOiI2MDAwMDE1ODUiLCJnYW
  1lU2Vzc2lvbklkIjoiMTU3NTY0OTM0MDIwOTI3MzUxYzBiLTQ3ZGQtNDQ0Yi1iM2FlLTYy
  ZmQ5OGY3NzhjYiIsImdhbWVUeXBlIjoiMSIsImltZWkiOiI4NjA5MjEwNDI3MjkxMDkiLC
  Jtb2RlbCI6IlJlZG1pIE5vdGUgNyBQcm8iLCJuZXR3b3JrIjoiMSIsInBob25lIjoiMTgz
  ODQyNTE2NjgiLsdfsWFsQXBwVmVyc2lvbiI6IjEuMTMuMS4yIiwicmVzZTUiOiIxIiwicm
  VzZTYiOiIyOCwxNyIsInJlc2U3IjoiMTU3NTY0OTM0MDIwOTI3MzUxYzBiLTQ3ZGQtNDQ0
  Yi1iM2FlLTYyZmQ5OGY3NzhjYiIsInNjcmVlbiI6IjIyNjEqMTA4MCIsInN5c3RlbVZlcn
  Npb24iOiI5IiwidWlkIjoiMjI1NjYzODYzMDU2IiwidXNlcklkVHlwZSI6IjAiLCJ2ZXJz
  aW9uIjoiMS4wLjEuNSJ9", 
  "type": "StreamingResolutionChanged"
}

2.2 响应信息

响应信息示例：

{
    "code": 0
}

表2-7 参数说明