网站首页 > 厂商资讯 > 环信 >

环信即时通讯接入的SDK如何配置？

随着互联网技术的飞速发展，即时通讯已经成为人们日常沟通的重要方式。环信即时通讯云服务，作为一款功能强大、性能稳定的即时通讯解决方案，为广大开发者提供了便捷的接入方式。本文将详细讲解环信即时通讯接入的SDK如何配置。

一、准备工作

注册环信开发者账号

首先，您需要在环信官网（https://www.rongcloud.cn/）注册一个开发者账号。注册成功后，您将获得一个App Key，这是您接入环信即时通讯云服务的重要凭证。

创建应用

登录环信官网，进入开发者中心，点击“创建应用”，填写相关信息，包括应用名称、应用描述等。创建成功后，您将获得一个App ID，用于后续SDK配置。

二、SDK下载与集成

下载SDK

登录环信官网，进入开发者中心，找到您的应用，在“SDK下载”页面下载对应的SDK。目前，环信支持Android、iOS、Web、Windows等多个平台。

集成SDK

以下以Android平台为例，讲解SDK的集成过程。

（1）解压下载的SDK包，将“lib”目录下的jar包添加到项目的libs目录。

（2）在AndroidManifest.xml文件中添加以下权限：

（3）在项目的build.gradle文件中添加以下依赖：

dependencies {

    implementation 'cn.rongcloud:imkit:4.3.1'

    implementation 'cn.rongcloud:imkit-uikit:4.3.1'

}

（4）初始化环信SDK

在Activity的onCreate方法中，调用以下代码初始化环信SDK：

RongIM.init(this, "你的App Key");

三、配置环信SDK

配置环信云服务器

登录环信官网，进入开发者中心，找到您的应用，在“配置”页面，设置以下信息：

（1）主域名：用于接收环信云服务器的请求。

（2）子域名：用于发送消息、上传图片、语音等。

（3）消息推送：配置消息推送的证书和别名。

配置环信IMKit

在项目的AndroidManifest.xml文件中，添加以下配置：


    android:name="RONG_CLOUD_APP_KEY"

    android:value="你的App Key" />


    android:name="RONG_CLOUD_APP_ID"

    android:value="你的App ID" />


    android:name="RONG_CLOUD_SERVER"

    android:value="你的主域名" />


    android:name="RONG_CLOUD_SUB_DOMAIN"

    android:value="你的子域名" />


    android:name="RONG_CLOUD_MESSAGE_PUSH_APP_ID"

    android:value="你的消息推送App ID" />


    android:name="RONG_CLOUD_MESSAGE_PUSH_APP_KEY"

    android:value="你的消息推送App Key" />


    android:name="RONG_CLOUD_MESSAGE_PUSH_ALIAS"

    android:value="你的消息推送别名" />

四、登录与注册

调用环信SDK提供的登录接口，传入用户名和密码：

RongIM.connect(username, new RongIMClient.ConnectCallback() {

    @Override

    public void onTokenIncorrect() {

        // token错误

    }



    @Override

    public void onSuccess(String userId) {

        // 登录成功

    }



    @Override

    public void onError(RongIMClient.ErrorCode errorCode) {

        // 登录失败

    }

});

调用环信SDK提供的注册接口，传入用户名、密码和昵称：

RongIM.register(username, password, nickname, new RongIMClient.RegisterCallback() {

    @Override

    public void onSuccess(String userId) {

        // 注册成功

    }



    @Override

    public void onError(RongIMClient.ErrorCode errorCode) {

        // 注册失败

    }

});

五、发送消息

发送文本消息

RongIM.getInstance().sendMessage(

    TextMessage.obtain(userId, targetId, content),

    new RongIMClient.SendCallback() {

        @Override

        public void onMessageSent(Message message, int i) {

            // 消息发送成功

        }



        @Override

        public void onError(Message message, RongIMClient.ErrorCode errorCode) {

            // 消息发送失败

        }

    }

);

发送图片消息

RongIM.getInstance().sendMessage(

    ImageMessage.obtain(userId, targetId, imageUri),

    new RongIMClient.SendCallback() {

        @Override

        public void onMessageSent(Message message, int i) {

            // 消息发送成功

        }



        @Override

        public void onError(Message message, RongIMClient.ErrorCode errorCode) {

            // 消息发送失败

        }

    }

);

发送语音消息

RongIM.getInstance().sendMessage(

    VoiceMessage.obtain(userId, targetId, voiceUri),

    new RongIMClient.SendCallback() {

        @Override

        public void onMessageSent(Message message, int i) {

            // 消息发送成功

        }



        @Override

        public void onError(Message message, RongIMClient.ErrorCode errorCode) {

            // 消息发送失败

        }

    }

);

发送视频消息

RongIM.getInstance().sendMessage(

    VideoMessage.obtain(userId, targetId, videoUri),

    new RongIMClient.SendCallback() {

        @Override

        public void onMessageSent(Message message, int i) {

            // 消息发送成功

        }



        @Override

        public void onError(Message message, RongIMClient.ErrorCode errorCode) {

            // 消息发送失败

        }

    }

);

六、总结

通过以上步骤，您已经成功配置了环信即时通讯接入的SDK。在实际开发过程中，您可以根据需求，调用环信SDK提供的各种功能，实现即时通讯、消息推送、音视频通话等功能。希望本文对您有所帮助。