腾讯通RTX插件开发指南.docVIP

腾讯通RTX插件开发指南 目 录 1、开发前准备 2、创建插件工程 3、界面上的体现 4、交互控制 5、收发数据处理 6、插件打包发布 7、后语 1、开发前准备 需要安装如下文件： RTXC2006Beta02， RTXClient2006 SDKBeta02 ； 开发插件的过程一般是要经历一下几个步骤： 创建插件工程， RTX客户端里界面上体现， 交互控制， 数据传输， 打包发布； 以下的用例是开发一个程序共享的插件，通过介绍开发程序共享的插件，来讲解插 件的一般开发过程。 2、创建插件工程 创建插件工程，首先把RTXC SDK目录中wizard目录下的RTXCModuleAW.awx文件拷至VC安装目录Microsoft Visual Studio\COMMON\MSDev98\Template\ ，然后在VC中创建一个插件工程。 第一步：创建一个AppSharePlugin 工程。  第二步：设置插件的信息。  第三步：设置插件内部绑定的事件。  完成以上三个步骤之后，可以自动生成如下函数：  这些自动生成的代码，已经定义了RTXC的接口函数，一个插件的基本框架已经搭建成功，用户只需要在这些接口函数里添加自己的功能。 创建完成一个插件工程之后，就需要考虑在RTX的客户端界面能体现出该插件，如菜单、面板、TAB或者在RTXC其他的界面元素上；程序共享主要在RTXC的菜单上增加一个新的菜单项来体现，其他的体现方式，可以参看RTXC SDK文档。 3、界面上的体现 程序共享一般需要在RTX客户端的菜单中添加“程序共享”的菜单项，操作步骤如下： 第一步：设置动态菜单相关的内容。 首先在Stdafx.h文件中添加如下代码： #import ClientObjects.tlb raw_interfaces_only no_namespace, named_guids #include RTXCModuleIds.h 在插件中实现动态的添加和删除菜单，就必须包含ClientOjbect.tlb和RTXModuleIds.h 这两个文件，这两个文件分别位于SDK安装目录下的TLB和INCLUDE目录下，用户可以根据实际情况，设置文件的相对路径。 然后在AppSharePluginModule.h文件中增加菜单对象的定义和菜单响应的函数，如下： IRTXCMenuPtr m_pMenu; // 定义RTXC菜单对象 IRTXCUICommand* m_pUICmd; 定义菜单响应函数的接口： BEGIN_DUAL_INTERFACE_PART(MenuSink, IRTXCUICommand) STDMETHOD(OnInvoke)(enum RTXC_UI_TYPE UIType, long Id, VARIANT Parameter) { METHOD_PROLOGUE(CAppSharePluginModule, MenuSink) return pThis-OnInvoke(UIType, Id, Parameter); } STDMETHOD(OnQueryState)(enum RTXC_UI_TYPE UIType, long Id, VARIANT Parameter, BSTR* Text, enum RTXC_UI_ITEM_STATE* State) { METHOD_PROLOGUE(CAppSharePluginModule, MenuSink) return pThis-OnQueryState(UIType, Id, Parameter, Text, State); } END_DUAL_INTERFACE_PART(MenuSink) 定义菜单响应的接口函数： HRESULT OnInvoke(enum RTXC_UI_TYPE UIType, long Id, VARIANT Parameter); HRESUL