1、HTML5 SDK集成攻略

1.1、引进sdk

开发者集成云通讯H5_SDK,需求先引进H5_SDK。即在您的页面中引进如下代码:

Http环境引进代码:<script src="http://app.cloopen.com/im50/ytx-web-im-min-new-5.3.2r16.js"></script>

Https环境引进代码:<script src="https://app.cloopen.com/im50/ytx-web-im-min-new-5.3.2r16.js"></script>

注:SDK接口阐明请参阅《SDK接口阐明》

补白:

(1)H5基本功用以及音视频的兼容性:

a、H5浏览器支撑IM功用状况:

IE浏览器要求IE10及以上才支撑,发送附件要求IE11才支撑;Chrome浏览器需求40版别以上内核支撑;Firefox浏览器主张50版别以上。

b、H5浏览器支撑音视频功用状况:

HTTP协议点对点音视频只支撑谷歌浏览器(44,45,46稳定版);HTTPS协议支撑Chrome40以上一切版别(引荐运用Chrome47以上版别)及Firefox最新版别,支撑Edge浏览器40以上。

Android:有必要为HTTPS协议。

Android Webkit 53以上支撑音视频功用。

注:webview是安卓原生代码里用于显现html代码的当地,内核为webkit,与谷歌浏览器的内核相同。支撑微信和QQ内置浏览器。

IOS:有必要为HTTPS协议

注:现在仅支撑ios11的safari浏览器

c、H5暂不支撑和老渠道3.6.4互通。

(2)H5_SDK供给音视频功用,假如需求运用该功用,请注意以下三点:

a、音视频功用需求在web环境下运用,需求将本项目布置在tomcat等web容器中才能够运用。

b、demo中装备的默许appid不支撑H5的音视频功用,如需运用请修正为自己的appid,并将appid提交给技术支撑申请。

阐明:
运用demo替换成自己的appid需求修正的当地,sig要自己从头核算,sig核算规矩:MD5(appid+userName+timestamp(yyyyMMddHHmmss)+apptoken); appid和apptoken是用户在咱们控制台创立的使用的,测验音视频的话,使用需求在控制台上线,而且供给appid给咱们装备,时刻戳不要写死,是每次获取登录的体系时刻,3rd的当地写客户端核算sig的地址就能够;假如本地核算sig进行测验,直接在demo中justdo.js中进行如下修正即可测验:

(1)._appid : '20150314000000110000000000000010', // 使用ID,换成自己的使用id;

(2)._appToken = '17E24E5AFDB6D0C1EF32F3533494502B';//运用是赋值为使用对应的appToken,换成自己的使用token。

(3).flag = true;//是否从第三方服务器获取sig,sig为大写。flag置为false,则需求本地核算sig。

2、恳求回谐和告诉回调

H5_SDK中和服务端的交互采纳异步回调办法,有两种异步回调办法,一种是恳求回调办法,一种是告诉回调办法,详细介绍如下:

(1)恳求回调办法:即由用户自动宣布一个操作恳求,恳求的成果在回调中回来。详细说便是在调用H5_SDK的办法时,H5_SDK的办法参数中有回调办法,恳求的成果直接在参数的回调办法中处理。例如发送音讯的办法,包括获悉音讯发送成功和发送失利的回调,此办法便是恳求回调办法。

(2)告诉回调办法:告诉回调是指由云通讯服务端自动给客户端发送的信令或事务音讯,如接纳音讯,便是由服务端告诉使用来收音讯,此办法便是告诉回调办法。

文档更新时刻:2018年1月10日