Інтеграція Nakama для мобільної гри: сервер, матчмейкінг

Інтеграція Nakama для серверної частини мобільної гри

Ви розробили мобільну гру на Unity? Серверна частина — завжди вузьке місце. Кастомний бекенд на Go вимагає щонайменше місяця розробки, а готові BaaS-рішення, такі як PlayFab або GameSparks, помітно б'ють по бюджету. Nakama (GitHub) — open-source ігровий сервер, який лягає на вашу інфраструктуру і закриває ключові задачі: аутентифікацію, матчмейкінг, лідерборди, real-time матчі та зберігання даних. Ми інтегрували Nakama в більш ніж 10 мобільних ігор — від казуальних пазлів до competitive PvP-шутерів. Розкажемо, як це працює і чому Nakama економить до 40% витрат на серверну частину порівняно з пропрієтарними рішеннями.

Які проблеми вирішує Nakama?

Типові складнощі при розробці серверної частини мобільної гри:

1. Аутентифікація без сторонніх SDK. Nakama підтримує device ID, email, соціальні мережі (Apple, Google, Facebook) через єдиний API. App Store Review Guidelines (Section 5.1) вимагають шифрування токенів — ми використовуємо Keychain/Keystore для iOS та EncryptedSharedPreferences для Android. Refresh token оновлюється автоматично, сесія не втрачається при перезапуску.

2. Матчмейкінг з фільтрацією. Nakama використовує запити в стилі Bleve Search. Ви можете фільтрувати гравців за скіллом, регіоном, режимом гри. Наприклад, +properties.skill:>1200 та +properties.region:eu. Це в 3 рази швидше за кастомну реалізацію на Go.

3. Authoritative матчі для anti-cheat. У relayed матчах сервер лише пересилає повідомлення — будь-який клієнт може підмінити дані. Authoritative матчі на TypeScript виконують валідацію ходів на сервері, що виключає чітерство. Порівняння:

Як ми впроваджуємо Nakama: процес і стек

Наш стек: Nakama 3.x (сервер), Unity 2022 LTS (клієнт), TypeScript (authoritative модулі), Kubernetes (оркестрація). Приклад кейсу: Замовник хотів real-time PvP-шутер з античитом. Ми розгорнули Nakama на 3 вузлах Kubernetes, налаштували authoritative матчі з валідацією дій (перевірка швидкості, координат, урону), матчмейкінг по MMR та регіону. Результат: пінг <50 мс в Європі, жодного випадку чітерства за 3 місяці. Вартість серверної інфраструктури — на 40% нижча, ніж у PlayFab.

Процес роботи та терміни

Загальний термін: від 2 до 4 тижнів залежно від складності. Оцінимо ваш проєкт за 1 день — напишіть нам, обговоримо деталі.

Чому обирають Nakama замість кастомного бекенду?

Nakama скорочує час запуску MVP на 60% порівняно з написанням сервера на Go або Node.js. Ви отримуєте готові модулі: аутентифікація, друзі, групи, чати, лідерборди, матчмейкінг. Open-source ліцензія (Apache 2.0) — немає Vendor Lock-In. При необхідності кастомної логіки — TypeScript або Lua, без зміни технології.

Як працює матчмейкінг у Nakama?

Матчмейкер використовує пошуковий двигун Bleve. Ви задаєте критерії: діапазон скіллу, режим гри, регіон. Приклад коду:

var ticket = await client.AddMatchmakerAsync(
    session,
    query: "+properties.skill:>1200",
    minCount: 2,
    maxCount: 4,
    stringProperties: new Dictionary<string, string> { ["mode"] = "deathmatch" },
    numericProperties: new Dictionary<string, double> { ["skill"] = 1500 }
);

socket.ReceivedMatchmakerMatched += matched => {
    socket.JoinMatchAsync(matched.MatchId);
};

При отриманні matched-події клієнт підключається до матчу. Для authoritative матчів на сервері додатково валідується склад гравців.

Типові помилки при інтеграції Nakama

