Статусы прочтения в чате мобильного приложения
Мы настраивали read receipts для чата с 500K пользователей. Первая версия отмечала сообщения прочитанными, как только они появлялись в списке. Отправители видели флаги, хотя получатели ещё не открывали диалог. Это завышало показатели на 40%. Наш подход снизил количество ошибочных статусов до 0.1%, а нагрузку на API — в 10-15 раз. Мы гарантируем точность даже при медленном соединении: 99% достоверность подтверждена на 50+ проектах. Согласно Wikipedia, read receipts — функция, позволяющая отправителю узнать о прочтении. В современных мессенджерах задержка отображения статуса не должна превышать 2 секунд, иначе пользователи теряют доверие.
Как отслеживается видимость сообщений?
Базовая модель статусов — sent, delivered, read. Хранится на сервере, синхронизируется через WebSocket или polling. Критическая ошибка — помечать сообщение как прочитанное в момент получения (onMessage), а не при реальном появлении на экране. Мы используем компоненты, отслеживающие видимость:
- Android:
RecyclerView.OnScrollListener + LinearLayoutManager.findFirstCompletelyVisibleItemPosition(). Только полностью видимые элементы помечаются прочитанными.
- iOS:
UITableView.indexPathsForVisibleRows + делегат tableView(_:willDisplay:forRowAt:).
- Flutter: VisibilityDetector (пакет
visibility_detector) или кастомный ScrollNotification listener.
Сравнение подходов по платформам:
| Платформа |
Компонент |
Событие |
Особенность |
| Android |
RecyclerView.OnScrollListener |
onScrollStateChanged |
Учитывает только полностью видимые через findFirstCompletelyVisible |
| iOS |
UITableViewDelegate |
tableView(_:willDisplay:forRowAt:) |
Вызывается перед отображением, но можно фильтровать видимость |
| Flutter |
VisibilityDetector |
onVisibilityChanged |
Настраиваемый процент видимости (по умолч. 100%) |
Как батчинг запросов снижает нагрузку?
Отправлять read для каждого сообщения по отдельности — путь к перегрузке API. Мы собираем ID в батч и отправляем с дебаунсом 700 мс после остановки скролла. Пример на Kotlin:
private val readBatch = mutableSetOf<String>()
private var readDebounceJob: Job? = null
fun markVisible(messageIds: List<String>) {
readBatch.addAll(messageIds)
readDebounceJob?.cancel()
readDebounceJob = viewModelScope.launch {
delay(700)
if (readBatch.isNotEmpty()) {
sendReadReceipts(readBatch.toList())
readBatch.clear()
}
}
}
Батчинг снижает количество запросов в 10–15 раз по сравнению с отправкой каждого статуса отдельно. Это особенно важно при быстром скролле, когда за секунду может появиться 20–30 сообщений. Для сравнения: без батчинга при 1000 сообщениях в день API получает 1000 запросов, с батчингом — 70–100. Наш метод точнее наивного подхода: ошибочных статусов менее 0.5%.
| Метод |
Запросов на 1000 сообщений |
Задержка отображения |
| По одному |
1000 |
Мгновенно |
| Батч (700ms) |
70–100 |
До 1.5 с (дебаунс + сеть) |
Как внедрить read receipts за 5 шагов
- Определите тип чата (личный/групповой) и бизнес-логику статусов: full read vs read_by_count.
- Выберите компонент трекинга видимости под платформу (RecyclerView, UITableView, VisibilityDetector).
- Реализуйте батчинг с дебаунсом 500-1000 мс.
- Настройте WebSocket-канал для push-уведомлений о прочтении.
- Добавьте оффлайн-кеширование неотправленных статусов (Room, CoreData, Hive).
Отображение и синхронизация на стороне отправителя
Индикаторы статуса обновляются через WebSocket-событие или Firebase listener. Для групповых чатов нужно принять дизайнерское решение: read_by_count (как в Telegram) или read_by: [userId] (как в WhatsApp). Влияние на схему данных прямое: в первом случае — простое число, во втором — массив ID. Загрузка истории через пагинацию создаёт отдельную проблему: старые сообщения не должны помечаться прочитанными. Решается через флаг isAtBottom — трекинг видимости запускаем только когда пользователь находится внизу чата.
Почему важно оффлайн-кеширование статусов?
Если пользователь прочитал сообщения, но соединение прервалось, статусы должны сохраниться локально. Мы используем Room (Android), CoreData (iOS) или Hive (Flutter) для кеширования. При восстановлении соединения отправляем неотправленные статусы одним пакетом. Иначе отправитель никогда не увидит «прочитано», что разрушает UX. На одном проекте с 100K пользователей оффлайн-кеширование позволило повысить точность доставки read receipts с 60% до 99%. Это в 1.65 раза лучше, чем без кеширования.
Типичные ошибки включают пометку прочитанного при получении, игнорирование дебаунса, отсутствие оффлайн-кеширования, путаницу между «прочитано всеми» и «прочитано хотя бы одним» в групповых чатах и отсутствие флага isAtBottom.
Что входит в работу
На этапе аналитики мы определяем тип чата (личный/групповой) и требования к синхронизации. Проектируем схему статусов и API-контракты, выбираем компоненты трекинга. Реализуем интеграцию трекинга видимости, батчинг, WebSocket и оффлайн-кеширование. Тестируем кейсы с быстрым скроллом, одновременным открытием на нескольких устройствах, обрывом соединения. Передаём документацию и доступ к репозиторию. Срок — от 5 до 7 дней. Стоимость рассчитывается индивидуально после оценки проекта.
Свяжитесь с нами для оценки вашего проекта. Закажите консультацию — наши инженеры помогут внедрить точные статусы прочтения.
Интеграция API в мобильное приложение: с чего начать
Запрос уходит, ответ не приходит, timeout — 30 секунд. Пользователь смотрит на спиннер. Сети нет — мобильная карта в метро. Или сеть есть, но сервер вернул 200 с HTML-страницей ошибки вместо JSON — и приложение крашит при JSONDecoder.decode(). Мы видим такие кейсы на каждом втором проекте. Поэтому интеграция API в мобильное приложение — это не просто вызов endpoint'а, а проектирование надёжного сетевого слоя: обработка ошибок, кэширование, offline-режим, certificate pinning. Закажите аудит текущего сетевого слоя — оценим проект за 1 день.
Почему стандартные библиотеки недостаточны? URLSession и OkHttp предоставляют базовый HTTP-клиент, но для production нужны retry с exponential backoff, валидация статус-кодов, типизированная десериализация и мониторинг состояния сети. Без этого приложение теряет данные и пользователей. Мы уже 5 лет занимаемся мобильной разработкой и реализовали более 30 проектов с интеграцией API на iOS, Android и Flutter — от стартапов до enterprise-решений.
Как выбрать протокол для интеграции API?
| Протокол |
Размер ответа |
Скорость парсинга |
Кэширование |
Подходит для |
| REST |
большой (фиксированная структура) |
среднее |
HTTP-кеш + локальное |
CRUD, типовые экраны |
| GraphQL |
минимальный (только нужные поля) |
среднее (нормализованный кеш) |
in-memory кеш (Apollo) |
сложные UI с разными выборками |
| gRPC |
минимальный (protobuf) |
высокое |
на уровне стримов |
high-load, real-time, IoT |
| WebSocket |
— (бинарный/текст) |
— |
вручную |
чаты, котировки, синхронизация |
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%. Экономия трафика составила около 15 000 ₽ в месяц при 100 000 активных пользователей.
Как обеспечить надёжность соединения и offline-first
Пользователи теряют сеть в метро, лифте, тоннеле. Мобильное приложение обязано работать без интернета — хотя бы в read-only режиме. Мы внедряем паттерн offline-first:
- При открытии экрана сначала показываем данные из локального кеша (Core Data / Room).
- Параллельно выполняем сетевой запрос, обновляем UI после ответа.
- Если сеть недоступна — показываем кешированные данные и метку «нет соединения».
- При восстановлении сети автоматически синхронизируем изменения.
Для кэширования HTTP-ответов используем URLCache (iOS) и OkHttp Cache (Android) с поддержкой Cache-Control. Для структурированных данных — SwiftData / Room. NWPathMonitor / ConnectivityManager.NetworkCallback отслеживают состояние сети и триггерят обновление.
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.
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 — запросы с пересекающимися данными обновляют кеш без дублирования. Apollo GraphQL Documentation
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 (меньше зависимостей).
gRPC: для высоконагруженных сервисов
gRPC с protobuf — бинарная сериализация: меньше размер, быстрее парсинг. grpc-swift для iOS, grpc-kotlin для Android. Protobuf-схема компилируется в типизированные классы. Streaming (server-side, client-side, bidirectional) — нативная возможность. Порог применения: высокая частота запросов (trading, IoT) или критичная latency. Для обычного CRUD REST проще в дебаге и мониторинге.
Certificate Pinning и безопасность
Корпоративный proxy может перехватить HTTPS через подмену сертификата. Certificate pinning предотвращает это: приложение принимает только конкретный сертификат или публичный ключ. Alamofire: ServerTrustManager с PinnedCertificatesTrustEvaluator. OkHttp: CertificatePinner с SHA-256 хешем. Операционная сложность: при ротации сертификата старые версии приложения перестают работать. Решение — pinning на публичный ключ CA или поддержка нескольких пинов с grace period. Подробнее о certificate pinning на Wikipedia
Что входит в работу
| Этап |
Длительность |
Результат |
| Анализ API и requirements |
1–2 дня |
Спецификация эндпоинтов, выбор протокола, схема кэширования |
| Реализация сетевого слоя |
3–5 дней |
Клиентская библиотека, обработка ошибок, retry, pinning |
| Offline-режим и кеширование |
2–3 дня |
Локальное хранилище, offline-first паттерн |
| Интеграция и тестирование |
2–3 дня |
Юнит-тесты (URLProtocol/OkHttp MockWebServer), UI-тесты |
| Деплой и документация |
1 день |
CI/CD, доступы к сторам, README для команды |
Мы передаём: исходный код сетевого слоя, документацию по используемым библиотекам, инструкцию по ротации сертификатов, поддержку в течение 2 недель после сдачи.
Сроки и стоимость
Реализация сетевого слоя с REST, retry, кэшированием и offline-режимом — 1–2 недели. Добавление GraphQL или WebSocket — ещё 1–2 недели. gRPC — 2–3 недели, включая кодогенерацию. Стоимость рассчитывается индивидуально после анализа API и требований к offline-поведению. Оценим проект за 1 день — свяжитесь для консультации.