快速开始

大约 2 分钟

快速开始

利用 ChatroomUIKit,你可以轻松实现聊天室内的用户交互。本文介绍如何实现在聊天室中发送消息。

前提条件

  • Android Studio Arctic Fox (2020.3.1) 或以上版本;
  • Android API 级别 21 或以上;
  • 使用 Kotlin 语言开发,1.5.21 或以上版本;
  • JDK 1.8 或以上版本;
  • Gradle 7.0.0 或以上版本;
  • 已在环信即时通讯云控制台open in new window创建了有效的环信即时通讯 IM 开发者账号,并获取了 App Key
  • 如果你的网络环境部署了防火墙,请联系环信技术支持设置白名单。

创建项目引入 ChatroomUIKit 模块

  1. 在 Android Studio 中创建一个 Android 平台下的 App 或者打开自己现有项目。

  2. 选择 File > import Module

  3. 模块本地依赖。

找到下载的 ChatroomUIKit 模块添加为本地依赖。将 ChatroomUIKitopen in new windowChatroomServiceopen in new window 模块导入到项目中。

// settings.gradle
include ':ChatroomUIKit'
include ':ChatroomService'
project(':ChatroomUIKit').projectDir = new File('../ChatroomUIKit/ChatroomUIKit')
project(':ChatroomService').projectDir = new File('../ChatroomUIKit/ChatroomService')

// app/build.gradle
dependencies {
  implementation(project(mapOf("path" to ":ChatroomUIKit")))
}

第一步 初始化 ChatroomUIKit

你可以在应用加载时或使用 ChatroomUIKit 之前对其进行初始化。

初始化时,需传入 App Key。你可以在环信即时通讯云控制台open in new window应用详情页面查看 App Key。

// 初始化 ChatroomUIKit   
class ChatroomApplication : Application() {

  override fun onCreate() {
    super.onCreate()

    ChatroomUIKitClient.getInstance().setUp(this, "Your AppKey")

  }
}

第二步 登录 ChatroomUIKit

环信控制台open in new window 创建用户,获取用户 ID 和用户 token 登录 ChatroomUIKit。详见 创建用户文档

提示

若你已集成了 IM SDK,SDK 的所有用户 ID 均可用于登录 ChatroomUIKit。

在生产环境中,为了安全考虑,你需要在你的应用服务器集成 获取 App Token API获取用户 Token API 实现获取 Token 的业务逻辑,使你的用户从你的应用服务器获取 Token。

 ChatroomUIKitClient.getInstance().login("userId", "token")

第三步 创建聊天室视图

创建聊天室视图的步骤如下:

  1. 获取聊天室列表,加入指定的聊天室。除此之外,你还可以在环信即时通讯云控制台上创建聊天室,获取聊天室 ID。

  2. 加载聊天室视图 ComposeChatroom,传入的参数包括聊天室 ID 和聊天室所有者的用户 ID。

class ChatroomActivity : ComponentActivity(){
	override fun onCreate(savedInstanceState: Bundle?) {
		super.onCreate(savedInstanceState)
		setContent {
			ComposeChatroom(roomId = roomId,roomOwner = ownerInfo)
		}
	}
}
  1. 添加聊天室成员open in new window

第四步 发送消息

在屏幕下方输入消息内容,点击 发送 按钮,发送消息。

img