qqapi设计实施说明书模板

《qqapi设计实施说明书模板》由会员上传分享，免费在线阅读，更多相关内容在工程资料-天天文库。

1、完美WORD格式QQAPI设计说明书深圳腾讯计算机系统有限公司专业知识分享完美WORD格式目录一、引言31.1编写目的31.2更新时间3二、总体设计3三、注册的系统消息33.1WM_QQAPI_REGISTER33.2WM_QQAPI_REGISTER_RESP43.3WM_QQAPI_AVAILABLE4四、从设备到QQ的自定义事件54.1EVENT_QQAPI_SET_AUDIODEVICE54.2EVENT_QQAPI_GET_USERINFO54.3EVENT_QQAPI_PRESS_KEY54.4EVEN

2、T_QQAPI_CALL64.5EVENT_QQAPI_MUTE64.6EVENT_QQAPI_UNREGISTER7五、从QQ到设备的自定义事件75.1EVENT_QQAPI_USERINFO75.2EVENT_QQAPI_STATUS_CHANGE75.3EVENT_QQAPI_SHUTDOWN8六、双向的自定义事件86.1EVENT_QQAPI_CALL_STATUS8七、错误码定义107.1从QQ到设备――EVENT_QQAPI_ERROR10八、参数类型码表11专业知识分享完美WORD格式一、引言1.1编

3、写目的本文档提供了QQAPI接口说明，以供第三方应用程序使用，用于QQ和硬件设备（例如USBPhone）的交互。1.2更新时间最后修订日期：2005-05-24版本号：v1.0二、总体设计QQ应用程序和第三方应用程序以收发消息的方式进行通讯。双方未成功注册之前，采用RegisterWindowMessage（WindowsAPI）注册的系统消息进行交互，注册成功后，双方分别获取对方的窗口句柄，接下来的交互通过收发WM_COPYDATA（Windows消息）消息完成。WM_COPYDATA的wParam参数为发送方的

4、窗口句柄，lParam为指向COPYDATASTRUCT结构的指针，COPYDATASTRUCT定义如下：typedefstructtagCOPYDATASTRUCT{ULONG_PTRdwData;DWORDcbData;PVOIDlpData;}COPYDATASTRUCT,*PCOPYDATASTRUCT;dwData：事件码，标示传送的消息事件码lpData：消息参数，采用多个相连的“类型（1字节）＋长度（4字节）＋值”的格式。所有的参数类型码表见8参数类型码表cbData：消息参数总长度，单位字节三、注册

5、的系统消息第三方程序使用WindowsSDK――RegisterWindowMessage，进行下列系统消息的注册。例如：RegisterWindowMessage(“WM_QQAPI_REGISTER”);3.1WM_QQAPI_REGISTER消息名：注册消息方向：设备àQQ专业知识分享完美WORD格式wParam：发送方的窗口句柄lParam：QQAPI版本号，目前为100，表示1.00。第三方应用程序启动并检测到可用的设备后，向所有Windows窗口广播这个消息，带上自己的窗口句柄作为消息参数，如下：Sen

6、dMessage(HWND_BROADCAST,WM_QQAPI_REGISTER,发送端窗口句柄,0);当QQ收到这个消息时，弹出“外设控制”窗口等待用户选择，如下：3.2WM_QQAPI_REGISTER_RESP消息名：注册回复消息方向：QQà设备wParam：值如下：WAITING（1）：等待用户选择OK（2）：用户选择“允许使用”REJECT（3）：用户选择“禁止使用”lParam：当wParam为OK（2）时，lParam为QQ应用程序的窗口句柄。当用户选择“禁止使用”之后，如果第三方应用程序再次发送W

7、M_QQAPI_REGISTER消息，QQ不再弹出“QQ安全警告”框，直接返回REJECT的WM_QQAPI_REGISTER_RESP消息，直到QQ程序重新启动为止。3.3WM_QQAPI_AVAILABLE消息名：QQAPI可用消息方向：QQà设备wParam：发送方的窗口句柄，即QQ程序的窗口句柄lParam：QQAPI版本号，目前为1当QQ启动后，向所有Windows窗口广播这个消息：SendMessage(HWND_BROADCAST,WM_QQAPI_AVAILABLE,QQ窗口句柄,0);当第三方应用

8、程序收到这个消息时，再发起WM_QQAPI_REGISTER消息进行注册。这种情况出现在，当第三方应用程序先启动，而QQ程序后启动的情况下。专业知识分享完美WORD格式四、从设备到QQ的自定义事件4.1EVENT_QQAPI_SET_AUDIODEVICE事件说明：设置QQ使用的音频设备参数说明：WM_COPYDATA中的参数COPYDATASTRUCT结构