高级功能指南

    使用说明

    开发环境下可直接使用,生产环境下需要先开通公有云专业版(仅按当月第 5 高日活对应档位计费),开通后可使用以下 5 大高级功能:

    • 服务端实时消息路由:将消息实时路由到您指定的服务器,可用于消息的业务操作等场景。
    • 单群聊消息云存储:提供单聊、群聊、讨论组消息的云端保存,客户端可以获取云端消息。
    • 在线状态订阅:将用户在线状态实时同步到您的应用服务器。
    • 广播消息和推送:通过后台或 Server API 发送广播消息和推送给应用内的用户。
    • 多设备消息同步:开启后可以支持 Web 端、PC 端和移动端之间的消息同步。且开通此功能后,可以同时支持多个 Web 端同时在线。

    开通方式

    应用状态为已上线:登录开发者平台,在“应用/IM 服务/高级功能设置”中开通公有云专业版。

    应用状态为未上线:登录开发者平台,在“应用/IM 服务/高级功能设置”中开通公有云专业版,或者在“应用资料”页中,申请上线时选择公有云专业版。

    功能介绍

    服务端实时消息路由

    使用场景

    服务端实时消息路由服务可用于以下场景:

    1. 存储聊天记录:可通过开启此服务,实时同步用户发送的消息至应用服务器,由应用服务器进行存储。
    2. 数据迁移:实现第三方通讯云服务到融云的平滑迁移,您的新客户端(集成融云 SDK)向老客户端(即集成原第三方 SDK)发送消息时,融云会通过消息路由服务调用原第三方的相应服务端接口,实现向指定老客户端(即集成原第三方 SDK)用户发送消息。详细请查看如何实现第三方通讯云服务到融云的平滑迁移

    功能说明

    将消息实时同步到您指定的服务器,目前支持二人会话、讨论组、群聊、聊天室、客服会话消息同步。

    以下情况,消息不会同步到应用服务器:

    • 开发者通过 Server API 发送的消息不会同步到应用服务器。
    • 消息中包含敏感词时,该条消息不会同步到应用服务器。

    环境说明

    • 开发环境,默认为关闭状态,开启后 2 个小时内生效。
    • 生产环境,需要您的应用在开发者后台申请上线并开通公有云专业版后才能开启。服务开启、关闭设置完成后 2 个小时内生效。点击查看详细计费标准

    开发指南

    请参见 Server API 服务端实时消息路由

    单群聊消息云存储

    使用场景

    如您的应用需要用户在不同设备(移动端、Web 端)登录后,仍然可以查看会话中以前发送的聊天消息时,可开启此服务通过接口获取历史消息来自行实现。

    功能说明

    开启后提供单聊、群聊、讨论组消息的云端保存服务,客户端可以获取云端历史消息,历史消息最多保存 6 个月(服务开启后开始存储)。

    环境说明

    • 开发环境,默认为关闭状态,开启后 2 个小时内生效。
    • 生产环境,需要您的应用在开发者后台申请上线并开通公有云专业版后才能开启。服务开启、关闭设置完成后 2 个小时内生效。点击查看详细计费标准

    开发指南

    如果您使用的是 IMKit SDK 进行集成,我们已经在 SDK 中实现了这部分功能,开启后在会话界面中即可拉取到历史聊天记录,如果您使用的是 IMLib SDK 请参考下面文档。

    Android 开发指南请参见读取远程服务器的消息

    iOS 开发指南请参见读取远程服务器的消息

    Web 开发指南请参见读取远程服务器的消息

    在线状态订阅

    使用场景

    如您的应用中需要在客户端显示用户状态时,可通过开启此服务,订阅用户在线状态到您的应用服务器后自行实现用户状态的显示。

    功能说明

    订阅后,融云服务器将用户在线状态(在线、离线、登出)同步给开发者的应用服务器(在线状态订阅地址)。

    状态说明

    • 在线状态表示应用已经连接融云服务器,即客户端调用 connect 方法连接成功。
    • 离线状态表示应用已经断开与融云服务器的连接,异常断网情况下离线状态会延迟 5 分钟同步。
    • 登出状态表示应用已经注销登录状态,即客户端调用 logoutdisconnect 方法注消登录,用户注销登录同时也会同步离线状态。

    环境说明

    • 开发环境,默认为关闭状态,开启后 2 个小时内生效。
    • 生产环境,需要您的应用在开发者后台申请上线并开通公有云专业版后才能开启。服务开启、关闭设置完成后 2 个小时内生效。点击查看详细计费标准

    开发指南

    请参见 Server API 在线状态订阅

    广播消息和推送

    使用场景

    使用广播推送服务,可以将应用的活动预告或是内容动态精准地推送给终端用户,用户及时获取到相关信息,从而有效提升用户活跃度。

    功能说明

    通过融云开发者后台或调用 Server API 发送广播消息和推送给应用内的用户,支持按全部或部分指定用户方式推送,广播推送服务每小时只能发送 1 次,每天最多发送 3 次。

    广播推送服务包括两个功能:一个是发送广播消息,一个是推送(Push)

    • 推送(Push) 是一种技术概念,是指从服务端实时发送信息到客户端。

      大家概念中的典型推送服务是类似 APNS(Apple Push Notification Service)GCM(Google Cloud Messaging) 等服务。在国内,由于谷歌服务不能使用,因此您的应用必须使用第三方或者自己研发的服务来推送。

      因为融云是使用长连接技术来实现 IM 服务的,和典型的 Push 服务具有相同的长连接机制,所以,很多开发者也会直接使用融云来实现推送功能。

      在某些场合,iOS 平台的推送(通过 APNS 的 Push)和远程通知(Remote Notification)表示相同的意思,可以互相替换使用。

    • 广播(Broadcast) 是一种业务概念,是通过后台管理界面或者调用服务端接口,向 App 中的所有用户发送一条消息。

    功能特性

    • 多种消息类型推送,支持消息类型自定义。
    • 标签设置,根据属性对用户设置标签分组,建立精准用户画像向用户推送精准消息。
    • 自定义推送消息处理逻辑,可根据添加自定义参数的键值,将键值传递到客户端,在客户端实现自己的业务逻辑。
    • 推送历史查询效果分析,无论是通过 Web 发送的还是通过 API 发送的都可以在推送历史记录中查询。

    开发环境

    • 开发环境,默认为开启状态,可直接使用。
    • 生产环境,需要您的应用在开发者后台申请上线并开通公有云专业版后才能开启。服务开启、关闭设置完成后 2 个小时内生效。点击查看详细计费标准

    多设备消息同步

    使用场景

    满足用户在使用多个设备的场景下,在其他设备登录后消息同步的需求。

    功能说明

    多设备消息同步功能开启后,可以支持 Web 端、PC 端和移动端之间的消息同步。且开通此功能后,可以同时支持多个 Web 端同时在线。

    补充说明:

    默认的情况下,融云仅支持 1 个 Web 端、1 个 PC 端、1 个移动端同时在线。

    环境说明

    • 开发环境,默认为关闭状态,开启后 2 个小时内生效。
    • 生产环境,需要您的应用在开发者后台申请上线并开通公有云专业版后才能开启。服务开启、关闭设置完成后 2 个小时内生效。点击查看详细计费标准