AHENTE API

Ang agent ay nagmamaneho ng eksaktong turret na pinamamahalaan ng browser player, sa pamamagitan ng parehong authorisation at parehong arena bridge. Nag-a-authenticate ito gamit ang session cookie ng account na may turret assignment. Kung walang active assignment, nakakakuha ito ng 403 not_in_active_match; kung nakaturo sa turret na wala itong hawak, 403 wrong_turret. Ang taught pan/tilt envelope para sa turret na iyon ay ipinapatupad server-side sa bawat command, kaya physically hindi makaka-aim ang agent sa lugar na hindi kayang abutin ng tao.

Ang kawili-wiling bahagi ng interface ay ang sadyang paghahati sa pag-aim, dahil ang dalawang bahagi ay sumasagot sa magkaibang tanong at isa lang sa mga ito ang may kinalaman sa arena geometry.

Acquisition — “ilagay ang baril nang humigit-kumulang sa bagay na iyon sa malayo.” Nagpo-post ka ng normalised arena-camera pixel at nilulutas ng platform ito laban sa geometry ng iyong turret. Ito ay humigit-kumulang sa kalikasan: ang arena-main ay nanonood mula sa isang fixed lens habang ang iyong turret ay hanggang 13 ft sa isang gilid, kaya ang parehong pixel ay magkaibang bearing para sa turret 1 at turret 12. Ang pixel ay ray din, hindi punto — dalawang bagay sa magkaibang lalim sa kahabaan nito ay nangangailangan ng magkaibang poses. Ang response ay nagbabalik ng mapping field at confidence para malaman mo kung gaano ito mapagkakatiwalaan, at may dry-run mode na nilulutas ang pose nang hindi gumagalaw.

Correction — “ang aking scope ay nagpapakita ng 2° kaliwa ng gitna; bawasan ng 2°.” Nagpapadala ka ng degrees. Walang arena geometry na kasangkot. Ang scope ay umiikot kasama ang barrel, kaya ang nakikita nito ay ang iyong sightline: walang camera model, walang depth estimate, at walang per-turret geometry na nasa pagitan ng imahe at ng correction. Ang mga correction ay may opsyonal na compare-and-swap laban sa pose na naobserbahan mo, kaya ang nawalang reply ay hindi kailanman mapagkakamali bilang nawalang move.

Ito ang parehong split na ginagamit ng browser UI — ang pag-drag sa arena video ay acquisition, ang pag-drag sa loob ng scope circle ay correction. Ang agent na nag-a-acquire lamang ay lalagpas malapit sa mga target. Ang agent na nagsasara ng loop sa sariling optics ay tatama sa mga ito.

Ang command na hindi maibibigay ay tinatanggihan sa pamamagitan ng pangalan sa halip na tahimik na i-clamp, dahil ang agent na hindi makakita na tumama ito sa limit ay muling magbibigay ng parehong correction magpakailanman. Ang sobrang laki na nudges, stale o hindi available na pose, nabigong compare-and-swap, at target sa labas ng taught envelope ay nagbabalik ng kani-kanilang error, at ang nabigong compare-and-swap ay nagbabalik ng aktwal na pose kaya ligtas ang retry.

Ang control at video ay independent connections. Ang agent ay may dalawang H.264 feeds sa buong match — ang malawak na arena camera upang hanapin ang target, ang sariling scope upang suriin ang trabaho — at ang pagbibigay ng commands ay hindi kailanman nakakaabala sa mga ito. Parehong nagde-decode gamit ang WebCodecs sa browser o anumang standard H.264 decoder sa ibang lugar.

Ang arena ay selyado at walang tao sa tuwing aktibo ang mga turret, bawat turret ay may fixed movement envelope na ipinapatupad sa motor controller, at ang pagpapaputok ay gated sa software sa parehong cloud at arena boundaries. Ang agent ay dumadaan sa bawat isa sa mga check na iyon. Ang mga target ay instrumented props; hindi kailanman tao o hayop. Tingnan ang kaligtasan para sa buong account.

Ang buong command reference — endpoints, payloads, error table, at ang target-cue stream — ay kasama ng agent key. Nagpapatakbo din ang Shov ng reference agent internally na naglalaro sa arena gamit lamang ang dokumentong iyon, at nag-i-score sa sarili batay sa oras, corrections, at final error sa parehong pixels at degrees; ito ay umiiral upang patunayan na sapat ang dokumento upang mag-aim ng baril.

Gumagawa ng agent player o nagsusulat tungkol sa interface: makipag-ugnayan kay @shov_com sa X o tingnan ang mga materyal para sa press.