# SuperCollider

> SuperCollider 3.14.1をお使いのコンピューターで動かし、移植性の高いゲーム音楽を作曲、レンダリング、分析、エクスポートできます。プロジェクト内のコードとしてのスコア、オフラインでのWAVレンダリング、同期されたステムとループ、サンプルのインポート、プレビュー、そしてUnity、Godot、Unrealへのエクスポートに対応します。

- ID: `aigd.supercollider`
- ソース: 公式 (ファーストパーティ `aigd.*`)
- カテゴリ: オーディオ
- パブリッシャー: AI Game Dev (`aigd`), 確認済み
- 最新バージョン: 0.1.12 (公開日 2026-11-22)
- ライセンス: Apache-2.0
- AI Game Dev アプリが必要です: `>=0.25.11`
- ネイティブコード: いいえ
- 評価: まだ評価はありません
- HTML ページ: https://ai-game.dev/ja/packages/aigd.supercollider

## インストール

gamedev CLI を使用する場合は、プロジェクトフォルダで:

```bash
gamedev pkg add aigd.supercollider
```

デスクトップアプリで: パッケージウィンドウ（ステータスバーのパッケージアイコン）を開き、**参照** を選択して `aigd.supercollider` を検索し、**プロジェクトに追加** をクリックします。詳細: https://ai-game.dev/docs/wiki/app/packages

## バージョン

| バージョン | 公開日 | アプリが必要 | 備考 |
|---|---|---|---|
| 0.1.12 | 2026-11-22 | `>=0.25.11` | 最新 |
| 0.1.11 | 2026-11-19 | `>=0.25.11` | - |
| 0.1.10 | 2026-11-13 | `>=0.25.11` | - |
| 0.1.9 | 2026-11-06 | `>=0.25.11` | - |
| 0.1.8 | 2026-11-06 | `>=0.25.11` | - |
| 0.1.7 | 2026-11-01 | `>=0.25.11` | - |
| 0.1.5 | 2026-10-13 | `>=0.20.0` | - |
| 0.1.4 | 2026-10-09 | `>=0.20.0` | - |
| 0.1.2 | 2026-10-05 | `>=0.20.0` | - |
| 0.1.1 | 2026-10-01 | `>=0.20.0` | - |

## 説明

````markdown
# SuperCollider (`aigd.supercollider`)

