配置 Liberty 即時通訊
配置「即時通訊」特性包括 server.xml 檔的更新。
關於這項作業
如果要將 Liberty 伺服器配置成執行啟用「即時通訊」的應用程式,您必須設定 rtcomm-1.0 特性。您也可以啟用其他數項配置和選項,來與使用「即時通訊」的應用程式一起運作。
程序
- 如果要啟用 rtcomm-1.0 特性,請在 server.xml 檔的 featureManager 元素內,新增下列的元素宣告:
<featureManager> <feature>rtcomm-1.0</feature> </featureManager>
如果您想修改預設值,您需要在 Liberty 伺服器配置中新增 Rtcomm 特性。如果要這樣做,您可以使用 WDT 工具,或手動在 server.xml 檔中新增下列配置行:
預設值包括:<rtcomm/>
- Rtcomm MQTT 分配管理系統連線詳細資料:(主機:localhost,埠:1883)
- Rtcomm 根主題路徑:/rtcomm/
- 停用 SSL
註: 如果要讓預設值生效,需要在 Liberty 伺服器相同的機器上安裝和啟用「MQTT 分配管理系統」。如果您想變更「MQTT 分配管理系統」的預設值,您需要將 server.xml 檔編輯成如下:<rtcomm messageServerHost="<brokerhostname>" messageServerPort="<brokerportname>" />
- 配置 Rtcomm 主題路徑。rtcommTopicPath 會與其他 Rtcomm 主題名稱搭配使用。這個主題路徑提供唯一的名稱空間,以防與使用相同訊息分配管理系統的其他開發人員發生衝突。如果要設定這個路徑,請在 server.xml 檔中新增下列配置行:
<rtcomm rtcommTopicPath="/rtcomm/"/>
在起始設定時,必須連同訊息分配管理系統位址,將您所配置的名稱和路徑傳遞至 rtcomm 用戶端程式庫。伺服器會建立主題名稱,並將它附加至主題路徑。
註: 只要您配置多部 Liberty 伺服器來使用相同的 MQTT 分配管理系統,各 Liberty 伺服器的 rtcommTopicPath 就必須是唯一的,否則,其行為無從預測。 - 您可以配置共用訂閱路徑,以便附加到 rtcommTopicPath 前面。當使用共用訂閱時,訊息分配管理系統需要這個路徑。如果要設定這個路徑,請在 server.xml 檔中新增下列配置行:
<rtcomm sharedSubscriptionPath="$SharedSubscription/rtcomm/">
當使用呼叫佇列時,必須配置共用訂閱。呼叫佇列依賴共用訂閱,來將訊息分送到所有佇列接聽器。比方說,若有多個服務台代理程式都在接聽單一佇列,則會使用共用訂閱,以便將呼叫一次分送到一個代理程式。
註: 在 MQTT 分配管理系統中,共用訂閱支援並非標準。先前的配置顯示如何適當設定 rtcomm-1.0 特性,以便與 IBM® MessageSight 一起運作。有關如何配置共用訂閱,請參閱您分配管理系統的產品說明文件。 - 選用:在使用 Rtcomm 特性時,配置其他選項。
- 使用 Rtcomm 特性來配置後端服務
Rtcomm 特性支援諸多後端服務,包括:
- 「互動式連線功能建立 (ICE)」伺服器配置:指定在協議對等媒體階段作業時,要傳送給 Rtcomm WebRTC 用戶端使用的 URL。
- 「呼叫佇列」支援:Rtcomm 可配置成支援共用呼叫佇列,並且可讓使用者建立共用呼叫佇列,以供諸多代理程式訂閱特定的呼叫佇列,並回應客戶的呼叫。比方說,您可以撥電話給特定產品的客戶支援中心。可以有多個代理程式訂閱佇列,但是一次只會選擇一個代理程式來回應每一項呼叫。
- Rtcomm 閘道:新增可讓「階段作業起始通訊協定 (SIP)」與 Rtcomm WebRTC 端點連接的功能,以便交換音訊和視訊串流。如需如何配置「Rtcomm 閘道」的進一步詳細資料,請參閱配置「Rtcomm 閘道」。
- 替代端點遞送:指定使用者希望透過替代端點來遞送新的階段作業。
- 「互動式連線功能建立 (ICE)」伺服器配置
ICE 是一種用於電腦網路連結的技術,其涉及 Voice over Internet Protocol (VoIP)、對等式通訊、視訊、即時傳訊,及其他互動式媒體等之類網際網路應用程式中的 NAT(網址轉換器)。在這類應用程式中,NAT 遍訪是一個有助於通訊的重要元件,它涉及私密網路安裝架構中的主機,而這些主機通常有防火牆保護。
「節點控制器」提供 ICE 伺服器配置,以便在 Rtcomm 用戶端節點設定與另一個用戶端的對等式階段作業時,通知它們可以使用哪些 ICE 伺服器。WebRTC 極度倚靠 ICE 伺服器來遍訪防火牆,在正式作業部署中,務必要包含 ICE 支援,以確保能有最高的機率可以連接端點。
ICE 伺服器配置是透過服務查詢要求來存取,而服務查詢要求會發佈給 Rtcomm 特性相關聯的連接器主題名稱。如需 Rtcomm 服務查詢的相關資訊,請參閱通訊協定詳細資料 GitHub lib.rtcomm.clientjs。
如果要配置各種類型的 ICE 伺服器,請在 server.xml 檔的 rtcomm 配置行中,新增下列內容:
<rtcomm> <iceServerURL>stun:example1.hostname.com:8880</iceServerURL> <iceServerURL>stun:example2.hostname.com:8881</iceServerURL> </rtcomm>
- 第三方呼叫控制
您可以在 GitHub 儲存庫中找到所有的通訊協定詳細資料,其中定義了與第三方呼叫控制有關的訊息格式。 lib.rtcomm.node-red 和 lib.rtcomm.node 相關的開放程式碼元件用來與這些服務互動。
- 呼叫佇列支援
呼叫佇列提供循環式互動,其中,眾多使用者可以訂閱佇列,而另一使用者可以呼叫該佇列。其中只有一個訂閱的使用者會收到該呼叫。如果要啟用這項特性,請依照先前步驟 2 所示,定義佇列並啟用「共用訂閱」。
如果要配置呼叫佇列,請配置共用訂閱路徑,以附加到 rtcommTopicPath 前面。當使用共用訂閱時,訊息分配管理系統需要這個路徑。您可以在 server.xml 檔中新增下列配置行,以便定義支援的 callQueues:<rtcomm sharedSubscriptionPath="$SharedSubscription/rtcomm/"> <callQueue description="refrigerator" callQueueID="callQueueID2" timeout="500s"></callQueue> </rtcomm>
使用者可以視需要建立任意數目的唯一呼叫佇列。若有配置此項,代理程式會訂閱共用訂閱路徑、rtcomm 主題路徑及主題名稱 ("$SharedSubscription/rtcomm//rtcomm/callQueue"),以接收來自伺服器的呼叫要求。
每一個佇列的可用配置項目如下:
- 配置說明:指定這個呼叫佇列實例的字面說明。服務查詢回應中會傳回這項字面說明,可更清楚地將佇列資訊傳達給用戶端。
- 配置 callQueueID:與呼叫佇列主題名稱相關聯的端點 ID,這是呼叫端用來呼叫特定佇列的目的地端點 ID。
- 配置逾時值:終止正在佇列中等待的呼叫之前,要等待的秒數。
- 替代端點遞送
- 指定使用者希望透過替代端點來遞送新的階段作業。當使用這個選項時,您可以訂閱 alternateEndpointRouting 主題名稱(例如 /rtcomm/alternateEndpointRouting),並且能夠將新的階段作業遞送至適當的端點。如果要啟用這項功能,請在 server.xml 檔中新增下列配置行:
<rtcomm alternateEndpointRoutingEnabled="true"/>
- Rtcomm SSL 配置
- 請確定環境是配置成在 Rtcomm 特性與 MQTT 分配管理系統之間使用 SSL。
- SSL reference 是用來連接至啟用 SSL 之 MQTT 分配管理系統的 SSL 配置 ID。
註: 為了讓 Rtcomm 特性使用 SSL,必須啟用 SSL 特性。如果要啟用 SSL 特性,請在 server.xml 檔中新增下列配置行。<rtcomm sslEnabled="true" sslRef="mySSLConfig" />
如需 sslRef 配置屬性的進一步詳細資料,請參閱 Liberty:SSL 配置屬性。

檔名:twlp_config_rtcomm.html