一:准备工作

1、集成流程

(1)注册成为云通讯平台用户。

(2)登陆云通讯平台,进入管理控制台,创建自己的应用。

(3)下载云通讯Android SDK,根据开发指南进行编码实现。

2、前期准备

(1)注册成为云通讯的用户

(2)登陆云通讯平台,进入管理控制台,创建自己的应用。在创建IM类应用的时候,只需填写应用名称,不必选择"启用应用回调地址"、"启用IVR"、"启用TTS"、"服务器白名单"等选项。

(3)应用创建成功后,在"应用列表"里面可以看见自己刚刚创建的应用,可以对该应用进行编辑和删除操作。当该应用集成完云通讯IM能力后准备正式对外发布时,需要点击"上线"。

注意:使用5.0以上的SDK集成客户端,测试音视频、音视频会议、群组等需要先将在我们控制台对应的应用上线,才可以进行测试。

3、核心概念

(1)生产环境:对应的接入域名为:https://app.cloopen.com:8883

(2)开发者主账号:每个开发者在云通讯平台对应一个主账号

(a)ACCOUNT SID:主账号id。

(b)AUTH TOKEN:主账号验证token。

(3)AppID:应用标识,每个创建的应用都对应唯一的id标识。

(4)子账号:每个App用户在云通讯对应一个子账号,包括账号id和验证token,用于安全性验证。

(5)通讯账号:通讯账号主要用于云通讯平台的语音通讯能力,每个子账号都对应一个通讯账号,由系统自动生成。

说明:

每一个注册开发者对应一个主账号。

每一个主账号下可以创建多个应用。

每一个应用下面可以创建亿级子账号。

每一个子账号对应一个通讯账号。

二:使用介绍

1、云通讯IM 账号体系

为了方便开发者进行开发和兼容IM4.0以前版本,云通讯支持两种账号体系。

(1)固定子账号体系(即通讯账号+通讯密码登录方式):开发者需要自己调用创建子账号接口 ,为app的用户创建对应的云通讯通讯账号,并将通讯账号和用户id进行绑定,通讯密码和用户密码进行绑定,登录 的时候必须用云通讯通讯账号和通讯密码登录。

说明:固定子账号体系在所有IM版本中都支持,需要注意的是4.0之前的版本登录需要使用子账号,子账号密码,通讯账号,通讯密码进行登 录,5.0的固定子账号体系,直接用通讯账号和通讯密码就可以。如果要在demo中测试加密码登录方式,需要先在官网控制台创建自己的应 用,然后将demo默认的应id和token替换成自己创建的应用的,登录的通讯账号和密码,需要是该应用下创建的通讯账号和密码。

Android中替换应用id和token的地方是ECPreferenceSettings类,ios 是在AppConfig.plst文件中修改,demo中的appkey就是用户在控制台创建的应用的appid。

(2)任意子账号体系(即自定义登录方式):用户不必自己在云通讯后台为用户创建云通讯子账号,可以直接使用用户自己开发的App中的账号进行登录,该登录方式我们不验证密码。用户在集成的过程中,可以自己实现对自己登录账号密码的验证。

说明:任意子账号体系在IM5.0以后的版本中支持,登录的用户名,不能包含中文,特殊符号,不能以g或者gg开头,建议在5-20位之间。

2、登录流程

对应账号体系,登录云通讯也有两种验证方式:


✾ 账号和密码验证方式:在登录的时候,输入云通讯的通讯账号和对应的通讯密码即可登录。

使用此种登陆方式,在app用户注册的时候,需要同时向云通讯后台注册,如图所示:

使用此种登陆方式,登陆流程如图所示:


✾ 账号和appId,appToken验证方式:此种方式登陆无需使用云通讯子账号,直接使用app的自有账号登陆即可,appID和appToken可以在官网的"控制台"相关应用的描述页面得到,此种方式的登陆流程如图所示:

3、业务指南

3.1、业务指南

两个用户一对一进行聊天,支持文本、表情、语音、图片、附件5种消息格式。支持已发送(指消息已经发送到服务端)回执。

3.2、群组

两个以上用户一起聊天。支持文本、表情、语音、图片、附件5种消息格式。同样也支持已发送回执。

3.3、群组操作

支持创建群组、主动加入群组、邀请加入群组、成员主动退出群组、群主解散群组、群主踢人、设置消息免打扰操作。
群组又分为私有群组和公开群组。私有群组是指主动加入时必须经管理员同意才能加入的群组,公开群组是指主动加入时无需经管理员同意就能加入的群组。

