# ext2-ul-TTS-Live

**Repository Path**: mind-plus/ext2-ul-tts-live

## Basic Information

- **Project Name**: ext2-ul-TTS-Live
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-10-13
- **Last Updated**: 2026-10-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: MindPlus-Ext2

## README

# 离线语音合成

![cover](extension/public/cover.png)

`TTSLive` 是一个适用于 Mind+ V2 实时模式的扩展（使用宿主环境的 Web Speech API 与操作系统已安装的语音朗读文本，无需联网和外部程序）。
该扩展共提供 5 个积木，运行环境要求见下方“运行环境”。

## 源码仓库

V1 原始仓库：（与 V2 一同发布，发布后补充链接）

## 运行环境

- 无需外部桌面程序；依赖 Mind+ 运行环境提供的 Web Speech API。
- 朗读效果取决于操作系统安装的语音包；未找到中文语音时自动回退到第一个可用语音。

## 积木

| 类型 | 积木功能 |
|---|---|
| 命令 | 初始化语音合成 |
| 命令 | 设置音量 [VOLUME] |
| 命令 | 设置语速 [RATE] |
| 命令 | 朗读 [TEXT] |
| 命令 | 停止朗读 |

## 示例程序

1. 在 Mind+ V2 实时模式的扩展库中加载本扩展，点击扩展卡片启用分类。
2. 先用「初始化语音合成」加载可用语音列表，再用「设置音量」「设置语速」调整参数（音量 0–100，语速 0–100）。
3. 用「朗读 [TEXT]」朗读文本，需要中断时用「停止朗读」。

> 注意：以上步骤基于积木定义与 Web Speech API 行为整理，实际朗读效果取决于系统语音包。

## 本地构建

```bash
npm ci
npm run build
```

构建产物在 `build/ext-wyh-TTSLive@2.0.0/`，可在 Mind+ V2 开发者模式直接加载其中的 `config.json`。

## 更新日志

### V2.0.0

- 迁移到 Mind+ V2 实时模式，积木 opcode、参数与默认值与 V1 保持一致。
- 补充 `compatibilityId` 兼容字段，统一积木配色。

## 开发指南

更详细的 Mind+ V2 扩展开发说明请参考：[Mind+官方扩展开发文档](https://mindplus.dfrobot.com.cn/mp2/Extensions/)

## V1 原始库来源

本库迁移自 Mind+ V1（1.x）用户库，保留 `compatibilityId` 字段以兼容旧版工程。

- compatibilityId：`wyh-tts-live-thirdex`
- 原作者：wyh
- 原始仓库：https://gitee.com/mind-plus/ext-tts-live