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;//客户端鼠标显示的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;