Tencent Cloud

Recent Pages

Android

最后更新时间：2024-06-24 17:05:38

本文会引导您集成 TUIKit 或 TUIChat 并成功发送第一条消息。
开发环境要求
Android Studio-Giraffe 
Gradle-7.2
Android Gradle Plugin Version-7.0.0
kotlin-gradle-plugin-1.5.31
创建应用
在集成 TUIKit 之前，您需要先去控制台创建一个新的 Chat 应用，步骤如下：
1. 注册控制台账号。
2. 进入 Application，点击 Create application，弹出 application 信息填写框。
3. 填写 Application name，选择 product 为 Chat，选择合适的 Region。
操作完成后，您会在 My Applications 列表中看到刚才创建的 application。
注意：
请记录下该 application 的 SDKAppID，后续步骤会使用到。另外，请严格保管好 SDKSecretKey，不要透露给无关人员。
操作步骤图示如下：
﻿
创建用户账号
创建 application 只能保证您可以正常初始化 SDK。如果要成功发消息，您还需要在 application 中创建用户账号。创建账号方式有很多，例如直接在控制台创建，或者通过 API 在客户端注册，您可以选择任意一种合适的方式。
注意：
发消息至少是两个用户之间进行，因此您在此环节至少要创建 2 个账号。请记录下这 2 个账号的 userID，后续步骤会使用到。
如果您想在控制台创建，步骤如下：
1. 单击进入您上面创建的 application，会在左侧边栏看到 Chat 产品入口，单击进入。
2. 进入 Chat 产品子页面后，点击 Users，进入用户管理页面。
3. 单击 Create account，弹出创建账号信息填写框。如果只是普通成员，我们建议您选择 General 类型。虽然 Nickname 不是必填项，我们依然建议您设置。如果界面上不方便展示 userID，您可以通过 Nickname 识别出不同用户。
图示如下：
﻿
如果你想通过客户端注册，不用额外操作，只需要在下文“登录 TUIKit” 中传入一个全新的 userID 即可，此时 TUIKit 会自动为您注册该 userID。
集成 TUIKit
聊天互动中发送消息的功能是由 TUIChat 实现的，您至少要集成 TUIChat才能正常收发消息，其他的组件，例如TUIConversation、TUIContact、TUIGroup 等，您可以按需集成。
如果您需要多个 UI 组件，可以集成 TUIKit，请参见文档：集成 TUIKit。
如果您只需要集成 TUIChat，请参见文档：仅集成聊天。
登录 TUIKit
使用 TUIKit 组件里的功能都需要登录，由 TUILogin 提供登录接口，如下：
// API location: TUICore/TUILogin.java
// Called when login is clicked on the user UI
TUILogin.login(context, sdkAppID, userID, userSig, new TUICallback() {
    @Override
    public void onSuccess() {
    }
    
    @Override
    public void onError(final int code, final String desc) {
    }
});
该接口要求输入 3 个参数：
sdkAppID，新创建应用的 SDKAppID，已在上文步骤中获取到。
userID，user1 的 userID，已在上文步骤中获取到，注意不是用户的 NickName。
userSig，user1 的 userSig，可使用控制台提供的开发工具实时生成，路径：主页 > Development Tools > UserSig Tools >  Signature (UserSig) Generator ，图示如下：
﻿
跳转聊天界面
为了实现发消息的目标，接下来要做的是：
1. 使用上述注册的账号之一（下文称之为 user1）登录 TUIKit，此时 user1 上线了。
2. user1 给另一个账号（下文称之为 user2）发消息，user2 可以不登录，跟 user1 可以没有任何好友关系。
说明：
此处讲解的是登录 user1 后给 user2 发消息。如果您希望 user1 和 user2 能聊天互动，需要使用同样的步骤登录 user2 并进入与 user1 的聊天界面。
您可以在 user1 登录成功的回调里跳转到聊天界面，就可以给 user2 发消息了。
示例代码如下，其中 chatID 需要传入聊天对象 user2 的 userID。
Intent intent = new Intent(context, TUIC2CChatMinimalistActivity.class);
intent.putExtra(TUIConstants.TUIChat.CHAT_ID, "chatID");
intent.putExtra(TUIConstants.TUIChat.CHAT_TYPE, V2TIMConversation.V2TIM_C2C);
intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
context.startActivity(intent);
发送第一条消息
操作完上述步骤，您可以跳转到如下的聊天界面。快点手动点击输入框，发送您的第一条消息吧：
﻿
联系我们
如果您对本文有疑问，欢迎加入Telegram 技术交流群，您将获得可靠的技术支持。