Android云通信IM系列1集成与配置

jiezi

5 年前

因为项目中用到了腾讯云通信，网上云通信 IM 的文章很少，所以我打算详细写一下，希望对大家有所帮助。

什么是云通信 IM

云通信 IM（Instant Messaging）承载亿级 QQ 用户即时通讯技术，数十年技术积累，腾讯云为您提供超乎寻常即时通讯聊天服务。针对开发者的不同阶段需求及不同场景，云通信 IM 提供了一系列解决方案，包括：Android/iOS/Windows/Web 的 SDK 组件、服务端集成接口、第三方回调接口等，利用这些组件，可以在应用中构建自己的即时通讯产品，解决开发者面临的高并发、高可用性的一系列问题。

首先我们要知道云通信 IM 登录流程，直接看下面图：

不难看懂，说的简单一点就是我们调后台接口去获取 Identifier 与 UserSig。
我们在测试阶段可以获取测试 userSig，这点在下面会讲到。

一. 配置

1. 创建应用
2. 配置应用 - 管理员
3. 获取 UserSig

完成账号管理员配置后，单击下载公私钥的链接，即可获得一个名为 keys.zip 的压缩包。解压后可以得到两个文件，即 public_key 和 private_key，用记事本打开 private_key 文件，并将其中的内容拷贝到开发辅助工具的私钥文本输入框中。其中：identifier 即为您的测试账号（也就是 userId），私钥为 private_key 文件里的文本内容，生成的签名就是 userSig。identifier 和 userSig 是一一对应的关系。
具体操作可以看下面网址：
https://cloud.tencent.com/doc…

Android-demo 下载地址：
https://github.com/tencentyun…

二. 集成 SDK

在项目中添加 IM SDK 的依赖

dependencies {api 'com.tencent.imsdk:imsdk: 版本号'}

版本号最好用当前最新的版本，我用的是 4.3.118

dependencies {api 'com.tencent.imsdk:imsdk:4.3.118'}

TUIKit 是基于腾讯云 IM SDK 的一款 UI 组件库，里面提供了一些通用的 UI 组件，开发者可通过该组件库选取自己所需要的组件快速的搭建一个 IM 应用。
IM 软件都具备一些通用的 UI 界面，如会话列表，聊天界面等。TUIKit 提供了这一类的组件，并提供了灵活的 UI 和交互扩展接口，方便用户做个性化开发。

TUkit 我们不一定要集成，只是说如何有需要的可以去集成
集成的方式：

直接依赖它的 aar 包
把 aar 源码文件拷贝到咱们项目中

我建议用第二种方式，因为 TUkit 视图实在是过于简洁，很大程度上我们都需要修改，而且功能上我们也要去修改，用 aar 包方式的话我们不能去更改文件。

如果有朋友对 aar 不了解，可以看我之前的文章：
https://mp.weixin.qq.com/s/_m…

1. 初始化

可以直接看官网址：
https://cloud.tencent.com/doc…
或者我们可以下载云通信 IM 的 demo，然后仿照它的初始化配置也可以的。

2. 登录

// identifier 为用户名，userSig 为用户登录凭证
TIMManager.getInstance().login(identifier, userSig, new TIMCallBack() {
    @Override
    public void onError(int code, String desc) {
        // 错误码 code 和错误描述 desc，可用于定位请求失败原因
        // 错误码 code 列表请参见错误码表
        Log.d(tag, "login failed. code:" + code + "errmsg:" + desc);
    }

    @Override
    public void onSuccess() {Log.d(tag, "login succ");
    }
});

先讲到这里，希望对大家有帮助，下节讲一下具体的功能！
想多了解的朋友可以加我的微信，交个朋友：lengquele5311

大家可以关注我的微信公众号：「秦子帅」一个有质量、有态度的公众号！

本文由博客一文多发平台 OpenWrite 发布！

Android云通信IM系列1集成与配置

前言

集成

一. 配置

二. 集成 SDK

TUIKit 集成

基本操作

1. 初始化

2. 登录