# pulsesrc
Source: [https://docs.qualcomm.com/doc/80-70014-50Y/topic/pulsesrc.html](https://docs.qualcomm.com/doc/80-70014-50Y/topic/pulsesrc.html)
pulsesrc 插件与底层 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-70014-50Y/topic/audio-only-capture.html)。
## 接插口配置
| 接插口名称 | 处理能力 | 处理能力 | 处理能力 |
| --- | --- | --- | --- |
| SRC 模板："src"
| 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 } |
| SRC 模板："src"
| audio/x-raw | 布局： | 交错 |
| SRC 模板："src"
| audio/x-raw | 码率： | [ 1, 22579200 ] |
| SRC 模板："src"
| audio/x-raw | 通道： | [ 1, 32 ] |
| SRC 模板："src"
| audio/x-alaw | 码率： | [ 1, 22579200 ] |
| SRC 模板："src"
| audio/x-alaw | 通道： | [ 1, 32 ] |
| SRC 模板："src"
| audio/x-mulaw | 码率： | [ 1, 22579200 ] |
| SRC 模板："src"
| audio/x-mulaw | 通道： | [ 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 | 音频缓冲区的大小（以微秒为单位）。这是设备中缓冲的最大数据量和源报告的最大延迟。如有必要，组件可能会忽略此值; 请参阅 "actual-buffer-time"
- 标志：可读、可写
- 64 位整型。范围：1 - 9223372036854775807 默认值：200000
|
| latency-time | 每次迭代中要读取的最小数据量（以微秒为单位）。这是源报告的最小延迟。如有必要，组件可能会忽略此值; 请参阅 "actual-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 | 声音设备的人类可读名称 |
| 音量 | 该流的线性音量，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）：创建阻塞流 - 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:** [Qualcomm GST 插件](https://docs.qualcomm.com/doc/80-70014-50Y/topic/qim-sdk-plugins.html)
Last Published: Nov 11, 2025
[Previous Topic
v4l2vp9dec](https://docs.qualcomm.com/bundle/publicresource/80-70014-50Y/topics/v4l2vp9dec.md) [Next Topic
pulsesink](https://docs.qualcomm.com/bundle/publicresource/80-70014-50Y/topics/pulsesink.md)