📖 Часто Задаваемые Вопросы (PluginYG)

Q. Я собрал билд игры, загрузил на Яндекс Игры, но она не запускается. Что делать?

A. Откройте консоль браузера (Chrome: F12 или CTRL+SHIFT+I. Вкладка "Console") и посмотрите внимательно на строки выделенные красным цветом и изучите их. Одна из этих строк, ваша ошибка.

Q. Я использую движок Construct\Unreal\Godot\Cocos и у меня возникли трудности с ЯндексSDK. Сможете помочь?

A. PluginYG написан для игрового движка Unity и мы не знаем чем вам помочь.

Q. Хочу проверить работу смены языка в игру. Как это сделать?

• Можете воспользоваться пунктом Language, секцией Player Info Simulation, из скрипта InfoYG.

• Также, можете изменить прификс языка в адресной строке черновика на Яндекс Играх.

Q. Модерация отклонила игру и до следующей возможности подать игру на модерацию надо ждать n-дней. Могу я создать новый черновик и отправить игру на модерацию из него?

A. Нет, так делать нельзя. В конечном итоге ваш аккаунт могут заблокировать.

Q. Загрузил архив с игрой в черновик, а она не запускается по ссылке. Как её запустить?

A. Заполните все поля черновика.

Q. Нужно-ли, сейчас, при сборке билда включать опцию "Decompression Fallback"?

A. Нет. Теперь в этой опции нет необходимости, всё будет работать без неё.

Q. Опубликовал игру, но в ней нет стики баннеров. Как их включить?

A. Ждите. Баннеры появляются в течении нескольких часов, после публикации игры.

Q. Установил плагин версии 1.6.1 (или старше) - появилась ошибка в консоли, связанная с методом "FindAnyObjectByType()". Как исправить?

A. Поддержка этих методов появилась, в Unity, начиная с версии 2021.3.18f1 и старше.

Q. Как правильно обновить плагин?

A. Необходимо удалить папки "YandexGame" и "WebGLTemplates". Также удалите файлы "YandexMetricaPlugin" и "yandexProvider" из папки "Plugins", если они есть.

Если Вы импортируете плагин в проект не первый раз, Вы можете убрать галочку напротив папки "YandexGame", находящейся в папке "WorkingData", чтобы не слетели Ваши сохранения и настройки плагина, если таковые имеются.

Q. При сворачивании\переключении вкладки с игрой, звук продолжает воспроизводиться. Как исправить?

A. Убрать галочку на пункте "Run In Background", в "Player Settings\Resolution and Presentation".

Q. Плеер (звуковой), из игры запущенной в браузере, отображается в панели уведомления (шторке) телефона. Как исправить?

A. У звуковых файлов (звуков), в Unity, установить параметр "Load Type" - "Decompress On Load".

Q. Нужно ли мне что то прописывать в HTML?

A. Нет. Для работы плагина Вам не нужно заходить в html и css скрипты. Но для собственного расширения функционала, конечно, вы можете что то изменять в любых скриптах плагина.

Q. Как узнать устройство, с которого запущена игра?

A. Нужно получить данные об устройстве (смотрите раздел 🔗“Данные”). Данные можно получать только после инициализации SDK (смотрите раздел 🔗“Инициализация”).

Q. Ошибки при импорте плагина. Как исправить?

1. В проекте отсутствует библиотека Newtonsoft Json.net (Смотрите раздел 🔗“Импорт плагина”).
2. Не корректно настроен компонент Graphic Settings YG (Смотрите раздел 🔗“Настройки графики от плагина”)
3. Иные ошибки могут быть из-за устаревшего ПО. Плагин работает на Unity 2021 версиях и выше.
4. Редактор кода не поддерживает синтаксис плагина. В таком случае может помочь обновление программы редактора кода или её замена.
5. Может помочь удаление папки "Library".

Q. Не билдится проект (билд происходит с ошибкой). Как исправить?

1. Не выбран или слетел шаблон плагина. (Смотрите раздел 🔗“Выбор WebGL шаблона“). Так же может помочь переоткрытие меню "Project Settings", перезапуск Unity, удаление папки "WebGLTemplates" и её реимпорт. Или всё это, вместе взятое, в разной последовательности… К сожалению, в Unity не очень стабильно работают WebGL шаблоны.
2. Неправильно настроен проект. Вы можете найти рекомендации по настройке и оптимизации проекта в 🔗видео плагина и на Trello. (Смотрите раздел 🔗“Ссылки”). Настройки проекта находятся в "Project Settings\Player". Ниже представлены скриншоты с примером настроек проекта. Красным цветом отмечены - необходимые параметры, жёлтым - рекомендуемые:

