本文介绍 Android 端初始化 NERoom SDK 的操作步骤。

公共云

国内环境

如果您的 AppKey 对应的服务区域是中国国内，初始化 NERoom SDK 的示例代码如下：

String appKey = "your appKey";
NERoomKitOptions options = new NERoomKitOptions(appKey);

NERoomKit.getInstance().initialize(this, options, new NECallback2<Unit>() {
    @Override
    public void onSuccess(@Nullable Unit unit) {
        super.onSuccess(unit);
    }

    @Override
    public void onError(int code, @Nullable String message) {
        super.onError(code, message);
    }
});

海外环境

如果您的 AppKey 对应的服务区域是海外，初始化 NERoom SDK 的示例代码如下：

String appKey = "your appKey";
String roomServerUrl = "https://roomkit-sg.netease.im/";
HashMap<String, Object> extras = new HashMap<>();
NEServerConfig serverConfig = new NEServerConfig();
NEIMServerConfig imServerConfig = new NEIMServerConfig();
imServerConfig.setLink("link-sg.netease.im:7000");
imServerConfig.setLbs("https://lbs.netease.im/lbs/conf.jsp");
imServerConfig.setNosLbs("http://wannos.127.net/lbs");
imServerConfig.setNosDownloader("{bucket}-nosdn.netease.im/{object}");
imServerConfig.setNosUploader("https://nosup-hz1.127.net");
imServerConfig.setNosUploaderHost("nosup-hz1.127.net");
imServerConfig.setHttpsEnabled(true);
serverConfig.setImServerConfig(imServerConfig);
NERoomKitServerConfig roomKitServerConfig = new NERoomKitServerConfig();
roomKitServerConfig.setRoomServer(roomServerUrl);
serverConfig.setRoomKitServerConfig(roomKitServerConfig);
NERoomKitOptions options = new NERoomKitOptions(appKey, false, serverConfig, "", extras);
NERoomKit.getInstance()
    .initialize(
        this, options, new NECallback2<Unit>() {
            @Override
            public void onError(int code, @Nullable String message) {
                super.onError(code, message);
            }

            @Override
            public void onSuccess(@Nullable Unit data) {
                super.onSuccess(data);
            }
        });

私有化

方式1：通过 serverUrl 设置（推荐）

调用 initialize 方法初始化 NERoom 时，配置 NERoomKitOptions 的 serverUrl 参数为私有化服务器地址。

示例代码如下:

String appKey = "your appKey";
HashMap<String, Object> extras = new HashMap<>();
NERoomKitOptions options = new NERoomKitOptions(appKey, false, null, serverUrl, extras);
NERoomKit.getInstance()
                .initialize(
                        this, options, new NECallback2<Unit>() {
                            @Override
                            public void onError(int code, @Nullable String message) {
                                super.onError(code, message);
                            }

                            @Override
                            public void onSuccess(@Nullable Unit data) {
                                super.onSuccess(data);
                            }
                        });

方式2：通过配置文件设置

私有云服务器部署完成后，网易云信会提供给您对应的 NERoom 私有化配置文件（JSON 类型）。您在初始化 NERoom SDK 时，需要进行相关的配置，以便 SDK 能接入到目标私有云服务器上。

具体配置步骤如下：

1. 将配置文件重命名为 xkit_server.config，并在构建项目前将配置文件添加到工程中 app 模块的 assets 目录下。

   

2. 调用 initialze 方法初始化 NERoom SDK 时，在 xkit_server.config 配置文件中，将 NERoomKitOptions 的第二个参数 useAssetServerConfig 设置为 true。

   示例代码如下:

   String appKey = "your appKey";
   HashMap<String, Object> extras = new HashMap<>();
   NERoomKitOptions options = new NERoomKitOptions(appKey, true, null, "", extras);
   NERoomKit.getInstance()
                   .initialize(
                           this, options, new NECallback2<Unit>() {
                               @Override
                               public void onError(int code, @Nullable String message) {
                                   super.onError(code, message);
                               }
   
                               @Override
                               public void onSuccess(@Nullable Unit data) {
                                   super.onSuccess(data);
                               }
                           });