game-audio

game-audio

目的

このスキルを使うと、ゲームエンジンでリアルタイムのオーディオ処理を行い、効果音や音楽の再生、没入感のある体験のための空間オーディオを管理できます。Unity や Unreal などのエンジンと連携して、オーディオストリーム、エフェクト、位置を扱い、ゲームで低レイテンシのパフォーマンスを実現します。

使用するタイミング

• プレイヤーのアクションに応じた効果音など、動的なオーディオが必要なゲームを開発する場合。
• 3D の音響環境を再現するため、VR／AR ゲームに空間オーディオを実装する場合。
• リソースに制約のあるモバイルゲーム向けに、オーディオを最適化する場合。
• エンジン固有の API を使って、BGM とゲーム内エフェクトなどのオーディオレイヤーをミックスする必要がある場合。

主な機能

• processAudio 関数を使って、リバーブ、エコー、ピッチシフトなどのエフェクトをリアルタイムのオーディオストリームに適用します。
• ベクターベースの位置指定で空間オーディオを扱います。たとえば、プレイヤーの座標を基に音の減衰を計算します。
• 複数のオーディオ形式（WAV、MP3、OGG）と動的な音量調整に対応します。
• ゲームループと連携して、衝突検出時にサウンドを再生するなど、イベント駆動のオーディオトリガーを実現します。
• 適応型音楽のための周波数スペクトル検出など、オーディオ分析ツールを提供します。

使用パターン

このスキルを使うには、まずゲームエンジンのスクリプトで初期化し、オーディオの再生または処理用のメソッドを呼び出します。処理を実行する前に、オーディオコンテキストが利用可能であることを必ず確認してください。CLI を使う場合は、プロジェクトのルートディレクトリからコマンドを実行します。基本的な流れは、スキルをインポートし、$GAME_AUDIO_API_KEY で認証を設定して、オーディオイベント用のイベントハンドラーを使うことです。

主なコマンド／API

• CLI コマンド：claw audio play --file assets/sound.wav --volume 0.8 --loop true
  • フラグ：--file はオーディオファイルのパスを指定します。--volume は音量（0.0～1.0）を設定します。--loop はループ再生を有効にします。
• API エンドポイント：POST /api/game-audio/play、JSON ボディ：{"file": "assets/sound.wav", "position": [0, 0, 0]}
  • 必要なヘッダー：Authorization: Bearer $GAME_AUDIO_API_KEY
• コード例（Python）：

  import claw_audio
  claw_audio.init(key=os.environ['GAME_AUDIO_API_KEY'])
  claw_audio.play_sound('assets/sound.wav', volume=0.5)
  

• コード例（Unity 用 C#）：

  using ClawAudio;
  void Start() {
      AudioManager.Instance.Play("assets/music.mp3", loop: true);
  }
  

• 設定形式：オーディオ設定用の JSON。例：{"effects": {"reverb": 0.3}, "spatial": true}。claw_audio.load_config('config.json') で読み込みます。

統合に関する注意

プロジェクトの依存関係としてこのスキルを追加して統合します（例：Node.js では npm、Unity では Package Manager を使用）。claw_audio.check_device() を使って、オーディオハードウェアが検出されていることを確認してください。複数のエンジンで互換性を保つには、呼び出しを抽象化レイヤーでラップします。他の OpenClaw スキルと併用する場合は、クラスター経由でオーディオイベントを渡します（例：「game-dev」スキルにリンクします）。認証用の環境変数を設定します：export GAME_AUDIO_API_KEY=your_key。本番環境に導入する前に、サンドボックス環境で統合をテストしてください。

エラー処理

ファイルが見つからない、API 呼び出しに失敗するといった例外に対処するため、オーディオの呼び出しは必ず try-catch ブロックでラップしてください。よくあるエラー：「Audio device unavailable」―claw_audio.is_device_ready() で確認し、2 秒後に再試行してください。API エラーの場合は、ステータスコード（認証エラーを示す 401 など）を確認し、claw_audio.log_error(message) でログに記録してください。カスタムハンドラーを使います。例：

try:
    claw_audio.play_sound('file.wav')
except AudioError as e:
    print(f"Error: {e}. Retrying...")
    claw_audio.retry_operation()

CLI では --timeout 5000 のようにコマンドにタイムアウトを設定し、レイテンシの問題を監視してください。

具体的な使用例

1. Unity ゲームでプレイヤーのジャンプ時に効果音を再生する：

   • コード：

     void OnJump() {
         AudioManager.Instance.Play("jump.wav", position: playerTransform.position);
     }
     

   • 手順：Start() で AudioManager を初期化し、$GAME_AUDIO_API_KEY が設定されていることを確認して、入力イベントで OnJump() を呼び出します。

2. 3D ゲームで敵の検知に空間オーディオを実装する：

   • コード：

     def detect_enemy():
         position = [enemy_x, enemy_y, enemy_z]
         claw_audio.play_spatial('alert.mp3', position=position, radius=5.0)
     

   • 手順：ゲームループで detect_enemy() を呼び出し、減衰計算用にプレイヤーの位置を渡して、音がフェードする範囲を調整するために radius を設定します。

グラフの関係性

• 関連先：「game-dev」クラスター（同期した視聴覚効果を実現する game-rendering などのスキル）。
• タグによる接続：「audio」は speech-recognition などのスキルに、「sound」はオーディオ編集ツールに関連付けられています。
• 依存関係：基本機能には「core-audio」が必要です。空間計算には「game-physics」と連携します。