import threading import logging from typing import Callable, List from .photon import PhotonDecoder, PhotonMessage from .translate import into_game_message from .world import World from . import discovery logger = logging.getLogger(__name__) class Pipeline: """Decodes captured UDP payloads into app events (aoaddons lib.rs flow).""" def __init__(self, emit: Callable[[dict], None]): self.emit = emit self.decoder = PhotonDecoder() self.world = World() self._lock = threading.RLock() self._warned_unknown = set() def on_udp(self, payload: bytes): logger.debug("received UDP payload: %d bytes", len(payload)) discovery.log( 'udp_payload', length=len(payload), payload_hex=payload.hex()) messages = self.decoder.decode_packet(payload) if not messages: return with self._lock: for message in messages: discovery.log( 'photon_message', message=discovery.message_record(message)) for event in self._events_from_message(message): self.emit(event) def _events_from_message(self, message: PhotonMessage) -> List[dict]: game_message = into_game_message(message) if game_message is None: self._warn_unknown_game_message(message) return [] discovery.log( 'game_message', message=discovery.game_message_record(game_message)) logger.debug("translated game message: %s", game_message) events = self.world.transform(game_message) for event in events: discovery.log('app_event', event=event) logger.debug("emitting app event: %s", event) return events def _warn_unknown_game_message(self, message: PhotonMessage): if message.kind == 'Event': key = ('Event', message.code, message.params.get(252)) elif message.kind in ('Request', 'Response'): key = (message.kind, message.code, message.params.get(253)) else: return if key in self._warned_unknown: return self._warned_unknown.add(key) logger.warning("ignoring unknown Photon game message: kind=%s code=%s opcode=%s params=%s", key[0], key[1], key[2], message.params)