Перейти к основному содержимому
Версия: 5.8.2

Быстрый старт

Это руководство поможет запустить чат в вашем приложении за несколько минут.

Чеклист готовности​

Перед началом убедитесь, что у вас есть всё необходимое:

  • Xcode 16+ установлен, таргет проекта — iOS 14.0+, Swift 5
  • providerUid — уникальный ключ приложения (выдаётся edna при интеграции)
  • URL-адреса сервера — REST, WebSocket, DataStore (выдаются edna) или имя облачного хоста
  • SDK подключён — через CocoaPods, SPM или вручную (инструкция)
  • Доступ к сети — устройство/симулятор может достучаться до сервера edna
Нет данных для подключения?

Напишите на support@edna.ru — вам предоставят providerUid и URL-адреса для вашего окружения.

Вариант 1. Попробовать демо-приложение​

Демо-приложение позволяет быстро оценить возможности SDK без интеграции в ваш проект.

  1. Скачайте проект — ChatCenterDemo.

  2. Откройте ChatCenterDemo.xcodeproj в Xcode.

  3. Смените Bundle Identifier на ваш в настройках таргета.

  4. Отредактируйте файл Resources/servers.json — укажите ваши данные для подключения:

[
    {
        "name": "Мой сервер",
        "isSelected": true,
        "restURL": "https://your-server.edna.ru",
        "webSocketURL": "wss://your-server.edna.ru/socket",
        "dataStoreURL": "https://your-server.edna.ru/files",
        "providerUid": "YOUR_PROVIDER_UID",
        "apiVersion": 17
    }
]

  1. Запустите приложение на устройстве или симуляторе.

  2. Выберите сервер и пользователя, нажмите Войти — откроется экран чата.

подсказка

Серверы и пользователей также можно добавлять и редактировать прямо в интерфейсе демо-приложения.

Вариант 2. Минимальная интеграция в ваше приложение​

Шаг 1. Подключите SDK​

Добавьте фреймворк одним из способов, описанных в разделе Подключение.

Шаг 2. Инициализируйте SDK​

import ChatCenterUI

// Настройка подключения
let transport = ChatTransportConfig(cloudHost: "your-server.edna.ru")
let chatConfig = ChatConfig(transportConfig: transport)

// Инициализация SDK (рекомендуется в AppDelegate)
let chatCenterSDK = ChatCenterUISDK(
    providerUid: "YOUR_PROVIDER_UID",
    chatConfig: chatConfig
)

Шаг 3. Авторизуйте пользователя​

let chatUser = ChatUser(identifier: "unique_user_id", name: "Имя пользователя")
chatCenterSDK.authorize(user: chatUser)
Безопасность идентификатора

Не используйте номер телефона, email или другие легко угадываемые данные в качестве identifier. Подробнее — в разделе Управление пользователем.

Шаг 4. Откройте чат​

let chatController = try chatCenterSDK.getChat()
navigationController?.pushViewController(chatController, animated: true)

Готово — чат работает.

Что дальше​

Последнее обновление