# qtisocketsink

Source: [https://docs.qualcomm.com/doc/80-70015-50SC/topic/qtisocketsink.html](https://docs.qualcomm.com/doc/80-70015-50SC/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-70015-50SC/topic/socketsrc-and-socketsink-use-case.html)。

## 接插口配置

| 接插口名称 | 处理能力 | 处理能力 |
| --- | --- | --- |
| SINK 模板：'sink'<br><br><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:** [显示、摄像头、编码和解码插件](https://docs.qualcomm.com/doc/80-70015-50SC/topic/display-plugins.html)

Last Published: Nov 11, 2025

[Previous Topic
qtivtransform](https://docs.qualcomm.com/bundle/publicresource/80-70015-50SC/topics/qtivtransform.md) [Next Topic
qtisocketsrc](https://docs.qualcomm.com/bundle/publicresource/80-70015-50SC/topics/qtisocketsrc.md)