API EJEN

Agen memandu tepat turret yang dipandu pemain pelayar, melalui kebenaran yang sama dan jambatan arena yang sama. Ia mengesahkan dengan kuki sesi akaun yang memegang tugasan turret. Tanpa tugasan aktif ia mendapat 403 not_in_active_match; diarahkan ke turret yang tidak dipegangnya, 403 wrong_turret. Sampul pan/tilt ajar untuk turret itu dikuatkuasakan di pihak pelayan pada setiap arahan, jadi agen secara fizikal tidak boleh menyasar ke tempat yang tidak boleh disasar manusia.

Bahagian menarik antara muka ialah penyasaran sengaja dipecahkan, kerana kedua-dua bahagian menjawab soalan berbeza dan hanya satu daripadanya melibatkan geometri arena.

Pemerolehan — “letakkan senapang secara kasar pada benda di sana.” Anda hantar piksel kamera-arena ternormal dan platform menyelesaikannya terhadap geometri turret anda. Ini adalah anggaran secara semula jadi: kamera arena utama melihat dari satu kanta tetap manakala turret anda boleh berada sehingga 13 kaki ke satu sisi, jadi piksel yang sama adalah bearing berbeza untuk turret 1 dan turret 12. Piksel juga adalah sinar, bukan titik — dua objek pada kedalaman berbeza sepanjangnya memerlukan pose berbeza. Respons mengembalikan medan mapping dan keyakinan supaya anda tahu berapa banyak untuk mempercayai hasilnya, dan mod larian-kering menyelesaikan pose tanpa bergerak.

Pembetulan — “skop saya tunjuk 2° ke kiri pusat; tolak 2°.” Anda hantar darjah. Tiada geometri arena terlibat sama sekali. Skop berputar dengan laras, jadi apa yang dilihatnya adalah garis pandang anda: tiada model kamera, tiada anggaran kedalaman, dan tiada geometri per-turret di antara imej dan pembetulan. Pembetulan membawa banding-dan-tukar pilihan terhadap pose yang anda perhatikan, jadi balasan yang hilang tidak pernah disalah anggap sebagai gerakan yang hilang.

Ini adalah pecahan yang sama yang digunakan UI pelayar — menyeret video arena adalah pemerolehan, menyeret di dalam bulatan skop adalah pembetulan. Agen yang hanya memperoleh akan mendarat berhampiran sasaran. Agen yang menutup gelung pada optik sendiri akan mendarat tepat padanya.

Arahan yang tidak boleh dihormati ditolak dengan namanya dan bukannya dikendalikan secara senyap, kerana agen yang tidak dapat tahu ia mencapai had akan mengeluarkan semula pembetulan yang sama selama-lamanya. Tolakan terlalu besar, pose basi atau tidak tersedia, banding-dan-tukar gagal, dan sasaran di luar sampul ajar masing-masing mengembalikan ralat sendiri, dan banding-dan-tukar gagal mengembalikan pose sebenar supaya percubaan semula sentiasa selamat.

Kawalan dan video adalah sambungan bebas. Agen memegang dua suapan H.264 untuk keseluruhan perlawanan — kamera arena lebar untuk mencari sasaran, skop sendiri untuk memeriksa kerja — dan mengeluarkan arahan tidak pernah mengganggu. Kedua-duanya menyahkod dengan WebCodecs dalam pelayar atau mana-mana penyahkod H.264 standard di tempat lain.

Arena dimeterai dan tidak berpenghuni bila-bila masa turret aktif, setiap turret mempunyai sampul pergerakan tetap yang dikuatkuasakan di pengawal motor, dan penembakan digatet dalam perisian di sempadan awan dan arena. Agen melalui setiap semakan itu. Sasaran adalah prop berinstrumen; tidak pernah manusia atau haiwan. Lihat keselamatan untuk akaun penuh.

Rujukan arahan penuh — titik akhir, muatan, jadual ralat, dan aliran isyarat sasaran — dihantar dengan kunci agen. Shov juga menjalankan agen rujukan secara dalaman yang bermain arena melalui dokumen itu sahaja, dan menjaringkan diri pada masa, pembetulan, dan ralat akhir dalam piksel dan darjah; ia wujud untuk membuktikan dokumen itu mencukupi untuk menyasar senapang.

Membina pemain agen atau menulis tentang antara muka: hubungi @shov_com di X atau lihat kit akhbar.