Интеграция SDK чата Stream Chat в мобильное приложение

Real-time чат без лагов — частая головная боль мобильных команд. Ошибки в конфигурации WebSocket, нестабильный reconnect, утечка токенов — типичные проблемы, которые мы видим на аудитах. Stream Chat SDK решает их, но требует правильной настройки. У нас за плечами 5 лет опыта и 20+ проектов с чатами, 8 из них на Stream Chat. Гарантируем стабильность даже при слабом соединении. Разберём интеграцию с нуля, без «Hello World» из документации.

Stream Chat отличается от SendBird архитектурно: API построен на событийной модели (WebSocket + event-driven state), SDK предоставляет готовые SwiftUI/Compose-компоненты с глубокой кастомизацией через subclassing и view factories. Размер бинарника меньше: iOS около 8 МБ, Android AAR ~6 МБ. Мы не раз сталкивались, что SendBird даёт больше свободы, но Stream Chat быстрее в интеграции — до 40% экономии времени на первичный запуск.

Почему Stream Chat экономит до 40% времени разработки?

Готовые UI-компоненты покрывают 80% поведения. Остальные 20% — кастомизация через ViewFactory. Это быстрее, чем писать свой чат с нуля на UIKit/Compose. Полный кастомный UI имеет смысл только при несовместимых дизайн-системах.

Инициализация и управление токенами

Stream работает на JWT. Клиент никогда не генерирует токен самостоятельно — только ваш бэкенд через Stream Chat SDK. На бэкенде токен создаётся с помощью stream_chat.create_token(user_id) (Python/Node SDK). На клиенте:

// iOS
let client = ChatClient(config: ChatClientConfig(apiKeyString: "YOUR_KEY"))
let token = try Token(rawValue: "eyJ...")
client.connectUser(userInfo: .init(id: userId), token: token) { error in
    ...
}

// Android
val client = ChatClient.Builder("YOUR_KEY", context).build()
client.connectUser(User(id = userId), token).enqueue { result -> ... }

Token refresh: Stream SDK вызывает TokenProvider когда токен истекает. Реализуйте TokenProvider (iOS: closure-based, Android: TokenProvider interface) — там делайте запрос к своему API и возвращайте новый токен. Без этого пользователь вылетит из чата через TTL токена.

Как создать каналы и подписаться на события?

Stream использует комбинацию type:id для идентификации канала. Типы — messaging, livestream, team, commerce, gaming — влияют на дефолтные permissions.

// iOS: получить или создать канал 1-на-1
let channelId = ChannelId(type: .messaging, id: "user1_user2")
let controller = client.channelController(
    createChannelWithId: channelId,
    members: [userId, targetId],
    isCurrentUserMember: true
)
controller.synchronize { error in
    ...
}

synchronize() — ключевой вызов. Он подтягивает историю, подписывается на realtime-события и синхронизирует локальный state. Без него канал создаётся, но события не приходят. На Android аналогично через client.channel(channelType, channelId).create(memberIds).

Как настроить push-уведомления?

Stream использует собственный провайдер уведомлений поверх APNs/FCM. Регистрация:

// iOS — после получения APNs токена chatClient.currentUserController().addDevice(.apns(token: deviceToken)) 

// Android
FirebaseMessaging.getInstance().token.addOnSuccessListener { token ->
    client.addDevice(Device(token = token, pushProvider = PushProvider.FIREBASE)).enqueue()
}

Stream самостоятельно отправляет уведомления при новых сообщениях в каналах, где пользователь — участник. В dashboard настраиваем шаблоны уведомлений. Deeplink — через обработку CKNNotificationInfo (iOS) или RemoteMessage.data (Android).

Кастомизация UI: сохраняем функциональность

Stream предоставляет ChatChannelView, MessageListView, MessageComposerView из пакета StreamChatSwiftUI. Кастомизация — через ViewFactory:

class CustomViewFactory: DefaultViewFactory {
    func makeMessageAvatarView(for userInfo: UserAvatarData) -> some View {
        // Ваш кастомный аватар
        CustomAvatarView(imageUrl: userInfo.imageURL)
    }
}

Utils.shared.viewFactory = CustomViewFactory()

Это чище, чем полностью свой UI — 80% поведения (свайп, реакции, тред) достаётся бесплатно, кастомизируем только внешний вид. Полный кастомный UI имеет смысл только если дизайн несовместим с моделью компонентов Stream. Для Android аналогично: MessageListView и MessageComposerView в XML или Compose, кастомизация через AttachmentFactoryManager и MessageListViewModelFactory.

Офлайн-кэш и восстановление соединения

iOS SDK использует CoreData под капотом, Android — Room. Включается автоматически при isLocalStorageEnabled = true в конфигурации (по умолчанию — true). При восстановлении сети SDK автоматически синхронизирует пропущенные события через механизм health check WebSocket.

Что входит в реализацию?

Мы документируем каждый шаг и оставляем вам работающий код. Ниже — этапы и сроки.

Этапы и сроки

С готовыми компонентами StreamChatSwiftUI / StreamChatUI — 3–4 дня. Полностью кастомный UI на Core SDK — 6–8 дней. Стоимость рассчитывается индивидуально. Свяжитесь с нами для аудита текущей реализации или закажите интеграцию под ключ — мы гарантируем стабильность и поддержку после сдачи.