设置服务器地址

功能说明

小鱼易连服务可在多种环境中部署，如混合云、分区云、公有云等。开发者可以根据不同的服务环境配置对应的服务器地址。在 Web SDK 中，您可以通过初始配置或动态设置的方式，灵活切换服务器、日志地址，以便适应多种业务场景并进行音视频呼叫。

实现方法

初始设置服务器地址

在调用 XYRTC.createClient 方法创建XYRTCClient实例时，可通过server参数指定服务器地址。

参数规则：

• 正常模式：域名/IP:{port}，举例：cloudapi.xylink.com:443
• 反向代理模式：域名/IP:{port}/{proxy_url}，举例：cloud.xylink.com:443/xy_cloudapi
• 版本无需添加协议头，例如http://或https://
• 公有云环境默认地址：cloudapi.xylink.com:443
• 分区云环境地址是WebRTC网关的域名/IP和端口

版本兼容：

• v2和v3版本需要配置协议头，配置格式：协议://域名/IP:{port}
• v2和v3版本支持在初始化时分别配置：wssServer｜httpServer｜logServer地址，v4+版本请在动态设置方式中配置

// 导入主文件
import XYRTC from '@xylink/xy-rtc-sdk';

const XYClient = XYRTC.createClient({
  // 公有云环境下默认可不填写
  server: 'cloudapi.xylink.com:443',
  
  // 其他配置
  ...
});

// 后续通过 XYClient 实例执行登录、呼叫等操作

动态设置服务器地址

在某些业务场景中，可能需要在XYRTCClient实例创建后切换服务器地址。小鱼易连 Web SDK 支持通过 setServerAddress 方法动态调整以下地址，无需重新初始化应用：

• HTTP 服务器地址（可选）：httpServer
• WebSocket 地址（可选）：wssServer
• 日志服务器地址（可选）：logServer

参数规则：

• 正常模式：域名/IP:{port}，举例：cloudapi.xylink.com:443
• 反向代理模式：域名/IP:{port}/{proxy_url}，举例：cloud.xylink.com:443/xy_cloudapi
• 无需添加协议头，例如http://或https://
• 公有云环境默认地址：cloudapi.xylink.com:443
• 分区云环境地址是WebRTC网关的域名/IP和端口

// 动态设置服务器地址
XYClient.setServerAddress({
  // 配置 HTTP 服务器地址
  httpServer: 'cloudapi.xylink.com:443', 
  // 配置 WebSocket 地址
  wssServer: 'cloudapi.xylink.com:443', 
  // 配置日志服务器地址
  logServer: 'log.xylink.com:443', 
});

// 调用完成后，无需重新初始化即可使用新地址进行登录+音视频呼叫

设置服务器功能示例图如下：

API参考

1. XYRTC.createClient
2. setServerAddress