# pulsesink
Source: [https://docs.qualcomm.com/doc/80-70014-50/topic/pulsesink.html](https://docs.qualcomm.com/doc/80-70014-50/topic/pulsesink.html)
The pulsesink plugin interacts with the underlying PulseAudio sound server to play
the PCM samples.
The PulseAudio Server interacts with the underlying hardware to provide the playback
capability and is based on [GstAudioBaseSink](https://gstreamer.freedesktop.org/documentation/audio/gstaudiobasesink.html#GstAudioBaseSink) base class.
## Inheritance chain
[GObject](https://docs.gtk.org/gobject/) → [GstObject](https://gstreamer.freedesktop.org/documentation/gstreamer/gstobject.html?gi-language=c) → [GstElement](https://gstreamer.freedesktop.org/documentation/gstreamer/gstelement.html?gi-language=c) → [GstBaseSink](https://gstreamer.freedesktop.org/documentation/base/gstbasesink.html?gi-language=c#GstBaseSink)→ [GstAudioBaseSink](https://gstreamer.freedesktop.org/documentation/audio/gstaudiobasesink.html#GstAudioBaseSink) → GstPulseSink
The following tables provide information on pad templates and element properties of
pulsesink. For use cases, see [Audio (only) playback](https://docs.qualcomm.com/doc/80-70014-50/topic/audio-only-playback.html).
## Pad configuration
| Pad Name | Capabilities | Capabilities | Capabilities |
| --- | --- | --- | --- |
| SINK template: 'sink'
*Availability:* Always
*Direction:* sink | audio/x-raw | format: | { (string)S16LE, (string)S16BE, (string)F32LE, (string)F32BE,
(string)S32LE, (string)S32BE, (string)S24LE, (string)S24BE,
(string)S24\_32LE, (string)S24\_32BE, (string)U8 } |
| SINK template: 'sink'
*Availability:* Always
*Direction:* sink | audio/x-raw | layout: | interleaved |
| SINK template: 'sink'
*Availability:* Always
*Direction:* sink | audio/x-raw | rate: | [ 1, 22579200 ] |
| SINK template: 'sink'
*Availability:* Always
*Direction:* sink | audio/x-raw | channels: | [ 1, 32 ] |
| SINK template: 'sink'
*Availability:* Always
*Direction:* sink | audio/x-alaw | rate: | [ 1, 22579200 ] |
| SINK template: 'sink'
*Availability:* Always
*Direction:* sink | audio/x-alaw | channels: | [ 1, 32 ] |
| SINK template: 'sink'
*Availability:* Always
*Direction:* sink | audio/x-mulaw | rate: | [ 1, 22579200 ] |
| SINK template: 'sink'
*Availability:* Always
*Direction:* sink | audio/x-mulaw | channels: | [ 1, 32 ] |
| SINK template: 'sink'
*Availability:* Always
*Direction:* sink | audio/x-ac3 | framed: | true |
| SINK template: 'sink'
*Availability:* Always
*Direction:* sink | audio/x-eac3 | framed: | true |
| SINK template: 'sink'
*Availability:* Always
*Direction:* sink | audio/x-dts | framed: | true |
| SINK template: 'sink'
*Availability:* Always
*Direction:* sink | audio/x-dts | block-size: | { (int)512, (int)1024, (int)2048 } |
| SINK template: 'sink'
*Availability:* Always
*Direction:* sink | audio/mpeg | mpegversion: | 1 |
| SINK template: 'sink'
*Availability:* Always
*Direction:* sink | audio/mpeg | mpegaudioversion: | [ 1, 3 ] |
| SINK template: 'sink'
*Availability:* Always
*Direction:* sink | audio/mpeg | parsed: | true |
| SINK template: 'sink'
*Availability:* Always
*Direction:* sink | audio/mpeg | mpegversion: | { (int)2, (int)4 } |
| SINK template: 'sink'
*Availability:* Always
*Direction:* sink | audio/mpeg | framed: | true |
| SINK template: 'sink'
*Availability:* Always
*Direction:* sink | audio/mpeg | stream-format: | adts |
| | | | |
| | | | |
| | | | |
| | | | |
| | | | |
| | | | |
| | | | |
| | | | |
| | | | |
| | | | |
| | | | |
| | | | |
| | | | |
| | | | |
| | | | |
| | | | |
| | | | |
## Element configuration
Table : Elements properties of pulsesink
| Property | Description |
| --- | --- |
| name |
- The name of the object
- flags: readable, writable
- String. Default: "pulsesink0"
|
| parent |
- The parent of the object
- flags: readable, writable
- Object of type "GstObject"
|
| sync |
- Sync on the clock
- flags: readable, writable
- Boolean. Default: true
|
| max-lateness |
- Maximum number of nanoseconds that a buffer can be late
before it is dropped (-1 unlimited)
- flags: readable, writable
- Integer64. Range: -1 - 9223372036854775807 Default: -1
|
| qos |
- Generate Quality-of-Service events upstream
- flags: readable, writable
- Boolean. Default: false
|
| async |
- Go asynchronously to PAUSED
- flags: readable, writable
- Boolean. Default: true
|
| ts-offset |
- Timestamp offset in nanoseconds
- flags: readable, writable
- Integer64. Range: -9223372036854775808 - 9223372036854775807
Default: 0
|
| enable-last-sample |
- Enable the last-sample property
- flags: readable, writable
- Boolean. Default: false
|
| last-sample |
- The last sample received in the sink
- flags: readable
- Boxed pointer of type "GstSample"
|
| blocksize |
- Size in bytes to pull per buffer (0 = default)
- flags: readable, writable
- Unsigned Integer. Range: 0 - 4294967295 Default: 4096
|
| render-delay |
- Additional render delay of the sink in nanoseconds
- flags: readable, writable
- Unsigned Integer64. Range: 0 - 18446744073709551615 Default:
0
|
| throttle-time |
- The time to keep between rendered buffers (0 =
disabled)
- flags: readable, writable
- Unsigned Integer64. Range: 0 - 18446744073709551615 Default:
0
|
| max-bitrate |
- The maximum bits per second to render (0 = disabled)
- flags: readable, writable
- Unsigned Integer64. Range: 0 - 18446744073709551615 Default:
0
|
| buffer-time |
- Size of audio buffer in microseconds, this is the minimum
latency that the sink reports
- flags: readable, writable
- Integer64. Range: 1 - 9223372036854775807 Default:
200000
|
| latency-time |
- The minimum amount of data to write in each iteration in
microseconds
- flags: readable, writable
- Integer64. Range: 1 - 9223372036854775807 Default:
10000
|
| provide-clock |
- Provide a clock to be used as the global pipeline clock
- flags: readable, writable
- Boolean. Default: true
|
| slave-method |
- Algorithm used to match the rate of the masterclock
- flags: readable, writable
Enum "GstAudioBaseSinkSlaveMethod" Default: 1, "skew"
- (0): resample - GST_AUDIO_BASE_SINK_SLAVE_RESAMPLE
- (1): skew - GST_AUDIO_BASE_SINK_SLAVE_SKEW
- (2): none - GST_AUDIO_BASE_SINK_SLAVE_NONE
- (3): custom - GST_AUDIO_BASE_SINK_SLAVE_CUSTOM
|
| can-activate-pull |
- Allow pull-based scheduling
- flags: readable, writable
- Boolean. Default: false
|
| alignment-threshold |
- Timestamp alignment threshold in nanoseconds
- flags: readable, writable
- Unsigned Integer64. Range: 1 - 18446744073709551614 Default:
40000000
|
| drift-tolerance |
- Tolerance for clock drift in microseconds
- flags: readable, writable
- Integer64. Range: 1 - 9223372036854775807 Default:
40000
|
| discont-wait |
- Window of time in nanoseconds to wait before creating a
discontinuity
- flags: readable, writable
- Unsigned Integer64. Range: 0 - 18446744073709551614 Default:
1000000000
|
| server |
- The PulseAudio server to connect to
- flags: readable, writable
- String. Default: null
|
| device |
- The PulseAudio sink device to connect to
- flags: readable, writable
- String. Default: null
|
| current-device |
- The current PulseAudio sink device
- flags: readable
- String. Default: ""
|
| device-name |
- Human-readable name of the sound device
- flags: readable
- String. Default: null
|
| volume |
- Linear volume of this stream, 1.0=100%
- flags: readable, writable
- Double. Range: 0 - 10 Default: 1
|
| mute |
- Mute state of this stream
- flags: readable, writable
- Boolean. Default: false
|
| client-name |
- The PulseAudio client name to use
- flags: readable, writable, changeable only in NULL or READY
state
- String. Default: "gst-inspect-1.0"
|
| stream-properties |
- list of pulseaudio stream properties
- flags: readable, writable
- Boxed pointer of type "GstStructure"
|
| stream-flags |
- Stream flags to use (not all default flags can be
overridden)
- flags: writable
- Flags "GstPulseStreamFlags" Default: 0x0000200b, "Try to
adjust the latency of the sink/source based on the requested
buffer metrics and adjust buffer metrics accordingly+Timing
update requests are issued periodically
automatically+Interpolate the latency for this stream+Create
the stream corked"
- (0x00000000): Flag to pass when no specific options
are needed - GST_PULSE_STREAM_NOFLAGS
- (0x00000001): Create the stream corked -
GST_PULSE_STREAM_START_CORKED
- (0x00000002): Interpolate the latency for this
stream - GST_PULSE_STREAM_INTERPOLATE_TIMING
- (0x00000004): Don't force the time to increase
monotonically - GST_PULSE_STREAM_NOT_MONOTONIC
- (0x00000008): Timing update requests are issued
periodically automatically -
GST_PULSE_STREAM_AUTO_TIMING_UPDATE
- (0x00000010): Don't remap channels by their name,
instead map them simply by their index -
GST_PULSE_STREAM_NO_REMAP_CHANNELS
- (0x00000020): When remapping channels by name, don't
upmix or downmix them to related channels -
GST_PULSE_STREAM_NO_REMIX_CHANNELS
- (0x00000040): Use the sample format of the
sink/device this stream is being connected to -
GST_PULSE_STREAM_FIX_FORMAT
- (0x00000080): Use the sample rate of the sink -
GST_PULSE_STREAM_FIX_RATE
- (0x00000100): Use the number of channels and the
channel map of the sink -
GST_PULSE_STREAM_FIX_CHANNELS
- (0x00000200): Don't allow moving of this stream to
another sink/device -
GST_PULSE_STREAM_DONT_MOVE
- (0x00000400): Allow dynamic changing of the sampling
rate during playback -
GST_PULSE_STREAM_VARIABLE_RATE
- (0x00000800): Find peaks instead of resampling -
GST_PULSE_STREAM_PEAK_DETECT
- (0x00001000): Create in muted state -
GST_PULSE_STREAM_START_MUTED
- (0x00002000): Try to adjust the latency of the
sink/source based on the requested buffer metrics
and adjust buffer metrics accordingly -
GST_PULSE_STREAM_ADJUST_LATENCY
- (0x00004000): Enable compatibility mode for legacy
clients that rely on a classic hardware device
fragment-style playback model -
GST_PULSE_STREAM_EARLY_REQUESTS
- (0x00008000): If set this stream won't be considered
when it is checked whether the device this stream is
connected to should auto-suspend -
GST_PULSE_STREAM_DONT_INHIBIT_AUTO_SUSPEND
- (0x00010000): Create in unmuted state -
GST_PULSE_STREAM_START_UNMUTED
- (0x00020000): If the sink/source this stream is
connected to is suspended during the creation of
this stream, cause it to fail -
GST_PULSE_STREAM_FAIL_ON_SUSPEND
- (0x00040000): If a volume is passed when this stream
is created, creation of this stream, cause it to
fail - GST_PULSE_STREAM_RELATIVE_VOLUME
- (0x00080000): Used to tag content that will be
rendered by passthrough sinks -
GST_PULSE_STREAM_PASSTHROUGH Write only
|
| prebuf |
- Prebuf to be set with sink-input
- flags: writable
- Integer. Range: -1 - 2147483647 Default: 0 Write only
|
**Parent Topic:** [Qualcomm GST plugins](https://docs.qualcomm.com/doc/80-70014-50/topic/qim-sdk-plugins.html)
Last Published: Oct 27, 2025
[Previous Topic
pulsesrc](https://docs.qualcomm.com/bundle/publicresource/80-70014-50/topics/pulsesrc.md) [Next Topic
qtivcomposer](https://docs.qualcomm.com/bundle/publicresource/80-70014-50/topics/qtivcomposer.md)