(c#)SKYPE API项目总结（一）

这个项目的需求：SKYPE软件文字聊天同步翻译，并将翻译后的内容会发送给对方，将对方发给自己的话翻译成自己语种。功能见图：

                                      

当点击使用译牛后，在SKYPE软件中，会弹出上面的图片，点击允许后此插件将可以对SKYPE进行操作，界面将变成上图右侧图片。

双击在线好友将出现聊天对话框：

这里发的话,SKYPE软件也会同步：

这个SKYPE小插件主要用到微软在线翻译api和SKYPE API，微软在线翻译参考使用文档 ，  skype api下载地址，执行文件夹里的reg.bat对此dll进行注册后，方可使用。Skype4COM.dll的引用请参考于小章的博客，接下来我将总结下这个小插件用到的一些知识点。

1.软件界面：

软件界面使用的是常用的DotNetBar破解的.dll类库的下载地址。

2.翻译接口的使用：

利用翻译接口进行翻译的功能制作成了一个WebService，因为考虑到翻译接口API里共用一个APP_ID，首先在自己的WS中引用微软在线翻译的web_service.

代码如下：

 public class WS_Translate : System.Web.Services.WebService
    {
        string appId = System.Configuration.ConfigurationManager.AppSettings["Application_id"];
        ServiceRefer.LanguageServiceClient client = new ServiceRefer.LanguageServiceClient();//微软在线翻译的web service
       
        [WebMethod(Discription="获取翻译结果<BR>参数：string text（要翻译的文本）, string from（该文本的语言代码）, string to（要翻译成的目标语言代码）<BR>返回：string （翻译后的文本）")]
        public string GetTranslateResult(string text,string from,string to)
        {                                
            string resulte=client .Translate (appId ,text ,from,to,"text/html","general");          
            return resulte;
        }      

        [WebMethod(Discription="返回语言代码<BR>参数：无<BR>返回：string[]")]
        public string[] GetLanguagesCode() { string[] LanguagesCode = client.GetLanguagesForTranslate(appId); return LanguagesCode; }

        [WebMethod(Discription="根据提供的显示语言类型，返回对应该语言的语言名称列表。<BR>参数：string localeLanguage<BR>返回：string[]")]
        public string[] GetLanguage() { string[] LanguagesName = client.GetLanguageNames(appId,"zh-CHS", GetLanguagesCode());//"zh-CHS"简体中文 
        return LanguagesName; } 
    }

skype api工具类代码如下：

namespace YiNiu
{
    /// <summary>
    /// Skype工具
    /// </summary>
    public class SkypeTool
    {
        /// <summary>
        /// Skype对象
        /// </summary>
        public Skype Skype { get; set; }

        /// <summary>
        /// 当前用户
        /// </summary>
        public User CurrentUser
        {
            get
            {
                try
                {
                    return this.Skype.CurrentUser;
                }
                catch
                {
                    return null;
                }
            }
        }

        /// <summary>
        /// 当前用户的资料
        /// </summary>
        public Profile CurrentUserProfile { get { return this.Skype.CurrentUserProfile; } }

        /// <summary>
        /// 我的语言种类
        /// </summary>
        public String MyCode { get { return this.CurrentUser .LanguageCode ; } }

        /// <summary>
        /// 在线好友
        /// </summary>
        public UserCollection  Friends { get { return this.Skype.Friends ; } }

        /// <summary>
        /// 连接状态
        /// </summary>
        public TOnlineStatus  Status { get { return this.Skype.CurrentUser.OnlineStatus; }}

        /// <summary>
        /// 是否Skype正在运行
        /// </summary>
        public bool IsSkypeRunning { get { return this.Skype.Client.IsRunning; } }

        /// <summary>
        /// 消息状态变化时
        /// </summary>
        public event _ISkypeEvents_MessageStatusEventHandler MessageStatus;

        /// <summary>
        /// 在线用户状态变化时
        /// </summary>
        public event _ISkypeEvents_OnlineStatusEventHandler OnlineStatus;

        /// <summary>
        /// 实例化WebService
        /// </summary>
        public  TranslateService translate = new TranslateService(ConstStrings.TRANSLATE_WEBSERVICE_URL);

        /// <summary>
        /// 构造函数
        /// </summary>
        public SkypeTool()
        {
            this.Skype = new Skype();//实例化Skype对象
            this.Skype.MessageStatus += new _ISkypeEvents_MessageStatusEventHandler(Skype_MessageStatus);//发送信息和接受信息时触发此事件
            this.Skype.OnlineStatus += new _ISkypeEvents_OnlineStatusEventHandler(Skype_OnlineStatus);//用户在线状态改变触发此事件
        }

        /// <summary>
        /// 返回状态列表
        /// </summary>     
        public DataTable GetStatus()
        {
            DataTable list = new DataTable();
            list.Columns.Add(new DataColumn("Display", typeof(string)));
            list.Columns.Add(new DataColumn("Value", typeof(string)));
            for (int i = 0; i < 5; i++)
            { list.Rows.Add(list.NewRow()); }
            //英文的对应是用SKYPE API读出的链接状态
            list.Rows[0][0] = "在线";
            list.Rows[1][0] = "离开";
            list.Rows[4][0] = "请勿打扰";
            list.Rows[2][0] = "隐身";
            list.Rows[3][0] = "离线";
            list.Rows[0][1] = "Online";
            list.Rows[1][1] = "Away";
            list.Rows[2][1] = "Invisible";
            list.Rows[3][1] = "Offline";
            list.Rows[4][1] = "DND";                                   
            return list;
        }

        /// <summary>
        /// 返回好友列表
        /// </summary>
        /// <returns></returns>
        public string[,] GetFriends()
        {    
            string[,] list = new string[Skype.Friends.Count, 3];
            for (int i = 0; i < Skype.Friends.Count; i++)
            {
                int index = 1;
                if (Skype.Friends[i + 1].FullName != "" || Skype.Friends[i + 1].DisplayName != "" || Skype.Friends[i + 1].Handle!="")
                {
                    //获得用户在线状态
                    string status=this.TextSataus ((this.Skype.get_User(Skype.Friends[i + 1].Handle.ToString()).OnlineStatus)).ToUpper();
                    if (status  == "ONLINE")
                    {
                       index = 0;
                    }
                    if (Skype.Friends[i + 1].DisplayName != "")
                    {
                        list[i, 0] = Skype.Friends[i + 1].DisplayName.ToString();//用户昵称
                    }
                    else
                    {
                        if (Skype.Friends[i + 1].FullName != "")
                        { list[i, 0] = Skype.Friends[i + 1].FullName.ToString(); }//用户昵称
                        else
                        { list[i, 0] = Skype.Friends[i + 1].Handle.ToString(); }
                    }
                    list[i, 1] = Skype.Friends[i + 1].Handle.ToString();//用户名
                    list[i, 2] = index.ToString();//用户在线状态
                }
            }
            return list;        
        }
   
        /// <summary>
        /// 返回语言列表
        /// </summary>
        /// <returns></returns>
        public DataTable GetToLanguage(string code)
        {
            DataTable list = new DataTable();
            list.Columns.Add(new DataColumn("Display", typeof(string)));
            list.Columns.Add(new DataColumn("Value", typeof(string)));           
            List<string> LanguagesName = translate.GetLanguagesName(code);//调用webService
            List<string> LanguagesCode = translate.GetLanguagesCode();
            for (int i = 0; i < LanguagesName.Count; i++)
            {
                list.Rows.Add(list.NewRow());
                list.Rows[i][0] = LanguagesName[i].ToString();
                list.Rows[i][1] = LanguagesCode[i].ToString(); ;
            }
            return list;
        }
       
        /// <summary>
        /// 获得某一用户的语言类型
        /// </summary>
        /// <param name="fullname"></param>
        /// <returns></returns>
        public string  GetUserLanguageCode(string fullname)
        {
           return   SetMycode(Skype.get_User(fullname ).LanguageCode.ToString()); 
        }

        /// <summary>
        /// 初始化语言
        /// </summary>
        /// <returns></returns>
        public string SetMycode(string code)
        {
            //在Skype中和TranslateSope中汉语的英文code不对应需要转换           
            if (code == "zh-Hans" || code == "zh")//获取sender.languageCode,汉语是ch，不分简体和繁体
            {
                code = "zh-CHS";
            }
            if (code == "zh-Hant")
            {
                code = "zh-CHT";
            }
            return code;
        }

        /// <summary>
        /// 建立聊天
        /// </summary>
        /// <param name="friend">好友的用户名handle</param>      
        public IChat CreateIchat(string friend)
        {
            IChat ichat = Skype.CreateChatWith(friend);
            return ichat;
        }

        /// <summary>
        /// 状态变化
        /// </summary>
        /// <param name="pMessage">信息</param>
        /// <param name="Status">信息状态</param>
        private void Skype_MessageStatus(ChatMessage pMessage, TChatMessageStatus Status)
        {
            if (this.MessageStatus != null)
            {
                this.MessageStatus(pMessage, Status);
            }
        }

        /// <summary>
        /// 改变用户状态
        /// </summary>
        /// <param name="Status">用户在线状态</param>
        public  void ChangeStatus(string  Status)
        {            
            this.Skype.ChangeUserStatus(Skype.Convert.TextToUserStatus(Status)); 
        }

        /// <summary>
        /// 启动Skype
        /// </summary>
        public bool StartSkype()
        {
            try
            {
                if (!this.Skype.Client.IsRunning)
                {
                    this.Skype.Client.Start(false, true);                  
                }            
                //添加到类，用于控制
                this.Skype.Attach(5, false);              
                return true;
            }
            catch 
            {          
                return false;
            }            
        }

        /// <summary>
        /// 用户状态变化事件
        /// </summary>
        /// <param name="pUser">用户</param>
        /// <param name="Status">状态</param>
        public void Skype_OnlineStatus(User pUser, TOnlineStatus Status)
        {
            if (this.OnlineStatus  != null)
            {
                this.OnlineStatus(pUser, Status);
            }
        }

        /// <summary>
        /// 用户在线状态改变成"online"格式
        /// </summary>      
        public string TextSataus(TOnlineStatus Status)
        {
            return this.Skype.Convert.OnlineStatusToText(Status);
        }
    }  
}

这里软件整体的框架就出来了，后面章节再具体介绍细节的处理，软件的全部代码下载