> Documentation index for agents: https://docs.rocketride.ai/llms.txt

# audio_player

A RocketRide audio sink that plays incoming audio or a video's audio track
through the system output device.

## What it does

The node passes incoming `audio` and `video` streams to a PCM player and has no
downstream lane. Choose it when a local pipeline needs to play a stream rather
than transform it, transcribe it, or generate speech. It serializes playback
across node instances with one shared lock.

## Lanes

| Lane in | Lane out | Description |
| --- | --- | --- |
| `audio` | — | Pass the audio stream to the player. |
| `video` | — | Extract and play the video's audio track. |

## Configuration

This node exposes no configuration fields. It has one empty `default` profile;
playback behavior is fixed by the implementation.

## Limitations

The `nosaas` capability means this node is excluded from SaaS deployments. It
opens an output stream through `sounddevice`, so it is intended for a runtime
that can access an audio output device.

## Notes

### Fixed playback format and buffering

The player is configured for 44,100 Hz, two-channel, signed 16-bit PCM output
with a low-latency stream and 1,024-frame callback blocks. It accumulates input
into 16 KiB chunks and enqueues at most 32 chunks; a full queue blocks incoming
writes, providing natural backpressure that prevents unbounded memory growth.

At end of stream, whatever is left in the accumulator — a partial chunk, or the
whole stream when it is shorter than 16 KiB — is queued ahead of the
end-of-stream marker, so short streams and stream tails are never discarded.

On stop, the node polls until the queue and the internal playback buffer are
both fully drained before closing the stream, so buffered audio plays to
completion. The final callback always fills its output buffer as required by
`sounddevice`: a partial block is played in full and padded with silence, while
an exact-boundary end writes silence before stopping. The callback stops
immediately after committing that terminal block.

<!-- ROCKETRIDE:GENERATED:PARAMS START -->
<!-- Generated by nodes:docs-generate. Do not edit by hand. -->

## Schema

_No configuration fields._

## Dependencies

- `imageio_ffmpeg`
- `sounddevice` `>=0.5`

## Source

[<svg viewBox="0 0 16 16" width="15" height="15" fill="currentColor" aria-hidden="true" style="vertical-align:-0.15em;margin-right:0.35em"><path d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"/></svg> View source](https://github.com/rocketride-org/rocketride-server/tree/develop/nodes/src/nodes/audio_player)
<!-- ROCKETRIDE:GENERATED:PARAMS END -->
