Skip to content

通知消息说明

葉修齊 edited this page Feb 6, 2024 · 2 revisions
  • MAA-LRC会对每个已设置启用且启用条件检查通过的任务的运行结果发送回调通知给服务端。
  • MAA-LRC目前不会对通知消息行为进行过滤(也就是想要让某些任务不发送结果通知),如何渲染、显示多少给用户都应当是服务端的工作。MAA-LRC只应当确保服务端能收到足够详尽的日志汇报。
  • MAA-LRC上报的消息是一条json格式文本,核心参数是消息类型(type)和消息文本(payload),其格式如下。

任务结果汇报

{
	"type": "normal_task_report",	//消息类型 可能值为:normal_task_report | interrupt_task_report
	"name": "日常配置",		//该任务所在的的配置名称
	"task": "活动关卡",		//上报的子任务的id,!!准备废弃!!,因为这个数据可以在下面的task_config里面获得
	"task_type": "Fight",		//上报的子任务类型,!!准备废弃!!,因为这个数据可以在下面的task_config里面获得
	"task_config": {		//任务自身的配置,服务端可以在下发时加入额外的信息实现echo效果
			"type": "Fight",
			"enable": true,
			"id": "活动关卡",
			"screenshot": "after",
			"params": {
					"expiring_medicine": 1000,
					"stage": "RS-5"
				}
			},

	"devices": "00E0F192A9D", 		//maa-gui-rc的协议里原本是MAA自动生成的设备标识符,我这里就简单设置为设备MAC地址
	"user": "",				//maa-gui-rc里为用户在MAA设置中填写的用户标识符,这里直接留空暂时不作处理

	"status": "SUCCESS", 			//运行结果,目前出错识别尚未完善,大多数时候都是SUCCESS,少数时候是FAILED
	"payload": "作战结果:\n  RS-5 * 1 \n战斗掉落:\n  驮兽盲盒 * 12\n  固源岩 * 2\n  龙门币 * 144",  
	"image": "iVBORw0KAABQAAA...",		//截图,如果有的话是图片的base64编码,没有的话就是空字符串""
	"duration": 300				//任务运行耗时,单位:秒
}

配置启动与结束通知

	{
			"type": "normal_config_notice", // 可能值为 normal_config_notice | interrupt_config_notice
			"status": "BEGIN", // 可能值为 BEGIN | END
			"payload": "2023-12-25 12:00:13\n开始运行配置:测试配置"
	}

更新日志

	{
			"type": "update_notice",
			"status": "UPDATED", // 可能值为 UPDATED(已更新,内核版本或者OTA文件发生变化) | LATEST(不需要更新)
			"payload": "一些更新日志"
	}

消息回执

	{
			"type": "receipt", //服务器下发的消息收到后的回执"receipt"
			"status": "SUCCESS",
			"payload": "MAA已收到一条一般任务配置,加入任务处理队列中逐个运行"
		}

其他日志通知

	{
			"payload": "日志内容",
			"type": "notice", //一些其他日志通知
		}