私有云 SDK IP 地址/域名配置

大约 2 分钟

私有云 SDK IP 地址/域名配置

使用私有云部署配置前,请引入 EMOptions+PrivateDeploy.h。以下配置均只能在调用 initializeSDKWithOptions: 时设置,运行期间不能动态修改。

静态配置 IP 地址/域名

SDK 默认指向公有云地址,在部署私有云后,需要将地址重新指向到新的地址,以下是地址修改方法:

方式一:TCP 连接

EMOptions *options = [EMOptions optionsWithAppkey:appkey];
options.enableDnsConfig = NO;
options.chatPort = 8080;//设置端口号
options.chatServer = @"xxx.xxx.xxx.xxx";//设置 IP 地址
options.restServer = @"xxx.xxx.xxx.xxx:8080";//设置ip:port
options.enableTLSConnection = YES;// 是否使用加密连接。TCP 连接为 TLS 加密
[[EMClient sharedClient] initializeSDKWithOptions:options];

方式二:WebSocket 连接

EMOptions* options = [EMOptions optionsWithAppkey:@"Your appkey"];
options.enableDnsConfig = NO;
options.restServer = @"https://restaddress";
options.webSocketServer = @"im-api-wechat.easemob.com";
options.webSocketPort = 443;
options.enableTLSConnection = YES;// 是否使用加密连接。webSocket 为 WSS 协议。
[[EMClient sharedClient] initializeSDKWithOptions:options];

提示

如需只使用 HTTPS,请在调用 initializeSDKWithOptions: 前设置该属性。

options.usingHttpsOnly = YES;

动态配置地址

  1. 服务器端配置 DNS 地址表。
  2. 设置服务器端配置的 URL 地址。
options.enableDnsConfig = YES;
options.dnsURL = @"xxxx";//设置服务器端配置的 URL 地址
[[EMClient sharedClient] initializeSDKWithOptions:options];

接口列表

API 名称所属模块/类型说明
optionsWithAppkeyEMOptions创建 SDK 配置对象。
enableDnsConfigEMOptions (PrivateDeploy)控制是否使用 DNS 配置;设为 NO 时使用静态服务器地址。
chatServerEMOptions (PrivateDeploy)设置 TCP Chat 服务器地址。
chatPortEMOptions (PrivateDeploy)设置 TCP Chat 服务器端口。
restServerEMOptions (PrivateDeploy)设置 REST 服务器地址。
webSocketServerEMOptions (PrivateDeploy)设置 WebSocket 服务器地址。
webSocketPortEMOptions (PrivateDeploy)设置 WebSocket 服务器端口。
enableTLSConnectionEMOptions (PrivateDeploy)为 Chat 或 WebSocket 连接启用 TLS。
usingHttpsOnlyEMOptions仅使用 HTTPS 协议。
dnsURLEMOptions (PrivateDeploy)设置服务器端 DNS 地址表的 URL。
initializeSDKWithOptionsEMClient使用上述配置初始化 SDK。
上次编辑于: