融云海外数据中心配置操作指南

我的应用大部分客户都在海外,故需要连接海外数据中心,都需要配置哪些参数?
发布时间: 2020-07-30 11:46

回答:

融云海外数据中心

流程

  1. 创建海外数据中心 AppKey

  2. 客户的 App Server 调用地址替换融云海外数据中心 Server API 地址

  3. SDK 设置海外数据中心的导航服务器(navServer)地址及媒体服务器地址

服务端 API

将 App Server 调用的融云 Server API 地址改为海外数据中心 API 地址,融云海外数据中心:api-sg01.ronghub.com

客户端 SDK 接入

融云 SDK(Android、iOS)默认配置连接的是中国数据中心,海外数据中心,需要修改 SDK 导航域名和文件服务器地址:

Android 平台

在 SDK 初始化 init 之前,请先调用 setServerInfo(final String naviServer, final String fileServer) 方法设置数据中心的导航域名和文件服务器地址:

方法说明如下:

/**
* 设置 海外 数据中心的导航服务器和媒体服务器地址。
* 此方法要在 {@link #init(Context, String)} 前使用
*
* @param naviServer 海外 数据中心的导航服务器地址。
* @param fileServer 海外 数据中心的媒体服务器地址,即文件和图片的上传地址。使用独立数据中心时必须填写。
*/
public static void setServerInfo(final String naviServer, final String fileServer) {
    if (TextUtils.isEmpty(naviServer)) {
        RLog.e(TAG, "setServerInfo naviServer should not be null.");
        throw new IllegalArgumentException("naviServer should not be null.");
        }
        RongIMClient.setServerInfo(fileServer, fileServer);
}
  • naviServer 参数如下:

    • 海外数据中心:navsg01.cn.ronghub.com

  • fileServer 参数如下:

    • 海外数据中心:upload.qiniup.com

iOS 平台

在 SDK 初始化 init 之前,请先调用 setServerInfo(final String naviServer, final String fileServer) 方法设置数据中心的导航域名和文件服务器地址:

/*!
设置 海外 数据中心导航服务器和上传文件服务器信息
@param naviServer    海外 数据中心导航服务器地址,具体的格式参考下面的说明
@param fileServer    海外 数据中心文件服务器地址,具体的格式参考下面的说明
@return               是否设置成功
@warning 仅限 海外 数据中心使用,使用前必须先联系商务开通。必须在SDK init之前进行设置。
@discussion
naviServer必须为有效的服务器地址,fileServer如果想使用默认的,可以传nil。
naviServer和fileServer的格式说明:
1、如果使用https,则设置为https://cn.xxx.com:port或https://cn.xxx.com格式,其中域名部分也可以是IP,如果不指定端口,将默认使用443端口。
2、如果使用http,则设置为cn.xxx.com:port或cn.xxx.com格式,其中域名部分也可以是IP,如果不指定端口,将默认使用80端口。
*/
-(BOOL)setServerInfo:(NSString *)naviServer fileServer:(NSString *)fileServer;
  • naviServer 参数如下:

    • 海外数据中心:navsg01.cn.ronghub.com

  • fileServer 参数如下:

    • 海外数据中心:upload.qiniup.com

Web 端

在初始化时设置 navi 地址,例如 SDK 中的 navi 地址为: nav.cn.ronghub.com,初始化代码如下:

var appkey = 'kj29chm026yyn'
RongIMLib.RongIMClient.init(appkey, null, {
    navi: 'https://nav.cn.ronghub.com'
});

将 nav.cn.ronghub.com 替换为对应的海外数据中心的 navi 地址。

  • navi 如下:

    • 海外数据中心:navsg01.cn.ronghub.com