# 本機音效與音樂（Stable Audio 3）

> 在 AI Game Dev 中以 sa3.cpp 執行本機音效與音樂的執行環境；sa3.cpp 是 Stable Audio 3 的 C++/ggml 移植版，支援 CUDA、Vulkan、Metal 或 CPU，不需 Python。可執行 Stable Audio 3 Small SFX、Small Music 與 Medium 模型，這些模型是各自獨立的套件。

- ID: `aigd.sa3cpp`
- 來源: 官方 (第一方 `aigd.*`)
- 分類: 音訊
- 發佈者: AI Game Dev (`aigd`), 已驗證
- 最新版本: 1.0.2 (發佈於 2026-11-22)
- 授權條款: MIT
- 需要 AI Game Dev 應用程式: `>=0.32.0-beta.6`
- 原生程式碼: 否
- 評分: 尚無評分
- HTML 頁面: https://ai-game.dev/zh-hant/packages/aigd.sa3cpp

## 安裝

在專案資料夾中，使用 gamedev CLI：

```bash
gamedev pkg add aigd.sa3cpp
```

在桌面應用程式中：開啟「套件」視窗（狀態列上的套件圖示），選擇 **瀏覽**，搜尋 `aigd.sa3cpp`，然後點 **加入專案**。更多資訊：https://ai-game.dev/docs/wiki/app/packages

## 版本

| 版本 | 發佈日期 | 需要應用程式 | 備註 |
|---|---|---|---|
| 1.0.2 | 2026-11-22 | `>=0.32.0-beta.6` | 最新 |
| 1.0.1 | 2026-11-21 | `>=0.32.0-beta.6` | - |

## 說明

````markdown
# 本機音效與音樂（`aigd.sa3cpp`）

