ACP消息格式

主要的消息收发角色

• Agent
• AP
• 心跳服务
• 会话服务
• 存储服务
• 流式服务
• 证书服务

消息发送链路

• Agent->AP，心跳，会话，存储，流式
• AP->响应Agent，浏览器
• 心跳->响应会话服务，响应Agent
• 会话->主动和响应Agent，心跳
• 存储->响应Agent
• 流式->响应Agent

消息格式定义

Agent与AP之间的所有消息均使用https传输，json格式。

Agent发送给AP的消息定义

{
  "agent_id": "xxx.yyy.zzz",
  "signature": "xxxxxxxxxx",
  ...
}

AP响应Agent的消息定义

{
  "code": 200,
  "message": "OK",
  ...
}

错误代码定义

2XX
    200    成功处理消息，直接回复了数据
    201    回复了一个流式输出端口，数据需要从端口中获取或者推送
    202    已经开始处理，需要等待后续的消息
4XX
    401    请求者AID不在授权范围内
    403    问题超出服务范围
5XX
    503    当前请求超过服务能力

Agent与消息服务之间的通信

WSS传输的二进制格式：

MessageHeader  消息头
MessageBody    消息体

MessageHeader 定义

字段	说明	字节数
MagicNumber	MU	2字节
Version	版本号	2字节
Flags	标志位	4字节
MsgType	消息类型	2字节
MsgSeq	消息序列号	4字节
ContentType	内容类型	1字节
EncodedFlag	编码标志	1字节
Reserved	保留	4字节
CRC32	消息负载CRC32	4字节
PayloadLength	消息负载长度	4字节

ContentType 定义

值	说明
0	普通文本
1	json文本
2	audio data
3	video data
4	image

EncodedFlag 定义

位定义（7 6 5 4 3 2 1 0）：

• 第0位：压缩标志
• 第1位：加密标志

值	说明
0	原始内容
1	zip压缩
2	加密
3	zip压缩+加密