Документация
Docs/ru/reference/ai-control-protocol/methods.md
Методы AiControl
Сгенерированный справочник. Не редактируйте его напрямую. Измените
BuildTools/AiControlProtocol.json, затем запуститеpython BuildTools/docs_ai_control_protocol.py --write.
| Обзор | Wire-контракт | Методы | Команды и события | Безопасность | Интеграция и проверка | Канонический JSON | Руководство |
| Стабильный ID | Метод | Параметры | Результат | Контракт | Источник |
|---|---|---|---|---|---|
ai-control-protocol.method.auth |
auth |
{token: string} |
{authorized: boolean} |
Аутентифицирует текущее соединение настроенным общим token; неудачная попытка оставляет его неавторизованным, а следующая попытка может завершиться успешно. | Examples/AiControlSample/ai_control_sample.py |
ai-control-protocol.method.ping |
ping |
{} |
{ok: true} |
Сообщает о доступности bridge после авторизации. | Examples/AiControlSample/ai_control_sample.py |
ai-control-protocol.method.status |
status |
{} |
{running, host, port, queuedCommands, maxQueuedCommands, events, maxEvents, observationSeq, lastError} |
Возвращает состояние транспорта, заполнение и пределы очереди/событий, sequence последнего наблюдения и последнюю ошибку bridge. | Examples/AiControlSample/ai_control_sample.py |
ai-control-protocol.method.observe |
observe |
{} |
{observationSeq: integer, observation: object} |
Возвращает последний полный проектный снимок наблюдения и монотонно возрастающий sequence его замены. | Examples/AiControlSample/ai_control_sample.py |
ai-control-protocol.method.events |
events |
{afterSeq?: integer, limit?: integer} |
{latestSeq: integer, events: [{seq: integer, event: object}]} |
Возвращает сохранённые события с seq больше afterSeq по возрастанию; ограничивает limit диапазоном 1..500. | Examples/AiControlSample/ai_control_sample.py |
ai-control-protocol.method.act |
act |
project command object with non-empty type |
{accepted: true, commandSeq: integer} |
Ставит в очередь одну проектную команду и возвращает её sequence; принятие не означает завершение или игровой успех. | Examples/AiControlSample/ai_control_sample.py |