开发前准备工作

一、准备工作

                

1、集成流程

                
(1)注册成为云通讯平台用户。
                
(2)登陆云通讯平台,进入管理控制台,创建自己的应用。
                
(3)下载云通讯SDK,根据开发手册进行编码实现。
                                 

2、前期准备

                
(1)注册成为云通讯的用户
                
(2)登陆云通讯平台,进入管理控制台,创建自己的应用。在创建IM类应用的时候,只需填写应用名称,不必选择"启用应用回调地址"、"启用IVR"、"启用TTS"、"服务器白名单"等选项。
                
                
(3)应用创建成功后,在"应用列表"里面可以看见自己刚刚创建的应用,可以对该应用进行编辑和删除操作。
                
注意:
开通IM相关功能,应用需要上线,才可以进行测试。点击“上线”,显示运营中就是上线状态。如果是第一次操作,会先提示提交认证信息,认证通过后才能上线。
   
                          

3、核心概念                

1)生产环境:对应的接入域名为:https://imapp.yuntongxun.com:8883                
2)开发者主账号:每个开发者在云通讯平台对应一个主账号               
    a)ACCOUNT SID:主账号id。                
    b)AUTH TOKEN:主账号验证token。                
3)AppID:应用标识,每个创建的应用都对应唯一的id标识。                
4)子账号:每个App用户在云通讯对应一个子账号,包括账号id和验证token,用于安全性验证。                
5)通讯账号:通讯账号主要用于云通讯平台的语音通讯能力,每个子账号都对应一个通讯账号,由系统自动生成。
                
说明:                
  • 每一个注册开发者对应一个主账号。                
  • 每一个主账号下可以创建多个应用。                                 
  • 每一个应用下面可以创建亿级子账号。               
  • 每一个子账号对应一个通讯账号。
                

二、使用介绍

                

1、云通讯IM 账号体系                

云通讯支持两种账号体系。                
(1)固定子账号体系(即通讯账号+通讯密码登录方式):开发者需要自己调用创建子账号接口 ,为app的用户创建对应的云通讯通讯账号,并将通讯账号和用户id进行绑定,通讯密码和用户密码进行绑定,登录 的时候必须用云通讯通讯账号和通讯密码登录。               
说明:固定子账号体系在IM5.0以后的版本中都支持如果要在demo中测试加密码登录方式,需要先在官网控制台创建自己的应 用,然后将demo默认的应id和token替换成自己创建的应用的,登录的通讯账号和密码,需要是该应用下创建的通讯账号和密码。              
Android中替换应用id和token的地方是ECPreferenceSettings类和RestServerDefines类,ios 是在AppConfig.plist文件(5.4.0及之后版本是在ECAppKey.h)中修改,demo中的appkey就是用户在控制台创建的应用的appid
                
(2)任意子账号体系(即自定义登录方式):用户不必自己在云通讯后台为用户创建云通讯子账号,可以直接使用用户自己开发的App中的账号进行登录,该登录方式我们不验证密码。用户在集成的过程中,可以自己实现对自己登录账号密码的验证。                
说明:任意子账号体系在IM5.0以后的版本中支持,登录的用户名,不能包含中文,特殊符号,不能以g开头,建议在5-20位之间。

2、应用ID和应用Token的获取

应用ID:登陆官网查看控制台→应用管理→应用列表→APP ID。
应用Token:登陆官网查看控制台→应用管理→应用列表→APP TOKEN。
如图所示:
                                

3、登录流程

                
对应账号体系,登录云通讯也有两种验证方式:
账号和密码验证方式:在登录的时候,输入云通讯的通讯账号和对应的通讯密码即可登录。
                
使用此种登陆方式,在app用户注册的时候,需要同时向云通讯后台注册,如图所示:
                
                
使用此种登陆方式,登陆流程如图所示:
                
                
账号和appId,appToken验证方式:此种方式登陆无需使用云通讯子账号,直接使用app的自有账号登陆即可,appID和appToken可以在官网的"控制台"相关应用的描述页面得到,此种方式的登陆流程如图所示:
                
                

4、业务指南

                

4.1、单聊

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

4.2、群组

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

4.3、群组操作

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

4.4、离线消息

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

4.5、设备推送

                
用户不在线时,有人给其发送消息,服务端会给用户设置发送推送通知。用户可以选择查看通知唤起应用,此时消息会被获取到。也可以选择忽略,此时消息变成离线消息。
注意:为了使在推送通知里面显示的是用户昵称而不是用户的账号ID,用户需要调用设置个人信息接口来设置用户的昵称。
                
Ios支持离线推送,离线推送是通过苹果的apns推送实现的,需要自己上传推送证书,请参考“iOS推送证书”文档,Android没有离线推送一说,当前最新版本支持在调用登出接口后,通过广播实现消息通知。
                

4.6、自定义消息

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

5、体系架构           

5.1、技术特点                

容联IM通讯云服务,聚焦于"场景·连接"服务,帮助开发构建更完整的产品体验。                
容联IM通讯云的主要技术特点有:                
  • 无需更改App原有框架和App Server架构,集成sdk接口即可实现IM通讯能力。                
  • 采取无DNS设计,实现快速登录体验。                
  • 自适应网络和最小心跳包相结合的心跳技术,消耗更少电量。                
  • 采取特有的二进制协议和包体精简、包体压缩、智能多包合并策略实现最小流量包和最快的收发速度。               
  • 参考微信、陌陌的系统设计方案,采取真正的push-pull系统架构,保证不丢消息、有序到达以及弱网络环境下的消息接收。
                

5.2、第三方和容联IM交互示意图

                
                
如图:
                
蓝色应用为开发者开发的App和开发者的后台服务器,后台服务器实现开发者自己的业务逻辑和保存自己的私有数据。绿色为 容联IM通讯云,红色为容联IM的sdk。
                
蓝色空心箭头为开发者app和自己的后台服务器进行信令及业务交互,蓝色箭头为开发者App,黄色箭头表示App server通过RESTFUL API接口的方式调用容联云的服务,如获取历史消息,广播消息等。
                

5.3、SDK 体系结构

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