# audio-spatial

Правило audio-spatial для Claude Code задаёт шаблоны настройки 3D-звука в Three.js: позиционирование источников, затухание и реакцию на действия пользователя.

- правило · `type=rule` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline · ★ 4719 у репозитория
- Автор: zebbern
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/zebbern/claude-code-guide/tree/HEAD/skills/three-best-practices/rules/audio-spatial.md
- Обновлён: 2026-10-24
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/rules/audio-spatial

## Что делает

Правило задаёт шаблоны кода для подсистемы звука Three.js: подключение `AudioListener` к камере, фоновый звук через `Audio` и пространственный звук с `PositionalAudio`. Включены параметры дистанции (`linear`, `inverse`, `exponential`), панорамирование через HRTF и расчёт направленности звукового конуса.

Внутри также собраны инструкции по загрузке файлов через `AudioLoader`, использованию анализатора `AudioAnalyser` для визуализаций и переиспользованию аудиобуферов.

Браузерная политика блокирует автовоспроизведение: без клика или нажатия пользователя метод `listener.context.resume()` не сработает и звук останется заглушённым.

## Установка

### Claude Code (родная платформа)

**Вручную: положить файлы**
- Файл: `.claude/rules/audio-spatial.md` — Поле paths во frontmatter ограничивает файлы

### Codex

**AGENTS.md**
- Codex читает AGENTS.md: вставьте текст правила туда

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/rules/audio-spatial.mdc` — Во frontmatter: description, globs, alwaysApply

### GitHub Copilot

**Вручную: положить файлы**
- Файл: `.github/instructions/audio-spatial.instructions.md` — Поле applyTo задаёт, к каким файлам применять

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/rules/audio-spatial.md`

### Cline

**Вручную: положить файлы**
- Файл: `.clinerules/audio-spatial.md`

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/zebbern/claude-code-guide/tree/HEAD/skills/three-best-practices/rules/audio-spatial.md

## Когда брать
- привязать пространственный звук PositionalAudio к 3D-объектам сцены
- настроить затухание звука по моделям inverse, linear или exponential
- обойти блокировку автовоспроизведения через возобновление AudioContext
- подключить AudioAnalyser для создания визуализаций под частоты трека

## Примеры запросов агенту
- Добавь пространственный звук шагов к мешу персонажа с затуханием по модели inverse
- Настрой запуск фоновой музыки по клику на кнопку через AudioContext resume
- Сделай визуализатор частот для аудиофайла с помощью Three.js AudioAnalyser

## Похожие
- [threejs-audio](https://affpapa.org/nevibecode/skills/threejs-audio.md) — скилл · 583 установки
- [threejs-spatial-data](https://affpapa.org/nevibecode/skills/threejs-spatial-data.md) — скилл · 587 установок
- [audio-and-sound](https://affpapa.org/nevibecode/skills/audio-and-sound.md) — скилл · 1200 установок
- [threejs-fundamentals](https://affpapa.org/nevibecode/skills/threejs-fundamentals.md) — скилл · 24100 установок
- [threejs-interaction](https://affpapa.org/nevibecode/skills/threejs-interaction.md) — скилл · 20100 установок
- [webgl-3d-object](https://affpapa.org/nevibecode/skills/webgl-3d-object.md) — скилл · 2000 установок

Из того же набора: [zebbern/claude-code-guide](https://affpapa.org/nevibecode/by/zebbern/claude-code-guide.md) — 86 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
