bricks/dist/docs/en/webspeech.md
yumoqing 2e22085122 feat: 401后登录成功自动重试原始请求
- withLoginInfo 改为接收完整 opts(含 method/headers/params)
- 等待 login_window 的 destroy 事件(=登录成功信号)
- 登录成功后重试原始请求
- 重试仍401则返回null(避免死循环)
- 用户手动关闭登录窗口时也触发重试,401则返回null
2026-05-27 15:39:34 +08:00

40 lines
1.8 KiB
Markdown

# WebTTS
**Widget Functionality**: Implements browser-based Text-to-Speech (TTS) functionality, supporting multiple languages, pitch, and speech rate settings, along with event callbacks during the speech synthesis process.
**Type**: Container widget
**Parent Widget**: bricks.VBox
## Initialization Parameters
- `opts`: Inherits initialization parameters from `bricks.VBox`, used to configure layout and basic properties.
- Supports all common configuration options of a VBox container (such as styles, child widgets, etc.).
## Main Events
No custom events are triggered; however, the following speech synthesis events are internally used for status monitoring:
- `onstart`: Logs a message when speech synthesis begins.
- `onend`: Logs a message when speech synthesis ends.
- `onerror`: Outputs error information if speech synthesis fails.
> Note: This widget performs speech playback by calling the `speak(text)` method and does not rely on external event binding mechanisms to trigger UI changes.
---
# WebASR
**Widget Functionality**: Implements browser-based Speech Recognition functionality, converting user's spoken input into text content and dispatching recognition results via events.
**Type**: Container widget
**Parent Widget**: bricks.VBox
## Initialization Parameters
- `opts`: Inherits initialization parameters from `bricks.VBox`, used to configure layout and basic properties.
- Supports all common configuration options of a VBox container.
## Main Events
- `asr_result`: Triggered when speech recognition successfully returns a result, carrying the recognized text content.
- Data format: `{ content: string }`
- Example: `{ content: "Hello World" }`
> Note: Requires browser support for the `SpeechRecognition` API; otherwise, a "not supported" message will be logged.