Asp.Net 集成RTX(腾讯通)开发实践



做完这个集成这后,还是感觉挺有意思的,毕竟公司90%的人都在使用RTX,再也用使用OA通知,可以像360强制弹窗一样,提醒在线的同事啦。


以下开发基于RTX2010进行开发

准备工作


RTX腾讯通的介绍可以在下面的这个网站上获取

腾讯通官网

以下文档可能在您开发过程中,能给您带来帮助:

官网下载地址:

http://rtx.tencent.com/rtx/support/index.shtml



Server端开发文档指南



Client端开发文档指南




RTXServer SDK 帮助文档及示例



RTXClient SDK 帮助文档及示例


建议在开发之前,大致浏览或阅读以上的相关文档,这样做起来才有底。



环境配置

1.装有RTX2011 正式版的RTX Server 服务端的服务器




2.RTX SDK的安装,可以与RXT的Server 安装在同一服务器上,也可以安装在不同的服务器中



安装好后,最好使用SDK自带的Demo测试一下是否OK,如果不OK,则要检查安装是否有问题

2.1验证是否OK



如果能启动成功,则证明配置是OK的




排除安装问题外,则需要检查下面这三个文件的配置是否OK

SDK默认是安装的服务器可以访问的,如果您的SDK是安装在其它服务器上,则要通过配置三个XML文件,将SDK的服务器的IP添加在可允许访问的IP策略上.

文件名称:

AppConfig.xml AppConnConfig.xml SDKProperty.xml

AppConfig.xml





AppConnConfig.xml




SDKProperty.xml




三个文件修改后,要重启RTX的相关服务才能生效,建议能重启整台服务器最好.


3.客户端的安装




一切环境配置OK,就可以开始进行开发工作了.

安装好SDK后,就可以引用SDK安装中的相关dll

[b]集成开发[b]

1.首先要引用SDK中的组件,引用中的文件是在SDK的安装路径下



引用后,就成了下面这样子的了



提示:在SDK的安装路径下还有个demo,这个demo可以很好的帮助我们实现开发


2.在cs文件中引用

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;

using RTXSAPILib;



初始化服务器配置


int retval;
           //初始化服务器属性
           RTXSAPILib.IRTXSAPIRootObj RootObj;
           RootObj = new RTXSAPIRootObj();
           //创建根对象
           RootObj.ServerIP = "172.28.8.36"

           RootObj.ServerPort ="8006"; //设置服务器端口



进行相关的代码操作

发送提醒消息

///
       /// 发送消息提醒
       ///

       /// 接收者
       /// 标题
       /// 停留时间 0为等待用户关闭,以毫秒计
       /// 发送内容,自动识别链接
       ///
       public  static int SendNotify(string receiverAccount, string title, string holdtime, string content)
       {
           int retval;
           //初始化服务器属性
           RTXSAPILib.IRTXSAPIRootObj RootObj;
           RootObj = new RTXSAPIRootObj();
           //创建根对象
           RootObj.ServerIP = *****.***.DAL.SysConfig.strRTXSERVER.ToString();

           RootObj.ServerPort = Convert.ToInt16(*****.***.DAL.SysConfig.strRTXSERVERPORTAL); //设置服务器端口

           try
           {
               RootObj.SendNotify(receiverAccount, title, 0, content); //获取版本信息

               retval = 1;

               return retval;
           }
           catch (Exception xe)
           {
               retval = 0;

               return retval;

           }

       }




发送IM聊天消息

  ///
       /// 发送IM
       ///

       /// 发送人
       /// 发送人密码
       /// 接收者,不能超过128人一次
       /// 发送内容
       /// 0为发送出错 1为成功
       public int SendIM(string senderAccount, string password,  string receiver, string content)
       {
           int retval;

           //初始化服务器属性
           RTXSAPILib.IRTXSAPIRootObj RootObj;
           RootObj = new RTXSAPIRootObj();
           //创建根对象
           RootObj.ServerIP = *****.***.DAL.SysConfig.strRTXSERVER.ToString();
           RootObj.ServerPort = Convert.ToInt16(*****.***.DAL.SysConfig.strRTXSERVERPORTAL); //设置服务器端口

           //获致sessionkey

           string sessionKey = GetSessionKey(senderAccount);

           try
           {
               RootObj.SendIM(senderAccount, password, receiver, content, sessionKey);

               retval = 1;

               return retval;
           }
           catch (Exception xe)
           {
               retval = 0;

               return retval;
              
           }
       }