3.4、离线消息

指用户不在线时候,有人给其发送消息,此时消息存储在服务端,当用户再上线时,从服务端获取这些之前未收到的消息。

3.5、设备推送

用户不在线时,有人给其发送消息,服务端会给用户设置发送推送通知。用户可以选择查看通知唤起应用,此时消息会被获取到。也可以选择忽略,此时消息变成离线消息。
注意:为了使在推送通知里面显示的是用户昵称而不是用户的账号ID,用户需要调用设置个人信息接口来设置用户的昵称。

Ios支持离线推送,离线推送是通过苹果的apns推送实现的,需要自己上传推送证书,请参考“iOS推送证书”文档,Android没有离线推送一说,当前最新版本支持在调用登出接口后,通过广播实现消息通知。

3.6、自定义消息

可以通过自定义消息发送指令来实现一些扩展功能。如消息已经送达,消息已读,位置分享、阅后即焚……。

4、体系架构

4.1技术特点

容联IM通讯云服务,聚焦于"场景·连接"服务,帮助开发构建更完整的产品体验。

容联IM通讯云的主要技术特点有:

1、无需更改App原有框架和App Server架构,集成sdk接口即可实现IM通讯能力。

2、采取无DNS设计,实现快速登录体验。

3、自适应网络和最小心跳包相结合的心跳技术,消耗更少电量。

4、采取特有的二进制协议和包体精简、包体压缩、智能多包合并策略实现最小流量包和最快的收发速度。

5、参考微信、陌陌的系统设计方案,采取真正的push-pull系统架构,保证不丢消息、有序到达以及弱网络环境下的消息接收。

4.2第三方应用和云通讯IM云交互示意图:

如图:

蓝色应用为开发者开发的App和开发者的后台服务器,后台服务器实现开发者自己的业务逻辑和保存自己的私有数据。绿色为容联IM通讯云,红色为容联IM的sdk。

蓝色空心箭头为开发者app和自己的后台服务器进行信令及业务交互,蓝色箭头为开发者App,黄色箭头表示App server通过RESTFUL API接口的方式调用容联云的服务,如获取历史消息,广播消息等。

4.3 SDK 体系结构:

如图:

容联IM SDK是一个能力库,提供各种IM相关的接口,包括Yuntx_IMLib 和LibCore两部分。Yuntx_IMLib采取Native语言开发,封装各种消息结构和能力结构。LibCore是核心IM SDK的核心协议栈,主要处理特有的二进制协议和传输层协议,采取c语言开发。iOS和Android采取同一套LibCore,保证消息处理的一致性。


1、Android 类结构:

ECDevice 是IM sdk的核心类,包括:

(1)方法集:主要有登陆方法,登出方法,设置个人信息方法,获取个人信息方法,以及获取群组管理和IM聊天管理接口

(2)ECChatManager包含IM聊天相关接口以及回调接口的定义

(3)ECGroupManager包含群组管理接口以及回调接口的定义

(4)ECVoIPCallManager包含音视频通讯接口以及相应的回调接口的定义

(5)ECMeetingManager包含实时对讲接口,语音会议接口,视频会议接口以及相应的回调接口的定义


2、iOS 类结构:

ECDevice 是IM sdk的核心类,包括:

(1)方法集:主要有登陆方法,登出方法,设置个人信息方法,获取个人信息方法。

(2)MessageManager实例:包括GroupManager,处理群组的相关功能,ChatManager处理聊天的相关消息

(3)ECVoIPCallManager实例:包含音视频通讯接口以及相应的回调接口的定义

(4)ECMeetingManager实例:包含实时对讲接口,语音会议接口,视频会议接口以及相应的回调接口的定义

(5)Delegate:通知回调接口集:包括ECChatDelegate通知回调接口集,ECBaseDelegate登录、登出回调接口集,ECGroupDelegate群组管理通知回调接口集,ECVoIPCallDelegate音视频功能通知回调接口集,ECMeetingDelegate音视频会议功能回调接口集。


3、消息类结构:

ECMessage是消息基类,ECMessageBody是抽象的消息内容类,包括:

(1)ECTextMessageBody:文本消息内容类。

(2)ECFileMessageBody:附件消息内容类,同事时也是多媒体消息内容基类,分别是:

1.ECVoiceMessageBody:语音消息内容类。

2.ECVideoMessageBody:视频消息内容类。

3.ECImageMessageBody:图片消息内容类。