StreamKit+ Addon Docs

Початок роботи

Що таке інтеграційний аддон?

Інтеграційний аддон — це папка, яку користувач обирає під час встановлення. Вона містить як мінімум manifest.json. Залежно від категорії аддона можуть також бути:

Застосунок зберігає шлях встановлення в Config.data.addonsInstalled[].path. Аддони не входять до основного бінарного файлу застосунку.

Архітектура

Шар Роль
Папка аддона manifest.json + index.js та/або web-ресурси
Main process Запускає worker, застосовує дозволи, маршрутизує HTTP/config IPC, обслуговує статичні маршрути
Worker sandbox GenerateContext() + vm.runInContext — глобальні об'єкти, доступні коду аддона

Код аддона має використовувати глобальні імена з контексту пісочниці. import SDK StreamKit+ всередині VM не підтримується.

Встановлення аддона

  1. Зберіть або підготуйте папку з manifest.json (і необхідними файлами).
  2. Відкрийте Settings → розділ, що відповідає type вашого аддона (Platforms, Overlay, Widgets, Applications).
  3. Install from folder і оберіть каталог.
  4. Підтвердіть запитані permissions під час встановлення.
  5. Увімкніть аддон і налаштуйте параметри, якщо worker викликає GenerateConfig().

Для worker-аддонів на TypeScript: скомпілюйте в index.js перед встановленням або встановіть папку з виходом webpack.

Мінімальний приклад worker

await network.endpoints.create('hook', 'POST', 'onHook');

events.On('onHook', ({ body }) => {
  console.log('Webhook payload', body);
  return { ok: true };
});

URL ендпоінта:

http://localhost:{WEB_SERVER_PORT}/addon/{addonId}/hook

Замініть {addonId} на id з manifest.json, а {WEB_SERVER_PORT} — на локальний порт web-сервера застосунку.

Структура проєкту (рекомендовано)

MyOrg-my-stream-addon/
├── manifest.json       # id: "MyOrg/my-stream-addon"
├── index.js            # або index.ts + tsconfig.json (збірка в index.js)
├── logo.png            # іконка з маніфесту
├── index.html          # якщо потрібен web UI
└── ...                 # додаткові ресурси з web_contents

Пов'язані матеріали