LocalAudioChannel

package com.socketsvc.client.api;

public interface LocalAudioChannel { ... }

A locally-rendered sound: only the local player hears it. Never sent over the network, so it has nothing to do with the voice connection or any other player's microphone - use this for things like a client-side ambience mod or a personal 3D notification sound.

MethodsCopy Anchor Link

getIdCopy Anchor Link

UUID getId()

playCopy Anchor Link

void play(short[] pcm)

Plays one 20 ms frame: 48 kHz, mono, signed 16-bit PCM, exactly 960 samples.

Does not block and does not pace. A short queue sits behind it to absorb ordinary jitter, and a frame offered when that queue is full is refused - so a caller that hands over frames faster than 20 ms of sound per 20 ms of time loses the surplus rather than building latency nobody can see. A frame of the wrong length is refused for the same reason: playing it would play it at the wrong speed.

Which makes #queued() the thing to pace against, not a timer. See its note.

queuedCopy Anchor Link

int queued()

How many frames this channel is still holding, of the #capacity() it can.

The clock for anything feeding a continuous stream. A film, a radio, anything that decodes ahead of itself has to be held back by something, and the only honest measure of "far enough ahead" is how much the mixer has not played yet. Feed while this is below a frame or two of target and wait while it is not, and nothing is ever refused.

Pacing against a wall clock instead is what this replaces, and it does not work: two clocks that agree on the rate still disagree on the phase, and the difference accumulates into exactly the surplus #play has to throw away.

capacityCopy Anchor Link

int capacity()

The most #queued() can be. A frame offered past it is refused.

isClosedCopy Anchor Link

boolean isClosed()

closeCopy Anchor Link

void close()

Stops playback and releases the channel; further #play calls are ignored.