Transient seat

创建临时 seat 的协议

特权客户端可以使用 transient seat 协议创建独立的 seat,当客户端销毁其 transient seat 时,该 seat 会从 compositor 中移除。

本协议旨在与虚拟输入协议(例如 "virtual_keyboard_unstable_v1" 或 "wlr_virtual_pointer_unstable_v1")配合使用,这两种协议都允许用户选择一个 seat。

由该协议创建的 "wl_seat" global 本身不会生成输入事件,也不具备任何能力,除非其他协议扩展(如上述提到的扩展)分配给它。

例如,远程桌面服务器可以为每个新连接遵循以下步骤,为每个远程用户创建一个带有虚拟输入的 seat:

transient seat 管理器

transient seat manager 用于创建生命周期较短的 seat。

create(seat: new_id<ext_transient_seat_v1>)
参数
类型
描述
seatnew_id<ext_transient_seat_v1>
创建一个 transient seat

创建一个新的 seat,当客户端的 transient seat 对象被销毁时,该 seat 也会被移除。

实际的 seat 可能会更早被移除,在这种情况下,transient seat 对象将变得无效。

destroy()
销毁管理器

销毁 manager。

由该 manager 创建的所有对象都将保持有效,直到它们自身被销毁。


transient seat handle

When the transient seat handle is destroyed, the seat itself will also be destroyed.

destroy()
销毁 transient seat

当客户端销毁 transient seat 对象时,compositor 创建的关联 seat 也会被销毁。

ready(global_name: uint)
参数
类型
描述
global_nameuint
transient seat 已就绪

此事件通告了与 wl_registry_bind 一起使用的 wl_seat 的 global 名称。

当且仅当允许创建 transient seat 时,它会在 transient seat 创建完毕且新的 "wl_seat" global 被通告后立即发送且仅发送一次。

denied()
transient seat 创建被拒绝

该事件通知客户端,compositor 拒绝了其创建 transient seat 的请求。

当且仅当创建 transient seat 被拒绝时,它会在 transient seat 对象创建后立即发送且仅发送一次。

收到此事件后,客户端应销毁该对象。


合成器支持

Cage
Cage
0.2.0
COSMIC
COSMIC
1.0.0~beta.8
GameScope
GameScope
3.15.14
Hyprland
Hyprland
0.52.1
Jay
1.12.0
KWin
KWin
6.6
Labwc
Labwc
0.9.2
Louvre
Louvre
2.14.1
Mir
Mir
2.26
Muffin
Muffin
6.6.0
Mutter
Mutter
49.2
niri
niri
25.11
phoc
phoc
0.52
river
river
0.3.13
Sway
Sway
1.11
Treeland
Treeland
0.8.0
Wayfire
Wayfire
0.9.0
Weston
Weston
14.0.2
ext_transient_seat_manager_v1
x
x
x
x
1
x
x
x
x
x
x
x
x
x
1
x
x
x

Copyright © 2020 - 2023 Andri Yngvason

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice (including the next paragraph) shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Footer

© 2026 Wayland Explorer

本网站与 Wayland 官方项目无任何关联。网站所有内容均根据 Wayland 协议 XML 文件自动生成。

本网站使用的 Visual Studio Code - Codicons 遵循 CC BY 4.0 许可。