连接任务浏览器流¶
通过WebSocket接收画面和事件,并按协议发送有界输入。它是浏览器交接协议,成功升级不是JSON查询结果。
GET https://api.moi.matrixorigin.cn/v5/workspaces/{workspace_id}/agent-runtime-tasks/{task_id}/browser/stream
调用前准备¶
先取得同一工作区/任务的未过期短期令牌。浏览器Origin须是同主机或部署明确允许的Origin;当前身份与角色会在接入及连接期间重新检查。
请求参数¶
const target = new URL(apiBaseUrl);
target.pathname = target.pathname.replace(/\/$/, '') + `/workspaces/${encodeURIComponent(workspaceId)}/agent-runtime-tasks/${encodeURIComponent(taskId)}/browser/stream`;
target.protocol = target.protocol === 'https:' ? 'wss:' : 'ws:';
target.search = '';
target.hash = '';
const socket = new WebSocket(target.toString(), ['moi-browser.v1', token]);
其余变量来自原任务及前一步令牌。此片段只展示握手;处理事件、画面和确认须继续按共享协议实现。
参数 |
类型 |
说明 |
|---|---|---|
|
string |
本人任务所属工作区。 |
|
string |
原运行任务ID。 |
|
HTTP header |
浏览器自动发送;缺少或不允许时拒绝。 |
|
string列表 |
同时提供moi-browser.v1和一个moi-browser-token-v1.开头的证明。 |
流式响应¶
HTTP/1.1 101 Switching Protocols
Sec-WebSocket-Protocol: moi-browser.v1
文本消息:{"type":"frame","seq":1,"metadata":{"deviceWidth":1280,"deviceHeight":720}}
下一条消息:原始图像二进制字节
字段或响应项 |
类型 |
说明 |
|---|---|---|
|
string |
已知事件包括frame、url、status、released。 |
|
integer |
服务端帧序号,用于ack。 |
|
JSON对象 |
帧元信息;示例包含尺寸,不宣称所有提供方字段已穷举。 |
图像消息 |
binary |
紧跟frame文本事件,不能当JSON内Base64读取。 |
连接复查 |
协议行为 |
当前实现周期重建访问上下文并复查;失败可发1008关闭。 |
错误响应¶
HTTP / code |
条件 |
|---|---|
400 / 2 |
浏览器参数无效。 |
401 / 6 |
身份证明无效,或流证明不匹配路径。 |
403 / 5 |
当前授权拒绝,或流的Origin/子协议不符合要求。 |
404 / 3 |
任务不可访问、非本人任务或缺少所需上下文。 |
409 / 15 |
现有浏览器未运行,details.reason=BROWSER_NOT_RUNNING。 |
410 / 3 |
原环境已结束或过期,details.reason=BROWSER_SESSION_ENDED。 |
503 / 15 |
浏览器运行依赖不可用,或任务状态不能使用。 |
500 / 1 |
其他内部失败。 |
101升级后不再返回普通HTTP JSON错误;周期复查失败可关闭连接,恢复见环境与错误。
产品认证阶段还可能使用字符串code/msg,不能将上表数字错误当作全部认证封套。