Q. Крашится игра\вечная загрузка при тестировании проекта в черновике Яндекса. Как исправить?

1. Не выбран или слетел шаблон плагина. (Смотрите раздел 🔗“Выбор WebGL шаблона”).
2. Использование методов и данных плагина до инициализации SDK. Необходимо инициализировать данные в соответствии с документацией. (Смотрите раздел 🔗“Инициализация”)
3. Не правильно настроен проект. (Смотрите вопрос "Не билдится проект (билд происходит с ошибкой). Что делать?")
4. Возможно, по какой то причине, вам нужно установить задержку перед инициализацией SDK. За это отвечает параметр "SDK Start Delay" в файле настроек плагина "InfoYG". Читайте описание данного параметра во всплывающей подсказке при наведении.
5. Убедитесь, что билд упакован в ZIP архив и целостность файлов внутри не нарушена.
6. Убедитесь, что Вы делаете билд в правильную папку и что Вы заливаете именно тот билд, что планировали.
7. Грузится Ваш старый, не рабочий билд (если таковой имелся). Требуется очистка кеша браузера, что бы запускался свежезалитый билд. Для Яндекс Браузера достаточно просто полностью закрыть браузер и открыть снова.

Q. Не отображается шрифт в WebGL билде. Как исправить?

A. Нельзя использовать дефолтный Unity шрифт, который по умолчанию назначен в компоненте текста. Нужно использовать какой-либо сторонний шрифт, который находится в проекте как файл, и назначить шрифт в компоненты текста.

Или, если Вы используете локализацию от плагина, в настройках "InfoYG" назначьте default шрифт в массиве шрифтов, тогда плагин сам будет применять данный шрифт в игре.

Q. Нет звука на мобильном устройстве?

A. В игре на Unity звук может не работать в Яндекс браузере, Opera и других. Смотрите в сторону плагина 🔗AudioYB. Так же, возможно, звуки будут исправно работать, если использовать 🔗FMOD (Требуется не только ассет, но и программа FMOD).

Q. Не отображается ник или аватар игрока?

A. Должны быть включены данные параметры:

Если при включённых параметрах всё же не отображаются ник и аватар, значит:

1. При первом запуске игры в открывшемся окне не было дано разрешение на использование личных данных аккаунта.
2. Вышеописанное окно по каким то причинам не было показано и разрешение не было получено.

При любом из вариантов нужно попробовать протестировать черновик через другой аккаунт. Может быть поможет чистка кеша браузера или запуск игры в другом браузере.

Q. Можно использовать Unity ниже 2021 версии?

A. Для этого Вы можете использовать версию плагина 0.4.4. В ней меньше функций, но она рабочая.

Q. Как сделать вертикальную ориентацию экрана, изменить прогресс бар?

1. Найдите файл "style.css", в нём прописаны такие данные. В css файле можно сменить соотношение экрана, размеры прогресс бара, его цвет. Более подробную информацию можно найти в поиске по 🔗чату группы этого плагина или в интернете.
2. Также есть 🔗сторонние шаблоны.

Q. Не работает авто-локализация. Как заставить её работать?

1. Необходимо активировать автолокализацию в файле настроек плагина "InfoYG". Для этого имеется соответствующая кнопка.
2. Включите разрешение загрузки по протоколу HTTP для Unity Editor в "Project\Settings\Player\Allow downloads over HTTP".
3. Попробуйте сменить домен (Domain Auto Localization) в файле настроек плагина "InfoYG".

Q. Во время игры частично или полностью не переводится текст. Как это исправить?

A. По какой-то причине слетели ссылки внутри скрипта "Language YG". Чтобы восстановить ссылки, есть метод "Reserialize" в контекстном меню. Нажмите на три точки на компоненте или на правую кнопку мыши и в открывшемся списке, внизу, будет пункт "Reserialize".

⚠️При выполнении "Reserialize" сцена автоматически не сохраняется и не помечается как * (грязная), поэтому требуется дополнительно сохранить проект.

Для исправления всех компонентов не сцене такой метод также имеется в инструменте "Auto Localization Masse". Так же, можно выделить все компоненты на сцене с помощью поиска в иерархии по полному имени компонента "LanguageYG", и сделать "Reserialize" для всех выделенных объектов.

Q. Ошибка: "компонент Language YG не найден". Как исправить?

A. У некоторых появляется ошибка при попытке создания компонента "Language YG". Должно помочь перекомпилирование скрипта "LanguageYG". Как ни странно, помогает переименовывание данного скрипта в “Language”.