管理 river 状态对象

一个全局工厂,用于接收特定于 river 的状态信息的对象。它可用于实现例如状态栏 (status bar)。

destroy()
销毁 river_status_manager 对象

此请求表明客户端将不再使用 river_status_manager 对象。通过此实例创建的对象不受影响。

get_river_output_status(id: new_id<zriver_output_status_v1>, output: object<wl_output>)
参数
类型
描述
idnew_id<zriver_output_status_v1>
outputobject<wl_output>
创建 output 状态对象

这将为给定的 wl_output 创建一个新的 river_output_status 对象。

get_river_seat_status(id: new_id<zriver_seat_status_v1>, seat: object<wl_seat>)
参数
类型
描述
idnew_id<zriver_seat_status_v1>
seatobject<wl_seat>
创建 seat 状态对象

这将为给定的 wl_seat 创建一个新的 river_seat_status 对象。


跟踪 output 标签 (tags) 和焦点

此接口允许客户端接收有关 output 当前窗口状态的信息。

destroy()
销毁 river_output_status 对象

此请求表明客户端将不再使用 river_output_status 对象。

focused_tags(tags: uint)
参数
类型
描述
tagsuint
32-bit bitfield
output 的焦点标签 (focused tags)

在绑定接口时发送一次,之后在 output 的标签焦点改变时再次发送。

view_tags(tags: array)
参数
类型
描述
tagsarray
array of 32-bit bitfields
output 视图 (views) 的标签状态

在绑定接口时发送一次,之后在 output 的标签状态改变时再次发送。

urgent_tags(tags: uint)
参数
类型
描述
tagsuint
32-bit bitfield
包含紧急视图 (urgent view) 的 output 标签

在绑定接口时发送一次,之后在具有至少一个紧急视图的标签集发生改变时再次发送。

layout_name(name: string)
参数
类型
描述
namestring
layout name
布局名称

如果存在布局名称,则在绑定接口时发送一次,之后在名称改变时再次发送。

layout_name_clear()
布局名称清除

当当前布局名称被移除且未设置新名称时发送,例如当活动布局生成器 (layout generator) 断开连接时。


跟踪 seat 焦点和模式

此接口允许客户端接收有关 seat 焦点的 output 以及在输出级别操作还是在视图级别操作等状态的信息。

destroy()
销毁 river_seat_status 对象

此请求表明客户端将不再使用 river_seat_status 对象。

focused_output(output: object<wl_output>)
参数
类型
描述
outputobject<wl_output>
seat 当前焦点的 output

在绑定接口时发送一次,之后在 seat 的 output 焦点改变时再次发送。

unfocused_output(output: object<wl_output>)
参数
类型
描述
outputobject<wl_output>
the seat unfocused an output

Sent whenever an output loses focus.

focused_view(title: string)
参数
类型
描述
titlestring
title of the focused view
information on the focused view

Sent once on binding the interface and again whenever the focused view or a property thereof changes. The title may be an empty string if no view is focused or the focused view did not set a title.

mode(name: string)
参数
类型
描述
namestring
name of the mode
当前操作模式

在绑定接口时发送一次,之后在 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
zriver_status_manager_v1
x
x
x
x
x
x
x
x
x
x
x
x
x
4
x
x
x
x

Copyright 2020 The River Developers

Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.

THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

Footer

© 2026 Wayland Explorer

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

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