# Существующие плагины и как с ними работать
\
В статье "работа с доступными плагинам"и был описан процесс добавления и использования доступных плагинов. Но возникает вопрос - какие плагины доступны и что они делают.
Разбираться плагины будут по порядку их нахождения в окне **Extensions → Recent**.
## Head Avatar
Создает 3D-модель головы по одной фотографии лица человека (селфи).
### Пример сцены
Отсканируйте этот QR-код, чтобы увидеть сцену с этим плагином.
### Как использовать
Чтобы установить плагин, нажмите на плагин. Откроется окно с его описанием.
В открывшемся окне нажмите кнопку **Install**.
Далее, для добавления объекта, нужно нажать на **+** рядом с добавленным плагином в блоке **Objects** слева.
Откроется окно добавления объекта.
В данном случае для плагина **Head Avatar** необходимо добавить изображение (с вашего устройства). На изображении должно быть лицо человека (хотя бы одно). Размер фотографии должен быть не более **5 МБ** и в формате **JPG**.
{% hint style="danger" %}
ВАЖНО: Лицо на изображении должно быть отчетливо видно. Желательно — фотография лица в анфас, без перекрытия его посторонними объектами (волосы, маска, руки и так далее). Так же, в идеально должно быть равномерное освещение.
{% endhint %}
Ниже приведены примеры входного изображения и полученного 3D-аватара головы. Это прекрасно иллюстрирует, как будет выглядеть аватар из плохого и хорошего изображения.
Пример **хорошего** изображения (лицо отлично видно, освещение равномерное):
Пример **плохого** изображения (лицо закрыто маской и волосами, а также неравномерное освещение):
После выбора изображения начнется обработка. Вы увидите зеленую сферу на сцене.
После обработки изображения (через некоторое время) вместо сферы появится 3D-голова.
## Spine Animation
Этот плагин позволяет использовать 2D-анимацию, созданную в Spine, в сценах **MyWebAR**.
### Пример сцены
Отсканируйте этот QR-код, чтобы увидеть сцену с этим плагином.
### Использование
Чтобы установить плагин, нажмите на плагин. Откроется окно с его описанием.
В открывшемся окне нажмите кнопку **Install**.
Далее, для добавления объекта, нужно нажать на **+** рядом с добавленным плагином в блоке **Objects** слева.
Откроется окно добавления объекта.
{% hint style="warning" %}
Текущая версия плагина поддерживает версию 3.8:
Пользователи должны экспортировать анимацию Spine с помощью редактора Spine, совместимого с этой версией.
В текущей версии плагина пользователи могут использовать только одну анимацию Spine в одном проекте.
{% endhint %}
Как можно заметить, для добавления объекта нужны 3 файла:
1. **Spine Sprite**: формат PNG,
2. **Spine JSON**: формат JSON,
3. **Spine Atlas**: формат TXT или ATLAS.
Кроме того, объект имеет пять параметров:
* **Animation Name** — название анимации
* **Opacity** — прозрачность объекта.
* **Frame Scale** — масштаб объекта. Увеличивая данное значение, у объекта будет улучшаться качество (до определенного значения) и его размер.
* **Frame Offset X** — сдвиг объекта относительно оси X.
* **Frame Offset Y** — сдвиг объекта относительно оси Y.
{% hint style="danger" %}
ВАЖНО: Загружаемые объекты обязательно должны иметь название **skeleton**.format (например, *skeleton.atlas*).
В случае, если название файла другое(например, ***spine.png***) — объект не будет работать.
Пример корректных названий:
{% endhint %}
После выбора изображения начнется обработка. Вы увидите зеленую сферу в сцене.
После обработки и преобразования объекта — 2D-анимация появится на сцене (сама анимация работает только в дополненной реальности или в окне предварительного просмотра).
## Ready Player Me
Создает настраиваемый 3D-аватар человека с полным телом с помощью Ready Player Me и добавляет его в проект MyWebAR.
### Пример сцены
Отсканируйте этот QR-код, чтобы увидеть сцену с этим плагином.
### Использование
Чтобы установить плагин, нажмите на плагин. Откроется окно с его описанием.
В открывшемся окне нажмите кнопку **Install**.
Далее, для добавления объекта, нужно нажать на **+** рядом с добавленным плагином в блоке **Objects** слева.
Откроется окно добавления объекта. В данном окне вы будете пошагово создавать аватар.
Первое, что вам нужно сделать, это выбрать тип тела (по половому признаку).
Далее необходимо загрузить свое изображение (или сделать селфи).
Выбранная фотография появится в окне предварительного просмотра. Чтобы продолжить, нажмите кнопку **Accept**.
Аватар начнет загружаться и обрабатываться. Вам нужно подождать определенное время.
После обработки вы увидите получившийся 3D-аватар. Кроме того, вы можете изменить его по своему усмотрению.
Для продолжения нажмите кнопку **Next**.
Следующий шаг - создать учетную запись, чтобы сохранить полученный аватар, или просто продолжить, нажав на кнопку **Continue without signup**.
После того как аватар будет обработан, он появится на сцене.
## Occlusion Cylinder, Cube, Sphere, Cone
Плагин окклюзии позволяет маскировать поверхности физического объекта таким образом, чтобы виртуальные объекты не появлялись поверх них, когда они находятся за объектом в вашей сцене.
Примером использования этого плагина является сцена портала.
### Пример сцены
Отсканируйте этот QR-код, чтобы увидеть сцену с этим плагином.
{% hint style="info" %}
В этом примере показана сцена с порталом.
О том, как сделать подобную сцену, читайте здесь.
{% endhint %}
### Использование
Чтобы установить плагин, нажмите на плагин. Откроется окно с его описанием.
В открывшемся окне нажмите кнопку **Install**.
Далее, для добавления объекта, нужно нажать на **+** рядом с добавленным плагином в блоке **Objects** слева.
Откроется окно добавления объекта.
После нажатия кнопки **Save** объект появится в сцене. Это будет геометрический полупрозрачный объект (он будет невидим в дополненной реальности). Этот объект будет маскировать все, что находится внутри него, а также за ним (при определенном угле).
Перейдя к предварительному просмотру сцены, можно увидеть, что 3D-модель аллигатора не будет видна.
## Bloom Effect
Данный плагин создает невидимый объект-шейдер, который вызывает эффект контурного рассеяного свечения объекта.
### Пример сцены
Отсканируйте этот QR-код, чтобы увидеть сцену с этим плагином.
### Как использовать
Чтобы установить плагин, нажмите на плагин. Откроется окно с его описанием.
В открывшемся окне нажмите кнопку **Install**.
Далее, для добавления объекта, нужно нажать на **+** рядом с добавленным плагином в блоке **Objects** слева.
Откроется окно добавления объекта. Здесь можно увидеть три параметра.
Параметрами данного плагина являются:
* **Strength** — сила (мощность) свечения,
* **Radius** — размер свечения (при значении 0 — свечение максимально),
* **Threshold** —пороговое значение, которое решает, какие фрагменты будут светиться.
Нажатие кнопки **Save** добавляет шейдер в сцену.
Чтобы увидеть, как это работает, необходимо перейти к просмотру дополненной реальности (или окно предварительного просмотра).
## Shadows
Благодаря этому плагину у вас есть возможность создавать тени различных объектов на сцене.
### Пример сцены
Отсканируйте этот QR-код, чтобы увидеть сцену с этим плагином.
### Как использовать
Чтобы установить плагин, нажмите на плагин магазине расширений. Откроется окно с его описанием.
В открывшемся окне нажмите кнопку **Install**.
Далее, для добавления объекта, нужно нажать на **+** рядом с добавленным плагином в блоке **Objects** слева.
Откроется окно добавления объекта. Здесь можно увидеть целых шесть настраиваемых параметров.
Параметрами данного плагина являются:
* **Debug** — при включении этой опции появится вспомогательный куб, который поможет визуализировать объем тени,
* **Shadow Opacity** — непрозрачность тени (при значении *1* — тень будет полностью черной),
* **Shadow Near** и **Shadow Far** — глубина объема тени, включив режим **Debug**, можно увидеть вспомогательный куб для более тонкой настройки этих параметров,
* **Shadow Resolution** — разрешение карты теней (автоматически масштабируется до ближайшей степени двойки), *минимальное* значение — *128*, *максимальное* — *2048*, примеры значений: *128*, *256*, *512*, *1024*, *2048*,
* **Shadow Volume** — параметр, влияющий на ширину и высоту объема тени, при малом значении тень получается с четкими границами, при большем — границы размываются.
Нажатие кнопки **Save** добавляет плагин создания тени на сцену.
Изменяя местоположение плагина **Shadows**, вы можете управлять расположением тени и ее размером.
{% hint style="info" %}
Вы можете заметить, что оси, взаимодействующие с объектом, также отбрасывают тень. Об этом не стоит беспокоиться, поскольку в дополненной реальности вы не сможете увидеть оси.
{% endhint %}
Чтобы увидеть, как плагин работает в дополненной реальности, можно переключиться в режим предварительного просмотра, нажав кнопку **Preview**.
