Socket聊天程序API接口.docx

Socket聊天程序API接口typedef unsigned int uint32t;typedef unsigned short uint16t;typedef unsigned short uint8t;#define QF_Register 0x1#define QF_Login 0x2#define QF_ModifyUser 0x3#define QF_ModifyDynamicUser 0x4#define QF_Logout 0x5#define QF_UploadHeadImage 0x6#define QF_DownloadHeadImage 0x7#define QF_DeleteHeadImage 0x8#define QF_HeartBeat 0x9#define QF_Profile 0x10#define QF_SaveOfflineMsg 0x12#define QF_ReadOfflineMsg 0x13/** Socket聊天程序API接口 *//* 请求头的通用类型 */struct QFChatRequestProtocol { uint32t type; /* 协议类型 */ uint32t subType; /* 协议子类型 */ uint32t payloadLength; /* 协议内容长度 */ uint32t reserverd; /* 保留字段 */};/* 响应头的通用类型 */struct QFChatResponseProtocol { uint32t payloadLength; /* 协议内容长度 */ uint32t status; char msg[128];};/** 用户静态信息: */struct QFUserInfo { uint32t userID; /* 用户在服务器数据库上存放的ID */ char username[32];/* 用户名; 用户名不能修改 */ char password[32];/* 密码 */ char nickname[128]; /* 昵称 */ char qmd[128];/* 用户的签名档 */};/** 用户动态信息: */#define QFUSER_INFO_STATUS (11)#define QFUSER_INFO_LAN (12)#define QFUSER_INFO_WAN (13)#define QFUSER_INFO_GPS (14)struct QFDynamicUserInfo { uint32t userID; uint32t type; /* 后续包含的内容有什么，*/ /* 比如有 status; 有局域网地址，有广域网地址，有gps */ /* 用户的状态 *//* 0 Online; 1 Away; 2 Hidden; */ uint32t status; char lanIP[16];/* 局域网的ip地址 */ char wanIP[16];/* 外网的ip地址 */ uint16t lanPort;/* 局域网的端口 */ uint16t wanPort;/* 外网的端口 */ float gpsLatitude; float gpsLongitude;};/* 1. 注册Register */struct QFRegisterRequest { struct QFChatRequestProtocol header; struct QFUserInfo user; /* 里面的userID无效 */};/** 成功后返回status = 0; */struct QFRegisterResponse { struct QFChatResponseProtocol response;};/*status = 0 成功返回status 0 错误错误信息放在msg中*//* 2. 登陆Login */struct QFLoginRequest { struct QFChatRequestProtocol header; char username[32];/* 用户名 */ char password[32];/* 密码 */ char lanIP[32];/* 局域网的ip地址 */ char lanPort[32];/* 局域网的端口 */ float gpsLatitude; float gpsLongitude;};/* 成功后返回 */struct QFLoginResponse { struct QFChatResponseProtocol response; uint32 userID;};/** 3. 修改用户信息ModifyUser */struc