chat21-android-sdk

项目介绍：Chat21-Android-SDK

Chat21-Android-SDK 是一个开源的即时聊天软件开发工具包，构成了 Tiledesk.com 平台的基础。这个SDK主要用于在Android应用中集成实时聊天功能。下面将为您详细介绍其主要功能、示例、安装步骤以及常见问题解决方法。

功能特色

Chat21提供了一系列功能，帮助开发者构建强大的聊天应用：

• 一对一消息通信：用户可以相互发送直接消息。
• 表情支持：让交流更加生动活泼。
• 图片附件支持：用户可在聊天中发送图片。
• 创建群组聊天：支持多个用户加入同一聊天会话。
• 消息历史查看：用户可查阅过去的聊天记录。
• 群组列表查看：便于管理和浏览所参与的群组。
• 已读回执功能：显示消息已发送、已送达和已读状态。
• 会话列表视图：展示最近发送的消息，界面类似于WhatsApp。
• 用户状态管理：查看用户在线状态和不活跃时间。
• 用户资料查看：包括全名和邮箱信息的查看。
• 邮箱和密码登录：使用Firebase的邮箱和密码认证方法。
• 用户注册：全名、邮箱、密码和头像注册。
• 联系人列表查看：支持完整名称字段的全文搜索。

使用示例

截图展示

Chat21 Android Demo应用在Google Play上有现成的展示，可以通过此链接查看并下载。

示例应用代码

Demo应用的源代码可以通过GitHub获取。如果想自己动手构建聊天应用，Chat21提供了教程。

安装前提条件

在开始之前，您需要确保以下环境配置正确：

• 配置完好的Firebase项目。
• 安装了Chat21 Firebase云函数，具体细节见说明。
• 加入您的应用的google-services.json文件，官方说明请参见文档。

Firebase库配置

您需要在项目的/project/build.gradle中包含Google Services插件和Google的Maven仓库，然后在模块的/project/app/build.gradle中添加相关依赖。确保设置了正确的targetSdkVersion和multiDexEnabled为true。

Chat21库安装

要运行Chat21，需要最低SDK版本为API 19，targetSdkVersion至少为API 22。请在app的build.gradle文件中添加以下依赖：

dependencies {
    compile 'org.chat21.android:chat21:1.0.10'
    compile 'com.vanniktech:emoji-ios:0.5.1'
}

Chat21 SDK初始化

ChatManager配置

使用ChatManager.Configuration.Builder创建SDK配置并初始化Chat21：

ChatManager.Configuration mChatConfiguration = new ChatManager.Configuration.Builder("<APP_ID>")
        .firebaseUrl("<FIREBASE_DATABASE_URL>")
        .storageBucket("<STORAGE_BUCKET>")
        .build();
        
ChatManager.start(<CONTEXT>, mChatConfiguration, <LOGGED_USER>);

ChatUI的使用

ChatUI帮助您快速将常见UI元素与Chat21 SDK API连接，可以以活动或片段的方式启动聊天功能：

ChatUI.getInstance().setContext(this);
ChatUI.getInstance().showConversationsListActivity();

常见问题解决

• Android支持库冲突
• MultiDex配置

遇到这些问题时，可以参考项目中的build.gradle和Application类的配置方法进行调整。

通过本项目的说明和示例代码，您可以轻松地使用Chat21-Android-SDK构建强大的聊天应用。无论是基础功能还是进阶功能，Chat21都能够满足开发者的需求。您还可以通过Chat21的文档学习如何将您自己的库发布到JCenter。