本機音效與音樂是讓 AI Game Dev 應用程式在你自己的電腦上，透過 Stable Audio 3 模型製作音效與純樂器音樂的執行環境。它使用 [sa3.cpp](https://github.com/betweentwomidnights/sa3.cpp)，這是 Stability AI 的 Stable Audio 3 的 C++/ggml 移植版，不需要 Python。所有內容都在你的電腦上製作，而且製作不花任何費用。它適合想要音效、擬音、UI 音效與背景音樂、又不想依賴雲端服務的遊戲開發者。

## 功能

- 下載適合你電腦的 sa3.cpp 版本（Windows、Apple 晶片的 Mac，或 Intel Mac 與 Linux 的預覽版；CUDA、Vulkan、Metal 或 CPU），以 sha256 檢查後執行。
- 在工作階段的 Tools 列中加入 **SFX & Music** 開關。此開關預設關閉，需在工作階段中自行開啟。
- 每個音效執行一次 `sa3-generate`，不會常駐任何伺服器。

此套件只有資料（`aigd-package.json`，沒有程式碼）。它告訴 AI Game Dev 該為你的電腦下載哪一個 sa3.cpp 版本。程式本身由應用程式負責下載、檢查與執行。

## 模型是獨立的套件

此套件不含任何模型。請從 Packages 瀏覽器安裝模型套件，再到 Models 面板下載其檔案：

| 套件 | 製作的內容 |
|---|---|
| [Stable Audio 3 Small SFX](https://ai-game.dev/packages/aigd.audio-stable-audio-3-small-sfx)（`aigd.audio-stable-audio-3-small-sfx`） | 音效與擬音，最長 60 秒 |
| [Stable Audio 3 Small Music](https://ai-game.dev/packages/aigd.audio-stable-audio-3-small-music)（`aigd.audio-stable-audio-3-small-music`） | 純樂器音樂，最長 2 分鐘 |
| [Stable Audio 3 Medium](https://ai-game.dev/packages/aigd.audio-stable-audio-3-medium)（`aigd.audio-stable-audio-3-medium`） | 純樂器音樂，最長 6 分 20 秒 |

未經你確認，不會下載任何東西。你會先看到檔案大小與模型的授權條款。Stable Audio 3 模型有各自的授權，其中包含營收上限、註冊義務與 "Powered by Stability AI" 標示。每個模型套件的 README 都載明這些條款。

其他本機音樂、音效與語音模型則透過 [Local audio generation](https://ai-game.dev/packages/aigd.audiocpp)（`aigd.audiocpp`）執行。

## 範例請求

在 **SFX & Music** 開啟且已安裝模型的情況下，你可以用白話直接請代理程式：

- 「做一段短促的雷射槍聲，給玩家的槍用。」
- 「產生踩在雪地上的腳步聲，4 秒。」
- 「做一段 90 秒的放鬆 lo-fi 純樂器音樂，給主選單用。」

## 會下載哪些內容

應用程式會下載上游的版本，以標籤固定並以 sha256 檢查：`betweentwomidnights/sa3.cpp` [`v0.2.4`](https://github.com/betweentwomidnights/sa3.cpp/releases/tag/v0.2.4)（commit `3152253`）。上游將其標示為 pre-release。應用程式會為你的電腦挑選其中一種變體。

| 變體 | 電腦 | 下載 |
|---|---|---|
| `win-x64-cuda12` | Windows，NVIDIA GPU（驅動程式 572.61 以上，運算能力 6.1 以上） | 752 MB（程式 + NVIDIA CUDA 12.8 執行環境） |
| `win-x64-vulkan` | Windows，AMD / Intel / 其他 GPU | 19 MB（核心 + Vulkan 後端） |
| `win-x64-cpu` | Windows，沒有可用的 GPU（較慢；Medium 需要 GPU） | 7 MB |
| `darwin-arm64-metal` | Apple 晶片的 Mac，macOS 13.3 以上 | 11 MB（由上游簽署與公證） |
| `darwin-x64-cpu` | Intel Mac，macOS 13.3 以上（僅 CPU） | 11 MB |
| `linux-x64-vulkan` | Linux x64，配備 Vulkan GPU，**glibc 2.38 以上**（Ubuntu 24.04+、Debian 13+）。需要 `libgomp.so.1` 與 `libvulkan.so.1` | 22 MB |
| `linux-x64-cpu` | Linux x64，沒有可用的 GPU，glibc 2.38 以上。需要 `libgomp.so.1` | 12 MB |

Windows CUDA 變體使用上游的獨立封裝檔。它是唯一內含 CUDA 執行環境的封裝檔（`cudart64_12`、`cublas64_12`、`cublasLt64_12`）。拆分式的 `cuda` 封裝檔只包含 `ggml-cuda.dll`，並預期系統已安裝 CUDA 12.8 執行環境。

**預覽版。** Linux 與 Intel Mac 變體尚未在實體硬體上測試，上游也未驗證 CPU 世代。這些變體可以選取，並標示為「preview」。

應用程式絕不會安裝驅動程式或系統函式庫。若有缺少的項目，它會告訴你需要安裝什麼。

## 授權條款

- sa3.cpp — MIT，© 2026 betweentwomidnights（[授權條款](https://github.com/betweentwomidnights/sa3.cpp/blob/3152253622d8b54deec14bfb0938371a5bd20439/LICENSE)）。
- ggml — MIT，© The ggml authors（[ggml-org/ggml](https://github.com/ggml-org/ggml)）。
- cpp-httplib（MIT，© yhirose）、yyjson（MIT，© YaoYuan）、Signalsmith Stretch 與 Signalsmith Linear（MIT，© Signalsmith Audio）。其授權條款檔案隨封裝檔一併提供。
- RoyalCities RC-stable-audio-tools 提示詞引擎（MIT，© 2023 Stability AI），經改寫後用於 `sat-*` 工具（[原始碼](https://github.com/RoyalCities/RC-stable-audio-tools)）。AI Game Dev 不會執行這些工具；授權條款位於封裝檔的 `THIRD_PARTY_NOTICES.md` 中。
- Microsoft Visual C++ 執行環境（`msvcp140`、`vcruntime140`、`vcruntime140_1`、`vcomp140`），僅包含於 Windows 變體。上游依 Visual Studio 2022 可轉散發程式碼條款轉散發。
- NVIDIA CUDA 執行環境（cudart、cuBLAS），僅包含於 Windows CUDA 變體。上游依 [NVIDIA CUDA EULA](https://docs.nvidia.com/cuda/eula/) 轉散發，且 `NVIDIA-CUDA-EULA.txt` 隨封裝檔提供。
- 此套件 — MIT。執行環境不含任何模型權重。每個模型套件各自載明其授權條款。

所有檔案都從上游的 GitHub release 下載。AI Game Dev 不自行託管這些檔案。
````
