# qtisocketsink

Source: [https://docs.qualcomm.com/doc/80-70014-50Y/topic/qtisocketsink.html](https://docs.qualcomm.com/doc/80-70014-50Y/topic/qtisocketsink.html)

qtisocketsink 插件使用 UNIX 套接字将文件描述符 (FD) 支持的 [GstBuffers](https://gstreamer.freedesktop.org/documentation/gstreamer/gstbuffer.html) 传输到以 qtisocketsrc 作为入口点的其他进程。

qtisocketsink 插件需要将 UNIX 域套接字文件（应具有 .sock 扩展名）作为 *socket* 属性传递，以传输 FD。

从另一个进程传递到此插件的缓冲区使用引用计数器进行跟踪，当缓冲区通过套接字发送或返回时，该计数器会相应地递增或递减。

可以使用 qtisocketsink 执行的一些配置：

- 可以将 *async* 属性设置为 false，以便套接字异步转换为 PAUSED 状态。
- 对于更高级的配置，可以通过 *max-lateness* 属性调整缓冲区在被丢弃之前可以延迟的最大纳秒数。
- 可以使用 *max-bitrate* 属性设置每秒渲染的最大位数。

## 继承链

[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) → GstFdSocketSink

下表提供了有关 qtisocketsink 的接插口模板和组件属性的信息。有关用例信息，请参见 [单摄像头流和套接字用例](https://docs.qualcomm.com/doc/80-70014-50Y/topic/socketsrc-and-socketsink-use-case.html)。

## 接插口配置

| 接插口名称 | 处理能力 | 处理能力 |
| --- | --- | --- |
| SINK 模板：'sink'<br><ul class="ul" id="qtisocketsink__ul_dlk_vdp_y1c"><br>                                    <li class="li"><em class="ph i">可用性：</em>总是</li><br><br>                                    <li class="li"><em class="ph i">方向：</em>接收设备</li><br><br>                                </ul> | 任意 | – |

## 组件配置

Table : qtisocketsink 的组件属性

| 属性 | 说明 |
| --- | --- |
| name | 对象名称<ul class="ul" id="qtisocketsink__ul_zmh_vxn_myb"><br>                                    <li class="li">标志：可读、可写</li><br><br>                                    <li class="li">字符串。默认值："fdsocketsink0"</li><br><br>                                </ul> |
| parent | 对象的父级<ul class="ul" id="qtisocketsink__ul_anh_vxn_myb"><br>                                    <li class="li">标志：可读、可写</li><br><br>                                    <li class="li">"GstObject" 类型的对象</li><br><br>                                </ul> |
| sync | 时钟同步<ul class="ul" id="qtisocketsink__ul_bnh_vxn_myb"><br>                                    <li class="li">标志：可读、可写</li><br><br>                                    <li class="li">Boolean。默认值：true</li><br><br>                                </ul> |
| max-lateness | 缓冲区在被丢弃之前可以延迟的最大纳秒数（-1 无限制）<ul class="ul" id="qtisocketsink__ul_cnh_vxn_myb"><br>                                    <li class="li">标志：可读、可写</li><br><br>                                    <li class="li">64 位整型。范围：-1 - 9223372036854775807 默认值：-1</li><br><br>                                </ul> |
| qos | 上游生成 QoS 事件<ul class="ul" id="qtisocketsink__ul_dnh_vxn_myb"><br>                                    <li class="li">标志：可读、可写</li><br><br>                                    <li class="li">Boolean。默认值：false</li><br><br>                                </ul> |
| async | 异步转到 PAUSED<ul class="ul" id="qtisocketsink__ul_enh_vxn_myb"><br>                                    <li class="li">标志：可读、可写</li><br><br>                                    <li class="li">Boolean。默认值：true</li><br><br>                                </ul> |
| ts-offset | 时间戳偏移量（以纳秒为单位）<ul class="ul" id="qtisocketsink__ul_fnh_vxn_myb"><br>                                    <li class="li">标志：可读、可写</li><br><br>                                    <li class="li">64 位整型。范围：-9223372036854775808 - 9223372036854775807 默认值：0</li><br><br>                                </ul> |
| enable-last-sample | 启用 last-sample 属性<ul class="ul" id="qtisocketsink__ul_gnh_vxn_myb"><br>                                    <li class="li">标志：可读、可写</li><br><br>                                    <li class="li">Boolean。默认值：true</li><br><br>                                </ul> |
| last-sample | 在接收设备中收到的最后一个样本<ul class="ul" id="qtisocketsink__ul_hnh_vxn_myb"><br>                                    <li class="li">标志：可读</li><br><br>                                    <li class="li">"GstSample" 类型的装箱指针</li><br><br>                                </ul> |
| blocksize | 每个缓冲区要拉取的大小（以字节为单位，0 = 默认值）<ul class="ul" id="qtisocketsink__ul_inh_vxn_myb"><br>                                    <li class="li">标志：可读、可写</li><br><br>                                    <li class="li">无符号整型。范围：0 - 4294967295 默认值：4096</li><br><br>                                </ul> |
| render-delay | 接收设备的额外渲染延迟（以纳秒为单位）<ul class="ul" id="qtisocketsink__ul_jnh_vxn_myb"><br>                                    <li class="li">标志：可读、可写</li><br><br>                                    <li class="li">64 位无符号整型。范围：0 - 18446744073709551615 默认值：0</li><br><br>                                </ul> |
| throttle-time | 在渲染的缓冲区之间保持的时间（0 = 禁用）<ul class="ul" id="qtisocketsink__ul_knh_vxn_myb"><br>                                    <li class="li">标志：可读、可写</li><br><br>                                    <li class="li">64 位无符号整型。范围：0 - 18446744073709551615 默认值：0</li><br><br>                                </ul> |
| max-bitrate | 每秒要渲染的最大位数（0 = 禁用）<ul class="ul" id="qtisocketsink__ul_lnh_vxn_myb"><br>                                    <li class="li">标志：可读、可写</li><br><br>                                    <li class="li">64 位无符号整型。范围：0 - 18446744073709551615 默认值：0</li><br><br>                                </ul> |
| socket | Unix 域套接字的位置<ul class="ul" id="qtisocketsink__ul_mnh_vxn_myb"><br>                                    <li class="li">标志：可读、可写、仅在 NULL 或 READY 状态下可更改</li><br><br>                                    <li class="li">字符串。默认值：null</li><br><br>                                </ul> |

**Parent Topic:** [Qualcomm GST 插件](https://docs.qualcomm.com/doc/80-70014-50Y/topic/qim-sdk-plugins.html)

Last Published: Nov 11, 2025

[Previous Topic
qtioverlay](https://docs.qualcomm.com/bundle/publicresource/80-70014-50Y/topics/qtioverlay.md) [Next Topic
qtisocketsrc](https://docs.qualcomm.com/bundle/publicresource/80-70014-50Y/topics/qtisocketsrc.md)