Мы добавили новый раздел документации FAQ — 🎁 Маленький подарочек для новичков в использовании PluginYG 🙂

С наступающим! 🎄 Надеюсь, у вас есть новогоднее настроение 🎄

В разделе FAQ можно найти ответы на часто задаваемые вопросы и решения популярных проблем.

FAQ написал наш незаменимый злодей @MOPE4ok — сердце чата, в котором мы обсуждаем PluginYG, Яндекс Игры и Unity.

🎄 С НОВЫМ ГОДОМ 2️⃣0️⃣2️⃣6️⃣

Эй, дружище, хватит спать в салате!
Весело отметил новый год!
Но сегодня наступает дата,
Чтоб прочесть наш годовой отчёт!

~10 обновлений плагина
~35 обновлений модулей
8 новых платформ, помимо Яндекс Игр

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

Более трёх лет мы строим мост между вашими играми и Yandex Games, а сейчас уже и между другими площадками. Мы активно и открыто общаемся с сообществом, с вами. Помогаем решать проблемы и не оставляем в трудную минуту. Мы вместе с вами развили PluginYG до высочайшего уровня. Огромное количество функционала, в котором всё продумано и отточено до мельчайших деталей. Мы рады, что смогли дать инструменты и помощь тысячам людей! Спасибо, что вы с нами! 🎄

✔️ Обновление 2️⃣🔣0️⃣0️⃣8️⃣

• Скорректирован index.html для предотвращения возможного появления полосы прокрутки.

• В окне контроля версий добавлены разделы, которые сортируют модули и платформы.

• Общая доработка системы контроля версий.

• В настройках платформы теперь удобнее просматривать значения полей.

• Добавлена опция AutoDefineSymbols в настройках плагина (basic settings). Теперь можно выключить автоматическую корректировку списка Define Symbols от плагина, если это потребуется.

• Рефакторинг UtilsLang.cs в модуле локализации.

📋 Документация | Сайт
📱 Чат, где можно задать вопрос
⚡️ Boosty (платные ресурсы и поддержка разработчика)

⬇️ Скачать последнюю версию
🦾 Unity Asset Store
🐱 GitHub
(Обновляйте плагин через инструмент контроля версиями)

🅰️ Яндекс Игры обновили проверку автоопределения языка, что это значит для пользователей PlugunYG?

В плагине есть опция Set Language Mod в настройках модуля Localization. По умолчанию выбран режим "При каждом запуске" - это означает, что автоопредиление языка будет происходить при каждом запуске игры. Какой язык даст SDK YandexGames, такой язык и будет. Но если в игре есть настройка, которая позволяет вручную выбрать язык, логично сохранять выбор пользователя и при последующих запусках игры включать тот язык, который пользователь предпочёл раньше. Однако настройка "При каждом запуске" не сохраняет выбор игрока и при каждом новом запуске игры язык снова переопределяется.

В связи с обновлением требований Яндекс Игр, теперь вы можете выбрать режим Set Language Mod: "Только при первом запуске". В таком случае язык будет автоматически определён только при первом запуске игры. Если пользователь поменяет язык в настройках вашей игры, то PluginYG запомнит выбор пользователя и при следующем запуске игры, язык включится тот, что вручную выбрал игрок.

✏️ Может быть полезно:

📌 Для переключения языка в игре вы можете использовать метод:
YG2.SwitchLanguage(string язык)

📌 В модуле Auto Translate Langs есть секретик, скрипт Graphic Settings YG - готовое решение для выбора языка. Оно отлично работает, но изначально не планировалось для большого функционала и открытого доступа. У скрипта есть проблемы с архитектурой как и у модуля Auto Translate Langs, по этому их поддержка прекращена. Но они остаются стабильными и вы всё еще можете их использовать.

📌 Как в настройках игры должна выглядеть опция выбора языка. Кнопки для выбора того или иного языка не нужно переводить на тот язык, который выбран в текущий момент. Например, если это кнопка для выбора английского языка, на ней должно быть написано English английским языком, не нужно переводить её как "Английский", если текущий язык в игре русский.

