player_state API

完整接口目录 · 玩家查询用法 · 工具包下载

模块说明

Single-owner projection of the core's observed player maps.

No callbacks, threads or invented join events. A fault clears state permanently;
create a new instance from a new atomic snapshot. Returned snapshots are copies.

PlayerState

class PlayerState

SDK 说明：

Bounded current state, not history or a complete-roster assertion.

At most 4096 entries in each of three maps and 8 MiB charged payload. Python
object overhead, incoming document, copy-on-update and caller snapshots are
additional; at most old plus replacement map payload coexist during apply.
Call from one owner; this class is not a concurrent synchronization primitive.

PlayerState.__init__

def __init__(self, snapshot)

PlayerState.epoch

@property
def epoch(self)

PlayerState.revision

@property
def revision(self)

PlayerState.apply

def apply(self, observation, *, epoch)

SDK 说明：

Apply exactly the next revision, atomically for the single owner.

PlayerState.snapshot

def snapshot(self)

SDK 说明：

Return an independent current snapshot; does not emit player events.