Whisper Unity 项目下载及安装教程

1. 项目介绍

Whisper Unity 是一个在 Unity3D 中运行语音转文本模型（Whisper.cpp）的项目。它提供了高性能的推理能力，使得 OpenAI 的 Whisper 自动语音识别（ASR）模型可以在本地机器上运行。该项目支持多种语言，并且可以在没有互联网连接的情况下运行。它还提供了不同大小的模型，以平衡速度和准确性。

2. 项目下载位置

要下载 Whisper Unity 项目，请访问项目的 GitHub 仓库。你可以通过以下步骤进行下载：

1. 打开命令行工具（如 Terminal 或 Command Prompt）。
2. 使用 git clone 命令克隆仓库：

   git clone https://github.com/Macoron/whisper.unity.git
   

3. 项目安装环境配置

3.1 系统要求

• 操作系统：Windows、MacOS、Linux、iOS、Android、WebGL
• Unity 版本：建议使用 Unity 2019.4 或更高版本
• 硬件要求：建议使用支持 CUDA 的 Nvidia GPU（可选）

3.2 环境配置步骤

1. 安装 Unity：

   • 访问 Unity 官网 下载并安装 Unity Hub。
   • 在 Unity Hub 中安装所需的 Unity 版本。

2. 配置 CUDA（可选）：

   • 如果你的系统有 Nvidia GPU，可以安装 CUDA Toolkit。
   • 安装完成后，在 Unity 项目设置中启用 CUDA。

3. 配置 Metal（可选）：

   • 如果你的系统是 MacOS，并且使用的是 Apple M1 或更高版本的芯片，可以启用 Metal 支持。
   • 在 Unity 项目设置中启用 Metal。

3.3 环境配置示例

4. 项目安装方式

1. 打开 Unity 项目：

   • 启动 Unity Hub。
   • 点击“添加”按钮，选择你克隆的 Whisper Unity 项目文件夹。
   • 打开项目。

2. 导入项目依赖：

   • 在 Unity 中，打开 Package Manager。
   • 点击“+”按钮，选择“Add package from git URL”。
   • 输入项目的 Git URL：https://github.com/Macoron/whisper.unity.git。

3. 配置项目设置：

   • 在 Unity 编辑器中，打开“Project Settings”。
   • 根据需要启用 CUDA 或 Metal 支持。

5. 项目处理脚本

Whisper Unity 项目包含多个处理脚本，用于编译和运行 Whisper.cpp 库。以下是一些关键脚本：

• build_cpp.bat：用于在 Windows 上编译 Whisper.cpp 库。
• build_cpp.sh：用于在 MacOS 和 Linux 上编译 Whisper.cpp 库。
• build_cpp_linux.sh：用于在 Linux 上编译 Whisper.cpp 库。

5.1 编译 Whisper.cpp 库

1. Windows：

   build_cpp.bat cpu path\to\whisper
   

2. MacOS：

   sh build_cpp.sh path/to/whisper all path/to/ndk/android.toolchain.cmake
   

3. Linux：

   sh build_cpp_linux.sh path/to/whisper cpu
   

5.2 运行示例

编译完成后，你可以在 Unity 中运行示例场景，测试 Whisper 模型的语音转文本功能。

---

通过以上步骤，你可以成功下载、安装并运行 Whisper Unity 项目。希望这篇教程对你有所帮助！