# 创建 LiveView RFB WebSocket 流 - CreateLivestreamStream #### 功能介绍 该接口通过 WebSocket 协议透传 RFB（Remote Framebuffer）二进制帧， 提供浏览器桌面的实时视频流，并支持键鼠输入（人工接管模式）。 **协议：** RFB over WebSocket（二进制帧） **模式说明：** - 当 automation_stream_status 为 enabled 时，LiveView 为纯观看通道， - 当 automation_stream_status 为 disabled（人工接管）时， 客户端发送的输入帧被服务端静默丢弃，不影响 automation/invoke 执行。 客户端输入帧被转发到 VNC 服务，人工可直接操作浏览器。 **关闭码说明：** - 1000：正常关闭 - 1008：Session ID 不匹配 - 1011：VNC 服务连接失败或超时 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-agentarts/agentarts_07_0003.html)。 #### 授权信息 当前API调用无需身份策略权限。 #### URI GET https://agentarts.com/v1/browsers/{browser_name}/livestream 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | browser_name | 是 | String | **参数解释：** 与会话关联的浏览器工具的唯一标识符。 浏览器工具名称获取方式： 1. 进入 AgentArts 平台，在左侧导航栏选择"组件库 \> 沙箱工具"。 2. 在浏览器工具列表中"浏览器工具名称/ID"处获取名称。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 | #### 请求参数 表2请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | Authorization | 是 | String | **参数解释**： 本次智能体工具调用对应的身份认证凭据。需要根据实际的智能体工具的入站身份认证方式获取对应的身份认证凭据。 API Key认证、IAM认证及OAuth 2.0认证具体请参见[认证鉴权](https://support.huaweicloud.com/api-agentarts/agentarts_07_0005.html)。 **约束限制**： 不涉及。 **取值范围**： 1-4096个字符，由字母、数字及特殊字符组成。 **默认取值**： 不涉及。 | | X-Hw-Agentarts-Browser-Session-Id | 是 | String | **参数解释：** 要使用的浏览器会话的唯一标识符。 **约束限制：** 必须是通过 StartBrowserSession 创建的活跃会话。如果会话已过期或已停止，请求将失败。 **取值范围：** 符合正则：\^\[a-zA-Z0-9_-\]+$。 **默认取值：** 不涉及。 | | Upgrade | 是 | String | **参数解释**： 固定为 websocket，表示从 HTTP 协议升级为 WebSocket 协议。 **约束限制**： 不涉及。 **取值范围**： websocket。 **默认取值**： 不涉及。 | | Connection | 是 | String | **参数解释**： 固定为 Upgrade，表示客户端请求升级连接协议。 **约束限制**： 不涉及。 **取值范围**： Upgrade。 **默认取值**： 不涉及。 | | Sec-Websocket-Key | 是 | String | **参数解释**： 随机 Base64 字符串（24 字符），用于生成 Sec-WebSocket-Accept 响应头。 **约束限制**： 不涉及。 **取值范围**： 24个字符的Base64字符串。 **默认取值**： 不涉及。 | | Sec-Websocket-Version | 是 | String | **参数解释**： WebSocket 协议版本，固定传 13（RFC 6455 规定的当前版本号）。 **约束限制**： 不涉及。 **取值范围**： 13。 **默认取值**： 不涉及。 | #### 响应参数 **状态码：101** 表3响应Header参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | Upgrade | String | **参数解释**： 固定为 websocket，表示从 HTTP 协议升级为 WebSocket 协议。 **约束限制**： 不涉及。 **取值范围**： websocket。 **默认取值**： 不涉及。 | | Connection | String | **参数解释**： 固定为 Upgrade，表示客户端请求升级连接协议。 **约束限制**： 不涉及。 **取值范围**： Upgrade。 **默认取值**： 不涉及。 | | Sec-WebSocket-Accept | String | **参数解释**： 由服务端基于Sec-WebSocket-Key计算并返回。 **约束限制**： 不涉及。 **取值范围**： 不涉及。 **默认取值**： 不涉及。 | **状态码：200** 无 #### 请求示例 无 #### 响应示例 无 #### 状态码 | 状态码 | 描述 | |:---|:---| | 101 | Switching Protocols ------ 连接升级成功，开始双向 RFB 二进制帧透传。 | | 200 | WebSocket 消息帧 ------ 升级后的双向 RFB 二进制数据帧。 每帧为 RFB 协议原始二进制数据（帧缓冲更新、鼠标键盘事件等），详见 RFC 6143。 | | 401 | 认证失败 | | 403 | 权限不足 | | 404 | 资源不存在 | | 500 | 内部系统错误 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-agentarts/ErrorCode.html)。