AI Game Devエージェントと[SuperCollider](https://supercollider.github.io)を使って、移植性の高いゲーム音楽を作曲、レンダリング、分析、エクスポートできます。エージェントはプロジェクト内にSuperColliderのスコア（`.scd`）を書き、お使いのコンピューターでオフラインでWAVにレンダリングし、結果をプレビューして、Unity、Godot、Unrealのプロジェクトへエクスポートします。すべてがローカルで動作し、AI Game Devの利用枠を一切消費しません。完成した音声ファイルだけでなく、バージョン管理に残る編集可能なソースコードとして音楽、ループ、ステム、エフェクトを扱いたいゲーム開発者に適しています。

## できること

- 読んで編集し、再レンダリングできるSuperColliderのコードとして、テーマ、ループ、スティンガーを作曲できます。
- レイヤー音楽やアダプティブ音楽のために、同じ長さと同じ設定で同期されたステム（たとえばパーカッションとメロディ）をレンダリングできます。
- 手持ちのサンプルを使用できます。WAVをインポートし、スコアから再生します。
- レンダリング結果を確認できます。長さ、サンプルレート、チャンネル数、ピーク、RMS、クリッピングです。
- アプリ内でレンダリング結果をプレビューし、そのWAVをエンジンのオーディオフォルダーへエクスポートします。

## リクエストの例

- 「8秒の穏やかな探索テーマを作曲し、レンダリングしてゲームへエクスポートして。」
- 「48 kHzステレオで2秒のシームレスなパーカッションループと、それに合うベースのステムを作って。」
- 「`Recordings/door.wav`をサンプルとしてインポートし、それを使って短いエコーの付いたドアの効果音を作って。」
- 「最後のレンダリングを分析して。クリッピングしている箇所はある？」

## 仕組み

このパッケージは**Music**機能を追加します（ツールのチャットのAudioグループの一部で、Audioと連動して切り替わります）。エージェントがそれを使えるかどうかはプロジェクトのModels画面（「SuperCollider (music)」）で決まります。エージェントには次のツールが提供されます。

| ツール | 動作 |
|---|---|
| `status`, `get_guide` | ランタイムの状態とオーサリングガイド。 |
| `init_project` | `AudioSource`のオーサリングツリーを作成し、テスト済みのサンプルスコアをコピーします。あなたの作曲を上書きすることはありません。 |
| `import_sample` | プロジェクトのWAVをサンプルへコピーし（リトルエンディアンPCM、モノラルまたはステレオ、16/24/32ビット、8–192 kHz）、そのSHA-256を記録します。 |
| `render`, `get_render_status`, `cancel_render` | スコアをこのチャットのジョブとしてオフラインでレンダリングし、進捗を追跡してキャンセルします。 |
| `analyze_audio` | WAVの長さ、レート、チャンネル数、ビット数、ピーク、RMS、クリッピング。 |
| `preview` | 短く完全なプレビュー用コピーをデスクトップアプリで開きます（CLIはそのパスを返します）。 |
| `export_to_game` | 完成したレンダリングをゲームプロジェクトへエクスポートします。 |

エージェントは通常のファイルツールでスコアを編集します。各`.scd`スコアは`Score`を返し、ランナーは新しい`scsynth`を非リアルタイムモードで使ってレンダリングします。レンダリングは44100、48000、96000 HzのモノラルまたはステレオPCM16 WAVで、最長600秒、要求された長さの正確なフレーム数に切り詰められ、正規化は行いません。シードを指定すると、作曲の言語側の乱数が再現可能になります。ただし、プラットフォーム間でビット単位で同一になることは保証されません。このパッケージはライブシンセシスを行わず、Quarksやプラグインのインストールも行いません。

4つのサンプルスコアでは、メロディックなシンセのノート（`music.scd`）、エコーの余韻を持つ楽器（`effect.scd`）、ステレオサンプル（`sample.scd`）、整列されたパーカッションステム（`loop-stem.scd`）を示します。

### エクスポート先

| プロジェクト | エクスポート |
|---|---|
| Unity | `Assets/Audio`。既存の`.meta`ファイルとそのGUIDは維持されます。 |
| Godot | `res://Audio/`。`AudioSource`には`.gdignore`が付くため、Godotはそれをスキップします。 |
| Unreal | 接続中のエディター経由で`/Game/Audio`へインポートされます。エディターがインポートを確認しない場合は、自分でインポートするためのWAVパスが表示されます。 |
| エンジンのないプロジェクト | `AudioSource/exports`内のWAVファイル。 |

`AudioSource`（スコア、楽器、エフェクト、サンプル、プリセット、`audio-project.json`、`dependencies.lock`）はバージョン管理に残してください。レンダリング結果は使い捨てです。

デスクトップアプリでは、Unity、Godot、Unrealのエディターに接続されたアイドル状態のチャットに2つのヒントが表示されます。1つはMusicをオンにするヒント、もう1つは8秒のサンプルテーマかあなた自身のアイデアを提案するヒントです。`/supercollider [status|guide]`で状態とガイドを確認できます。

## ランタイムと要件

- **SuperCollider 3.14.1**。初回に必要になったときに公式GitHubリリースからダウンロードし、固定されたSHA-256と照合します。Windows x64ではZIP、macOSではDMGです。パッケージを有効化しても何もダウンロードされません。
- **Linux:** SuperColliderはポータブルなLinuxビルドを公開していません。`runtimePath`を互換性のあるSuperCollider 3.14.1のインストール先に設定するか、`stagedArtifact`をレビュー済みのアーティファクト記述子（バージョン、プラットフォーム、URL、SHA-256、形式`tar`）に設定してください。
- 各ジョブは標準クラスライブラリとプラグインのみで実行されます。あなたのSuperCollider起動ファイルとホーム設定は読み込まれず、変更もされません。スコアのコードは信頼されたコードであり、セキュリティサンドボックスではありません。
- AI Game Dev 0.25.11以降。

## ライセンス

このパッケージ: Apache-2.0。SuperColliderは、そのプロジェクトによってGNU GPLの下でリリースされている自由ソフトウェアです。パッケージのアバターは公式のSuperColliderロゴです。商標はその所有者に帰属します。
````
