Интегрируйте свои игры с TikXander

Что такое локальная интеграция игр?

Локальная интеграция значит, что ваша игра или виджет — обычная веб-страница (браузер, OBS Browser Source или desktop WebView) и подключается к WebSocket на машине стримера. Локальный агент — мост: он ведёт соединение с TikTok Live (включая browser-mode) и раздаёт нормализованные события приложениям, разрешённым стримером.

События остаются на localhost (127.0.0.1). Публичный бэкенд для приёма подарков во время стрима не обязателен — удобно для OBS-оверлеев, кастомных мини-игр и прототипов.

Для кого это?

• Разработчики игр и виджетов, которым нужны подарки и чат TikTok Live в геймплее.
• Студии, строящие OBS-оверлеи с реакцией на gift, like, follow и chat в реальном времени.
• Креаторы и команды, прототипирующие свои интерактивные форматы до полноценного релиза.
• Те, кто предпочитает локальный низколатентный канал на ПК стримера вместо только облачных релеев.

Как это работает

1) Стример устанавливает и входит в локальный агент TikXander, затем запускает захват live (browser-mode агента — предпочтительный путь).

2) Ваше приложение подключается к локальному каналу событий на порту 8767. На том же localhost-сервере две публичные поверхности: версионированный developer-канал ws://127.0.0.1:8767/events/v1 (app id / права) и локальный DAPI ws://127.0.0.1:8767/dapi для лёгких потребителей на машине.

3) Когда зритель шлёт gift, like, chat или follow, агент отдаёт нормализованный кадр события. Игра мапит его в спавны, прогресс-бары, алерты или очки.

4) На том же хосте: long-poll (/events/v1/poll), simulate (POST /events/v1/simulate) и status (GET /events/v1/status) — чтобы разрабатывать без полного live каждый раз.

Локальные endpoints (ПК стримера)

• WebSocket developer API: ws://127.0.0.1:8767/events/v1 — версионированные события по app.
• WebSocket локальный DAPI: ws://127.0.0.1:8767/dapi — локальный поток событий.
• HTTP-хелперы (тот же порт): /events/v1/poll, /events/v1/simulate, /events/v1/status.
• Только localhost (127.0.0.1:8767): этот канал не покидает ПК стримера.

Типы событий

• gift — подарок зрителя с идентичностью и метаданными (стрики разрешены до fan-out).
• like — лайки в live (мягкий прогресс и ускорения).
• chat — комментарии для keyword-игр, опросов и shout-out.
• follow / join — моменты роста для welcome и счётчиков.
• live_status — сессия началась/закончилась для чистого idle UI.

С чего начать

1. 1. Создайте аккаунт TikXander

   Регистрация на games.tikxander.com — та же панель, что стримеры используют для игр, планов и live-инструментов.

2. 2. Установите локальный агент

   Смотрите продуктовую страницу Local Agent: оверлеи, виджеты и десктоп-агент, открывающий порты событий на localhost.

3. 3. Подключите игру к localhost

   Откройте WebSocket на ws://127.0.0.1:8767/events/v1 (с app id при необходимости) или ws://127.0.0.1:8767/dapi и смапьте gift/like/chat/follow на логику игры.

4. 4. Тестируйте без полного live

   Используйте POST /events/v1/simulate и GET /events/v1/status на том же хосте, чтобы инжектить тестовые подарки.

5. 5. Публикуйте в потоке стримера

   Стримеры могут сочетать ваш опыт с каталогом, виджетами и session-tools TikXander из панели.

Почему разработчики выбирают TikXander

Канал событий в реальном времени рядом с OBS, понятные типы (gift, like, chat, follow), симуляция для разработки и продуктовая поверхность, которой стримеры уже доверяют для интерактивного TikTok Live. Аккаунты и планы — games.tikxander.com; страница Local Agent — на этом сайте (например /ru/local-agent).

Часто задаваемые вопросы