# pulsesrc
Source: [https://docs.qualcomm.com/doc/80-70020-50SC/topic/pulsesrc.html](https://docs.qualcomm.com/doc/80-70020-50SC/topic/pulsesrc.html)
pulssrc 插件与底层 PulseAudio 声音服务器交互以捕获脉冲编码调制 (PCM) 样本。
PulseAudio 服务器与底层硬件交互以提供采集功能，并且基于 [GstAudioSrc](https://gstreamer.freedesktop.org/documentation/audio/gstaudiosrc.html#GstAudioSrc) 基类。
## 继承链
[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) → [GstBaseSrc](https://gstreamer.freedesktop.org/documentation/base/gstbasesrc.html#GstBaseSrc) → [GstPushSrc](https://gstreamer.freedesktop.org/documentation/base/gstpushsrc.html#GstPushSrc) → [GstAudioBaseSrc](https://gstreamer.freedesktop.org/documentation/audio/gstaudiobasesrc.html#GstAudioBaseSrc) → [GstAudioSrc](https://gstreamer.freedesktop.org/documentation/audio/gstaudiosrc.html#GstAudioSrc) → GstPulseSrc
下表提供了有关 pulsesrc 的设备端口模板和元素属性的信息。有关用例信息，请参见[（仅）音频采集](https://docs.qualcomm.com/doc/80-70020-50SC/topic/audio-use-cases.html#audio-only-capture)。
## 端口配置
| 端口名称 | 功能 | 功能 | 功能 |
| --- | --- | --- | --- |
| SRC 模板：'src'
| 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 } |
| SRC 模板：'src'
| audio/x-raw | layout： | interleaved |
| SRC 模板：'src'
| audio/x-raw | rate： | [ 1, 22579200 ] |
| SRC 模板：'src'
| audio/x-raw | channels： | [ 1, 32 ] |
| SRC 模板：'src'
| audio/x-alaw | rate： | [ 1, 22579200 ] |
| SRC 模板：'src'
| audio/x-alaw | channels： | [ 1, 32 ] |
| SRC 模板：'src'
| audio/x-mulaw | rate： | [ 1, 22579200 ] |
| SRC 模板：'src'
| audio/x-mulaw | channels： | [ 1, 32 ] |
| | | | |
| | | | |
| | | | |
| | | | |
| | | | |
| | | | |
| | | | |
## 元素配置
Table : pulsesrc 的元素属性
| 属性 | 说明 |
| --- | --- |
| name | 对象名称
- 标志：可读、可写
- 字符串。默认：“pulsesrc0”
|
| parent | 对象的父级
- 标志：可读、可写
- "GstObject" 类型的对象
|
| blocksize | 每个缓存要读取的大小（以字节为单位）（-1 = 默认值）
- 标志：可读、可写
- 无符号整型。范围：0 - 4294967295 默认值：0
|
| num-buffers | 发送 EOS 之前要输出的缓存数（-1 = 无限制）
- 标志：可读、可写
- 整型。范围：˗1 至 2147483647，默认值：˗1
|
| typefind | 在协商之前运行 typefind（已弃用，不起作用）
- 标志：可读、可写、已弃用
- Boolean。默认值：false
|
| do-timestamp | 将当前流时间应用于缓存
- 标志：可读、可写
- Boolean。默认值：true
|
| buffer-time | 音频缓存的大小（以微秒为单位）。此大小是设备中缓存的最大数据量和发送端报告的最大延迟。pulssrc 插件可以忽略这个值。
- 标志：可读、可写
- 64 位整型。范围：1 - 9223372036854775807 默认值：200000
|
| latency-time | 每次迭代中读取的最小数据量以微秒为单位。这是发送端报告的最小延迟。插件可以忽略该值。
- 标志：可读、可写
- 64 位整型。范围：1 - 9223372036854775807 默认值：10000
|
| actual-buffer-time | 音频缓存的实际配置大小（以微秒为单位）
- 标志：可读
- 64 位整型。范围：˗1 至 9223372036854775807，默认值：˗1
|
| actual-latency-time | 实际配置的音频延迟（以微秒为单位）
- 标志：可读
- 64 位整型。范围：˗1 至 9223372036854775807，默认值：˗1
|
| provide-clock | 提供要用作全局 pipeline 的时钟
- 标志：可读、可写
- Boolean。默认值：true
|
| slave-method | 用于匹配主时钟速率的算法。
- 标志：可读、可写
- 枚举 “GstAudioBaseSrcSlaveMethod” 默认：2，“ skew”
- (0): resample - GST_AUDIO_BASE_SRC_SLAVE_RESAMPLE
- (1): re-timestamp - GST_AUDIO_BASE_SRC_SLAVE_RE_TIMESTAMP
- (2): skew - GST_AUDIO_BASE_SRC_SLAVE_SKEW
- (3): none - GST_AUDIO_BASE_SRC_SLAVE_NONE
|
| 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" 类型的封装指针
|
| source-output-index | 与此记录流对应的 PulseAudio 源输出的索引
- 标志：可读
- 无符号整型。范围：0 - 4294967295 默认值：4294967295
|
| stream-flags | 流标志（并非所有默认标志都可以覆盖）。
- 标志：可写
- 标志 "GstPulseStreamFlags" 默认：0x0000000f，"定期自动发出定时更新请求。不强制时间单调增加并插入该流延迟。
- ((0x00000000)：不需要特定选项时要传递的标志 - GST_PULSE_STREAM_NOFLAGS
- (0x00000001): 创建 Corked 流 - 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 只写
|
**Parent Topic:** [配置音频插件](https://docs.qualcomm.com/doc/80-70020-50SC/topic/audio-plugins.html)
Last Published: Jul 23, 2025
[Previous Topic
配置音频插件](https://docs.qualcomm.com/bundle/publicresource/80-70020-50SC/topics/audio-plugins.md) [Next Topic
pulsesink](https://docs.qualcomm.com/bundle/publicresource/80-70020-50SC/topics/pulsesink.md)