---
title: "События реального времени"
description: "Доставка событий пользователю через HTTP-ответы, опрос и подключаемые push-драйверы"
canonical_url: "https://frame.qubeek.io/ru/developers/customization/realtime"
---
# События реального времени

> Доставка событий пользователю через HTTP-ответы, опрос и подключаемые push-драйверы

Frame сохраняет события для пользователя и доставляет их клиенту через обычные HTTP-ответы и фоновый опрос `/sync`. Базовый режим не требует отдельного WebSocket- или SSE-сервиса.

## Базовая доставка

Сервер добавляет события в `meta.events` ответа. Клиент также получает `meta.unread` и `meta.session` для счётчика уведомлений и состояния сессии. Когда обычных запросов нет, базовый драйвер обращается к `/sync`.

Настройки находятся в `config/frame.php`:

```ini [.env]
FRAME_REALTIME_DRIVER=null
FRAME_REALTIME_POLL=30000
FRAME_REALTIME_RETENTION=3600
```

`null` означает базовый режим, а не отключение доставки. Интервал опроса задаётся в миллисекундах. `retention` задаёт срок хранения доставленных событий в секундах.

## Отправка события

Передайте конкретного получателя в `RealtimeManager`. Сначала событие записывается в хранилище, затем передаётся активному push-драйверу, если он подключён.

```php
use Frame\Laravel\Realtime\RealtimeManager;

app(RealtimeManager::class)->emit($recipient, 'report.ready', [
    'report_id' => $report->getKey(),
]);
```

`$recipient` — модель пользователя, реализующая Laravel `Authenticatable`. Выбирайте получателя на сервере после проверки прав. Передавайте минимальные данные, например идентификатор отчёта; получение самого отчёта должно проверять доступ отдельно.

## Подписка в компоненте

Используйте `useRealtime()` из `@frame/vue`. Метод `on()` возвращает функцию отписки — вызовите её при размонтировании компонента:

```ts
import { useRealtime } from '@frame/vue'
import { onUnmounted } from 'vue'

const realtime = useRealtime()

const unsubscribe = realtime.on('report.ready', (data) => {
  // Refresh the report list through its authorized API.
})

onUnmounted(() => {
  unsubscribe()
})
```

Клиент устраняет повторную обработку событий с уже увиденными идентификаторами в своём ограниченном буфере. Это не гарантия однократного исполнения бизнес-операции: обработчик должен допускать повторную доставку и повторное открытие страницы.

## Подключаемые транспорты

Push-транспорт подключается отдельным адаптером. На сервере он регистрирует драйвер через `RealtimeManager::extend()`, на клиенте — через `DriverRegistry.register()` из `@frame/vue`. Имя драйвера и клиентские параметры приходят в блоке `realtime` ответа `/meta`.

Одной переменной `FRAME_REALTIME_DRIVER` недостаточно: серверный и клиентский адаптеры должны быть установлены и зарегистрированы. Неизвестное имя серверного драйвера приводит к ошибке конфигурации. Секреты сервиса не передавайте в публичный конфиг; клиенту нужны только параметры подключения и ограниченные полномочия конкретного пользователя.

## Что дальше

- [Уведомления](https://frame.qubeek.io/ru/developers/functions/notifications) — настройте уведомления пользователям.
- [Конфигурация приложения](https://frame.qubeek.io/ru/developers/customization/config) — разделите серверные и клиентские параметры.
- [Создание модуля](https://frame.qubeek.io/ru/developers/modules/custom) — подключите обработчик в свой модуль.


## Sitemap

See the full [sitemap](https://frame.qubeek.io/sitemap.md) for all pages.
