適用於 Zoom Rooms 的房間控制

Room Controls 功能可讓您控制第三方、具備 IP功能的設備，這樣使用者就能透過 Zoom Room 控制器控制設備。管理員可以建立設定檔，從 Zoom Room 加入外寄 IP 控制訊息。

使用室內控制器的要求

附註： 如果您是將室內控制功能用於音訊 / 視訊 (A/V) 用途，您可以在 Zoom Rooms 中具有多個 NIC 的電腦上指定獨立的網路介面卡 (NIC)。NIC 可以從連接至其他網路的房間控制裝置中獨立選擇，這些房間控制裝置與啟用 Zoom Rooms 的電腦相連。此設定可讓您的音訊/視訊流量遠離主要網路。

可透過 LAN 或 WLAN 控制的第三方裝置

• Zoom Rooms：
  • 電腦：全球最低版本 或更高
  • macOS:全球最低版本 或更高
  • 裝置：全球最低版本 或更高
• Zoom Rooms for Touch5.16.0 或更高版本
• iTach 網路介面卡 (IP2SL/IP2CC 或 wifi 同等產品)，如果裝置沒有 LAN 或 WLAN 存取功能

USB 序列介面卡

• Zoom Rooms：
  • 電腦：5.15.0 或更高版本
  • macOS: 5.15.0 或更高版本
• 基於 Prolific PL2303 晶片組的裝置，例如 Startech 或 Sabrent

如何啟用房間控制

在您上傳 JSON 設定檔之前，需要啟用 Zoom Room 的設定。