• Зберігання токена в PlayerPrefs без шифрування — порушення App Store Review Guidelines. Використовуйте Keychain (iOS) або EncryptedSharedPreferences (Android).
• Відсутність rate limiting на сервері — гравці можуть спамити запитами. Налаштуйте Nginx або використовуйте вбудований rate limiter Nakama.
• Не використовувати refresh token — сесія закінчиться через годину, гравець вилетить. Реалізуйте client.SessionRefreshAsync зі зберіганням refresh token.
• Ігнорування тестування під навантаженням — Nakama тримає до 10k одночасних підключень на один вузол, але потрібно перевіряти з вашими сценаріями.

Що входить в роботу

• Повний цикл: аналітика, проєктування, реалізація, тестування, деплой.
• Налаштування CI/CD для автоматичного розгортання (GitHub Actions, Docker).
• Документація по API та адмініструванню.
• Навчання вашої команди роботі з Nakama Console.
• Гарантія підтримки 1 місяць після запуску.

Наш досвід — 5+ років розробки мобільних ігор, 15+ проєктів з Nakama. Замовте розрахунок вартості інтеграції — отримайте пропозицію протягом дня. Зв'яжіться з нами для оцінки вашого проєкту — розкажемо, як Nakama прискорить запуск вашої гри.

Інтеграція API в мобільний додаток: з чого почати

Запит йде, відповідь не приходить, timeout — 30 секунд. Користувач дивиться на спінер. Мережі немає — мобільна карта в метро. Або мережа є, але сервер повернув 200 з HTML-сторінкою помилки замість JSON — і додаток крашиться при JSONDecoder.decode(). Ми бачимо такі кейси на кожному другому проєкті. Тому інтеграція API в мобільний додаток — це не просто виклик endpoint'у, а проектування надійного мережевого шару: обробка помилок, кешування, offline-режим, certificate pinning. Гарантуємо стабільну роботу навіть при нестабільному з'єднанні — замовте аудит поточного мережевого шару.

Стандартних бібліотек (URLSession, OkHttp) недостатньо для production: вони надають лише базовий HTTP-клієнт. Для реальної експлуатації потрібні retry з exponential backoff, валідація статус-кодів, типізована десеріалізація та моніторинг стану мережі. Без цього додаток втрачає дані та користувачів. Ми маємо понад 5 років досвіду в мобільній розробці, реалізували 30+ проєктів з інтеграцією API на iOS, Android та Flutter — від стартапів до enterprise-рішень. Сертифіковані iOS/Android розробники гарантують якість коду.

Як вибрати протокол для інтеграції API?

REST залишається стандартом для більшості проєктів. Але коли на екрані профілю потрібно 5 полів з 40, GraphQL виключає over-fetching і скорочує трафік на 30–60%. gRPC виправданий при тисячах запитів на хвилину (trading, IoT) — бінарна серіалізація в 3–5 разів швидше JSON. WebSocket — єдиний вибір для real-time без polling (повідомлення, сповіщення).

Приклад з практики: для фінтех-додатку ми замінили REST (40 полів) на GraphQL — розмір відповіді скоротився з 12 КБ до 2,5 КБ, час рендеру екрана впав на 70%. Економія трафіку була значною при 100 000 активних користувачів.

Як забезпечити надійність з'єднання та offline-first?

Користувачі втрачають мережу в метро, ліфті, тунелі. Мобільний додаток зобов'язаний працювати без інтернету — хоча б у read-only режимі. Ми впроваджуємо патерн offline-first:

1. При відкритті екрану спочатку показуємо дані з локального кешу (Core Data / Room).
2. Паралельно виконуємо мережевий запит, оновлюємо UI після відповіді.
3. Якщо мережа недоступна — показуємо кешовані дані та позначку «немає з'єднання».
4. При відновленні мережі автоматично синхронізуємо зміни.

