AI ПаделДокументация API На сайт

Тренажёр подачи мяча

Интерфейс для производителей тренажёров подачи — пушек и роботов. Тренажёр сообщает корту о каждом поданном мяче, корт возвращает измеренный результат: где мяч приземлился, отбил ли его игрок и попал ли ответ в мишень.

Что это даёт

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

На экране корта такая тренировка выглядит как обычная тренировка «Пушка»: ничего нового игроку осваивать не надо.

Как подключиться

ОткудаАдресКому подходит
Сеть клубаhttp://<адрес сервера корта>:8016/feeder/…Приложение тренажёра на телефоне в сети клуба, мост в клубе
Интернетhttps://<адрес корта в интернете>/feeder/…Облако производителя

Оба адреса клуб сообщает при подключении. Методы, ключ и ответы одинаковы. Доступ из интернета клуб может отключить — тогда запрос оттуда получит 403.

Корт и зоны

Координаты — в метрах от угла корта: x поперёк от 0 до 10, y вдоль от 0 до 20, сетка на y = 10. Половина 1 — y < 10, половина 2 — y > 10.

Каждая половина разделена на девять зон: три ряда по глубине от сетки и три полосы поперёк. Зона записывается как половина-ряд-полоса, например 2-2-1 — половина 2, дальний ряд, центр. Границы всех восемнадцати зон отдаёт GET /feeder/info.

Мишени тренировки — одна или несколько зон на одной половине. Тренажёр стоит на половине мишеней, игрок — на другой и отбивает в мишени.

Методы

МетодНазначение
GET /feeder/infoВерсия, корты, размеры корта, зоны, пределы
GET /feeder/timeЧасы корта
GET /feeder/sessionСвоя сессия на корте и состояние корта: идёт ли матч, упражнение, открыта ли «Пушка» с экрана
POST /feeder/session/openОткрыть тренировку или подключиться к открытой с экрана корта
POST /feeder/feedСообщить о поданном мяче
GET /feeder/feedsПоданные мячи с результатами
GET /feeder/eventsСобытия с курсором и ожиданием
POST /feeder/session/closeЗакончить тренировку и получить итог

Открыть тренировку

curl -X POST "http://<адрес сервера корта>:8016/feeder/session/open" \
  -H "X-Integration-Key: <ключ тренажёра>" -H "Content-Type: application/json" \
  -d '{"court": "Корт 4", "targets": ["2-2-0", "2-2-1"],
       "machine": {"vendor": "Производитель", "model": "Модель"},
       "program": {"name": "Глубокий драйв", "level": "3"}}'
ПолеЧто это
courtНазвание корта из GET /feeder/info; можно не указывать, если корт один
targetsЗоны-мишени на одной половине
attachtrue — подключиться к тренировке «Пушка», которую игрок уже открыл на экране корта; мишени тогда берутся с экрана
pass_codeQR-пропуск игрока из приложения клуба, если приложение тренажёра умеет его считать; тогда итог попадёт в личный кабинет игрока
playerИмя для экрана корта, если пропуска нет
voicefalse — без голоса корта
machine, programСведения о тренажёре и программе подач; сохраняются с итогом

В ответе — сессия: её id, половина игрока player_half, мишени и сводка totals. Повторный запрос при живой сессии возвращает ту же сессию: после обрыва связи можно просто открыть заново.

Сообщить о поданном мяче

curl -X POST "http://<адрес сервера корта>:8016/feeder/feed" \
  -H "X-Integration-Key: <ключ тренажёра>" -H "Content-Type: application/json" \
  -d '{"session": "<id сессии>", "id": "ball-17", "speed_kmh": 65, "spin": "top",
       "aim": {"x": 5.0, "y": 4.5}}'
ПолеЧто это
idНомер мяча у тренажёра. Повтор запроса с тем же id не создаёт второй мяч
tВремя вылета, секунды Unix. Если не указано, берётся время прихода запроса. Если часы тренажёра расходятся с часами корта больше чем на 2 секунды, тоже берётся время прихода, а в ответе есть clock_skew_s
speed_kmh, spin, kindПараметры подачи по данным тренажёра; сохраняются рядом с результатом
aimКуда целился тренажёр, координаты корта

Запрос отправляется в момент вылета мяча: результат привязывается к подаче по времени. Если запрос идёт через интернет с заметной задержкой, передавайте t и сверяйте часы по GET /feeder/time.

Получать результаты

curl "http://<адрес сервера корта>:8016/feeder/events?court=%D0%9A%D0%BE%D1%80%D1%82%204&after=0&wait=20" \
  -H "X-Integration-Key: <ключ тренажёра>"

after — курсор из прошлого ответа (поле cursor), wait — сколько секунд ждать новых событий, не больше 25.

СобытиеКогдаЧто внутри
session_openedТренировка открытаМишени
feedМяч принятНомер n, ваш id, время
feed_seenКорт увидел приземление поданного мячаseen: время, x, y, зона
resultИзвестен исход мячаstatus, result, сводка totals
session_closedТренировка закрытаКем: partner или court; итог

Исход мяча

codeЧто произошло с ответом игрока
targetВ мишень
other_zoneВ корт, но мимо мишени
outЗа линию
netВ сетку
glassВ стекло без отскока

Те же данные списком — GET /feeder/feeds?after=<номер мяча>.

Закончить

curl -X POST "http://<адрес сервера корта>:8016/feeder/session/close" \
  -H "X-Integration-Key: <ключ тренажёра>" -H "Content-Type: application/json" \
  -d '{"session": "<id сессии>"}'

В ответе — итог totals (подано, увидено кортом, отбито, в мишень, без ответа) и все мячи с результатами. Тренировка закрывается и сама: кнопкой «Стоп» на экране корта или после пяти минут без мячей — тогда придёт событие session_closed с closed_by: "court".

Отказы

КодcodeПричина
401—Нет ключа или ключ неверный
403—Доступ из интернета на этом корте отключён
400—Корта с таким названием нет
409court_busyНа корте идёт матч
409drill_activeНа корте идёт другое упражнение
409feeder_takenК корту уже подключён другой тренажёр
422bad_targetsМишени не заданы, такой зоны нет или мишени на двух половинах
422bad_passQR-пропуск игрока не подошёл
404no_sessionОткрытой сессии нет
429too_many_feedsБольше 3000 мячей в одной сессии

Чего в версии 1 нет