# pulsesink
Source: [https://docs.qualcomm.com/doc/80-70022-50SC/topic/pulsesink.html](https://docs.qualcomm.com/doc/80-70022-50SC/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-70022-50SC/topic/audio-use-cases.html#audio-only-playback)。
## 端口配置
| 端口名称 | 功能 | 功能 | 功能 |
| --- | --- | --- | --- |
| SINK 模板：'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 模板：'sink'
*可用性：* 始终可用
*方向：* 接收端 | audio/x-raw | layout： | interleaved |
| SINK 模板：'sink'
*可用性：* 始终可用
*方向：* 接收端 | audio/x-raw | rate： | [ 1, 22579200 ] |
| SINK 模板：'sink'
*可用性：* 始终可用
*方向：* 接收端 | audio/x-raw | channels： | [ 1, 32 ] |
| SINK 模板：'sink'
*可用性：* 始终可用
*方向：* 接收端 | audio/x-alaw | rate： | [ 1, 22579200 ] |
| SINK 模板：'sink'
*可用性：* 始终可用
*方向：* 接收端 | audio/x-alaw | channels： | [ 1, 32 ] |
| SINK 模板：'sink'
*可用性：* 始终可用
*方向：* 接收端 | audio/x-mulaw | rate： | [ 1, 22579200 ] |
| SINK 模板：'sink'
*可用性：* 始终可用
*方向：* 接收端 | audio/x-mulaw | channels： | [ 1, 32 ] |
| SINK 模板：'sink'
*可用性：* 始终可用
*方向：* 接收端 | audio/x-ac3 | framed： | true |
| SINK 模板：'sink'
*可用性：* 始终可用
*方向：* 接收端 | audio/x-eac3 | framed： | true |
| SINK 模板：'sink'
*可用性：* 始终可用
*方向：* 接收端 | audio/X-DTS | framed： | true |
| SINK 模板：'sink'
*可用性：* 始终可用
*方向：* 接收端 | audio/X-DTS | block-size： | { (int)512, (int)1024, (int)2048 } |
| SINK 模板：'sink'
*可用性：* 始终可用
*方向：* 接收端 | audio/MPEG | mpegversion: | 1 |
| SINK 模板：'sink'
*可用性：* 始终可用
*方向：* 接收端 | audio/MPEG | mpegaudioversion： | [ 1, 3 ] |
| SINK 模板：'sink'
*可用性：* 始终可用
*方向：* 接收端 | audio/MPEG | parsed： | true |
| SINK 模板：'sink'
*可用性：* 始终可用
*方向：* 接收端 | audio/MPEG | mpegversion: | { (int)2, (int)4 } |
| SINK 模板：'sink'
*可用性：* 始终可用
*方向：* 接收端 | audio/MPEG | framed： | true |
| 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 服务器。 |
| device | 用于连接的 PulseAudio 接收设备。 |
| current-device | 当前 PulseAudio 接收器设备 |
| device-name | 声音设备的人类可读名称 |
| volume | 该流的线性音量，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
- 根据请求的缓存指标调整接收器/源的延迟，并相应地调整缓存指标定时更新请求会定期自动发出。插入该流的延迟并创建 corked 流。
- (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:** [配置音频插件](https://docs.qualcomm.com/doc/80-70022-50SC/topic/audio-plugins.html)
Last Published: Nov 05, 2025
[Previous Topic
pulsesrc](https://docs.qualcomm.com/bundle/publicresource/80-70022-50SC/topics/pulsesrc.md) [Next Topic
配置 ML 插件](https://docs.qualcomm.com/bundle/publicresource/80-70022-50SC/topics/inferencing-plugins.md)