Для кешування HTTP-відповідей використовуємо URLCache (iOS) та OkHttp Cache (Android) з підтримкою Cache-Control. Для структурованих даних — SwiftData / Room. NWPathMonitor / ConnectivityManager.NetworkCallback відстежують стан мережі та тригерять оновлення. Connection Pooling і HTTP/2 multiplexing зменшують latency при паралельних запитах.

REST та вибір клієнтської бібліотеки

Alamofire (iOS) — де-факто стандарт для Swift-проєктів. Поверх URLSession додає request chaining, response validation, automatic retry, certificate pinning через ServerTrustManager. AF.request() з .validate() повертає помилку для будь-якого статус-коду поза 200–299. Без .validate() Alamofire вважає 404 та 500 успішними відповідями. З Swift Concurrency — async-версія через serializingDecodable.

Retrofit (Android) — анотаційний HTTP-клієнт поверх OkHttp. Інтерфейс з анотаціями компілюється в реалізацію. @GET, @POST, @Path, @Query, @Body — декларативний опис API. OkHttp під капотом: connection pooling, transparent gzip, HTTP/2 multiplex. HttpLoggingInterceptor — логування в debug-збірці. Authenticator — автоматичний refresh токена при 401. Згідно з OkHttp Official Guide, правильна конфігурація кешу зменшує кількість мережевих запитів на 40%.

Ktor (KMM/Flutter) — мультиплатформний HTTP-клієнт. На iOS працює через Darwin engine (URLSession), на Android — через OkHttp. Єдиний код для обох платформ при KMM-архітектурі.

GraphQL: коли REST не справляється

REST повертає фіксовану структуру. Екран профілю вимагає name, avatar, email — сервер віддає 40 полів. Over-fetching. GraphQL вирішує це: клієнт запитує рівно потрібні поля. Це критично для мобайлу, де трафік і час парсингу — реальні обмеження. Apollo iOS та Apollo Kotlin генерують типізовані класи за схемою: schema.graphql + query-файли → строгі типи на етапі компіляції. Subscriptions через WebSocket — real-time без polling. Обмеження: GraphQL складніше кешувати на рівні HTTP. Apollo використовує нормалізований in-memory кеш InMemoryNormalizedCache — запити з перетинаючимися даними оновлюють кеш без дублювання.

WebSocket: real-time без зайвого трафіку

Polling (setInterval кожні 5 секунд) — витрата батареї та трафіку. WebSocket — постійне двоспрямоване з'єднання. iOS: URLSessionWebSocketTask (нативний, iOS 13+). Android: OkHttp WebSocket. Обов'язкова обробка reconnect: при onFailure — експоненційний backoff (1с → 2с → 4с → 8с → максимум 60с). Socket.IO — надбудова з автоматичним reconnect, але для нових проєктів краще нативний WebSocket (менше залежностей). TLS 1.3 забезпечує безпеку з'єднання.

Чому важливий certificate pinning?

Корпоративний проксі може перехопити HTTPS через підміну сертифіката. Certificate pinning запобігає цьому: додаток приймає тільки конкретний сертифікат або публічний ключ. Alamofire: ServerTrustManager з PinnedCertificatesTrustEvaluator. OkHttp: CertificatePinner з SHA-256 хешем. Операційна складність: при ротації сертифіката старі версії додатку перестають працювати. Рішення — pinning на публічний ключ CA або підтримка кількох пінів з grace period. Правильне впровадження pinning гарантує захист від MITM-атак.

Що входить у роботу

Ми передаємо: вихідний код мережевого шару, документацію по використовуваних бібліотеках, інструкцію з ротації сертифікатів, підтримку протягом 2 тижнів після здачі.

Терміни та вартість

Реалізація мережевого шару з REST, retry, кешуванням та offline-режимом — 1–2 тижні. Додавання GraphQL або WebSocket — ще 1–2 тижні. gRPC — 2–3 тижні, включаючи кодогенерацію. Вартість розраховується індивідуально після аналізу API та вимог до offline-поведінки. Оцінимо проєкт за 1 день — зв'яжіться з нами для консультації. Замовте аудит мережевого шару — отримайте гарантію стабільної роботи під навантаженням.