> ## Documentation Index
> Fetch the complete documentation index at: https://elytopia.kidsgames.pro/llms.txt
> Use this file to discover all available pages before exploring further.

# Unity

## Шаг 1. Скачать и импортировать SDK

Установить SDK можно любым из способов ниже на выбор

<AccordionGroup>
  <Accordion title="Установка через Package Manager">
    #### Unity 2019.3 и новее

    1. Открой Package Manager (**Window > Package Manager**)
    2. Нажми кнопку `+`  в верхней левой части окна, и выбери пункт `"Add package from git URL..."`
    3. Введи следующий URL и нажми кнопку `Add`

    ```
    https://github.com/Elytopia-Studio/ElytopiaSDK-Unity.git
    ```
  </Accordion>

  <Accordion title="Установка через  .unitypackage файл">
    1. Скачай актуальный `elytopia-sdk.unitypackage` с GitHub по ссылке

           <Card title="Elytopia-SDK Unity / GitHub" horizontal="false" href="https://github.com/Elytopia-Studio/ElytopiaSDK-Unity/releases" />
    2. В Unity-проекте с игрой открой меню **Assets > Import Package > Custom Package** и выбери скаченный `elytopia-sdk.unitypackage`
    3. В появившемся окне **Import Unity Package** убедись, что все необходимые файлы выбраны, и нажмите **Import**
  </Accordion>
</AccordionGroup>

***

## Шаг 2. Показ рекламы

<Card title="Требования к показу рекламы" icon="badge-check" horizontal href="https://elytopia.kidsgames.pro/Requirements/ads" />

### Interstitial реклама

```csharp theme={null}
using Elytopia;

ElytopiaSDK.Instance.ShowInterstitialAdAsync();
```

<Note>
  Реклама запускается не при каждом показе рекламы. Система Elytopia сама определяет, когда пользователь готов к просмотру новой рекламы, поэтому не стесняйтесь указывать как можно больше вызовов рекламы
</Note>

***

## Шаг 3. Внутренние покупки

<Card title="Требования к внутренним покупкам" icon="badge-check" horizontal href="https://elytopia.kidsgames.pro/Requirements/iaps" />

### Совершение покупки

```csharp theme={null}
using Elytopia;

// Запрос на покупку
ElytopiaSDK.Instance.PurchaseProduct("PRODUCT_ID"); 

// Подписки на статус покупки
ElytopiaSDK.Instance.PurchaseSuccessEvent += SuccessPurchased; 
ElytopiaSDK.Instance.PurchaseFailedEvent += FailedPurchased;

// Обработка успешной покупки
void SuccessPurchased(string id)
{
    if (id == "PRODUCT_ID")
        MyGame.AddMoney();
    else if (id == "PRODUCT_ID2")
        MyGame.AddWizzrd();
    else if (id == "PRODUCT_ID3")
        MyGame.AddGold();
}

// Обработка неудачной покупки
void FailedPurchased(string id)
{
    // Например, можно открыть уведомление о неуспешной покупке
}
```

***

## Шаг 4. Размещение готовой сборки

Чтобы мы могли разместить вашу игру, нужно использовать WebGL-шаблон Elytopia последней версии

<Info>
  Шаблон импортируется автоматически при первом импорте ElytopiaSDK. По умолчанию автоимпорт шаблона включён. Чтобы включить или отключить его вручную, перейдите в:

  Tools -> ElytopiaSDK -> Enable/Disable Auto Install WebGL Template
</Info>

1. `Edit` -> `Project Settings` -> `Player` ->` Resolution and Presentation` -> `WebGL Template` -> `Elytopia [version]`

   <Info>
     Если по каким-либо причинам шаблон отсутствует, вы можете установить его вручную: `Tools` ->`ElytopiaSDK`-> `Install WebGL Template`
   </Info>
2. Заархивировать сборку **строго** в формате ZIP
3. Структура архива должна выглядеть так, без промежуточных папок

```plaintext theme={null}
webgl_game_name_build.zip
├── Build/
├── index.html
├── TemplateData/
└── ...
```

***

Все готово! После выполнения перечисленных шагов ваша WebGL-игра будет корректно работать в хабе Elytopia. Если возникнут дополнительные вопросы, обратитесь к документации или в службу поддержки.

<Info>
  Если ты нашел баг или хочешь предложить улучшение — пиши на почту [hello@kidsgames.pro](mailto:hello@kidsgames.pro) Будем рады помочь и сделать Elytopia ещё удобнее для разработчиков!
</Info>