本機音效與音樂(Stable Audio 3)
gamedev pkg add aigd.sa3cpp總覽
在 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 模型,這些模型是各自獨立的套件。
本機音效與音樂是讓 AI Game Dev 應用程式在你自己的電腦上,透過 Stable Audio 3 模型製作音效與純樂器音樂的執行環境。它使用 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(aigd.audio-stable-audio-3-small-sfx) | 音效與擬音,最長 60 秒 |
Stable Audio 3 Small Music(aigd.audio-stable-audio-3-small-music) | 純樂器音樂,最長 2 分鐘 |
Stable Audio 3 Medium(aigd.audio-stable-audio-3-medium) | 純樂器音樂,最長 6 分 20 秒 |
未經你確認,不會下載任何東西。你會先看到檔案大小與模型的授權條款。Stable Audio 3 模型有各自的授權,其中包含營收上限、註冊義務與 "Powered by Stability AI" 標示。每個模型套件的 README 都載明這些條款。
其他本機音樂、音效與語音模型則透過 Local audio generation(aigd.audiocpp)執行。
範例請求
在 SFX & Music 開啟且已安裝模型的情況下,你可以用白話直接請代理程式:
- 「做一段短促的雷射槍聲,給玩家的槍用。」
- 「產生踩在雪地上的腳步聲,4 秒。」
- 「做一段 90 秒的放鬆 lo-fi 純樂器音樂,給主選單用。」
會下載哪些內容
應用程式會下載上游的版本,以標籤固定並以 sha256 檢查:betweentwomidnights/sa3.cpp 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(授權條款)。
- ggml — MIT,© The ggml authors(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-*工具(原始碼)。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 轉散發,且
NVIDIA-CUDA-EULA.txt隨封裝檔提供。 - 此套件 — MIT。執行環境不含任何模型權重。每個模型套件各自載明其授權條款。
所有檔案都從上游的 GitHub release 下載。AI Game Dev 不自行託管這些檔案。
版本
| 版本 | 發布日期 | 需搭配應用程式 |
|---|---|---|
| 1.0.2最新 | 0.32.0-beta.6 或更新版本 | |
| 1.0.1 | 0.32.0-beta.6 或更新版本 |
安裝
在桌面應用程式中
開啟 套件 視窗(狀態列上的套件圖示),選擇 瀏覽,搜尋 aigd.sa3cpp,然後點選 加到專案。
還沒安裝應用程式?免費下載 AI Game Dev,支援 Windows、macOS 與 Linux。
從終端機
在你的專案資料夾中,使用 gamedev CLI:
gamedev pkg add aigd.sa3cpp需求
- AI Game Dev 0.32.0-beta.6 或更新版本
gamedev pkg add aigd.sa3cpp