获取sessionKey


       ///
       /// 根据账号获取sessionKey
       ///

       ///
       ///
       public static string GetSessionKey(string Account)  //服务器端代码
       {
           RTXSAPILib.IRTXSAPIRootObj RootObj;
           RootObj = new RTXSAPIRootObj();
           //创建根对象
           RootObj.ServerIP = *****.***.DAL.SysConfig.strRTXSERVER.ToString();
           RootObj.ServerPort = Convert.ToInt16(*****.***.HR.DAL.SysConfig.strRTXSERVERPORTAL); //设置服务器端口

           string SessionKey = "";


           RTXSAPILib.RTXSAPIUserAuthObj UserAuthObj = RootObj.UserAuthObj; //创建一个用户认证对象

           try
           {
               SessionKey ="{"+ UserAuthObj.GetSessionKey(Account)+"}";  //通过用户认证对象获取SessionKey
           }
           catch (Exception ex)
           {
              return ex.Message.ToString();
           }
           return SessionKey; //返回SessionKey
       }




检查用户在线状态

   ///
       /// 检查用户状态
       ///

       /// 用户账号
       ///
       public static string QueryUserState(string userAccount)
       {
           RTXSAPILib.IRTXSAPIRootObj RootObj;
           RootObj = new RTXSAPIRootObj();
           //创建根对象
           RootObj.ServerIP =*****.***.DAL.SysConfig.strRTXSERVER.ToString();
           RootObj.ServerPort = Convert.ToInt16(*****.***.DAL.SysConfig.strRTXSERVERPORTAL); //设置服务器端口
           try
           {
            
               return RootObj.QueryUserState("德仔");

           }
           catch (Exception ex)
           {
               return "Error";
           }
          

       }




检查是否存在用户


  ///
       /// 检查是否存在用户
       ///

       /// 用户账号
       ///
       public static bool IfExist(string userAccount)
       {
           int retval;

           RTXSAPILib.IRTXSAPIRootObj RootObj;
           RootObj = new RTXSAPIRootObj();
           //创建根对象
           RootObj.ServerIP =*****.***.DAL.SysConfig.strRTXSERVER.ToString();
           RootObj.ServerPort = Convert.ToInt16(*****.***.DAL.SysConfig.strRTXSERVERPORTAL); //设置服务器端口


           try
           {

               return RootObj.UserManager.IsUserExist(userAccount);
              
           }
           catch (Exception ex)
           {
               return false;
           }
       }



删除用户

  ///
       /// 删除用户
       ///

       /// 用户账号
       ///
       public static bool DeleteUserAccount(string userAccount)
       {
           RTXSAPILib.IRTXSAPIRootObj RootObj;
           RootObj = new RTXSAPIRootObj();

           //创建根对象
           RootObj.ServerIP = *****.***.DAL.SysConfig.strRTXSERVER.ToString();
           RootObj.ServerPort = Convert.ToInt16(*****.***.DAL.SysConfig.strRTXSERVERPORTAL); //设置服务器端口

           try
           {

               RootObj.UserManager.DeleteUser(userAccount);

               return true;
           }
           catch (Exception xe)
           {
              

               return false;

           }
       }




这里要注意的是:session key的格式要与RTX帮助文档中的key值的格式一样,否则就会出现发送IM的时候能看到IM但点击就会弹不出来的问题.格式是[color=red]"{"+md5值+"}+
形式的
[/color]

以上的代码开发完成后,就可以测试效果了




是不是很欣慰啊?呵呵!



参考文档

RTX ASP.NET(C#) 结合的个人实践 可以OA平台的接口
http://blog.csdn.net/yunfan555/article/details/2978284

asp.net (C#) RTX(腾讯通) 接口应用 能实现与OA接口

http://www.cnblogs.com/sunjie9606/archive/2012/10/25/2738337.html

[本日志由 admin 于 2015-12-03 09:25 AM 更新]
上一篇: 在线播放flv视频文件
下一篇: .Net 生成二维码 名片实现
文章来自: 本站原创
引用通告: 查看所有引用 | 我要引用此文章
Tags: Asp.Net 集成RTX
相关日志:
评论: 0 | 引用: 0 | 查看次数: 11750
发表评论
昵 称:
密 码: 游客发言不需要密码.
邮 箱: 邮件地址支持Gravatar头像,邮箱地址不会公开.
网 址: 输入网址便于回访.
内 容:
验证码:
选 项:
虽然发表评论不用注册,但是为了保护您的发言权,建议您注册帐号.
字数限制 30 字 | UBB代码 关闭 | [img]标签 关闭