Аддоны оверлея
Оверлеи — кратковременные эффекты, запускаемые правилами, таймерами или событиями дашборда.
Манифест
| Поле | Значение |
|---|---|
type |
overlay или overlay.info |
web_type |
overlay (когда задан web) |
Панели overlay.info показываются после или во время основного эффекта, когда у родительского оверлея включён showInfo.
Варианты
Простой медиа-оверлей (без воркера)
manifest.overlay с путями audio / video. Без index.js, без разрешений. Воспроизведение через встроенный iframe простого плеера.
Настройки: громкость, цикл, скрытие в конце, длительность (могут ограничиваться в манифесте).
Статический веб-оверлей (без воркера)
web + web_type: "overlay", без index.js. Требует WEB_CONTENT и файлы из web_contents.
Статический URL: /addon_static/{id}/
Параметры рантайма (громкость, длительность) можно читать из:
GET /overlay/settings/{overlayId}?token=
Полный аддон оверлея (с воркером)
type: "overlay", воркер index.js, WEB_CONTENT для кастомного HTML-эффекта.
Аддоны платформ с DASHBOARD_EVENTS могут регистрировать триггеры оверлея через dashboard.registerTriggers() и передавать trigger в addRecord().
Разрешения
| Паттерн | Разрешения |
|---|---|
| Только статический HTML | WEB_CONTENT |
| Воркер + HTTP для страницы | WEB_CONTENT, WEB_END_POINTS, часто SOCKET_END_POINTS |
Проверяйте data.token на эндпоинтах, предназначенных только для веб-страницы оверлея.