Правильно (представьте, что это кнопки):
Русский, English, Türk, 中文

Не правильно:
Русский, Английский, Турецкий, Китайский

🔠🔠🔠🔠🔠🔠💡2️⃣🔣0️⃣0️⃣9️⃣

• На мобильных устройствах недавно начал встречаться баг, при котором после закрытия рекламы за вознаграждение, фокус не возвращался к игре до момента касания области игры. Внесены корректировки в html.

• Новый метод PauseGameYG.SetState(timeScale, audioPause, cursorEnable)
Избавьтесь от проблем с фокусом игры используя один универсальный метод. Он точно синхронизирует состояния сочетая их с паузой игры во время просмотра рекламы и при других обстоятельствах. А также, вы больше не запутаетесь в каком скрипте изменяется timeScale или что то ещё, просто посмотрите ссылки, в каких местах вызывается метод SetState.
Подробнее в новом разделе документации «Пауза и фокус»

• Новая опция Auto Pause Game → Edit Time Scale. Даёт возможность выключить вмешательство в Time Scale при автоматической паузе. Особенно полезно для игр с мультиплеером.

• В настройках General Simulation новая опция Enable Inter Adv. Позволяет полностью выключить симуляцию межстраничной рекламы в Unity Editor.

• В настройках General Simulation новая опция Pause On Focus Game. Симулирование паузы в Unity Editor при смене фокуса.

• В css внесено пару строк, которые могут помочь исправить «чёрный экран» на мобильных устройствах.

• Доработки в Editor скриптах связанные с контролем версий.

• Фикс бага с вызовом onPurchaseSuccess, даже если в ConsumePurchaseByID передан false.

• Теперь в модуле AutoTranslateLangs перевод текстов с помощью API Google Translate производится без потери текста после точки или красной строки.

• Небольшое обновление js кода в модуле Authorization. Обратите внимание, сейчас на ЯИ наблюдается всплывающее окно с ошибкой, если при попытке войти в аккаунт, пользователь в итоге откажется от входа. Исправить ситуацию не удалось, рекомендую пока не делать кнопку авторизации в игре.

📋 Документация | Сайт
📱 Чат, где можно задать вопрос
⚡️ Boosty (платные ресурсы и поддержка разработчика)

⬇️ Скачать последнюю версию
🦾 Unity Asset Store
🐱 GitHub
(Обновляйте плагин через инструмент контроля версиями)

➕ Новый модуль платформы EmptyWebGL для тестирования игры.
Смотрите подробнее в документации, в разделе «Начало работы» → спойлер «Локальный хост, размещение на своём сервере, модуль EmptyWebGL.»

😐 Обновление PluginYG v2.0091

Правка в index.html в связи с сообщением из сообщества о том, что последние изменения в версии 2.009 могут препятствовать корректной работе виртуальной клавиатуры на мобильных устройствах.

В последних версиях Unity 6 мог не выводиться лог с отображением информации после сборки проекта. Теперь код адаптирован под новые версии Unity 6.

📋 Документация | Сайт
📱 Чат, где можно задать вопрос
⚡️ Boosty (платные ресурсы и поддержка разработчика)

⬇️ Скачать последнюю версию
🦾 Unity Asset Store
🐱 GitHub
(Обновляйте плагин через инструмент контроля версиями)

😐 Обновление PluginYG v2.0092

• Исправлена проблема со сбросом макета редактора Unity при инициализации окна настроек плагина.
• Исправлено всплывающее окно «Сводка обновлений», игнорирующее параметр «Не показывать больше».
• Другие оптимизации на стороне редактора.

Как обновиться, если вы вносили изменения в код плагина:
1. На Github перейдите к списку Commits, выберите коммит/коммиты с обновлением до последней версии и посмотрите какие скрипты были изменены.
2. Скачайте unitypackage по ссылке ниже или из Releases на Github.
3. При импорте пакета, отметьте только те файлы, которые были обновлены в коммитах и которые не затрут ваши изменения.
Также можно посмотреть, что было изменено в конкретных скриптах. А лучше при активных изменениях плагина создать свой форк.

