К основному содержанию
правило CX Codex

audio-spatial — правило для Claude Code: что делает и как установить

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

MIT ★ 4 719 обновлён 2026-10-24

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/rules/audio-spatial.md
Открыть на GitHub

Что делает audio-spatial

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

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

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

Какие задачи решает

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

Примеры запросов агенту

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

Как установить audio-spatial

Вручную: положить файлы

.claude/rules/audio-spatial.md

Поле paths во frontmatter ограничивает файлы

По шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать

Вопросы об audio-spatial

Как установить audio-spatial в Claude Code?

Добавьте файл правила по пути .claude/rules/audio-spatial.md в корень вашего репозитория.

Что делает правило audio-spatial?

Оно даёт ассистенту примеры реализации пространственного звука в Three.js, включая PositionalAudio, расчёт дистанции и конусов направленности.

Почему звук в браузере не играет автоматически?

Политика браузеров требует явного действия пользователя, поэтому запуск воспроизведения и вызов listener.context.resume() нужно привязывать к событию клика.

Исходный текст

audio-spatial.md · MIT
# Spatial Audio

Three.js audio system for 3D positional sound.

## Components

```javascript
import * as THREE from 'three';

// AudioListener - represents user position (attach to camera)
const listener = new THREE.AudioListener();
camera.add(listener);

// Audio - non-positional (background music)
const sound = new THREE.Audio(listener);

// PositionalAudio - 3D spatial sound
const positionalSound = new THREE.PositionalAudio(listener);
mesh.add(positionalSound);
```

## Loading Audio

```javascript
const audioLoader = new THREE.AudioLoader();
audioLoader.load('sound.mp3', (buffer) => {
  sound.setBuffer(buffer);
  sound.setLoop(true);
  sound.setVolume(0.5);
  sound.play();
});
```

## PositionalAudio Configuration

```javascript
const positionalAudio = new THREE.PositionalAudio(listener);

// Reference distance (max volume distance)
positionalAudio.setRefDistance(1);

// Maximum distance
positionalAudio.setMaxDistance(100);

// Rolloff model: 'linear', 'inverse', 'exponential'
positionalAudio.setRolloffFactor(1);
positionalAudio.setDistanceModel('inverse');

// Panning model: 'HRTF' (realistic) or 'equalpower'
positionalAudio.panner.panningModel = 'HRTF';

// Directionality (cone)
positionalAudio.setDirectionalCone(180, 230, 0.1);
// innerAngle, outerAngle, outerGain
```

## Distance Models

| Model | Behavior |
|-------|----------|
| `linear` | Linear decrease from ref to max distance |
| `inverse` | Inverse relationship (realistic) |
| `exponential` | Exponential falloff |

## Audio Controls

```javascript
// Play/pause
sound.play();
sound.pause();
sound.stop();

// Volume
sound.setVolume(0.5);  // 0.0 to 1.0

// Playback rate
sound.setPlaybackRate(1.5);

// Loop
sound.setLoop(true);

// Check state
if (sound.isPlaying) { }

// Duration
const duration = sound.buffer.duration;

// Current time
sound.offset; // read
```

## Audio Analyzer

```javascript
const analyser = new THREE.AudioAnalyser(sound, 32);

function animate() {
  const data = analyser.getAverageFrequency();
  // Use data for visualizations
  mesh.scale.setScalar(1 + data / 256);
}
```

## Multiple Audio Sources

```javascript
// Background music
const bgMusic = new THREE.Audio(listener);
audioLoader.load('music.mp3', (buffer) => {
  bgMusic.setBuffer(buffer);
  bgMusic.setLoop(true);
  bgMusic.setVolume(0.3);
});

// Spatial sounds on objects
objects.forEach((obj, i) => {
  const sound = new THREE.PositionalAudio(listener);
  audioLoader.load(`sound${i}.mp3`, (buffer) => {
    sound.setBuffer(buffer);
    sound.setRefDistance(5);
    sound.setLoop(true);
  });
  obj.add(sound);
});
```

## User Gesture Requirement

Audio requires user interaction to start (browser policy):

```javascript
const startButton = document.getElementById('start');
startButton.addEventListener('click', () => {
  // Resume AudioContext
  if (listener.context.state === 'suspended') {
    listener.context.resume();
  }
  sound.play();
  startButton.style.display = 'none';
});
```

## Best Practices

1. **HRTF**: Use `panningModel: 'HRTF'` for realistic 3D audio (best with headphones)

2. **User Gesture**: Always require user interaction before playing audio

3. **Dispose**: Call `audio.disconnect()` when removing sounds
   ```javascript
   sound.stop();
   sound.disconnect();
   ```

4. **Mobile**: Audio consumes significant battery on mobile devices

