# Waylandsink
Source: [https://docs.qualcomm.com/doc/80-70014-50Y/topic/waylandsink.html](https://docs.qualcomm.com/doc/80-70014-50Y/topic/waylandsink.html)
waylandsink 插件使用 [GstVideoSink](https://gstreamer.freedesktop.org/documentation/video/gstvideosink.html?gi-language=c) GStreamer 类。该插件基于 Wayland [Weston](https://wayland.pages.freedesktop.org/weston/) 合成器，会创建自己的窗口并在窗口中渲染传入的视频帧。
还会将 Weston 客户端 API 和状态映射到相应的 GStreamer API 和状态。Qualcomm 扩展了 waylandsink 的实现类，并增加了对窗口定位、基于 GBM 的专有零拷贝缓冲区后端和 XDG shell 后端的支持。
## 继承链
[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) → [GstVideoSink](https://gstreamer.freedesktop.org/documentation/video/gstvideosink.html?gi-language=c) → GstWaylandSink
下表提供了有关 waylandsink 的接插口模板和组件属性的信息。有关用例信息，请参见 [视频播放用例](https://docs.qualcomm.com/doc/80-70014-50Y/topic/video-playback-use-cases.html)。
## 接插口配置
| 接插口名称 | 处理能力 | 处理能力 | 处理能力 |
| --- | --- | --- | --- |
| SINK 模板：'sink'
可用性*：*总是
方向：接收设备 | video/x-raw | 格式： | { (string)BGRx, (string)BGRA, (string)RGBx, (string)xBGR, (string)xRGB, (string)RGBA, (string)ABGR, (string)ARGB, (string)RGB, (string)BGR, (string)RGB16, (string)BGR16, (string)YUY2, (string)YVYU, (string)UYVY, (string)AYUV, (string)NV12, (string)NV21, (string)NV16, (string)YUV9, (string)YVU9, (string)Y41B, (string)I420, (string)YV12, (string)Y42B, (string)v308 } |
| SINK 模板：'sink'
可用性*：*总是
方向：接收设备 | video/x-raw | 宽度： | [ 1, 2147483647 ] |
| SINK 模板：'sink'
可用性*：*总是
方向：接收设备 | video/x-raw | 高度： | [ 1, 2147483647 ] |
| SINK 模板：'sink'
可用性*：*总是
方向：接收设备 | video/x-raw | 帧率： | [ 0/1, 2147483647/1 ] |
| SINK 模板：'sink'
可用性*：*总是
方向：接收设备 | video/x-raw(memory:DMABuf) | 格式： | { (string)BGRx, (string)BGRA, (string)RGBx, (string)xBGR, (string)xRGB, (string)RGBA, (string)ABGR, (string)ARGB, (string)RGB, (string)BGR, (string)RGB16, (string)BGR16, (string)YUY2, (string)YVYU, (string)UYVY, (string)AYUV, (string)NV12, (string)NV21, (string)NV16, (string)YUV9, (string)YVU9, (string)Y41B, (string)I420, (string)YV12, (string)Y42B, (string)v308 } |
| SINK 模板：'sink'
可用性*：*总是
方向：接收设备 | video/x-raw(memory:DMABuf) | 宽度： | [ 1, 2147483647 ] |
| SINK 模板：'sink'
可用性*：*总是
方向：接收设备 | video/x-raw(memory:DMABuf) | 高度： | [ 1, 2147483647 ] |
| SINK 模板：'sink'
可用性*：*总是
方向：接收设备 | video/x-raw(memory:DMABuf) | 帧率： | [ 0/1, 2147483647/1 ] |
| SINK 模板：'sink'
可用性*：*总是
方向：接收设备 | video/x-raw(memory:GBM) | 格式： | { (string)BGRx, (string)BGRA, (string)RGBx, (string)xBGR, (string)xRGB, (string)RGBA, (string)ABGR, (string)ARGB, (string)RGB, (string)BGR, (string)RGB16, (string)BGR16, (string)YUY2, (string)YVYU, (string)UYVY, (string)AYUV, (string)NV12, (string)NV21, (string)NV16, (string)YUV9, (string)YVU9, (string)Y41B, (string)I420, (string)YV12, (string)Y42B, (string)v308 } |
| SINK 模板：'sink'
可用性*：*总是
方向：接收设备 | video/x-raw(memory:GBM) | 宽度： | [ 1, 2147483647 ] |
| SINK 模板：'sink'
可用性*：*总是
方向：接收设备 | video/x-raw(memory:GBM) | 高度： | [ 1, 2147483647 ] |
| SINK 模板：'sink'
可用性*：*总是
方向：接收设备 | video/x-raw(memory:GBM) | 帧率： | [ 0/1, 2147483647/1 ] |
| | | | |
| | | | |
| | | | |
| | | | |
| | | | |
| | | | |
| | | | |
| | | | |
| | | | |
| | | | |
| | | | |
## 组件配置
Note: 对于当前版本，不支持 **x**、**y**、**width** 和 **height** 属性。
Table : Waylandsink 的组件属性
| 属性 | 说明 |
| --- | --- |
| name |
- 对象名称
- 标志：可读、可写
- 字符串。默认值："waylandsink0"
|
| parent |
- 对象的父级
- 标志：可读、可写
- "GstObject" 类型的对象
|
| sync |
- 时钟同步
- 标志：可读、可写
- Boolean。默认值：true
|
| max-lateness |
- 缓冲区在被丢弃之前可以延迟的最大纳秒数（-1 无限制）
- 标志：可读、可写
- 64 位整型。范围：-1 - 9223372036854775807 默认值：20000000
|
| qos |
- 生成上游服务质量事件
- 标志：可读、可写
- Boolean。默认值：true
|
| async |
- 异步转到 PAUSED
- 标志：可读、可写
- Boolean。默认值：true
|
| ts-offset |
- 时间戳偏移量（以纳秒为单位）
- 标志：可读、可写
- 64 位整型。范围：-9223372036854775808 - 9223372036854775807 默认值：0
|
| enable-last-sample |
- 启用 last-sample 属性
- 标志：可读、可写
- Boolean。默认值：true
|
| 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
|
| show-preroll-frame |
- 是否在前贴片广告期间渲染视频帧
- 标志：可读、可写
- Boolean。默认值：true
|
| display |
- 要连接到的 Wayland 显示名称（如果未通过 GstContext 提供）
- 标志：可读、可写
- 字符串。默认值：null
|
| xdg-shell |
- 是否使用 XDG shell 协议进行显示
- 标志：可读、可写
- Boolean。默认值：true
|
| fullscreen |
- 是否应使表面全屏显示
- 标志：可读、可写、可在 NULL、READY、PAUSED 或 PLAYING 状态下更改
- Boolean。默认值：false
|
| x |
- 内容的 X 轴位置
- 标志：可读、可写、可在 NULL、READY、PAUSED 或 PLAYING 状态下更改
- 无符号整型。范围：0 - 1920 默认值：0
|
| y |
- 内容的 Y 轴位置
- 标志：可读、可写、可在 NULL、READY、PAUSED 或 PLAYING 状态下更改
- 无符号整型。范围：0 - 1920 默认值：0
|
| width |
- 内容的目标宽度
- 标志：可读、可写、可在 NULL、READY、PAUSED 或 PLAYING 状态下更改
- 无符号整型。范围：0 - 1920 默认值：640
|
| height |
- 内容的目标高度
- 标志：可读、可写、可在 NULL、READY、PAUSED 或 PLAYING 状态下更改
- 无符号整型。范围：0 - 1080 默认值：480
|
**Parent Topic:** [Qualcomm GST 插件](https://docs.qualcomm.com/doc/80-70014-50Y/topic/qim-sdk-plugins.html)
Last Published: Nov 11, 2025
[Previous Topic
qtivtransform](https://docs.qualcomm.com/bundle/publicresource/80-70014-50Y/topics/qtivtransform.md) [Next Topic
qtimlsnpe](https://docs.qualcomm.com/bundle/publicresource/80-70014-50Y/topics/qtimlsnpe.md)