rtcomm - 实时通信 (rtcomm)

定义与 Rtcomm 功能部件及其所有相关组件相关的配置。与 Rtcomm 功能部件相关联的所有实时功能都在此单一实体下配置。

NameTypeDefaultDescription
rtcommTopicPathstring/rtcomm/与此功能部件相关联的 MQTT 主题路径。在“Rtcomm 选项”内配置的所有 Rtcomm 主题名称都以此路径为前缀。要在消息代理内为此 Rtcomm 实例创建唯一名称空间,请修改此路径以使其唯一。
messageServerHoststringlocalhostMQTT 代理的主机。指定的主机可以是 IP 地址或域名服务器 (DNS) 主机名。
messageServerPort整形1883MQTT 代理侦听的端口。端口为任意有效端口号。
sslEnabled布尔型false在 Rtcomm 功能部件和 MQTT 代理之间使用 SSL。
sslRef对顶级 ssl 元素的引用(字符串)。要用于连接至启用 SSL 的 MQTT 代理的 SSL 配置的标识。
sharedSubscriptionPathstring指定用作主题路径前缀的共享预订路径。使用共享预订时,消息代理需要此路径。
alternateEndpointRoutingEnabled布尔型false启用备用端点路由选项。那些要控制端点路由的管理员必须启用此选项。

iceServerURL

指定可供客户机使用的交互连接建立 (ICE) 服务器 URL。客户机可请求要与 WebRTC 配合使用(通过使用 Rtcomm 服务查询)的 ICE 服务器 URL 的列表。以下是 ICE 服务器 URL 的示例格式:stun:hostname:port。

callQueue

定义调用队列的单个实例。此实例完全封装与单个队列相关的所有配置。

NameTypeDefaultDescription
id字符串唯一配置标识。
callQueueIDstringcallQueueID与调用队列主题相关联的名称。这是调用者用于调用特定队列的目标端点标识。
descriptionstring指定此调用队列实例的描述。此描述在服务查询响应中返回,可用于让客户机更好地了解此队列的相关信息。
timeout具有秒精度的时间段600s终止在此队列中等待的调用之前等待的秒数。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,以 30s 的形式指定 30 秒。可将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。

gateway

提供从 Rtcomm 至 SIP 网络的连接的 WebRTC 网关

NameTypeDefaultDescription
externalPRstringSIP 代理/注册商的 host:port 地址。如果指定了地址,那么所有出局 SIP 消息都将转发到此地址
sipContainer布尔型false出局 SIP 消息路由到在本地安装的 SIP 应用程序
allowFromSipEndpointRef对顶级 sipEndpoint 元素的引用的列表(以逗号分隔的字符串)。defaultSipUAEndpoint此连接器的 SIP 端点的列表。

gateway > allowFromSipEndpoint

此连接器的 SIP 端点的列表。

NameTypeDefaultDescription
id字符串唯一配置标识。
tcpOptionsRef对顶级 tcpOptions 元素的引用(字符串)。defaultTCPOptions定义 TCP 协议设置
sslOptionsRef对顶级 sslOptions 元素的引用(字符串)。定义 SSL 协议设置
sipTCPPort整形5060TCP 端口号
sipUDPPort整形5060UDP 端口号
sipTLSPort整形5061TLS 端口号
bindRetries整形60在端口绑定不成功时尝试的重试次数。
bindRetryDelay具有毫秒精度的时间段5000ms两次重试之间的延迟(以毫秒计)。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m)、秒 (s) 或毫秒 (ms)。例如,以 500ms 的形式指定 500 毫秒。可将多个值包括在单个条目中。例如,1s500ms 相当于 1.5 秒。
hoststringlocalhost端点主机的 IP 地址

gateway > allowFromSipEndpoint > tcpOptions

定义 TCP 协议设置

NameTypeDefaultDescription
inactivityTimeout具有毫秒精度的时间段60s用于等待读或写请求在套接字上完成的时间量。特定于协议的超时将覆盖此值。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m)、秒 (s) 或毫秒 (ms)。例如,以 500ms 的形式指定 500 毫秒。可将多个值包括在单个条目中。例如,1s500ms 相当于 1.5 秒。
soReuseAddr布尔型true允许立即重新绑定到没有任何处于活动状态的侦听器的端口。
addressIncludeListstring允许在此端点上进行入站连接的地址的逗号分隔列表。您可以指定 IPv4 或 IPv6 地址。IPv4 或 IPv6 地址中的所有值必须用数字或星号通配符表示。
addressExcludeListstring不允许在此端点上进行入站连接的地址的逗号分隔列表。您可以指定 IPv4 或 IPv6 地址。IPv4 或 IPv6 地址中的所有值必须用数字或星号通配符表示。
hostNameIncludeListstring允许在此端点上进行入站连接的主机名的逗号分隔列表。主机名是不区分大小写的,可以星号(用作通配符)开头。但是,不能在主机名中的任何其他位置使用星号。例如,*.abc.com 有效,但 *.abc.* 无效。
hostNameExcludeListstring不允许在此端点上进行入站连接的主机名的逗号分隔列表。主机名是不区分大小写的,可以星号(用作通配符)开头。但是,不能在主机名中的任何其他位置使用星号。例如,*.abc.com 有效,但 *.abc.* 无效。

gateway > allowFromSipEndpoint > sslOptions

定义 SSL 协议设置

NameTypeDefaultDescription
sessionTimeout具有秒精度的时间段1d用于等待读或写请求在套接字上完成的时间量。特定于协议的超时将覆盖此值。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,以 30s 的形式指定 30 秒。可将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。
suppressHandshakeErrors布尔型false禁用记录 SSL 握手错误。SSL 握手错误会在正常操作期间发生,但是当 SSL 行为异常时,这些消息将很有用。
sslRef对顶级 ssl 元素的引用(字符串)。缺省 SSL 配置指令表。缺省值为 defaultSSLSettings。
sslSessionTimeout具有毫秒精度的时间段8640msSSL 通道建立的 SSL 会话的超时限制。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m)、秒 (s) 或毫秒 (ms)。例如,以 500ms 的形式指定 500 毫秒。可将多个值包括在单个条目中。例如,1s500ms 相当于 1.5 秒。