首页 > 代码库 > 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协议----输入通道定义