ProxyRelayListener

package com.socketsvc.proxy.api;

public interface ProxyRelayListener { ... }

Observes the relay's connection lifecycle. Every method is a no-op by default, so an addon only overrides what it needs.

Callbacks run on the relay's own threads, never on the proxy's main thread, and a listener that throws is logged and skipped rather than breaking the connection. Do not block in them: the open callback runs before the connection is piped, and the close callback runs as it is torn down. These report relay activity only — the relay never decodes audio, so there is nothing here about speaking, volume or positions. Those live on the backend's own spatial audio API.

MethodsCopy Anchor Link

onRelayOpenedCopy Anchor Link

default void onRelayOpened(RelaySession session)

A connection was matched to a backend and is about to be piped through. Before the backend has checked its token: the session's player id is only what the client claimed.

onRelayClosedCopy Anchor Link

default void onRelayClosed(RelaySession session)

A previously opened relay finished, for any reason (either side closed, or the relay stopped).

onRelayRejectedCopy Anchor Link

default void onRelayRejected(UUID playerId, String reason)

An incoming connection was closed without being relayed.