1. 登入 Zoom Web 入口網站。
2. 按一下Room Management（房間管理），然後選擇Zoom Rooms（縮放房間）。
3. 按一下 Zoom Room 名稱右邊的Edit（編輯 ）。
4. 在Devices（裝置）下，將Enable Room Controls（啟用 室內控制）切換為開啟（藍色）。
5. (選用）勾選將 "Room Controls" 頁面設定為 Zoom Rooms 控制器首頁畫面 旁的方塊 。
   注意：這需要 Zoom Rooms 和 Zoom Rooms 控制器應用程式版本 6.3.0 或更高。
6. 按一下建立個人資料。
7. 輸入此房間的 JSON 設定。

如何撰寫 Room Controls 簡介

入門指南

在撰寫 Room Controls Profile 之前，需要對 JSON 有一定的瞭解。需要注意的關鍵項目是 JSON 是基於 key:value 對的系統，而且語法對於正確排版檔案非常重要。如需 JSON 基礎知識的其他資訊，請參考線上入門課程。

在任何編碼語言中，都應該對處理您檔案的下一個人給予一些禮貌。雖然室內控制對此沒有特定的要求，但我們建議您這樣做。若要留下作者、版本或其他歷史記錄，可以使用「關於」物件，並將其置於「適配器」之上。Room Controls 不會解析，但會保留在入口網站中。 以下舉例說明如何運用此功能。

{
"關於" ：{
"類型" ："中型會議 A" 、
"version":"v1.2.4" 、
"design_ref":"\files\MediumConfA" 、
"created" ："Mon, 21 Oct 2020 16:35:52 GMT"
},

轉接器

設定轉接器可將 Room Controls 連接到裝置。本節是設定的主要部分。巢狀 JSON 格式內的個別裝置應遵循類似的格式 (本範例的巢狀與下面的程式碼範例平行)：

• 適配器：適配器定義了個別裝置的連接
  • 模型：模型可以是"GenericNetworkAdapter","IP2CC", 和"IP2SL" 。 詳細資訊如下。
  • IP：這是網路裝置的 IP 位址 + 連接埠
    • 注意：在目前的軟體版本中，Room Controls 現在也支援主機名稱而非 IP 位址。
  • UUID:只有 Global Caché 裝置才需要使用，並遵循"GlobalCache_[MAC]。"
  • 連接埠：連接埠定義連接的裝置
    • ID：這是裝置的代碼名稱。 應遵循 JSON 變數格式
    • 名稱：這是使用者在介面上看到的友善名稱
    • 方法：方法定義個別 UI 區段
      • ID:這是在程式碼中呼叫的控制類型 ID (特定於控制類型)
      • 名稱：這是顯示在 Zoom Rooms 介面上的使用者可存取名稱
      • 命令：這是完整的指令或指令字串的共用部分，視動作類型而定
        • 注意：當動作類型為 'actions' 時，應在命令字串中放置一個 %應放在命令字串中，作為 'params' 內插入元素的占位符
         
      • 參數：此部分僅用於「動作」類型，包含可以捲動到父指令的元素。
        • ID：這是程式碼中呼叫的程式 ID
        • 名稱：這將會是房間控制按鈕上使用者可存取的文字
        • 值：這是插入父指令的指令區段。 例如，可以使用「POWR000%\\x0D 」作為父指令，「0」代表關閉，「1」代表開啟，可以插入到某些夏普顯示器中。

{
"適配器" ：[
            {
           "型號":"iTachIP2SL" 、
           "IP":"[IP_ADDRESS]" 、
           "uuid" ："GlobalCache_[UNIT_MAC_ADDRESS]" 、
           "ports" ：[
                     {
                    "id":"sl_sharp_tv" 、
                    "name":"Sharp Display" 、
                    "settings" ：{
                    "baud_rate" ："38400" 、
                    "flow_control" ："FLOW_NONE" 、
                    "parity" ："PARITY_NO"
                     },
                    "methods": [
                                {
                               "id":"power" 、
                               "name":"Power" 、
                               "command" ："POWR000%\x0D" 、
                               "params" ：[
                                          {
                                         "id":"displayOn" 、
                                         "name":"On" 、
                                         "value":"0001"
                                          },
                                          {
                                         "id":"displayOff" 、
                                         "name":"Off" 、
                                         "value":"0000"
                                          }
                                          ],
                               "type":"actions" 
                                },
...

在「方法」下面，可以使用額外的部分："response_filter" 。回應篩選器是一個信標，可讓下面定義的回應篩選器了解要聆聽哪個連線。此區域未定義任何功能。回應篩選器如何與其他章節配合，將在這些章節中說明。

風格

樣式控制介面元素的視覺樣式。調整的範圍不是非常廣泛，所以學起來也不是很難。

介面中有許多可用的圖示。它們涵蓋了從空調到免提電話的所有產品。以下圖示為目前的清單，但此清單仍會定期擴充。

裝置	名稱	圖片
冷氣機	空氣調節器
有线电视	有線電視
天花麥克風	圖示天花板麥克風
帷幕	圖示窗簾
DVD 播放器	圖示_dvd_player
Xbox/PS4 系統	遊戲控制台圖示
HDMI	圖示_hdmi
筆記本電腦	圖示_筆記型電腦
輕	圖示燈
投影機	圖示投影機
機架設備	機架設備
衛星碟	衛星碟
喇叭	圖示_喇叭
免提電話	圖示_喇叭
電視	圖示_電視
功率	圖示功率
向上	圖示向上
下	圖示向下
冷	圖示_冷
熱	圖示_熱
乾燥	圖示_乾燥
風	圖示風

樣式中有三個主要的修改器：圖示（如上文所述）、主要方法和可見性。

圖示是系統的可視化。您可以使用它們來標記裝置或取代與按鈕連結的文字。在下面的範例中，我們定義了一個名為「example」的裝置。

{
"適配器" ：[
            {
           "模型" ："ExternalControlSystem" 、
           "ip":"tcp://[USER_IP_ADDRESS]:[USER_PORT]" 、
           "連接埠" ：[
                     {
                    "id":"範例" 、
                    "name":"Example Device" 、
                    "方法": [
...

將「example」定義為裝置後，我們就可以在樣式中使用這個 ID。 舉例來說，將我們範例裝置的主圖示設定為一盞燈就很容易完成。

"樣式": [
         "example.icon=icon_light" 、
"example.main_method=power"
]

Zoom 也支援 Material Design Icons (MDI)，可在Google 官方 MDI 網站找到。

若要指定其中一個圖示，請遵循以下格式：

• mdi：使用此前綴將圖示識別為 Google MDI 圖示
• icon_name: 客戶可以從 Google Material Icons 官方網站搜尋圖示，並使用 '_「 取代圖示名稱中的 」(空格)
• style_name: 支援"概要","填充","圓角","尖銳" 和"two_tone"

"example.icon=mdi:local_airport:two_tone"

請注意，這應該全部使用小寫。在圖示名稱中使用下劃線 (_) 代替空格。如果圖示無法下載，則會顯示預設圖示。

您可能也注意到，在單一行中，我們也定義了裝置的 Main Method。 Main Method 會將您定義的引用指令拉到裝置的標題列中，並將其放在顯眼的位置，就像這樣：

我們已將 power 指令定義為主要方法，因此它會顯示在上列，與其他指令分開。

第三種樣式類型是可見性。可視性允許程式設計師定義一個函數，但在使用者介面上完全隱藏該函數。 它可以很容易地被定義：

"example.power.invisible=true"

遵循"device.command.invisible=true 的格式"允許 Rooms 使用者完全隱藏此指令。

規則

規則是 Room Controls 的自動化引擎。這是定義自行發生的事情的區域。舉例來說，如果我希望我的顯示器只有在會議進行時才會啟動，我可以利用"meeting_started" 和"meeting_ended" (Zoom現有的事件) 來實現這一目標。

"規則" ：{
         "meeting_started" ：[
                            "display.power.on" 、
"喚醒攝影機"
]
          ),
         "meeting_ended" ：[
                          "display.power.off"
]
          }

此範例可用於降低系統的耗電量。

如果每條規則只有一個指令還不夠，這些指令可以很容易地堆疊在一起。雖然它們在技術上是依序啟動的，但它們處理的速度很快，所以我們會認為這些事件是同時發生的。在我上面的範例中，"camera.power.wake" 加在"display.power.on" 之下，以便在顯示器喚醒時啟動我的攝影機。

注意：

• 自 Zoom Rooms 5.13.0 版起，規則內可用的庫存 Zoom 指令已擴充。會議開始/結束事件現在也適用於第三方互動會議，包括Microsoft Teams Direct Guest Join Meetings。 其他事件不適用於此版本中的第三方互操作會議。
• 房間控制使用者可以在 JSON 配置中指定"events only" ，以隱藏不必要的房間控制介面。在 JSON 中特別定義此欄位時，Native Room Controls UI 將不會出現在 Zoom Rooms 控制器上。在同時使用 NRC 活動和 Zoom Apps 的部署中，房間控制按鈕可直接啟動 Zoom App 介面，而不會顯示空的房間控制頁面。

注意：操作時間事件的操作時間是在 Zoom Rooms 設定頁面中設定。

您也可以簡單地新增自己的回應篩選器。在規則區中，您也可以使用下面討論的觸發事件 (Trigger Events)，利用外部輸入驅動您自己的自動化。

"規則":{
       "operation_time_started":[
                               "開啟"
],
       "user_customized_event1":[
                               "關閉電源"
]
         }

在這個範例中，我們的"user_customized_event1" 正在關閉受控的燈。這可能是由按鈕的輸入驅動，也可能是動作感應器失效，甚至可能是第三方系統（例如預約系統）向會議室發送沒有使用者報到的更新。如何使用此功能主要受限於您的想像力。

場景

Zoom Rooms 5.13.0 的新功能「場景」，讓房間控制的忠實使用者，終於可以在使用者體驗中加入巨集（在單一按鈕上堆疊多個指令）。 這對於場景召回或依賴裝置（例如降低投影機螢幕以及開啟投影機電源）很有幫助。

與規則或適配器一樣，場景也是 JSON 檔案中的頂層部分。 目前最多可設定 20 個場景。 在這些場景中，最多可支援 50 個獨立指令。

配置完成後，這些新的場景按鈕就會出現在房間控制視窗的頂端。

若要設定場景，您可以參考以下的程式碼範例。

在複製此內容之前，請注意「//text」區段是供您參考的備註，無法包含在最後的 JSON 檔案中。

"場景":[
     {
         "id":"scene_1", //required
         "name":"Turn on all lights", //可選，如果名稱和圖示為空則顯示
         "圖示":"icon_light", //可選，見圖示清單
         "指令" ：[ //必要
              "light1.power.on" 、
"light2.power.on"
]
     },
     {
         "id":"scene 2" 、
         "name":"關閉所有燈光"
         "圖示":"icon_light"
         "命令" ：[
              "light1.power.off" 、
"light2.power.off"
]
      }
  ]

回應篩選器

響應濾波器是室內控制功能的強大進步。這些篩選器會讀取從已定義裝置傳回的訊息，並立即掃描要匹配的詞組。當此詞組（或表達方式）在該連線上被識別時，Rules Trigger Event（如上所述）會啟動。

每個回應篩選器都由三個元件組成：

• "name": 該名稱用於"ports" section of"methods". 當"連接埠" 區域中的回應篩選器符合此名稱時，就會開始跨越定義的連線
• "filter_regex" ：regex (或正規表示式) 是回應篩選器嘗試匹配的字元集。當匹配發生時，"trigger_event" 會啟動
• "trigger_event" ：觸發事件用於規則部分。當"filter_regex" 啟動時，規則中此觸發事件所定義的自動化將會發生

如何使用房間控制

在 Zoom Rooms 控制器上，只要點選Room Controls 圖示，就能存取這些新增功能。

不在會議中時，可以在主功能表中找到Room Controls圖示。

在會議中，點選控制器視窗右上方的圖示，就會顯示相同的Room Controls。

疑難排解

故障排除是任何自訂組態的重要部分。雖然 Room Controls 可以很簡單，但它也有足夠的彈性在需要時變得複雜。以下部分應有助於解決可能出現的障礙。

房間控制錯誤

樣本檔案

這些檔案是從不同來源彙編而成，僅可作為起點使用。可能需要進行一些修改以符合您的應用。

• 通用檔案
  • Zoom Room Control JSON 設定檔
  • 帶附加註解的 Zoom Room 控制 JSON 設定檔
  • 通用照明 JSON 規範 (Relay)
  • 通用照明 JSON 規範 (序列)
• Avocor
  • JSON 設定檔 (IP)
• 中大西洋
  • Racklink JSON Profile (IP)
• 舒爾
  • MXA910 JSON Profile (IP)
• DTEN
  • DTEN 板 D7 (USB-Serial)