
VoskLib
一个将VOSK移植到Minecraft的库模组
🎙️ VoskLib
VoskLib 是一个面向 Minecraft Forge 1.20.1 的高性能离线语音识别库。
✨ 特性
- 100% 离线: 识别无需 API 密钥或互联网连接。
- 双模式: 可在字面模式(词汇量大)和语法模式(受限列表)之间切换。
- 游戏内模型管理器: 直接从模组配置菜单下载和管理 Vosk 模型,内置进度条。
- 线程安全: 后台音频处理会自动与 Minecraft 主线程同步。
- 对开发者友好: 提供易于使用的事件,用于获取部分和最终语音结果。
🛠️ 用户安装指南
- 安装 Minecraft Forge 1.20.1。
- 将 jar 文件放入你的
mods文件夹。 - 下载模型:
- 打开游戏,进入 Mods -> VoskLib -> Config。
- 选择一个模型(小、中或大),然后点击 Download。
- VoskLib 会自动处理下载和解压。
⌨️ 按键绑定
- V(默认): 开启/关闭语音识别。
- 可在标准控制菜单的“Vosk Voice Library”分类中进行配置。
💻 开发者 API
要在你的项目中使用 VoskLib,请将其添加到你的 build.gradle,并开始监听事件。
1. 处理语音结果
VoskLib 会在 Forge 事件总线上触发事件。这些事件已在主线程上执行,因此你可以安全地与玩家或世界交互。
@SubscribeEvent
public void onVoiceResult(VoskVoiceEvent.Result event) {
String text = event.getResult().toLowerCase();
if (text.contains("fireball")) {
// 你的逻辑:在玩家面前召唤一个火球
}
}
@SubscribeEvent
public void onPartialSpeech(VoskVoiceEvent.Partial event) {
// 适用于实时 UI 字幕
String partial = event.getResult();
}
2. 控制状态
你可以通过以下方式请求 VoskLib 开始或停止监听:
String[] spells = {"ignite", "freeze", "thunder", "heal"};
VoskManager.createRecognition(spells); // 为语法模式创建识别(针对特定单词的高准确率)
VoskManager.createRecognition(); // 为字面模式创建识别(通用听写)
VoskManager.startListening(); // 开始监听
VoskManager.stopListening(); // 停止监听
📜 致谢
- Vosk API: 由 Alpha Cephei 开发。
- 模组作者: Infinity Two。
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。