47 lines
1.7 KiB
Markdown
47 lines
1.7 KiB
Markdown
```markdown
|
||
# WebSocket
|
||
|
||
控件功能：用于建立与后端的 WebSocket 连接，支持发送和接收文本、Base64 编码的音视频数据，并提供多种事件回调。
|
||
类型：普通控件
|
||
父类控件：bricks.VBox
|
||
|
||
## 初始化参数
|
||
|
||
| 参数名 | 类型 | 说明 |
|
||
|--------------|--------|------|
|
||
| ws_url | string | WebSocket 服务器的连接地址（如 `ws://example.com/socket`） |
|
||
| with_session | boolean | 是否携带当前会话信息；若为 `true`，则从 `bricks.app.get_session()` 获取 session 并传入 WebSocket 构造函数（注：源码中拼写错误 `sessopn` 应为 `session`） |
|
||
|
||
> 示例：
|
||
> ```js
|
||
> new bricks.WebSocket({
|
||
> ws_url: "ws://localhost:8080/ws",
|
||
> with_session: true
|
||
> });
|
||
> ```
|
||
|
||
## 主要事件
|
||
|
||
| 事件名 | 触发时机 |
|
||
|------------------|--------|
|
||
| onopen | WebSocket 连接成功打开时触发 |
|
||
| onmessage | 收到服务器发送的消息时触发（原始消息） |
|
||
| onerror | WebSocket 发生错误时触发 |
|
||
| onclose | WebSocket 连接关闭时触发 |
|
||
| ontext | 收到类型为 `text` 的消息时触发（由 `on_message` 解析后派发） |
|
||
| onbase64audio | 收到类型为 `base64audio` 的消息时触发 |
|
||
| onbase64video | 收到类型为 `base64video` 的消息时触发 |
|
||
|
||
> 其他自定义类型可通过 `ontypedata` 方式动态派发，格式为 `on + type`。
|
||
|
||
### 事件数据说明
|
||
|
||
- 所有通过 `onmessage` 解析并派发的事件数据均来自 JSON 格式的 `e.data`，结构如下：
|
||
```json
|
||
{
|
||
"type": "text",
|
||
"data": "Hello"
|
||
}
|
||
```
|
||
控件根据 `type` 字段自动派发对应的事件（如 `ontext`），并将 `data` 作为参数传递给事件处理器。
|
||
``` |