# pulsesink
Source: [https://docs.qualcomm.com/doc/80-70014-50Y/topic/pulsesink.html](https://docs.qualcomm.com/doc/80-70014-50Y/topic/pulsesink.html)
pulsesink 插件与底层 PulseAudio 声音服务器交互以播放 PCM 样本。
PulseAudio Server 与底层硬件交互以提供播放功能，并且基于 [GstAudioBaseSink](https://gstreamer.freedesktop.org/documentation/audio/gstaudiobasesink.html#GstAudioBaseSink) 基类。
## 继承链
[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
下表提供了有关 pulsesink 的设备接插口模板和组件属性的信息。有关用例信息，请参见 [（仅）音频播放](https://docs.qualcomm.com/doc/80-70014-50Y/topic/audio-only-playback.html)。
## 接插口配置
| 接插口名称 | 处理能力 | 处理能力 | 处理能力 |
| --- | --- | --- | --- |
| SINK 模板： 'sink'
*可用性：*总是
*方向：*接收设备 | audio/x-raw | 格式： | { (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 模板： 'sink'
*可用性：*总是
*方向：*接收设备 | audio/x-raw | 布局： | 交错 |
| SINK 模板： 'sink'
*可用性：*总是
*方向：*接收设备 | audio/x-raw | 码率： | [ 1, 22579200 ] |
| SINK 模板： 'sink'
*可用性：*总是
*方向：*接收设备 | audio/x-raw | 通道： | [ 1, 32 ] |
| SINK 模板： 'sink'
*可用性：*总是
*方向：*接收设备 | audio/x-alaw | 码率： | [ 1, 22579200 ] |
| SINK 模板： 'sink'
*可用性：*总是
*方向：*接收设备 | audio/x-alaw | 通道： | [ 1, 32 ] |
| SINK 模板： 'sink'
*可用性：*总是
*方向：*接收设备 | audio/x-mulaw | 码率： | [ 1, 22579200 ] |
| SINK 模板： 'sink'
*可用性：*总是
*方向：*接收设备 | audio/x-mulaw | 通道： | [ 1, 32 ] |
| SINK 模板： 'sink'
*可用性：*总是
*方向：*接收设备 | audio/x-ac3 | 框架： | 真 |
| SINK 模板： 'sink'
*可用性：*总是
*方向：*接收设备 | audio/x-eac3 | 框架： | 真 |
| SINK 模板： 'sink'
*可用性：*总是
*方向：*接收设备 | audio/X-DTS | 框架： | 真 |
| SINK 模板： 'sink'
*可用性：*总是
*方向：*接收设备 | audio/X-DTS | 块大小： | { (int)512, (int)1024, (int)2048 } |
| SINK 模板： 'sink'
*可用性：*总是
*方向：*接收设备 | audio/MPEG | mpegversion: | 1 |
| SINK 模板： 'sink'
*可用性：*总是
*方向：*接收设备 | audio/MPEG | mpegaudioversion： | [ 1, 3 ] |
| SINK 模板： 'sink'
*可用性：*总是
*方向：*接收设备 | audio/MPEG | 解析： | 真 |
| SINK 模板： 'sink'
*可用性：*总是
*方向：*接收设备 | audio/MPEG | mpegversion: | { (int)2, (int)4 } |
| SINK 模板： 'sink'
*可用性：*总是
*方向：*接收设备 | audio/MPEG | 框架： | 真 |
| SINK 模板： 'sink'
*可用性：*总是
*方向：*接收设备 | audio/MPEG | stream-format: | adts |
| | | | |
| | | | |
| | | | |
| | | | |
| | | | |
| | | | |
| | | | |
| | | | |
| | | | |
| | | | |
| | | | |
| | | | |
| | | | |
| | | | |
| | | | |
| | | | |
| | | | |
## 组件配置
Table : pulsesink 的组件属性
| 属性 | 说明 |
| --- | --- |
| name |
- 对象名称
- 标志：可读、可写
- 字符串。默认值： "pulsesink0"
|
| parent |
- 对象的父级
- 标志：可读、可写
- "GstObject" 类型的对象
|
| sync |
- 时钟同步
- 标志：可读、可写
- Boolean。默认值：true
|
| max-lateness |
- 缓冲区在被丢弃之前可以延迟的最大纳秒数（-1 无限制）
- 标志：可读、可写
- 64 位整型。范围：-1 - 9223372036854775807 默认值：-1
|
| qos |
- 生成上游服务质量事件
- 标志：可读、可写
- Boolean。默认值：false
|
| async |
- 异步转到 PAUSED
- 标志：可读、可写
- Boolean。默认值：true
|
| ts-offset |
- 时间戳偏移量（以纳秒为单位）
- 标志：可读、可写
- 64 位整型。范围：-9223372036854775808 - 9223372036854775807 默认值：0
|
| enable-last-sample |
- 启用 last-sample 属性
- 标志：可读、可写
- Boolean。默认值：false
|
| last-sample |
- 在接收设备中收到的最后一个样本
- 标志：可读
- "GstSample" 类型的装箱指针
|
| blocksize |
- 每个缓冲区要拉取的大小（以字节为单位）（0 = 默认值）
- 标志：可读、可写
- 无符号整型。范围：0 - 4294967295 默认值：4096
|
| render-delay |
- 接收设备的额外渲染延迟（以纳秒为单位）
- 标志：可读、可写
- 64 位无符号整型。范围：0 - 18446744073709551615 默认值：0
|
| throttle-time |
- 在渲染的缓冲区之间保持的时间（0 = 禁用）
- 标志：可读、可写
- 64 位无符号整型。范围：0 - 18446744073709551615 默认值：0
|
| max-bitrate |
- 每秒要渲染的最大位数（0 = 禁用）
- 标志：可读、可写
- 64 位无符号整型。范围：0 - 18446744073709551615 默认值：0
|
| buffer-time |
- 音频缓冲区的大小（以微秒为单位），这是接收器报告的最小延迟
- 标志：可读、可写
- 64 位整型。范围：1 - 9223372036854775807 默认值：200000
|
| latency-time |
- 每次迭代中要写入的最小数据量（以微秒为单位）
- 标志：可读、可写
- 64 位整型。范围：1 - 9223372036854775807 默认值：10000
|
| provide-clock |
- 提供要用作全局 pipeline 的时钟
- 标志：可读、可写
- Boolean。默认值：true
|
| slave-method |
枚举 "GstAudioBaseSinkSlaveMethod" 默认值：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 |
- 允许基于拉取的调度
- 标志：可读、可写
- Boolean。默认值：false
|
| alignment-threshold |
- 时间戳对齐阈值（以纳秒为单位）
- 标志：可读、可写
- 64 位无符号整型。范围：1 - 18446744073709551614 默认值：40000000
|
| drift-tolerance |
- 时钟漂移容差（以微秒为单位）
- 标志：可读、可写
- 64 位整型。范围：1 - 9223372036854775807 默认值：40000
|
| discont-wait |
- 在创建不连续性之前等待的时间窗口（以纳秒为单位）
- 标志：可读、可写
- 64 位无符号整型。范围：0 - 18446744073709551614 默认值：1000000000
|
| server |
- 要连接的 PulseAudio 服务器
- 标志：可读、可写
- 字符串。默认值：null
|
| device |
- 要连接的 PulseAudio 接收器设备
- 标志：可读、可写
- 字符串。默认值：null
|
| current-device |
- 当前 PulseAudio 接收器设备
- 标志：可读
- 字符串。默认值：""
|
| device-name |
- 声音设备的人类可读名称
- 标志：可读
- 字符串。默认值：null
|
| 音量 |
- 该流的线性音量，1.0=100%
- 标志：可读、可写
- 双精度浮点型。范围：0 - 10 默认值：1
|
| mute |
- 此流的静音状态
- 标志：可读、可写
- Boolean。默认值：false
|
| client-name |
- PulseAudio 使用的客户端名称
- 标志：可读、可写、仅在 NULL 或 READY 状态下可更改
- 字符串。默认值： "gst-inspect-1.0"
|
| stream-properties |
- pulseAudio 流属性列表
- 标志：可读、可写
- "GstStructure" 类型的装箱指针
|
| stream-flags |
- 要使用的流标志（并非所有默认标志都可以覆盖）
- 标志：可写
- 标志 "GstPulseStreamFlags" 默认值：0x0000200b，“尝试根据请求的缓冲区指标调整接收器/源的延迟，并相应地调整缓冲区指标+定期自动发出定时更新请求+插值此流的延迟+创建阻塞流”
- （0x00000000）：不需要特定选项时要传递的标志 - GST_PULSE_STREAM_NOFLAGS
- （0x00000001）：创建阻塞流 - GST_PULSE_STREAM_START_CORKED
- （0x00000002）：对此流进行延迟插值 - GST_PULSE_STREAM_INTERPOLATE_TIMING
- （0x00000004）：不要强迫时间单调增加 - GST_PULSE_STREAM_NOT_MONOTONIC
- （0x00000008）：定时更新请求会定期自动发出 - GST_PULSE_STREAM_AUTO_TIMING_UPDATE
- （0x00000010）：不要按通道名称重新映射通道，而应仅按索引映射通道 - GST_PULSE_STREAM_NO_REMAP_CHANNELS
- （0x00000020）：按名称重新映射通道时，不要将它们上混或下混到相关通道 - GST_PULSE_STREAM_NO_REMIX_CHANNELS
- （0x00000040）：使用此流连接到的接收器/设备的示例格式 - GST_PULSE_STREAM_FIX_FORMAT
- （0x00000080）：使用接收器的采样率 - GST_PULSE_STREAM_FIX_RATE
- （0x00000100）：使用接收器的通道数和通道映射 - GST_PULSE_STREAM_FIX_CHANNELS
- （0x00000200）：不允许将此流移动到另一个接收器/设备 - GST_PULSE_STREAM_DONT_MOVE
- （0x00000400）：允许在播放过程中动态更改采样率 - GST_PULSE_STREAM_VARIABLE_RATE
- （0x00000800）：查找峰值而不是重采样 - GST_PULSE_STREAM_PEAK_DETECT
- （0x00001000）：在静音状态下创建 - GST_PULSE_STREAM_START_MUTED
- （0x00002000）：尝试根据请求的缓冲区指标调整接收器/源的延迟，并相应地调整缓冲区指标 - GST_PULSE_STREAM_ADJUST_LATENCY
- （0x00004000）：为依赖于经典硬件设备片段式播放模型的旧客户端启用兼容模式 - GST_PULSE_STREAM_EARLY_REQUESTS
- （0x00008000）：如果设置，则在检查此流连接到的设备是否应自动挂起时不会考虑此流 - GST_PULSE_STREAM_DONT_INHIBIT_AUTO_SUSPEND
- （0x00010000）：在未静音状态下创建 - GST_PULSE_STREAM_START_UNMUTED
- （0x00020000）：如果此流所连接的接收器/源在创建此流期间挂起，则会导致其失败 - GST_PULSE_STREAM_FAIL_ON_SUSPEND
- （0x00040000）：如果在创建此流时传递了音量，则创建此流会导致其失败 - GST_PULSE_STREAM_RELATIVE_VOLUME
- （0x00080000）：用于标记将由直通接收器呈现的内容 - GST_PULSE_STREAM_PASSTHROUGH 仅写入
|
| prebuf |
- 使用 sink-input 设置的 Prebuf
- 标志：可写
- 整型。范围：-1 - 2147483647 默认值：0 只写
|
**Parent Topic:** [Qualcomm GST 插件](https://docs.qualcomm.com/doc/80-70014-50Y/topic/qim-sdk-plugins.html)
Last Published: Nov 11, 2025
[Previous Topic
pulsesrc](https://docs.qualcomm.com/bundle/publicresource/80-70014-50Y/topics/pulsesrc.md) [Next Topic
qtivcomposer](https://docs.qualcomm.com/bundle/publicresource/80-70014-50Y/topics/qtivcomposer.md)