Struct ClientState 

pub struct ClientState<G: GameClientDef> { /* private fields */ }

Generic оркестрация клиентского ядра поверх игровой G: GameClientDef: сетевой буфер (interpolator), очередь событийных кадров, hot-буфер рендер-тика. Байтовая раскладка hot-буфера (флаги/камера/N танков×поля/M динамики×поля/predicted-хвост) не меняется — см. write_hot.

Implementations

impl<G: GameClientDef> ClientState<G>

pub fn new(cfg: EngineClientConfig, game_cfg: &G::Config) -> Self

pub fn push_frame(&mut self, data: &[u8], local_now: f64) -> bool

Бинарный кадр из транспорта: распаковка, вставка в буфер по seq, reconciliation предикта по player-блоку. false — кадр отброшен (чужой порт, версия или повреждённые данные).

pub fn game(&self) -> &G

Игровая половина ядра: игровая обёртка ABI (ClientCore плагина) достаёт через неё свои подсистемы — движок их формы не знает.

pub fn my_game_id(&self) -> Option<u32>

pub fn offset(&self) -> Option<f64>

pub fn sample(&mut self, local_now: f64) -> usize

Рендер-тик: выдача пересечённых кадров (фильтр дублей → JSON-очередь), интерполяция, шаг предикта, запись hot-буфера. Возвращает длину hot-буфера в f32-элементах.

pub fn hot(&self) -> &[f32]

pub fn take_frames(&mut self) -> String

Событийные кадры JSON-строкой [{game, camera}, …]; очередь очищается.

pub fn apply_input(&mut self, action: &str, key_name: &str, local_now: f64)

pub fn apply_aim(&mut self, x: f32, y: f32, flags: u32, local_now: f64)

pub fn try_action(&mut self, local_now: f64) -> Option<String>

pub fn cycle_item(&mut self, back: bool)

pub fn set_model(&mut self, model_name: &str)

pub fn set_active(&mut self, active: bool)

Смена режима игрок/спектатор (KEYSET_DATA).

pub fn set_map(&mut self, map_json: &str) -> Result<(), String>

Данные карты (MAP_DATA): мир raycast + сброс буфера и предикта.

pub fn sync_panel(&mut self, panel_json: &str)

pub fn reset(&mut self)

Полный сброс (порт CLEAR).

pub fn resync(&mut self)

Ресинк часов после долгой паузы вкладки (visibilitychange → visible): сетевая половина начинает с чистого листа, чтобы следующий кадр пересеял оффсет точно, а не догонял EMA десятки кадров. Игровую половину (предикт, своя идентичность) не трогаем — сущности на полотне живы.

pub fn debug_json(&self) -> String

Зеркало серверного EngineSim::debug_json на клиенте: состояние сетевого буфера (глубина, окно seq, оффсет, последний кадр), свой gameId, размеры hot-буфера и очереди событийных кадров.

pub fn take_divergence(&mut self) -> String

Записи расхождения предикта с авторитетным состоянием (JSON, см. client::divergence); очередь очищается. "null" — детектор выключен (боевой конфиг без секции divergence).

pub fn decode_frame(&self, data: &[u8]) -> String

Чистая распаковка кадра v3 в JSON-форму unpackFrame (тесты/харнесс).