小程序小游戏行为服务-阿里云帮助中心

支持小游戏关键游戏行为的进度上报。消息统一通过 gameMessage 通道发送，其中外层 action 用于事件路由，payload 用于携带具体行为标识及当前累计值。

上报 API

my.call('gameMessage', {
  data: {
    action: 'action_task_report', //行为任务上报固定为 action_task_report
    payload: {
      actionTaskEvent: 'catch_pigs', //行为任务标识
      value: 10 //当前累计行为量
    }
  }
});

数据字段说明

字段名	中文名称	说明
`action`	消息路由类型	行为任务上报时，`action` 固定为 `action_task_report`，用于通道路由。
`payload`	上报数据	需直接传入 JSON 对象，不要使用 `JSON.stringify`。
`payload.actionTaskEvent`	行为任务标识	该字段用于唯一标识具体行为，需与平台协商约定，并与任务配置保持一致。
`payload.value`	当前累计值	该字段表示当前统计周期内该行为的累计值，取值必须为非负整数，且不得超过安全整数范围。

说明

外层 action 固定为 action_task_report，仅用于通道路由，不用于表达具体游戏行为。
接入前需与平台确认 actionTaskEvent 的具体行为定义、触发时机以及累计统计口径。
payload.value 表示当前累计值，而非本次增量。例如累计完成 3 次时，应依次上报 1、2、3。
平台将忽略 actionTaskEvent 不匹配、取值非法、重复上报或累计值回退的数据；跨会话累计状态由 CP 侧维护，并始终上报最新累计值。