# ローカル効果音・音楽（Stable Audio 3）

> AI Game Dev でローカルの効果音と音楽を生成するためのランタイムです。Stable Audio 3 の C++/ggml 移植版である sa3.cpp を使い、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/ja/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 モデルを使って自分のコンピューター上で効果音やインストルメンタル音楽を生成できるようにするランタイムです。Stability AI の Stable Audio 3 を C++/ggml に移植した [sa3.cpp](https://github.com/betweentwomidnights/sa3.cpp) を使用しており、Python は不要です。すべてが自分のコンピューター上で生成され、生成に費用はかかりません。クラウドサービスを使わずに SFX、フォーリー、UI サウンド、BGM を用意したいゲーム開発者に適しています。

## 主な機能

- お使いのコンピューターに合った sa3.cpp のリリース（Windows、Apple silicon 搭載 Mac、またはプレビュー版として Intel Mac と Linux。CUDA、Vulkan、Metal、CPU）をダウンロードし、sha256 で検証して実行します。
- セッションのツールバーに **SFX & Music** スイッチを追加します。このスイッチは、セッション内でオンにするまでオフのままです。
- サウンド1つにつき `sa3-generate` を1回実行し、サーバーは常駐させません。

このパッケージはデータのみで（`aigd-package.json`、コードなし）、AI Game Dev にどの sa3.cpp リリースをダウンロードすべきかを伝えます。プログラムのダウンロード、検証、実行はアプリ自身が行います。

## モデルは別パッケージです

このパッケージにモデルは含まれていません。パッケージブラウザーからモデルパッケージをインストールし、モデルパネルからそのファイルをダウンロードしてください。

| パッケージ | 生成するもの |
|---|---|
| [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 にこれらの条件が記載されています。

その他のローカル音楽・効果音・音声モデルは [ローカル音声生成](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)（コミット `3152253`）です。アップストリームではプレリリースとして扱われています。アプリはお使いのコンピューターに合わせて1つのバリアントを選択します。

| バリアント | コンピューター | ダウンロード |
|---|---|---|
| `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 silicon 搭載 Mac、macOS 13.3 以降 | 11 MB（アップストリームによる署名と公証済み） |
| `darwin-x64-cpu` | Intel Mac、macOS 13.3 以降（CPU のみ） | 11 MB |
| `linux-x64-vulkan` | Vulkan GPU を搭載した Linux x64、**glibc 2.38 以降**（Ubuntu 24.04 以降、Debian 13 以降）。`libgomp.so.1` と `libvulkan.so.1` が必要 | 22 MB |
| `linux-x64-cpu` | 使用可能な GPU のない Linux x64、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 リリースからダウンロードされます。AI Game Dev はそれらをホストしていません。
````
