Передача игровых событий в vMix/OBS

Как получить ссылку на данные?

Для каждого поля турнира вы можете получить автоматическую ссылку, по которой в реальном времени обновляются игровые события. Данные доступны в формате CSV или JSON — выбирайте тот, который удобнее для вашей системы:

Примеры ссылок:

• CSV: https://api.ultisport.ru/export/game-on-the-field/spring2025/1/csv

• JSON: https://api.ultisport.ru/export/game-on-the-field/spring2025/1/json

Структура URL:

Ссылка

https://api.ultisport.ru/export/game-on-the-field/{URL_турнира}/{номер_поля}/{формат}

• {URL_турнира} — адрес турнира, например: spring2025, autumn2024, и т.д.

• {номер_поля} — номер поля на турнире: 1, 2, 3, ...

• {формат} — csv или json

Структура данных

Вот какие поля содержит файл (один ряд — одно текущее состояние игры):

Поле	Описание
status	Статус игры: NOT_STARTED, IN_PROGRESS, FINISHED
field	Номер поля
homeTeamScore	Счёт команды слева (домашняя команда)
visitorTeamScore	Счёт команды справа (гостевая команда)
homeTeamTitle	Полное название команды слева
visitorTeamTitle	Полное название команды справа
homeTeamAlias	Короткое название команды слева (до 5 символов)
visitorTeamAlias	Короткое название команды справа (до 5 символов)
homeTeamCity	Город команды слева
visitorTeamCity	Город команды справа
remainTimeText	Сколько времени осталось до конца матча, формат MM:SS, например 23:59
timePassedText	Сколько времени прошло, формат MM:SS
isPaused	true, если игра на паузе
timePassedSec	Сколько времени прошло в секундах
remainTimeSec	Сколько времени осталось в секундах
durationSec	Общая продолжительность игры в секундах
startedAt	Когда началась игра (в формате времени сервера)

Поля homeTeamAlias и visitorTeamAlias необходимо заранее согласовать с организаторами или отправить нам, чтобы мы добавили их в систему. Они используются для удобства отображения в графике и ограничены по длине (до 5 символов). Данные заносятся только для действительно крупных турниров.

Как подключить данные в OBS и vMix

OBS (через Text (GDI+) + Data Source)

1. В OBS добавьте новый источник: Text (GDI+)

2. В настройках включите галочку "Read from file" / "Читать из файла"

3. Укажите путь к локальному .txt файлу, который будет регулярно обновляться

4. Настройте скрипт или стороннюю программу (например, [StreamDeck], [NodeCG], [Touch Portal]), которая будет читать нужные данные из JSON/CSV и записывать в этот текстовый файл.

Выбирайте, какие поля выводить: счёт, названия команд, таймер и т.д. Всё зависит от шаблона вашей трансляции.

vMix (через Data Source Input)

1. Откройте vMix и перейдите в Add Input > Data Source

2. Выберите CSV или JSON, в зависимости от формата файла

3. В поле URL вставьте ссылку, например: https://api.ultisport.ru/export/game-on-the-field/spring2025/1/json

4. Укажите частоту обновления данных (например, каждые 1–2 секунды)

5. Добавьте Title шаблон и свяжите поля из данных с соответствующими текстовыми элементами (например, счёт, названия, таймер)

Рекомендации по отображению

• Для счёта используйте homeTeamScore и visitorTeamScore

• Для таймера — timePassedText или remainTimeText, в зависимости от логики трансляции

• Для приостановки таймера — учитывайте поле isPaused

• Названия команд — homeTeamAlias (слева) и visitorTeamAlias (справа), если нужно компактно; либо полные названия через homeTeamTitle

Тестовые данные

Если вам нужны тестовые данные для настройки? Напишите нам в Телеграм - мы оперативно отправим вам рабочую ссылку с примером.