DesktopService

本页列出 kibotos.ctrl.v1 中 DesktopService 的方法及每个方法用到的消息与枚举，由 ctrl.proto 及其注释生成，注释保持英文。多个服务共用的消息与枚举见 kibotos.ctrl.v1 类型。

DesktopService captures the Workspace desktop and delivers pointer and keyboard input to it. Every call requires a data-plane bearer credential with DESKTOP scope. The desktop is shared with whoever is watching it through a service connection: these operations neither take control from a viewer nor hand control to one. A Workspace whose desktop is not ready fails every call here and never waits for readiness.

Screenshot复制标题链接

ScreenshotFormat复制标题链接

PerformActions复制标题链接

ScreenPosition复制标题链接

ScreenPosition counts screen pixels from the top left corner. Where an action below leaves it absent, the pointer stays where it already is.

MovePointer复制标题链接

ClickPointer复制标题链接

count is 1 for a single click and 2 for a double click.

PressPointer复制标题链接

ReleasePointer复制标题链接

ScrollPointer复制标题链接

amount counts scroll steps, each one wheel notch.

PressKeys复制标题链接

PressKeys is one chord: the keys are held in the order given and released in the reverse order. Each name is a controlled key name of this contract, not a keycode and not a command line.

TypeText复制标题链接

TypeText types UTF-8 text character by character. Characters the desktop keyboard layout cannot produce are placed on spare keycodes for the duration of the call, so the layout is back to what it was when the call ends. Every remapping is a round trip the desktop applications have to notice: long text, or text with many distinct characters, belongs in WriteClipboard.

WriteClipboard复制标题链接

WriteClipboard makes the UTF-8 text the content of the desktop clipboard, so a paste chord later in the same request receives it. Any application that copies afterwards takes the clipboard over, so the content is not promised to survive past the request that wrote it.

WaitInput复制标题链接

DesktopAction复制标题链接

PointerButton复制标题链接

ScrollDirection复制标题链接