平台与WeLink深度融合技术汇总

由于工作需要，平台要集成WeLink的会议管理和通讯录管理功能，通过一段时间的努力终于完成，在这个过程中，收获不少，汇总一下这次的经验，如果有同样需要的人，可以参考一下。

WeLink是华为开发的一款协同办公软件，集成有视频会议，即时通讯，屏幕共享，通讯录，还有一站式企业服务等功能，具体介绍可以参考华为官网。

1、华为会议集成

1.开发文档

会议_华为云

实现效果：第三方应用通过输入API网关接入地址、会议用户帐号等相关参数进行预约会议，预约成功后即可获得入会链接。点击链接入会，系统自动调起华为会议客户端进入会议，实现一键入会。

 一键入会业务流程：

1. 初始化参数，填入API网关接入地址、用户帐号等参数。
2. 第三方向网关APIG发起预约会议请求，并传入预约会议初始化参数。
3. 网关APIG接收请求后，向CloudPortal发起预约会议请求。
4. CloudPortal预约会议成功后，向APIG网关返回会议信息。
5. 网关APIG将收到的会议信息返回给第三方。
6. 预约会议成功后，获取conferenceID以及密码。为了实现链接入会，第三方向网关APIG发起会议鉴权请求。
7. 网关APIG接收请求后，向CloudPortal发送会议鉴权请求。
8. CloudPortal会议鉴权成功后，向APIG网关返回认证信息。
9. 网关APIG将收到的认证信息返回给第三方，获取鉴权随机数(random)和下一跳url(siteUrl)。
10. 构造华为会议客户端的自定义URL Protocol，然后拉起华为客户端并加入会议。

 2.代码详解

 我们这里以通过账号密码获取token接口为例，讲解一下代码这块的写法

/// <summary>
        /// 通过账号密码获取token
        /// </summary>
        /// <param name="request">body参数</param>
        /// <returns></returns>
        public M_accessTokeninfoResponse GetMeetingToken(M_proxyRequest request)
        {
            M_accessTokeninfoResponse response = Action.Execute<M_accessTokeninfoResponse>(request);
            return response;
        }

 public T Execute<T>(ApiRequest request) where T : ApiResponse
        {
            var jsonResult = ExecuteGetJsonStr(request);
            return JsonConvert.DeserializeObject<T>(jsonResult);
        }

public  class M_accessTokeninfoResponse : ApiResponse
    {

        public string accessToken { get; set; }
        public string tokenIp { get; set; }
        public string validPeriod { get; set; }
        public string expireTime { get; set; }
        public string createTime { get; set; }
        public user user { get; set; }
        public int clientType { get; set; }
        public string forceLoginInd { get; set; }
        public string firstLogin { get; set; }
        public string pwdExpired { get; set; }
        public string daysPwdAvailable { get; set; }
    }

public class M_proxyRequest : ApiRequest
    {
        public string account { get; set; }
        public string authServerType { get; set; }
        public string authType { get; set; }
        public int clientType { get; set; }
        public int createTokenType { get; set; }
        public string pwd { get; set; }

        public override string GetApiMethod()
        {
            return "/v1/usg/acs/auth/proxy";
        }
    }

 public abstract class ApiRequest
    {
        public abstract string GetApiMethod();
    }

public class ApiResponse
    {
        //public string access_token { get; set; }
        //public Int32 expires_in { get; set; }
        public string code { get; set; }
        public string message { get; set; }
    }

public string ExecuteGetJsonStr(ApiRequest request)
        {
            var url = GetRequestUrl(request);
            var jsonData = GetRequestParamJsonStr(request);

            return HttpWebRequestHelper.PostJsonToUrl(url, jsonData);
        }

 private string GetRequestUrl(ApiRequest request)
        {
            StringBuilder urlSb = new StringBuilder(meetingsUrl);
            urlSb.Append(request.GetApiMethod());
            return urlSb.ToString();
        }

public string GetRequestParamJsonStr(ApiRequest request)
        {
            var jsonResult= JsonConvert.SerializeObject(request);
            if (jsonResult=="{}")
            {
                return "";
            }
            else
            {
                return jsonResult;
            }
        }

public static class HttpWebRequestHelper
    {
        #region PostJson方法
        /// <summary>
        /// post传递json数据
        /// 无token时
        /// </summary>
        /// <param name="url">要请求的URL地址</param>
        /// <param name="postData">json数据</param>
        /// <returns></returns>
        public static string PostJsonToUrl(string url, string postData)
        {
            string result = "";
            //解决请求被中止：无法建立SSL / TLS安全通道问题
            System.Net.ServicePointManager.SecurityProtocol = (SecurityProtocolType)192 | (SecurityProtocolType)768 | (SecurityProtocolType)3072;
            
            HttpWebRequest req = (HttpWebRequest)WebRequest.Create(url);

            req.Method = "POST";
            req.Timeout = 60000;//设置请求超时时间，单位为毫秒
            req.ContentType = "application/json";
            req.UserAgent = "Apache-HttpClient/4.5.3 (Java/1.8.0_191)";
            SetHeaderValue(req.Headers, "Connection", "keep-alive");
            SetHeaderValue(req.Headers, "X-Request-ID", Guid.NewGuid().ToString("N"));
            SetHeaderValue(req.Headers, "Accept-Language", "zh_CN");

            byte[] data = Encoding.UTF8.GetBytes(postData);

            req.ContentLength = data.Length;
            ServicePointManager.CertificatePolicy = new AcceptAllCertificatePolicy();

            using (Stream reqStream = req.GetRequestStream())
            {
                reqStream.Write(data, 0, data.Length);
            }

            HttpWebResponse resp = (HttpWebResponse)req.GetResponse();

            Stream stream = resp.GetResponseStream();

            //获取响应内容
            using (StreamReader reader = new StreamReader(stream, Encoding.UTF8))
            {
                result = reader.ReadToEnd();
            }

            return result;
        }
}

3.注意事项

.net 4.0 无法建立SSL / TLS安全通道问题，解决方案如下

   //解决请求被中止：无法建立SSL / TLS安全通道问题
   System.Net.ServicePointManager.SecurityProtocol = (SecurityProtocolType)192 | (SecurityProtocolType)768 | (SecurityProtocolType)3072;
　　　ServicePointManager.CertificatePolicy = new AcceptAllCertificatePolicy();

参考博客文档：https://www.cnblogs.com/SuperMetalMax/p/7286044.html

 2、实现效果

 会议管理页面

 

一键入会效果

视频会议效果图

 

屏幕共享，白板共享，程序共享等

 

 屏幕共享效果