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.

Methods複製段落連結

onRelayOpened複製段落連結

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.

onRelayClosed複製段落連結

default void onRelayClosed(RelaySession session)

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

onRelayRejected複製段落連結

default void onRelayRejected(UUID playerId, String reason)

An incoming connection was closed without being relayed.