📋 Документация | Сайт
📱 Чат, где можно задать вопрос
⚡️ Boosty (платные ресурсы и поддержка разработчика)

⬇️ Скачать последнюю версию
🦾 Unity Asset Store
🐱 GitHub
(Обновляйте плагин через инструмент контроля версиями)

✔️ Модуль Yandex Mobile ADS обновлен, версия 1.1

• Теперь модуль использует API 8 версии SDK Яндекс Рекламы для мобильных приложений.
Новый SDK Яндекса по заявлениям весит меньше на 30% для Android и на 15% меньше на IOS.

• Добавлена опция Yandex Mob Auto Load Ads в настройки платформы. По умолчанию она включена и при выполнении метода вызова рекламы, плагин сам будет загружать рекламный блок. Больше не придётся писать отдельный код для данного модуля, используя метод загрузки баннера и подписку на событие загрузки. Подробнее в документации.

• Упразднена опция устанавливающая признак возрастного ограничения пользователя. Добавлены новые методы в класс optionalPlatform: SetUserConsent и SetAgeRestricted. В документации обратите внимание на раздел "Конфиденциальность пользователя".

• Обновлена документация к модулю.

⚡️ Модуль платформы доступен на Boosty

🔠 Новый модуль TextGameLoad

Позволяет отобразить текст при загрузке игры с переводом на разные языки.

Как думаете, если написать «Пожалуйста, подождите🥺», то игроки действительно подождут?)

Документацию к модулю ищите в разделе «Шаблон», глава «Текст при загрузке игры».

📋 Документация | Сайт
📱 Чат, где можно задать вопрос
⚡️ Boosty (платные ресурсы и поддержка разработчика)

⬇️ Скачать последнюю версию плагина
🦾 Unity Asset Store
🐱 GitHub
(Обновляйте плагин через инструмент контроля версиями)

❗️Обнаружен баг❗️

❓Что за баг

Игра может полностью зависнуть при запуске после перезагрузки страницы (при первом открытии страницы бага нет). И если скрыть загрузочный экран Яндекс Игр кликом по нему, бага тоже не будет. Если при зависшей игре переключить вкладку на другую и снова вернуться на вкладу игры (убрать и вернуть фокус), то игра развисает.

🔧Как исправить

Баг наблюдается на определённом промежутке версий Unity. Явно выявлены версии 6.4.4 и 6.5.5. При этом в версии 6.5.7 на данный момент рекомендуемой самой Unity баг уже не наблюдается (v6.5.7 не поддерживает built-in render pipeline). В версии 6.3.8 проблемы нет (но это не значит, что все версии 6.3 могут не иметь бага).

✍️ Давайте в комментариях под этим постом соберём больше информации, какие версии имеют баг, а какие нет.

Лучший способ для исправления бага — это обновить Unity, но также проблему можно решить любым из следующих способов:

1. Включить опцию Run In Background в Project Settings → Player → Resolution and Presentation и деактивировать переопределение данной опции плагином в настройках платформы Яндекс Игры. Либо наоборот включить переопределение плагином и соответственно включить Run In Background внутри настроек платформы.

2. Включить опцию Show Splash Screen в Project Settings → Player → Splash Image.

3. Включить опцию Sync Init SDK в настройках плагина (стоит ознакомиться с этой опцией перед её включением в всплывающей подсказке при наведении на параметр).

🎮 Обновление модуля YandexGames 1.01

✔️ Улучшена обработка очереди сообщений паузы и возобновления игры в index.html. Это должно убрать баг зависания после перезагрузки страницы. Но пока всё ещё не забываем проверять наличие такого бага в своих проектах. Пишите в чат, если столкнулись с проблемами.

⚡️ Теперь тестирование WebGL-сборки на Яндекс Играх станет молниеносным! Платформа предоставляет возможность запускать локальный билд в production-окружении. Теперь PluginYG умеет это делать прямо в Unity. Так можно быстро проверить игру с подключенным SDK на сайте Яндекс Игр, не загружая архив в черновик и не дожидаясь его обработки. Перед отправкой на модерацию обязательно протестируйте игру и после загрузки архива в черновик.
Подробнее в документации