Перейти к руководству
Three.js Interactionавтор CloudAI-X

Three.js Interaction Skill.

Свяжите жест с нужным 3D-объектом, используя реальные координаты холста и камеры.

  • 3D
  • Three.js
Обзор источника · Three.js InteractionSKILL.md
Задача 3D Результат • Выбор объектов в координатах холста • Подходящая конфигурация управления камерой • Поведение выделения, наведения, перетаскивания или трансформации Перед началом Рабочий проект Three.js и рендерер; сверяйте примеры из источника с установленной версией. Дополнительные контроллеры и загрузчики зависят от выбранного подхода.
Редакционное резюме · источник проверен 2026-10-07 · не сгенерированный пример

01 Возможности

Three.js Interaction: выбор объектов и манипуляции с ними

Выбор объектов лучом, преобразование координат, управление камерой, выделение и манипуляции с объектами.

Рабочий процесс на основе источникаНе тест выполнения

Рабочий подход

Three.js Interaction охватывает raycasting и контроллеры. Он объясняет, как экранный ввод превращается в луч камеры, как пересечения определяют объекты или экземпляры и почему для встроенного холста нужно отдельное преобразование координат, а не расчёт на всё окно.

Навигация камеры и манипуляции с объектами — разные задачи. Orbit, fly, map, drag и transform-контроллеры выполняют разные роли. В сцене, похожей на редактор, эти обработчики нужно согласовать, чтобы перетаскивание модели не вращало камеру.

Ожидаемые результаты

  • Выбор объектов в координатах холста
  • Подходящая конфигурация управления камерой
  • Поведение выделения, наведения, перетаскивания или трансформации
Смотреть пример задания

От задания к проверке

  1. 01
    Определите цели

    Перечислите выбираемые объекты и решите, считать ли вложенные меши или экземпляры отдельными целями.

  2. 02
    Сопоставьте ввод

    Нормализуйте позиции указателя относительно прямоугольника холста и выполните raycast через активную камеру.

  3. 03
    Согласуйте контроллеры

    Управляйте конфликтами навигации во время манипуляций и восстанавливайте визуальную обратную связь при смене выделения.

02 Когда использовать

Когда использовать

Рабочий проект Three.js и рендерер; сверяйте примеры из источника с установленной версией. Дополнительные контроллеры и загрузчики зависят от выбранного подхода.

Хорошо подходит

  • Конфигураторы продуктовВыберите часть продукта и подсветите её или выполните действие именно с этим объектом.
  • Редакторы сценИспользуйте контроллеры трансформации или перетаскивания для перемещения, поворота и масштабирования выбранной геометрии.

Что проверить

  • Доступность — отдельный вопросОдни примеры с указателем не доказывают доступность с клавиатуры или через вспомогательные технологии.
  • Нужна проверка жизненного циклаПроверьте API контроллеров и очистку обработчиков событий в реальном приложении.

Что подготовить

  • Иерархия сценыУкажите выбираемые меши и экземпляры.
  • Расположение холстаПредоставьте реальное встроенное представление и активную камеру.
  • Поведение вводаОпишите навигацию, манипуляции, касания и альтернативные способы управления.

03 Важные решения

Важные решения

  1. Точная нормализация

    Координаты относительно холста не дают выбору смещаться внутри макета страницы.

  2. Владение взаимодействием

    Отключение конкурирующих контроллеров даёт каждому жесту одну чёткую задачу.

04 Пример задания

Попробуйте узкое задание

Приведённое ниже задание не тестировалось. Перед использованием проверьте настройку навыка.

Проверьте настройку

Используйте нужный каталог threejs-skills как руководство для агента. Это не среда выполнения Three.js, и он не устанавливает ресурсы сцены.

Исходный файл в upstream
https://github.com/CloudAI-X/threejs-skills/blob/b1c623076c661fc9b03dac19292e825a5d106823/skills/threejs-interaction/SKILL.md

Рабочий проект Three.js и рендерер; сверяйте примеры из источника с установленной версией. Дополнительные контроллеры и загрузчики зависят от выбранного подхода.

Начните с одного результата

Перед запуском навыка адаптируйте объём, исходные материалы и ограничения в этом задании.

Пример задания
Используйте threejs-interaction, чтобы добавить выделение в этот встроенный просмотрщик продукта. Выполняйте raycast только по перечисленным частям, используя координаты относительно холста. Подсвечивайте выбранную часть и не допускайте конфликта orbit-контроллеров с перетаскиванием объекта. Отдельно опишите альтернативу для клавиатуры.

Проверьте результат

Сверьте фактический результат с этими наблюдаемыми критериями.

  • Выбор остаётся точным после изменения макета.
  • Перетаскивание не вращает камеру.
  • Старые подсветки и обработчики обрабатываются явно.

OpenDesign предоставляет локальное дизайн-пространство для кодинг-агентов. Эта запись не означает, что навык включён в поставку или что внешние инструменты, учётные данные и программные зависимости входят в комплект.

05 Источник и лицензия

Источник и лицензия

Эта страница описывает зафиксированную ревизию источника по ссылке ниже. Поведение и требования upstream могут измениться.

Владелец источника
CloudAI-X
Репозиторий
CloudAI-X/threejs-skills
Лицензия
Не подтверждено — перед повторным использованием изучите условия upstream.
Проверенный снимок
2026-10-07 · b1c623076c66
Редакционное резюме источника
Выбор объектов лучом, преобразование координат, управление камерой, выделение и манипуляции с объектами.

Оригинальное резюме OpenDesign на основе указанного источника. Звёзды репозитория — датированный показатель популярности, а не использование навыка и не оценка качества.

06 Вопросы перед началом

Вопросы перед началом

Различает ли он экземпляры?

Документированный результат пересечения включает instanceId для InstancedMesh.

Почему клики могут не попадать во встроенный холст?

Одна из возможных причин — использование размеров окна вместо прямоугольника холста.

Охватывает ли он только навигацию orbit?

Нет. Он рассматривает несколько моделей управления камерой, а также перетаскивание и трансформации объектов.

OpenDesign

Оставьте место для следующей итерации дизайна.

Храните задание, исходные материалы и дизайнерскую работу вместе в локальном пространстве. Перед добавлением навыка в рабочий процесс проверьте его собственную настройку.

Исходный файл в upstream
https://github.com/CloudAI-X/threejs-skills/blob/b1c623076c661fc9b03dac19292e825a5d106823/skills/threejs-interaction/SKILL.md