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

融云SDK支持消息发送时附加自定义数据吗？

随着移动互联网的快速发展，即时通讯已经成为人们日常沟通的重要方式。融云作为国内领先的即时通讯云服务商，其提供的融云SDK在消息发送方面提供了丰富的功能，满足了开发者对于即时通讯的多样化需求。那么，融云SDK支持消息发送时附加自定义数据吗？本文将对此进行详细解答。

一、融云SDK简介

融云SDK是融云公司推出的一款面向开发者的即时通讯开发工具，它支持Android、iOS、Web等多个平台，能够帮助开发者快速实现即时通讯功能。融云SDK提供了丰富的API接口，包括消息发送、消息接收、用户管理、聊天室等，同时还支持语音、视频、图片等多种富媒体消息传输。

二、自定义数据的概念

在即时通讯场景中，自定义数据是指开发者可以在消息发送时，根据实际需求附加一些额外的数据。这些数据可以包括用户信息、业务数据、设备信息等，以便在消息接收端进行相应的处理。自定义数据在即时通讯应用中具有重要作用，可以提高消息的实用性、扩展性和灵活性。

三、融云SDK支持消息发送时附加自定义数据

消息类型支持

融云SDK支持多种消息类型，包括文本消息、图片消息、语音消息、视频消息等。在这些消息类型中，开发者都可以在消息体中附加自定义数据。

消息体格式

融云SDK使用JSON格式作为消息体的数据格式，开发者可以在消息体中定义自定义数据。以下是一个示例：

{

  "msg": "你好，自定义数据示例",

  "type": "text",

  "ext": {

    "user_id": "123456",

    "business_data": "example_data",

    "device_info": {

      "os": "Android",

      "model": "Xiaomi",

      "version": "8.1"

    }

  }

}

在上面的示例中，"ext"字段用于存放自定义数据，其中包含了用户信息、业务数据和设备信息。

消息发送

在融云SDK中，开发者可以通过调用消息发送API来发送带有自定义数据的消息。以下是一个示例：

RCMessage message = RCMessageBuilder.createTextMessage("msg");

message.setConversationType(RCConversationType.CHAT);

message.setTargetId("target_id");

message.add.ext("user_id", "123456");

message.add.ext("business_data", "example_data");

message.add.ext("device_info", new JSONObject("{\"os\":\"Android\",\"model\":\"Xiaomi\",\"version\":\"8.1\"}"));



RCIMClient.getInstance().getRCMessageManager().sendMessage(message, new RCIMClient.Callback() {

    @Override

    public void onSuccess(Object object) {

        // 发送成功

    }



    @Override

    public void onError(int errorCode, String errorMessage) {

        // 发送失败

    }

});

在上述代码中，我们通过add.ext方法为消息体添加了自定义数据。在消息发送成功后，接收端可以通过解析消息体中的自定义数据来进行相应的处理。

四、总结

融云SDK支持消息发送时附加自定义数据，这为开发者提供了更大的灵活性。通过自定义数据，开发者可以丰富消息内容，提高消息的实用性。在实际应用中，开发者可以根据自己的需求，在消息发送时添加相应的自定义数据，以满足多样化的业务场景。