#mopsicus: заметки с тегом с# https://mopsicus.ru/tags/csharp/ об играх, разработке на Unity и личном опыте Игорь Лопатин ru E2 (v3572; Aegea) Игорь Лопатин об играх, разработке на Unity и личном опыте FSM для C# 270 https://mopsicus.ru/all/fsm-for-csharp/ Thu, 05 Dec 2024 12:18:04 +0300 Игорь Лопатин https://mopsicus.ru/all/fsm-for-csharp/ <p>Доделал пакет для <a href="https://github.com/mopsicus/shardy">Shardy</a>: реализацию машины состояний (finite state machine). Все стейты и триггеры добавляются через билдер, цепочкой.</p> <div class="e2-text-picture"> <h3 style="display: none;" itemprop="name">Finite state machine</h3><h4 style="display: none;" itemprop="description">Finite state machine</h4><img itemprop="contentUrl" src="https://mopsicus.ru/pictures/fsm-example.jpg" width="781" height="1280" alt="Finite state machine" /> </div> <p>Для перехода на стейт надо активировать триггер(ы):</p> <pre class="e2-text-code"><code class="">fsm.Trigger(Action.Down); fsm.Trigger(Action.Down);</code></pre><p>В таком случае получится такой результат:</p> <blockquote> <p>initial is standing<br /> on exit standing<br /> on enter sitting<br /> on exit sitting<br /> on enter lying</p> </blockquote> <p>Ещё подсмотрел, как сгенерить описание для UML диаграммы и <a href="https://www.planttext.com/">отрендерить её на сайте</a> или <a href="http://www.plantuml.com/plantuml/uml/">на этом</a>, по-моему у них один движок:</p> <div class="e2-text-picture"> <h3 style="display: none;" itemprop="name">FSM UML diagram</h3><h4 style="display: none;" itemprop="description">FSM UML diagram</h4><img itemprop="contentUrl" src="https://mopsicus.ru/pictures/fsm-uml.jpg" width="642" height="272" alt="FSM UML diagram" /> </div> <p class="note">Чтобы сделать диаграмму более «интуитивной», вместо слова state используется ключевое слово agent, этом случае можно рисовать разные линии.</p> <pre class="e2-text-code"><code class="">@startuml skin rose title TestFSM left to right direction agent Standing agent Sitting agent Lying agent Jumping note left of Jumping some help message here end note Start --&gt; Standing Standing --&gt; Sitting : Down Standing ~~&gt; Jumping : Space Sitting --&gt; Lying : Down Sitting --&gt; Standing : Up Lying --&gt; Sitting : Up Jumping --&gt; Standing : Down @enduml</code></pre><p>Ещё к каждому переходу можно добавлять условия, (на картинке выше их нет) об этом подробнее в <a href="https://github.com/mopsicus/shardy-fsm/blob/main/Documentation~/index.md">документации</a>.</p> <p>Если у перехода между состояниями есть условие(я), то линия будет рисоваться пунктирной, а если нет триггера — то с крестиком на конце. Актуально когда состояний и переходов много, можно сгенерить диаграмму и посмотреть нет ли косяков.</p> <p><a href="https://github.com/mopsicus/shardy-fsm">Github</a></p> Shardy 267 https://mopsicus.ru/all/shardy/ Thu, 10 Oct 2024 22:33:59 +0300 Игорь Лопатин https://mopsicus.ru/all/shardy/ <div class="e2-text-picture"> <h3 style="display: none;" itemprop="name">Shardy</h3><h4 style="display: none;" itemprop="description">Shardy</h4><img itemprop="contentUrl" src="https://mopsicus.ru/pictures/logo.png" width="512" height="512" alt="Shardy" /> </div> <p>Друзья, был у меня давно один проект, который претерпел уже наверное 4 или 5 итераций. Этой штукой я пользуюсь на своих пет-проектах и со временем появилось желание сделать из всего этого опенсорсную историю. Поэтому начну из далека :)</p> <p>Давным-давно был такой проект на гитхабе <a href="https://github.com/NetEase/pomelo">Pomelo</a>. По меркам интернета — реально древний, ему больше 10 лет. Он и сейчас там есть, но уже заархивирован и не поддерживается, но форки вроде пилятся. Кто первый раз слышит, это фреймворк для создания игровых серверов на JavaScript и Node.js. Проект довольно большой, куча модулей, клиенты под разные платформы, хорошая дока. Наткнулся я на него несколько лет назад и начал ковырять, запускать, что-то пробовать. В итоге, многие вещи в нём мне понравились, но показалось всё как-то замудрёно что ли. Наверно потому что китайцы писали, а может я в ноду не сильно мог 😅 В общем, оттуда я потягал какие-то скрипты, интересные решения, потом переписал, упростил и, получился у меня такой лайтовый сервер из нескольких файлов, на котором я тестил всякие свои проекты, изучал ноду, яваскрипт и тайпскрипт позднее.</p> <p>Потом решил поделиться своими поделками и выложить на гитхаб. Когда было свободное время что-то дописывал, переписывал и снова забывал, потому что были задачи поважнее. В какой-то момент, переписал всё на TypeScript (TS). К тому времени уже были наработки не только сервера, но и клиента на C# + Unity и всё это дело стало обретать какой-то полезный вид. И вот, в результате n-ой итерации, архитектура устоялась, протестировалась и получился Shardy.</p> <p><a href="https://github.com/mopsicus/shardy">Shardy</a> — это фреймворк для онлайн игр и приложений на Node.js. Он даёт базовую функциональность для построения микросервисных решений: мобильных, социальных, веб, многопользовательских игр, приложений реального времени, чатов, middleware сервисов и т. п. Есть клиент на TS встроенный в фреймворк, а также <a href="https://github.com/mopsicus/shardy-unity">пакет для Unity</a>, который поддерживает сборки под iOS, Android и WebGL. Здесь я говорю микросервисных потому что по задумке, за каждый модуль будет отвечать отдельный Shardy-сервис со своими командами, настройками, возможно БД.</p> <p>Основные фичи:</p> <ul> <li>микросервисная парадигма</li> <li>простой API: RPC, команды, подписки и т. п.</li> <li>транспорт данных через сокеты и вебсокеты</li> <li>легкость и быстрота: Node.js и TypeScript</li> <li>поддержка пользовательской сериализации</li> <li>поддержка пользовательской валидации рукопожатий (handshake)</li> <li>продвинутый логгер: теги, фильтры, области</li> <li>справочные материалы: документация, сниппеты, примеры</li> <li>почти нулевая конфигурация</li> </ul> <p>Есть демка с примерами работы API и простенькая онлайн игра «Крестики-Нолики»: как серверная часть, так и клиентская. Всё можно посмотреть, поковырять, запустить у себя и попробовать поиграть. Весь код старался комментировать, иногда даже излишне. Также есть <a href="https://github.com/mopsicus/shardy/blob/main/docs/index.md">документация</a> с описанием всех компонентов и методов. Это всё в процессе наполнения и улучшения.</p> <p>Основная цель Shardy — предоставить простое бесплатное решение для создания многопользовательских онлайн игр. Вот так вот громко 😅 На это будет обращено основное внимание при дальнейшей разработке новых функций, сервисов и туторов (было бы время...).</p> <p>Не претендую на академическую правильность архитектуры и кода, делал в первую очередь для своих нужд. Но как показал опыт: зачастую многие принципы ООП, чистого кода, использование паттернов в «нужных» местах, разбиваются об реальность конкретного проекта :)</p> <p>Приглашаю всех заинтересованных инди и не только, в подписчиках вроде такие есть, посмотреть, покрутить, примерить, потестить на своих каких-то задачах, играх, проектах, прототипах. Если будут вопросы, отвечу тут в комментах или на почту mail@mopsicus.ru. В личку тоже можно, но могу не заметить или долго отвечать.</p> <p>Вот такое интро. Всем хороших игр! Онлайн игр :)</p> <p><a href="https://github.com/mopsicus/shardy">Shardy</a><br /> <a href="https://github.com/mopsicus/shardy-unity">Shardy for Unity</a><br /> <a href="https://github.com/mopsicus/shardy/blob/main/docs/index.md">Docs</a></p> Unity infinite scroller v2.0 264 https://mopsicus.ru/all/unity-infinite-scroller-v2-0/ Tue, 02 Apr 2024 14:09:54 +0300 Игорь Лопатин https://mopsicus.ru/all/unity-infinite-scroller-v2-0/ <div class="e2-text-picture"> <h3 style="display: none;" itemprop="name">UIS (Unity infinite scroller)</h3><h4 style="display: none;" itemprop="description">UIS (Unity infinite scroller)</h4><img itemprop="contentUrl" src="https://mopsicus.ru/pictures/logo-uis.png" width="896" height="512" alt="UIS (Unity infinite scroller)" /> </div> <p>Обновил скрипт бесконечного списка. Переделал реп в пакет пригодный для Unity, обновил демки, добавил функцию прокрутки к элементу и доку небольшую.</p> <p>Делалось для мобилок, чтобы не тормозило с большим количеством элементов и была привычная функция pull to refresh. Но некоторые используют и в ПК билдах 😄</p> <p><a href="https://github.com/mopsicus/uis">Github</a></p> Unity Mobile Input v2.0 263 https://mopsicus.ru/all/unity-mobile-input-v2-0/ Wed, 27 Mar 2024 14:16:56 +0300 Игорь Лопатин https://mopsicus.ru/all/unity-mobile-input-v2-0/ <div class="e2-text-picture"> <h3 style="display: none;" itemprop="name">UMI aka Unity Mobile Input</h3><h4 style="display: none;" itemprop="description">UMI aka Unity Mobile Input</h4><img itemprop="contentUrl" src="https://mopsicus.ru/pictures/umi-v2.png" width="1468" height="612" alt="UMI aka Unity Mobile Input" /> </div> <p>Обновил свой плагин для создания нативных полей ввода на мобилках. Исправил старые баги, причесал немного код, добавил комменты и обновил демо.</p> <p>Функции:</p> <ul> <li>нативное поле ввода и клавиатура для iOS и Android</li> <li>настройка типа кнопки: Стандартная, Далее, Готово, Поиск, Отправить</li> <li>настройка обработки кнопки</li> <li>настройка кнопкок Готово и Очистить (iOS)</li> <li>изменение опций поля ввода во время выполнения</li> <li>скрытие дополнительного поля ввода (Android)</li> <li>отслеживание появления и скрытия клавиатуры (с высотой)</li> <li>отслеживание ориентации экрана</li> <li>поддержка пользовательских шрифтов</li> </ul> <p>В новой версии добавил несколько методов чтобы можно было менять некоторые параметры во время исполнения:</p> <ul> <li>SetTextColor — изменение цвета текста</li> <li>SetPlaceholderColor — изменение цвета текста подсказки</li> <li>SetBackgroundColor — изменение цвета фона</li> <li>SetContentType — изменение типа поля ввода</li> <li>SetReadonly — изменение состояния «только для чтения»</li> </ul> <p>Устанавливается как пакет через Unity Package Manager.</p> <p><a href="https://github.com/mopsicus/umi">Github</a></p> Герои Гильдгаарда 261 https://mopsicus.ru/all/heroes-of-gildgaard/ Sun, 24 Sep 2023 13:25:31 +0300 Игорь Лопатин https://mopsicus.ru/all/heroes-of-gildgaard/ <div class="e2-text-picture"> <h3 style="display: none;" itemprop="name">Герои Гильдгаарда</h3><h4 style="display: none;" itemprop="description">Герои Гильдгаарда</h4><img itemprop="contentUrl" src="https://mopsicus.ru/pictures/banner.png" width="1500" height="500" alt="Герои Гильдгаарда" /> </div> <p>Запустили в софтлонч нашу первую игру с 3D, логическая онлайн стратегия на 2 или 4 игрока. Для любителей шашек, нард, шахмат, го и прочих настольных игр такого типа, будет интересно. Тут нет рандома, есть несколько стратегий, партии довольно короткие. Написал чуть <a href="https://pikabu.ru/story/geroi_gildgaarda_logicheskaya_onlayn_strategiya_10671660">подробнее на Пикабу</a>.</p> <p>Делали на Unity. Доступно в <a href="https://apps.apple.com/ru/app/id1642705298">AppStore</a>, <a href="https://play.google.com/store/apps/details?id=games.magicboard.hg">Google Play</a> и <a href="https://appgallery.huawei.com/#/app/C106987185">AppGallery</a>.</p> Unity Builder Bot 259 https://mopsicus.ru/all/telegram-bot-builder-unity/ Wed, 08 Jun 2022 20:12:33 +0300 Игорь Лопатин https://mopsicus.ru/all/telegram-bot-builder-unity/ <p>Бот сделан на основе моего старого скрипта из <a href="https://mopsicus.ru/all/custom-ci-cd-unity/">этой статьи</a>.</p> <p>Телеграм бот и расширение редактора для билда Unity проектов. Можно использовать по отдельности, но проектировалось чтобы работало вместе. Все исходники по ссылкам.</p> <div class="e2-text-picture"> <div class="fotorama" data-width="700" data-ratio="0.8816120906801"> <img src="https://mopsicus.ru/pictures/ubh.png" width="700" height="794" alt="Unity Builder Helper" /> <img src="https://mopsicus.ru/pictures/ubh-settings.png" width="700" height="794" alt="Unity Builder Helper settings" /> </div> </div> <p><a href="https://github.com/mopsicus/ubb">Телеграм бот</a> написан на Node.js и Telegraf.js. Может пулить апдейты, запускать билд юнити проекта, билдить Xcode проект (на маке), всё подписывать, загружать на сервер и скидывать ссылку. Билды для iOS тоже можно ставить по ссылке, там подключается манифест разработчика.</p> <p>Основные функции:</p> <ul> <li>добавить проект из Git репозитория</li> <li>удалить проект</li> <li>получить список всех проектов</li> <li>перейти в нужную ветку</li> <li>спулить апдейт</li> <li>сбилдить Unity проект</li> <li>сбилдить Xcode проект</li> <li>скомпилировать, сделать архив, экспорт в IPA</li> <li>сгенерировать HTML страницу с ссылками</li> <li>загрузить все файлы на сервер через sshpass</li> <li>получить логи</li> <li>очистить логи и билды</li> </ul> <p>Это все можно сделать с помощью телеграм, даже не запуская Unity. Каждый этап сборки логируется и уведомляется ботом.</p> <p><a href="https://github.com/mopsicus/ubh">Расширение редактора</a> позволяет быстро переключаться между платформами, включать дефайны, запускать локальный и удаленный билд на боте, подставлять данные для Keystore, нужные зависимости для Huawei, добавлять локализации для iOS, также добавлять сторонние файлы в билд. Есть <a href="https://github.com/mopsicus/ubh-demo">демка</a> с набором файлов и примерной структурой.</p> <p>Основные функции:</p> <ul> <li>изменить платформу</li> <li>установить defines</li> <li>выбрать папку для билдов под каждую платформу</li> <li>изменить версию, номер билда</li> <li>подставить данные для Keystore</li> <li>добавить локали и *.lproj файлы в Xcode проект</li> <li>добавить фреймворки и дополнительные файлы в Xcode проект</li> <li>добавить и применить google-services.json и agconnect-services.json</li> <li>добавить дополнительные файлы в APK</li> <li>пропатчить AndroidManifest.xml</li> <li>пропатчить gradle файлы</li> <li>добавить зависимости для Huawei билда</li> <li>сбилдить Unity проект</li> </ul> <p>Получилось как-то так, думаю кому-то будет полезно и интересно поковырять исходники. Подписывайтесь на <a href="https://t.me/mopsicus_ru">Telegram канал</a>, там посты появляются чаще %)</p> Unity и WebGL 257 https://mopsicus.ru/all/unity-webgl-tips/ Sat, 23 Apr 2022 17:50:39 +0300 Игорь Лопатин https://mopsicus.ru/all/unity-webgl-tips/ <div class="e2-text-picture"> <h3 style="display: none;" itemprop="name">Unity WebGL tips</h3><h4 style="display: none;" itemprop="description">Unity WebGL tips</h4><img itemprop="contentUrl" src="https://mopsicus.ru/pictures/unity-webgl-tips.png" width="1204" height="835" alt="Unity WebGL tips" /> </div> <p>Не от хорошей жизни пришлось делать WebGL версии наших мобильных игр :) Т. е. изначально, игры не продумывалась для браузера, но тем не менее, после небольших доработок и рефакторинга — всё необходимое заработало. Эта статья как раз для тех, кто задумался над выпуском версии для веб: набор из нескольких наблюдений, советов, собственных мыслей и велосипедов.</p> <p><b>Вебсокеты</b>. Так как у нас все игры — онлайн, то первое что сделал — поддержка сети. В мобильных играх у нас используются TCP сокеты, для браузера же надо использовать вебсокеты (WebSocket). И сразу надо сказать: C#’ские вебсокеты работать не будут. Надо брать готовый или писать свой JS плагин. И в качестве примера, в телеграм канале я уже постил <a href="https://github.com/jirihybek/unity-websocket-webgl">этот реп</a>. Он старый, работает и для примера пойдёт. Там кстати сделана поддержка вебсокетов в редакторе (уже через C#’ские). Т. е. можно дебажить и билдить, работать всё будет. В ассетсторе тоже есть разные реализации вебсокетов для WebGL, можно поискать, есть и Socket.IO, Mirror.</p> <p class="note">Да, для WebGL тоже можно и нужно <a href="https://docs.unity3d.com/Manual/webgl-interactingwithbrowserscripting.html">писать плагины</a>, как и для Android и iOS.</p> <p>В общем, в браузере много что работать не будет и особенно всё что связано с мобильной платформой: галерея, авторизация, пуши, буфер обмена, платежи — это всё надо делать или через JS плагины, менять реализацию или вообще отказываться.</p> <p><b>Платежи</b>. Google Play и AppStore не работают в WebGL. В том смысле что нельзя получить информацию о продукте (описание, цена и т. д.) и сделать покупку в браузере. Поэтому мы сделали просто: вместо запроса списка продуктов, делаем запрос к нашему серверу (сервер определяет что клиент WebGL) и в ответ получаем примерно такую же структуру: цена: описание, количество. Но самое главное — приходит ещё и ссылка для оплаты! Т. е. для пользователя визуально всё осталось также, но при попытке оплаты открывается новая вкладка с сформированной ссылкой на оплату нужного товара. А тут уже можно подключить любой удобный сервис приема платежей и по коллбеку успешной оплаты начислять пользователю определенное количество продукта. Вот такие антисанкции.</p> <p><b>Загрузка изображений</b>. Тут проще, в браузерах уже есть встроенный механизм загрузки файлов, его и можно использовать. Вот <a href="https://github.com/greggman/getuserimage-unity-webgl">пример как это реализовано</a>, а на SO можно <a href="https://stackoverflow.com/a/35201934">прочитать</a> как автор до этого дошёл. К слову, этот код рабочий. Немного корявенький, требует рефакторинга, но работает. Картинка приходит в Unity в base64, раскукоживаете её в массив байт и дальше уже что требуется: отправляете на сервер, используйте в игре и т. п.</p> <p><b>Уведомления</b>. Все ненавидят уведомления в браузере. И у нас их скорее всего не будет. Но раз обещал, напишу что сохранил для себя если вдруг надумаем (или вы надумаете) делать пуши: плагин можно собрать из таких <a href="https://forum.unity.com/threads/unity-webgl-firebase-cloud-messaging-jslib-plugin.837307/">запчастей</a>, честно не пробовал ещё, скорее всего буду свой писать :) Это <a href="https://firebase.google.com/docs/cloud-messaging/js/client">Firebase Cloud Messaging</a>, он бесплатный и вообще можно отсылать пуши на все платформы. Для реализации на своем сервере, например для NodeJS, можно погуглить <a href="https://www.npmjs.com/package/web-push">web-push</a>. На Хабре есть статьи, вот свежая относительно <a href="https://habr.com/ru/post/562058/">про PHP и web пуши</a>. Есть еще <a href="https://pushjs.org">pushjs.org</a>, оно вроде как работает во всех браузерах, можно устанавливать кастомный сервис-воркер. Как писать воркеры можно <a href="https://serviceworke.rs">почитать в таком cook-book’e</a>. Но опять же, всё что связано с пушами не проверял ещё.</p> <p><b>Google и Apple авторизация</b>. У нас в приложениях как раз используются такие способы авторизации. И для них есть возможность сделать веб авторизацию, чего не скажешь про Huawei ID, хотя может и китайцы скоро допилят. Так вот, тут тоже всё относительно просто: открываете мануал как сделать веб авторизацию на своем сервере и делаете: <a href="https://developers.google.com/identity/gsi/web/guides/overview">Google</a> и <a href="https://developer.apple.com/documentation/sign_in_with_apple/sign_in_with_apple_js/configuring_your_webpage_for_sign_in_with_apple">Apple</a>. Про Apple есть еще норм <a href="https://habr.com/ru/company/cian/blog/475062/">статья на Хабре от ЦИАН</a>. Основной момент тут — это редирект после успешной авторизации, туда можно подставить свои параметры, а внутри плагина перехватить их и использовать для авторизации уже в WebGL приложении. Вот нашел <a href="https://stackoverflow.com/a/66514111">грубый пример</a> как это может работать. Автор как и предупреждает не совсем верно использует запрос авторизации. Лучше открывать свою страницу с кнопкой(-ми) авторизации и уже после успешного завершения перехватывать редирект со своего сайта.</p> <p><b>Где размещаться?</b> В комментариях в телеге спросили на каких сервисах публикуем WebGL игры — точно будем пока на своих сайтах, для нас это больше инструмент для платежей. Но в перспективе, рассматриваем ВК и Одноклассники. Может и во вражеском ФБ, кто знает. На реддите нашёл вот небольшой <a href="https://www.reddit.com/r/webgl/comments/ek8xyq/which_are_the_best_webgl_publishing_website_for/">список</a> где можно разместиться, старый, но наверняка что-то живое есть, <a href="https://itch.io">https://itch.io</a> точно.</p> <p>И бонус, как сделать рабочий <a href="https://stackoverflow.com/a/30810322">вариант копирования в буфер обмена</a> во всех (вроде как) браузерах.</p> <p>Ну и ещё бонус, точнее анонс: мы делаем онлайн мобильную 3D игру, до этого как-то больше по 2D всё было, так что будут интересности по 3D. Подписывайтесь на <a href="https://t.me/mopsicus_ru">Telegram канал</a>.</p> EmojiHelper для Unity 254 https://mopsicus.ru/all/emoji-helper-unity/ Mon, 31 Jan 2022 18:02:15 +0300 Игорь Лопатин https://mopsicus.ru/all/emoji-helper-unity/ <p><a href="https://mopsicus.ru/all/emoji-in-unity/">Как добавить эмоджи</a>, я уже писал как-то. Но проблема до сих пор в том, что некорректно работают модификаторы. Точнее — они не работают. Т. е. если вы захотите использовать какой-то флаг или определенный цвет кожи или ещё что-то, то у вас вместо одного нужного эмоджи будет два, а то и три. Чтобы использовать эмоджи полноценно, написал небольшой <a href="https://gist.github.com/mopsicus/3903a1f111a738375a363b9e3f058385">хелпер</a>.</p> <p>Как это работает:</p> <ol start="1"> <li>Создаём спрайт атласы с эмоджи. Лучше разбить их на более мелкие или по группам, по категориям, по популярности...</li> <li>Делаем основной спрайт атлас и к нему цепляем как вспомогательные все остальные. Это может выглядеть как-то так:</li> </ol> <div class="e2-text-picture"> <h3 style="display: none;" itemprop="name">Emojis fallback list</h3><h4 style="display: none;" itemprop="description">Emojis fallback list</h4><img itemprop="contentUrl" src="https://mopsicus.ru/pictures/emojis-fallback.png" width="534" height="724" alt="Emojis fallback list" /> </div> <ol start="3"> <li>Не забываем выставить настройки TMP:</li> </ol> <div class="e2-text-picture"> <h3 style="display: none;" itemprop="name"></h3><h4 style="display: none;" itemprop="description"></h4><img itemprop="contentUrl" src="https://mopsicus.ru/pictures/tmp-emoji-settings.png" width="496" height="226" alt="" /> </div> <ol start="4"> <li>Теперь через хелпер можно использовать эмоджи:</li> </ol> <pre class="e2-text-code"><code class="">/// Можно применять сразу к TMP компоненту MyTMPText.CheckAndParseEmoji(&lt;text with emoji here&gt;);</code></pre> Unity iOS localization 251 https://mopsicus.ru/all/unity-ios-localization/ Mon, 08 Nov 2021 17:39:29 +0300 Игорь Лопатин https://mopsicus.ru/all/unity-ios-localization/ <div class="e2-text-picture"> <h3 style="display: none;" itemprop="name">Unity iOS localization scripts</h3><h4 style="display: none;" itemprop="description">Unity iOS localization scripts</h4><img itemprop="contentUrl" src="https://mopsicus.ru/pictures/ios-unity-localization.png" width="1280" height="720" alt="Unity iOS localization scripts" /> </div> <p><a href="https://github.com/mopsicus/unity-ios-localization">Исходники на Github</a></p> <p>Мобильные Unity разработчики меня сейчас должны понять: когда делаешь билд под iOS, то локализацию «из коробки» настроить не получится. Конечно, есть разные ассеты и даже! <a href="https://docs.unity3d.com/Packages/com.unity.localization@1.0/manual/index.html">официальный пакет для локализации</a>. С которым уже можно работать, кстати. Но как обычно, самое интересное в деталях...</p> <p>Если ваша игра поддерживает несколько языков, к примеру: русский, английский, немецкий, испанский, то для каждого языка неплохо бы сделать локализуемое название игры. Кроме того, если игра/приложение использует камеру или галерею, то нужно показывать диалог запроса прав доступа, тоже локализованный, иначе апрув скорее всего не пройти. Для этого, обычно используется файл <b>InfoPlist.strings</b> и содержимое его выглядит как-то так:<br />  </p> <pre class="e2-text-code"><code class="">&quot;CFBundleDisplayName&quot; = &quot;Локализованное название&quot;; &quot;NSCameraUsageDescription&quot; = &quot;Тут описание зачем приложению доступ к камере&quot;; &quot;NSPhotoLibraryUsageDescription&quot; = &quot;Тут описание зачем доступ к галерее&quot;; &quot;NSPhotoLibraryAddUsageDescription&quot; = &quot;Тут описание зачем доступ к галерее&quot;; &quot;NSUserTrackingUsageDescription&quot; = &quot;Тут описание зачем доступ к IDFA&quot;;  </code></pre><p>В общем-то всё это уже можно сделать официальным пакетом локализации, кроме <i>NSUserTrackingUsageDescription</i> по-моему. Но так как я всё равно использую пост-билд скрипт для добавления файлов, фреймворков и установки различных параметров через ProjectCapabilityManager, то использовать ещё один пакет не хотелось бы. Тем более, пакет для локализации сам использует приватные методы пространства имен <b>UnityEditor.iOS.Xcode</b>. Вот тут-то и нашлось решение. С помощью рефлексии вытянуть нужные методы и сделать расширение для PBXProject.</p> <p>В итоге, получился всего один файл с расширением, который позволяет:</p> <ul> <li>очистить неиспользуемые локали</li> <li>добавить используемые языки в приложении, из списка</li> <li>добавить <i><код_языка>.lproj</i> папки в проект с файлами InfoPlist.strings</li> </ul> <p>В старых проектах я использовал <a href="https://github.com/superbderrick/UnityiOSLocalization">UnityiOSLocalization</a>, он работал, но его «проблема» в большом количестве файлов, которые когда-то были доступны на Bitbucket’е, потом это всё стало приватным — т. е. это то что сейчас получилось вытянуть через рефлексию.</p> <p>Скорее всего когда допилят официальный пакет, всё это станет не актуальным, ну а пока можно пользоваться.</p> Разработка Unity плагинов для iOS и Android 250 https://mopsicus.ru/all/razrabotka-unity-plaginov-dlya-ios-i-android/ Tue, 05 Oct 2021 11:56:12 +0300 Игорь Лопатин https://mopsicus.ru/all/razrabotka-unity-plaginov-dlya-ios-i-android/ <div class="e2-text-picture"> <h3 style="display: none;" itemprop="name">Unity plugins system on JSON</h3><h4 style="display: none;" itemprop="description">Unity plugins system on JSON</h4><img itemprop="contentUrl" src="https://mopsicus.ru/pictures/unity-plugins-systems.png" width="1200" height="630" alt="Unity plugins system on JSON" /> </div> <p>Наконец-то дописал <a href="https://habr.com/ru/post/581160/">статью про создание плагинов</a>. В процессе «дописания» нашёл и пофиксил баг под iOS, так что — не зря :)</p> MoDI 240 https://mopsicus.ru/all/modi-unity-lightweight-ioc-container/ Tue, 13 Apr 2021 23:10:57 +0300 Игорь Лопатин https://mopsicus.ru/all/modi-unity-lightweight-ioc-container/ <div class="e2-text-picture"> <h3 style="display: none;" itemprop="name">MoDI. Lightweight IoC container for Unity.</h3><h4 style="display: none;" itemprop="description">MoDI. Lightweight IoC container for Unity.</h4><img itemprop="contentUrl" src="https://mopsicus.ru/pictures/MoDI.png" width="580" height="259" alt="MoDI. Lightweight IoC container for Unity." /> </div> <p><a href="https://github.com/mopsicus/modi">MoDI</a> — простой контейнер для внедрения зависимостей в Unity.</p> <p class="note">Когда я хочу в чём-то разобраться, я почти сразу перехожу к практической части. Если со старта не получается, тогда начинаю читать мануалы :) После этого, снова повторяю шаг №1 и так по кругу. Иногда это надоедает и я или ищу другие пути решения, или говорю себе, что это «не моё», мне это не надо — сдаюсь короче.</p> <p>Решил я однажды разобраться как работать с <a href="https://github.com/modesttree/Zenject">Zenject</a> и <a href="http://www.ninject.org">Ninject</a> в Unity. Сделал несколько тестовых проектов — вроде работает. Начал копать дальше, понял принцип и решил, что хочу своё такое же, но попроще :) И чтобы было достаточно для всех моих разработческих потребностей. Так появился MoDI.</p> <p>Не буду расписывать принцип инверсии зависимостей, об этом можно прочитать в более достоверных источниках. Скажу только, что более-менее серьёзный проект без этого сложно поддерживать и развивать. Да и вообще, один раз начав использовать сразу понимаешь все плюсы.</p> <p class="foot">Это можно сказать и про ECS, да Leopotam? :)</p> <p>MoDI можно подключить к проекту с помощью пакетного менеджера, через него же можно импортировать сцену с примерами. Ну или просто скачать архив и добавить в проект.</p> <p>Простейший пример выглядит так:</p> <pre class="e2-text-code"><code class="">using MoDI; using UnityEngine; public class QuickStart : MonoBehaviour { public void Start() { DI.Get().Bind&lt;Hello&gt;().WithArguments(&quot;Hi, I'm MoDI!&quot;); Hello hello = DI.Get().Resolve&lt;Hello&gt;(); } } public class Hello { public Hello(string data) { Debug.Log(data); } }</code></pre><p>После запуска данного скрипта в консоли появится сообщение: «Hi, I’m MoDI!».</p> <p>В документации можно найти ещё <a href="https://github.com/mopsicus/modi/blob/main/Documentation~/MoDI.md"> примеры и описание API</a>.</p> <p>Очередной велосипед для себя, но может кого-то заинтересует. Если хотите разработаться в этом как и я, пишите, помогу чем смогу ?</p> Форматирование С# кода в VS Code 234 https://mopsicus.ru/all/format-csharp-code-vscode/ Thu, 21 Jan 2021 17:28:39 +0300 Игорь Лопатин https://mopsicus.ru/all/format-csharp-code-vscode/ <p>До недавних пор, весь код я форматировал с помощью расширения <a href="https://marketplace.visualstudio.com/items?itemName=Leopotam.csharpfixformat">C# FixFormat</a>. Оно старое, не поддерживается, но работает! И вполне себе работает.</p> <p>Но после недавней переустановки VS Code, я ставил заново расширение для C# (OmniSharp) и погуглил на предмет выше. Как оказалось, OmniSharp уже умеет сам форматировать код, причем использует <a href="https://docs.microsoft.com/dotnet/api/microsoft.codeanalysis.csharp.formatting.csharpformattingoptions">все необходимые параметры</a>.</p> <p>Для того чтобы всё это заработало, надо в корне проекта создать файл <a href="https://github.com/OmniSharp/omnisharp-roslyn/wiki/Configuration-Options"><b>omnisharp.json</b></a> и добавить туда параметры форматирования. Например:</p> <pre class="e2-text-code"><code class="">{ &quot;FormattingOptions&quot;: { &quot;newLine&quot;: &quot;\n&quot;, &quot;useTabs&quot;: false, &quot;tabSize&quot;: 4, &quot;indentationSize&quot;: 4, &quot;NewLinesForBracesInTypes&quot;: false, &quot;NewLinesForBracesInMethods&quot;: false, &quot;NewLinesForBracesInProperties&quot;: false, &quot;NewLinesForBracesInAccessors&quot;: false, &quot;NewLinesForBracesInAnonymousMethods&quot;: false, &quot;NewLinesForBracesInControlBlocks&quot;: false, &quot;NewLinesForBracesInAnonymousTypes&quot;: false, &quot;NewLinesForBracesInObjectCollectionArrayInitializers&quot;: false, &quot;NewLinesForBracesInLambdaExpressionBody&quot;: false, &quot;NewLineForElse&quot;: false, &quot;NewLineForCatch&quot;: false, &quot;NewLineForFinally&quot;: false, &quot;NewLineForMembersInObjectInit&quot;: false, &quot;NewLineForMembersInAnonymousTypes&quot;: false, &quot;NewLineForClausesInQuery&quot;: false } }</code></pre><p>Также, не забудьте поставить в настройках VS Code:</p> <ul> <li>Csharp → Format → true</li> <li>Editor → Default formatter → ms-dotnettools.csharp</li> </ul> <p>Для форматирования при вводе и сохранении:</p> <ul> <li>Editor → Format On Type → true</li> <li>Editor → Format On Save → true</li> </ul> <p>И как бонус: OmniSharp также научился ставить XML комментарии, так что, минус <a href="https://marketplace.visualstudio.com/items?itemName=k--kato.docomment">ещё одно расширение</a>. Просто вводите три слеша над методом и шаблон XML коммента готов.</p> Командный бой на Unity (пример) 229 https://mopsicus.ru/all/unity-team-fight-example-with-pathfinding/ Mon, 14 Dec 2020 13:54:46 +0300 Игорь Лопатин https://mopsicus.ru/all/unity-team-fight-example-with-pathfinding/ <p>Так и не придумал как будет правильней назвать этот пример :)</p> <div class="lazy" data-expose="true" data-effect="relax"><div class="e2-text-video"> <iframe src="https://www.youtube.com/embed/ONT3SbW9eO4" frameborder="0" allowfullscreen></iframe><div class="e2-text-caption">Unity team fight example</div> </div></div> <p>Ограниченное поле из клеток и две команды. Юниты появляются рандомно на своей половине и начинается бой.<br /> Каждый юнит ищет противника, как сонар у подводной лодки. Найдя, строит к нему путь с помощью волнового алгоритма и начинает движение. Так как за ход многие юниты могут поменять свое расположение, путь перестраивается каждый раз.</p> <p>Когда противник в зоне атаки, юниты наносят друг друг рандомный дамаг. Победитель ищет новую цель и так продолжается пока одна из команд полностью не уничтожит другую.</p> <p><b>Из положительных моментов:</b> почти не выделяется память, только на корутины анимации (но это можно убрать) и все отрисовывается за 2-4 DC.</p> <p><a href="https://github.com/mopsicus/unity-team-fight">Исходники на Github</a></p> Создание плагинов для Unity 228 https://mopsicus.ru/all/make-plugins-for-unity/ Fri, 27 Nov 2020 00:12:48 +0300 Игорь Лопатин https://mopsicus.ru/all/make-plugins-for-unity/ <div class="e2-text-picture"> <h3 style="display: none;" itemprop="name">Плагины для Unity</h3><h4 style="display: none;" itemprop="description">Плагины для Unity</h4><img itemprop="contentUrl" src="https://mopsicus.ru/pictures/plugins.png" width="1460" height="730" alt="Плагины для Unity" /> </div> <p>Пишу статью про создание плагинов для Unity под iOS и Android. Нужны комменты и советы.</p> <p>За несколько лет, я сделал большое количество различных плагинов. Многие они не в паблике и опенсорс, но это не надолго (надеюсь :).</p> <p>Есть куча ситуаций когда одной Unity недостаточно и нужно использовать возможности платформы. Банально, но до сих пор, в Unity нет работы с галерей и камерой из коробки :) Смешно? Не очень. В Xamarin есть, а в Unity нет.</p> <p>Для многих менее опытных разработчиков, создание плагина для Unity под мобильную платформу кажется чем-то сложным, но на деле, это не так сложно и страшно. По крайней мере, организовать простое взаимодействие — достаточно просто. В статье, будет шаблон для Android (на Java) и iOS (на Obj-C) для создания плагинов и их связи с Unity приложением.</p> <p>Поэтому вопрос: о создании каких плагинов вы бы хотели прочитать в первую очередь? Примеры: галерея, уведомления, браузер, покупки, шаринг, [продолжите]...</p> Unity EventBus на интерфейсах 225 https://mopsicus.ru/all/unity-eventbus-via-interfaces/ Sat, 14 Nov 2020 13:31:38 +0300 Игорь Лопатин https://mopsicus.ru/all/unity-eventbus-via-interfaces/ <pre class="e2-text-code"><code class="">public class SaveLoadManager : Monobehaviour, IQiuckSaveHandler { private void OnEnable() { EventBus.Subscribe(this); } private void OnDisable() { EventBus.Unsubscribe(this); } private void HandleQuickSave() { // код сохранения ... } }</code></pre><p>Интересная <a href="https://habr.com/ru/post/527418/">реализация системы событий для Unity</a>. В качестве ключа для подписки выступает интерфейс. Несколько лет назад, я писал про <a href="https://mopsicus.ru/all/unity-event-manager-2-0/">простой менеджер событий</a>, но этот вариант выглядит по-лучше. Но нужно не забывать отписываться, чтобы избежать утечек. Как правильно в комментах заметили, можно использовать WeakReference, например.</p> Unity &amp; iOS capabilities 223 https://mopsicus.ru/all/unity-ios-capabilities/ Thu, 05 Nov 2020 13:01:42 +0300 Игорь Лопатин https://mopsicus.ru/all/unity-ios-capabilities/ <div class="e2-text-picture"> <h3 style="display: none;" itemprop="name">iOS capabilities list</h3><h4 style="display: none;" itemprop="description">iOS capabilities list</h4><img itemprop="contentUrl" src="https://mopsicus.ru/pictures/ios-capabilities.png" width="929" height="231" alt="iOS capabilities list" /> </div> <p>Как оказалось, даже для последних версий Unity, есть проблема программно выставить нужные параметры в Xcode проекте :( А это необходимость, иначе никакой CI\CD не работает и придётся билдить iOS версию вручную, что конечно не очень правильно.</p> <p>Для этих целей в Unity есть специальный <a href="https://docs.unity3d.com/ScriptReference/Callbacks.PostProcessBuildAttribute.html">PostProcessBuildAttribute</a> и <a href="https://docs.unity3d.com/ScriptReference/iOS.Xcode.PBXProject.html">PBXProject</a>. После билда в Xcode проект, можно настраивать уже другие параметры, не доступные внутри Unity. Но, даже следуя мануалам, как-то оно не всё работает...</p> <p>Так, например, чтобы добавить функцию <b>Sign in with Apple</b>, нужно воспользоваться <a href="https://docs.unity3d.com/ScriptReference/iOS.Xcode.ProjectCapabilityManager.html">ProjectCapabilityManager</a>. В коде это выглядит примерно так:</p> <pre class="e2-text-code"><code class="">... string projectPath = string.Format (&quot;{0}/Unity-iPhone.xcodeproj/project.pbxproj&quot;, path); PBXProject project = new PBXProject (); string file = File.ReadAllText (projectPath); project.ReadFromString (file); string target = project.GetUnityMainTargetGuid (); string entFile = &quot;game.entitlements&quot;; ProjectCapabilityManager manager = new ProjectCapabilityManager (projectPath, entFile, &quot;Unity-iPhone&quot;, target); manager.AddSignInWithApple (); // other capabilities manager.WriteToFile ();</code></pre><p>Но таким образом файл <i>X.entitlements</i> не добавляется в проект, создаётся, но не добавляется. И через <i>project.AddFile()</i> — тоже. Спасает как всегда stackoverflow :) Оказывается, помимо <i>project.AddFile()</i> надо добавить ещё специальный property, чтобы всё закрутилось:</p> <pre class="e2-text-code"><code class="">... project.AddFile (entFile, entFile); project.AddBuildProperty (target, &quot;CODE_SIGN_ENTITLEMENTS&quot;, entFile); File.WriteAllText (projectPath, project.WriteToString ());</code></pre><p>Почему это не написано в мануале Unity — непонятно.</p> Пример Ping Pong на Unity 218 https://mopsicus.ru/all/ping-pong-unity-example/ Thu, 24 Sep 2020 22:07:49 +0300 Игорь Лопатин https://mopsicus.ru/all/ping-pong-unity-example/ <div class="lazy" data-expose="true" data-effect="relax"><div class="e2-text-video"> <iframe src="https://www.youtube.com/embed/4iNnMPtOEgg" frameborder="0" allowfullscreen></iframe></div></div> <p>Запилил тут на досуге пример игры в настольный теннис на Unity. Есть даже примитивный сетевой режим, можно попробовать поиграть вдвоем.</p> <p><a href="https://github.com/mopsicus/unity-ping-pong-example">Исходники на Github</a></p> Градиентный текст в Unity 205 https://mopsicus.ru/all/full-text-gradient-tmp-unity/ Tue, 12 May 2020 15:48:53 +0300 Игорь Лопатин https://mopsicus.ru/all/full-text-gradient-tmp-unity/ <p>В пакете TextMeshPro уже есть встроенная градиентная заливка, но для моей задачи она не совсем подходила, потому что работает для каждого символа отдельно. Выглядит это так:</p> <div class="e2-text-picture"> <h3 style="display: none;" itemprop="name">Градиент для каждой буквы</h3><h4 style="display: none;" itemprop="description">Градиент для каждой буквы</h4><img itemprop="contentUrl" src="https://mopsicus.ru/pictures/gradient-before-character.png" width="512" height="128" alt="Градиент для каждой буквы" /> </div> <p>Пришлось написать небольшой скрипт, который вешается на текстовый компонент, берёт цвета градиента из свойств и применяет его для всего текста. Стало выглядеть так:</p> <div class="e2-text-picture"> <h3 style="display: none;" itemprop="name">Градиент для всего текста</h3><h4 style="display: none;" itemprop="description">Градиент для всего текста</h4><img itemprop="contentUrl" src="https://mopsicus.ru/pictures/gradient-after-full.png" width="512" height="128" alt="Градиент для всего текста" /> </div> <p>Принцип простой: разбиваем градиент для количество букв и потом по порядку применяем для каждой буквы свой диапазон.</p> <p><a href="https://gist.github.com/mopsicus/9d344451ca614d7e9937bc0c6da2b21d">Исходник</a></p> <p class="foot">Теперь будет гуглится по <i>full text gradient unity</i> :)</p> TabsView для Unity 195 https://mopsicus.ru/all/tabs-view-unity/ Wed, 19 Feb 2020 13:57:46 +0300 Игорь Лопатин https://mopsicus.ru/all/tabs-view-unity/ <p>Сегодня у нас раздел «Велосипедостроение» :)</p> <div class="lazy" data-expose="true" data-effect="relax"><div class="e2-text-video"> <iframe src="https://www.youtube.com/embed/RKvR7h9oFAI" frameborder="0" allowfullscreen></iframe></div></div> <p class="note">Если DOTween в проекте не используется, можно его выпилить и сделать вручную, чтобы не тащить библиотеку.</p> <p>Когда-то давно понадобилось сделать в UI горизонтальную прокрутку табами. В iOS есть такой стандартный элемент. В Android по-моему тоже. Для Unity как известно стандартные UI компоненты довольно скудны. Поэтому каждый придумывает себе, по мере надобности. Вот и получилось когда-то такое, довольно простое решение.</p> <ul> <li>Управляется свайпами</li> <li>Есть индикаторы состояния табов</li> <li>Анимации можно делать любые, с помощью <a href="http://dotween.demigiant.com/download.php">DOTween</a></li> <li>На переключение таба можно повесить хук</li> </ul> <p><a href="https://github.com/mopsicus/unity-tabs-view">Исходники на Github</a></p> Unity, нейросеть и птички 181 https://mopsicus.ru/all/unity-neural-network-example/ Thu, 03 Oct 2019 11:48:41 +0300 Игорь Лопатин https://mopsicus.ru/all/unity-neural-network-example/ <div class="lazy" data-expose="true" data-effect="relax"><div class="e2-text-video"> <iframe src="https://www.youtube.com/embed/3Tjy9F2I5mU" frameborder="0" allowfullscreen></iframe></div></div> <p>Очень простой и понятный пример обучения нейросети с линейной функцией активации. Короче, для самых начинающих. Можно переделать под что-то своё и поинтересней.</p> <p>Спойлер.<br /> В примере, птички обучились пролетать препятствия за 40+ генераций.</p> <p><a href="https://github.com/exoflow/EvolvingNeuralNetwork">Исходники на Github</a></p>