浏览器消息与输入¶
WebSocket升级前先等待内部ready信号;该ready被handler消费,不是客户端必收的第一事件。frame先发文本元数据,再发原始图像二进制。非frame事件作为文本转发。客户端须保持帧与图像配对;不要把下一条任意事件当图像。
客户端消息 |
关键字段 |
规则 |
|---|---|---|
ack |
type、seq |
seq为已处理帧的正序号。 |
release |
type |
发送释放信号;不能仅凭连接断开推断任务已恢复或浏览器已停止。 |
input_mouse |
eventType、x/y、button等 |
仅mousePressed/mouseReleased/mouseMoved/mouseWheel。 |
input_keyboard |
eventType、key/code/text等 |
仅keyDown/keyUp/char。 |
键鼠公共字段还包括clickCount、deltaX/deltaY、modifiers和windowsVirtualKeyCode;输入对象按服务端类型处理。文本最多4096字节,key/code最多64字节,modifiers为0至15,虚拟键码0至255。鼠标button为空或left/right/middle,clickCount为0至3,坐标非负,数值需有限且绝对值不超过100000。
传入消息只允许文本帧,最多16384字节;解压后同样限长。沙箱输入decoder拒绝未知结构字段及尾随JSON,不能将它当任意JavaScript/CDP/导航接口。输出scanner有4MiB单行限制,该限制不同于客户端输入上限。
当前handler连接最多10分钟,15秒ping、45秒读超时,约每30秒重新绑定当前访问并验证浏览器。期限与网络失败不能当业务取消。压缩是无损传输协商,帧的解码图像字节保持,不承诺固定帧率或压缩比例。
关闭查看连接不等于结束原浏览器。令牌取得与状态检查不创建替代沙箱、不启动浏览器。浏览器未运行与原环境已结束分别为409/BROWSER_NOT_RUNNING和410/BROWSER_SESSION_ENDED;恢复需要原任务与真实环境状态。