5. **Buffer Reuse**: Reuse audio buffers for repeated sounds
   ```javascript
   const sharedBuffer = await loadBuffer('shoot.mp3');

   function playShot(position) {
     const sound = new THREE.PositionalAudio(listener);
     sound.setBuffer(sharedBuffer);
     sound.position.copy(position);
     scene.add(sound);
     sound.play();
     sound.onEnded = () => {
       scene.remove(sound);
       sound.disconnect();
     };
   }
   ```

6. **Volume Levels**: Keep sound effects around 0.3-0.7, music around 0.2-0.4

7. **Ref Distance**: Set refDistance to the size of the emitting object

## Audio Formats

| Format | Browser Support | Notes |
|--------|-----------------|-------|
| MP3 | All | Good compression, universal |
| OGG | Chrome, Firefox | Better quality at same size |
| WAV | All | Uncompressed, large files |
| AAC | All | Good for music |

## References

- [Three.js Audio](https://threejs.org/docs/#api/en/audio/Audio)
- [Three.js PositionalAudio](https://threejs.org/docs/#api/en/audio/PositionalAudio)
- [Web Audio API](https://developer.mozilla.org/en-US/docs/Web/API/Web_Audio_API)

© zebbern · MIT · zebbern/claude-code-guide

Похожие правила IDE

Все правила IDE по теме «Геймдев и 3D: Unity, Unreal, Godot, Blender» →
threejs-audio cesartevisual Скилл threejs-audio для Claude Code настраивает пространственный звук в Three.js. Помогает привязать слушателя к камере, обойти блокировку автоплея и связать аудио с жизненным циклом сцены. CX Codex +1 583установок threejs-spatial-data cesartevisual Скилл threejs-spatial-data для Claude Code настраивает работу с BIM/IFC, GIS, CAD и большими координатами в Three.js. Помогает сохранить точность вычислений GPU и метаданные при рендеринге геометрии. CX Codex +1 587установок audio-and-sound phaserjs Скилл audio-and-sound помогает настроить воспроизведение звуков, фоновой музыки, громкости и пространственного аудио в играх на Phaser 4 через SoundManager и Web Audio API. CX Codex +1 1 200установок threejs-fundamentals CloudAI-X Скилл threejs-fundamentals помогает настроить базовую сцену Three.js r186: рендерер, камеры, цикл анимации с THREE.Timer и import map для WebGL или WebGPU с TSL. CX Codex +1 24 100установок threejs-interaction CloudAI-X Скилл threejs-interaction учит агента настраивать выбор объектов, перемещение по плоскости и управление камерой в three.js для WebGL и WebGPU. CX Codex +1 20 100установок webgl-3d-object MengTo Скилл webgl-3d-object добавляет в агент правила генерации трёхмерных объектов на Three.js с честным PBR-освещением, тенями и анимацией вместо псевдо-3D на CSS. CX Codex +1 2 000установок

Из того же набора86

Весь набор →
timeline-builder Скилл timeline-builder для Claude Code превращает JSON-данные в интерактивную HTML-хронологию с вертикальной, горизонтальной или двусторонней раскладкой. Отображает этапы проекта, историю выпусков и резюме. CX Codex +1 ★ 4 719звёзд репо loading-suspense Правило loading-suspense требует оборачивать асинхронные компоненты React Three Fiber в Suspense с заглушкой: без границы сцена останется пустой, пока грузится модель или текстура. CX Codex +1 ★ 4 719звёзд репо lighting-shadows-advanced Правило lighting-shadows-advanced для Claude Code настраивает освещение и тени в Three.js с учётом стоимости рендеринга. Оптимизирует тени при множестве источников света. CX Codex +1 ★ 4 719звёзд репо migration-checklist Правило migration-checklist подсказывает агенту, как мигрировать код при обновлении Three.js. Перечисляет breaking changes с r125 и актуальные пути импортов. CX Codex +1 ★ 4 719звёзд репо debug-devtools Правило debug-devtools для Claude Code и Codex добавляет в Three.js-проект средства диагностики производительности, сцены и потери WebGL-контекста. Находит узкие места и проверяет параметры вживую. CX Codex +1 ★ 4 719звёзд репо tsl-post-processing Правило tsl-post-processing для Claude Code описывает постобработку Three.js на TSL: эффекты подключаются к postProcessing.outputNode без цепочки проходов EffectComposer. Агент обращается к нему при написании кода сцены. CX Codex +1 ★ 4 719звёзд репо tsl-compute-shaders Правило tsl-compute-shaders подсказывает агенту, как писать вычислительные шейдеры на Three.js TSL для WebGPU и настраивать GPGPU-симуляции вроде частиц с расчётом физики. CX Codex +1 ★ 4 719звёзд репо animation-system Правило animation-system объясняет систему анимации Three.js: от запуска и смешивания клипов до морфинга и управления костями. Пригодится при работе с анимированными 3D-моделями. CX Codex +1 ★ 4 719звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой