Keyboard filter

解除键盘绑定并停止拦截事件。

解除绑定的键盘和输入法。合成器必须停止重定向键盘事件。keyboard_filter 客户端尚未响应的事件被视为收到 "passthrough" 操作。

此请求立即生效。

此请求控制键盘输入事件在到达焦点 surface 之前的过滤。

用法：

当 keyboard_filter 拦截时，合成器必须将每个拦截的事件发送到其绑定的 wl_keyboard，并在其内部队列中保留副本。 当客户端使用 .filter 请求响应时，合成器要么从队列中移除事件（filter_action.consume），要么将副本发送到原始 wl_keyboard 对象（filter_action.passthrough）。

合成器必须在处理更近的事件之前处理队列中最旧的 .filter。 因此，客户端将参数 "serial" 设置为它接收的相应事件的序列号。

例外：

如果事件不是 wl_keyboard.key 或不包含序列号，则无法过滤。keyboard_filter 客户端不得使用 .filter 请求响应它。当此类事件是队列中最旧的事件时，合成器必须像事件已收到 "passthrough" 回复一样继续处理。

截至 wl_keyboard v10 和 keyboard_filter_v1，唯一可以过滤的事件是 wl_keyboard.key 事件。

序列：

wl_keyboard 在 input_method.activate 提交后开始接收事件。 有效序列号是在 input_method.activate 之后发送的但尚未收到 .filter 确认的最旧 wl_keyboard 事件的序列号。 合成器可能会对它未发出的序列号的事件引发 invalid_serial 错误。 合成器必须忽略所有其他序列号的事件。（特别是，这意味着重复序列号的事件被正常接受，不会被忽略）。 事件必须按到达顺序过滤。

销毁 keyboard_filter 对象，停止事件拦截，并解除绑定到它的 wl_keyboard 和 input_method 对象。

将键盘绑定到输入法，以便在按键到达文本输入客户端之前捕获它们。

当 wl_keyboard 被绑定时，合成器必须将发送到具有文本输入的焦点 surface 的输入事件重定向到它。wl_keyboard 实例从此不再接收其他事件。 参见 keyboard_filter.filter。

要使绑定的 wl_keyboard 实例拦截事件，必须满足以下条件：

• 有一个焦点 surface，
• 该 surface 有一个已启用的文本输入对象，
• 绑定的输入法处于活动状态（关于 "active" 的含义，参见 input_method.activate、input_method.deactivate）。

当这些条件满足时，合成器必须开始将发送到文本输入 surface 的输入事件重定向到使用此请求绑定的 wl_keyboard。否则，文本输入 surface 将接收事件而不进行拦截。

请注意，文本输入客户端可能使用与输入法使用的不同版本的 wl_keyboard 对象。合成器应像通常对相关版本一样发出事件。此协议假设发送到多个不同协议版本键盘的事件是等效的。

背景：

每当输入法被激活时，合成器必须开始向其发送发送到文本输入客户端的键盘事件，以便可以使用键盘控制输入法。 传统上，从用户的角度来看，输入法接收按键就像它们是一个覆盖层：对输入法有意义的按键获得特殊的输入法含义，所有其他按键照常工作。 绑定和 keyboard_filter.filter 请求一起通过让输入法指示它感兴趣的事件来实现这一点。

销毁 xx_keyboard_filter_manager_v1 对象。

由此产生的 xx_keyboard_filter_v1 对象不受影响。