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

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

Скилл threejs-audio для Claude Code настраивает пространственный звук в Three.js. Помогает привязать слушателя к камере, обойти блокировку автоплея и связать аудио с жизненным циклом сцены.

MIT 583 установок ★ 26 обновлён 2026-09-10

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add cesartevisual/threejs-skills --skill threejs-audio -a claude-code
Открыть на GitHub

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

Скилл инструктирует агента по добавлению пространственного звука в проектах на Three.js. Он предписывает запускать воспроизведение только по клику или другому действию пользователя, чтобы браузер не блокировал звук, и связывать слушателя AudioListener с активной камерой без дублирования шин вывода.

Для позиционных источников скилл требует задавать конусы направленности и спад громкости в единицах сцены. Моделирование окклюзии стен автоматически не поддерживается: Three.js не глушит звук за преградами из коробки. Буферы звуков переиспользуются, а воспроизведение не должно срабатывать на каждом кадре столкновения.

При смене маршрута, сворачивании вкладки или переходе в сессию WebXR воспроизведение координируется с состоянием страницы. Скилл запрещает закрывать общий AudioContext, если он используется другими частями приложения.

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

  • привязать AudioListener к активной камере без дублирования вывода
  • настроить позиционирование звука и конусы направленности для объектов сцены
  • обработать блокировку автоплея браузером при загрузке страницы
  • освободить аудиоресурсы при размонтировании компонента или смене сцены

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

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

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

1Через Skills CLI (Vercel)

npx skills add cesartevisual/threejs-skills --skill threejs-audio -a claude-code

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

~/.claude/skills/threejs-audio/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/threejs-audio/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о threejs-audio

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

Выполните команду npx skills add cesartevisual/threejs-skills --skill threejs-audio -a claude-code в терминале.

Что делает threejs-audio?

Задаёт правила работы с Web Audio и PositionalAudio в Three.js: от привязки слушателя к камере до корректной остановки звуков при смене видимости вкладки или переходе в XR.

Учитывает ли threejs-audio препятствия и стены сцены?

Нет, позиционные источники в Three.js не рассчитывают окклюзию стен автоматически, поэтому физические преграды требуют отдельной логики.

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

SKILL.md · MIT
---
name: threejs-audio
description: "Add Three.js spatial audio, user-controlled playback, listener movement, and audio lifecycle handling."
---

# Spatial Audio

Use the project's installed versions and existing architecture. These instructions supplement the user's task; they do not authorize unrelated changes or external actions.

Establish whether audio communicates information or provides optional ambience. Expose mute/volume and any required textual equivalent in HTML. Start or resume audio from a user interaction and handle autoplay rejection without breaking the scene.

Attach the listener to the active viewpoint and handle camera changes without duplicating listeners or output paths. For positional sources, choose distance/rolloff and directional cones in the scene's units. A positional source does not automatically simulate wall occlusion.

Load and decode asynchronously with explicit failure and stale-result handling. Bound concurrent sources and reuse buffers where appropriate. Avoid replaying a sound on every frame of a collision; trigger from meaningful state transitions.

Coordinate pause, visibility changes, route transitions, and XR session transitions with playback. Stop/disconnect owned sources and release listeners. Do not close an AudioContext shared with another part of the application.

Verify blocked autoplay, first interaction, mute persistence, moving-camera attenuation, rapid retriggers, and repeated mount/unmount. Measure perceived volume on actual output devices when spatial audio matters.

## API reference

Consult the [official documentation](https://threejs.org/docs/pages/PositionalAudio.html) for exact signatures and revision-specific behavior. If documentation access is unavailable, inspect installed types/source and state any remaining uncertainty.

© cesartevisual · MIT · cesartevisual/threejs-skills

Похожие скиллы

Все скиллы по теме «Геймдев и 3D: Unity, Unreal, Godot, Blender» →
audio-spatial zebbern Правило audio-spatial для Claude Code задаёт шаблоны настройки 3D-звука в Three.js: позиционирование источников, затухание и реакцию на действия пользователя. CX Codex +1 ★ 4 719звёзд репо 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установок threejs-scene-setup gamedev-skills Скилл threejs-scene-setup для Claude Code настраивает базовую сцену three.js r187, камеру, рендерер и цикл анимации. Запускается при ошибках импорта модуля three, черном холсте или отсутствии анимации. CX Codex +1 11 100установок threejs-game OpusGameLabs Скилл threejs-game для Claude Code: задаёт структуру проекта и обязательные модули для 3D-игры в браузере на Three.js. Разворачивает сцену и игровой цикл с нуля. CX Codex +1 1 200установок threejs-graphics-optimizer ovachiever Скилл threejs-graphics-optimizer для Claude Code задаёт правила оптимизации THREE.js: сокращает вызовы отрисовки, настраивает мобильные fallback и помогает удерживать 16,67 мс на кадр. CX Codex +1 125установок

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

Весь набор →
threejs-geometry Скилл threejs-geometry для Claude Code создаёт и оптимизирует геометрию Three.js. Включается в задачах с BufferGeometry, процедурными мешами и инстансами. CX Codex +1 638установок threejs-product-viewer Скилл threejs-product-viewer для Claude Code помогает создавать интерактивные витрины товаров на Three.js. Включается при разработке конфигуратора с вариантами материалов, ракурсами камеры и точками на модели. CX Codex +1 621установок threejs-physics Скилл threejs-physics для Claude Code помогает связать Three.js с физическим движком вроде Rapier. Настраивает коллайдеры, фиксированный шаг симуляции и синхронизацию трансформаций с рендером. CX Codex +1 611установок threejs-html Скилл threejs-html для Claude Code помогает встроить Three.js в адаптивную вёрстку на Next.js или чистом HTML. Настраивает оверлеи, скролл-секции и несколько вьюпортов без поломки SSR. CX Codex +1 597установок threejs-spatial-data Скилл threejs-spatial-data для Claude Code настраивает работу с BIM/IFC, GIS, CAD и большими координатами в Three.js. Помогает сохранить точность вычислений GPU и метаданные при рендеринге геометрии. CX Codex +1 587установок threejs-webgpu Скилл threejs-webgpu для Claude Code помогает создавать и переносить проекты Three.js на WebGPURenderer, настраивать материалы TSL и вычисления на GPU. Он подключается к задачам, где нужно учесть ограничения выбранного графического backend. CX Codex +1 585установок threejs-deployment Скилл threejs-deployment для Claude Code готовит и проверяет сборки веб-приложений на Three.js, работу хостинга, пути декодеров и кэширование. CX Codex +1 582установок threejs-xr Скилл threejs-xr для Claude Code помогает добавлять VR- и AR-сессии в проекты на Three.js. Он подключается к задачам про XR-ввод, пространства отсчёта и жизненный цикл сессии. CX Codex +1 577установок

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

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