首页 > 代码库 > Spice协议----输入通道定义
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;//客户端鼠标显示的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;
Spice协议----输入通道定义
声明:以上内容来自用户投稿及互联网公开渠道收集整理发布,本网站不拥有所有权,未作人工编辑处理,也不承担相关法律责任,若内容有误或涉及侵权可进行投诉: 投诉/举报 工作人员会在5个工作日内联系你,一经查实,本站将立刻删除涉嫌侵权内容。