Spice协议----输入通道定义

1  输入通道定义

SPICE输入通道主要控制鼠标和键盘的操作

1.1服务器---》客户端

enum {    SPICE_MSG_INPUTS_INIT = 101,    SPICE_MSG_INPUTS_KEY_MODIFIERS,    SPICE_MSG_INPUTS_MOUSE_MOTION_ACK = 111,    SPICE_MSG_END_INPUTS};

1.2客户端---》服务器

enum {    SPICE_MSGC_INPUTS_KEY_DOWN = 101,    SPICE_MSGC_INPUTS_KEY_UP,    SPICE_MSGC_INPUTS_KEY_MODIFIERS,    SPICE_MSGC_INPUTS_KEY_SCANCODE,    SPICE_MSGC_INPUTS_MOUSE_MOTION = 111,    SPICE_MSGC_INPUTS_MOUSE_POSITION,    SPICE_MSGC_INPUTS_MOUSE_PRESS,    SPICE_MSGC_INPUTS_MOUSE_RELEASE,    SPICE_MSGC_END_INPUTS};

1.3Keyboard 消息

SPICE协议支持发送键盘事件和同步键盘指示灯功能。客户端发送键盘事件SPICE_MSGC_INPUTS_KEY_UP、SPICE_MSGC_INPUTS_KEY_DOWN消息。键值使用PC AT码表示。键盘指示灯同步是通过客户端发送SPICE_MSGC_INPUTS_KEY_MODIFIERS或者服务器端发送SPICE_MSG_INPUTS_KEY_MODIFIERS消息。这些消息中保存了键盘指示灯的状态。服务器同样可以使用SPICE_MSG_INPUTS_INIT消息发送键盘的修改。这个消息必须是第一个接收到的消息，后续不应该再发送。

1.3.1  键盘指示灯宏

typedef enumSpiceKeyboardModifierFlags {    SPICE_KEYBOARD_MODIFIER_FLAGS_SCROLL_LOCK =(1 << 0),    SPICE_KEYBOARD_MODIFIER_FLAGS_NUM_LOCK = (1<< 1),    SPICE_KEYBOARD_MODIFIER_FLAGS_CAPS_LOCK =(1 << 2),     SPICE_KEYBOARD_MODIFIER_FLAGS_MASK = 0x7} SpiceKeyboardModifierFlags;

1.3.2  客户端---》服务器宏

enum {    SPICE_MSGC_INPUTS_KEY_DOWN = 101,    SPICE_MSGC_INPUTS_KEY_UP,    SPICE_MSGC_INPUTS_KEY_MODIFIERS,    SPICE_MSGC_INPUTS_KEY_SCANCODE,    SPICE_MSGC_INPUTS_MOUSE_MOTION = 111,    SPICE_MSGC_INPUTS_MOUSE_POSITION,    SPICE_MSGC_INPUTS_MOUSE_PRESS,    SPICE_MSGC_INPUTS_MOUSE_RELEASE,    SPICE_MSGC_END_INPUTS};

1.3.3  服务器---》客户端宏

enum {    SPICE_MSG_INPUTS_INIT = 101,    SPICE_MSG_INPUTS_KEY_MODIFIERS,    SPICE_MSG_INPUTS_MOUSE_MOTION_ACK = 111,     SPICE_MSG_END_INPUTS};

1.3.4  键盘事件相关结构体

typedef structSpiceMsgcKeyDown {    uint32_t code;}SpiceMsgcKeyDown; typedef structSpiceMsgcKeyUp {    uint32_t code;}SpiceMsgcKeyUp; typedef structSpiceMsgcKeyModifiers {    uint32_t modifiers;}SpiceMsgcKeyModifiers;

1.4鼠标消息

SPICE 支持鼠标操作的两种模式：服务器和客户端模式。（更多的参见3.4章节）在服务器模式下，客户端发送鼠标运动消息（SPICE_MSGC_INPUTS_MOUSE_MOTION），客户端模式下，发送位置消息（SPICE_MSGC_INPUTS_MOUSE_POSITION）。位置消息保存客户鼠标的显示位置和显示通道的ID（在RedLinkMess.channel_id）。为了防止鼠标运动、位置时间发送频繁，客户端在收到每个SPICE_MSG_INPUTS_KEY_MODIFIERS消息后会回应SPICE_MSG_INPUTS_MOUSE_MOTION_ACK。这种机制允许客户端跟随服务器的信息和改变事件的推送策略。鼠标按钮事件使用SPICE_MSGC_INPUTS_MOUSE_PRESS和SPICE_MSGC_INPUTS_MOUSE_RELEASE消息发送给服务器。

1.4.1  鼠标按键ID

typedef enumSpiceMouseButton {    SPICE_MOUSE_BUTTON_INVALID,    SPICE_MOUSE_BUTTON_LEFT,    SPICE_MOUSE_BUTTON_MIDDLE,    SPICE_MOUSE_BUTTON_RIGHT,    SPICE_MOUSE_BUTTON_UP,    SPICE_MOUSE_BUTTON_DOWN,     SPICE_MOUSE_BUTTON_ENUM_END}SpiceMouseButton;

1.4.2  按键掩码

typedef enumSpiceMouseButtonMask {    SPICE_MOUSE_BUTTON_MASK_LEFT = (1 <<0),    SPICE_MOUSE_BUTTON_MASK_MIDDLE = (1<< 1),    SPICE_MOUSE_BUTTON_MASK_RIGHT = (1 <<2),     SPICE_MOUSE_BUTTON_MASK_MASK = 0x7}SpiceMouseButtonMask;

1.4.3  SpiceMsgcMouseMotion

typedef structSpiceMsgcMouseMotion {    int32_t dx; //鼠标移动到的X像素点    int32_t dy; //鼠标移动道德Y像素点    uint32_t buttons_state;//鼠标操作的掩码。}SpiceMsgcMouseMotion;

1.4.4SpiceMsgcMousePosition

typedef structSpiceMsgcMousePosition {    uint32_t x; //X 坐标位置    uint32_t y;//Y 坐标位置    uint32_t buttons_state; //鼠标操作的掩码    uint8_t display_id;//客户端鼠标显示的ＩＤ}SpiceMsgcMousePosition;

1.4.5SpiceMsgcMousePress

typedef structSpiceMsgcMousePress {    int32_t button;　//鼠标按键的ID号    int32_t buttons_state; //鼠标操作的掩码}SpiceMsgcMousePress;

1.4.6SpiceMsgcMouseRelease

typedef structSpiceMsgcMouseRelease {    int32_t button;//鼠标按键的ID号    int32_t buttons_state; //鼠标操作的掩码}SpiceMsgcMouseRelease;