用于变焦室的房间控制器

房间控制功能可让您控制具有 IP 功能的第三方设备，这样用户就可以通过 Zoom Room 控制器控制这些设备。管理员可以创建配置文件，添加来自 Zoom Room 的外发 IP 控制信息。

使用室内控制器的要求

注意： 如果您将房间控制用于音频/视频 (A/V)，则可以为 Zoom Rooms 中带有多个 NIC 的计算机分配单独的网络接口卡 (NIC)。可以从连接到备用网络的房间控制设备中独立选择网卡，这些设备连接到启用了 Zoom Rooms 的计算机上。这种配置可以使音频/视频流量远离主网络。

可通过局域网或无线局域网控制的第三方设备

• 放大房间：
  • 电脑：全球最低版本 或更高
  • macOS：全球最低版本 或更高
  • 设备：全球最低版本 或更高
• Zoom Rooms for Touch5.16.0 或更高版本
• iTach 网络适配器（IP2SL/IP2CC 或 Wifi 同等设备），如果设备无法访问局域网或无线局域网的话

USB 串行适配器

• 放大房间：
  • 电脑：5.15.0 或更高版本
  • macOS：5.15.0 或更高版本
• 基于 Prolific PL2303 芯片组的设备，如 Startech 或 Sabrent

如何启用房间控制器

在上传 JSON 配置文件之前，需要为 Zoom Room 启用该设置。

1. 登录 Zoom 门户网站。
2. 单击房间管理，然后选择缩放房间。
3. 单击缩放室名称右侧的编辑 。
4. 在"设备"下，将 "启用 房间控制 "切换为打开（蓝色）。
5. (可选）选中 旁边的复选框，将 "Room Controls" 页面设置为 Zoom Rooms 控制器的主屏幕。
   注意：这需要 Zoom Rooms 和 Zoom Rooms 控制器应用程序版本 6.3.0 或更高。
6. 单击创建个人资料。
7. 输入此房间的 JSON 配置。

如何撰写房间控制简介

入门

在编写房间控制配置文件之前，需要对 JSON 有一定的了解。需要注意的要点是，JSON 是一个基于键：值对的系统，语法对于正确布局文件非常重要。有关 JSON 基础知识的其他信息，请参考在线入门课程。

在任何编码语言中，都应该对处理您文件的下一个人给予一些礼遇。虽然对房间控制没有具体要求，但建议这样做。要留下作者、版本或其他历史记录，可以使用 "关于 "对象，并将其置于 "适配器 "之上。房间控制软件不会对其进行解析，但会保留在门户网站中。 下面举例说明如何加以利用。

{
"关于" ：{
"类型" ："中型会议 A" 、
"版本":"v1.2.4" 、
"design_ref":"\files\MediumConfA" 、
"created" ："Mon, 21 Oct 2020 16:35:52 GMT"
},

适配器

设置适配器可将房间控制器连接到设备。本部分是配置的主要部分。嵌套 JSON 格式内的各个设备应遵循类似的格式（本示例的嵌套与下面的代码示例类似）：

• 适配器适配器定义了各个设备的连接
  • 模型：模型可以是"GenericNetworkAdapter","IP2CC", 和"IP2SL" 。 详情如下。
  • IP：这是网络设备的 IP 地址 + 端口
    • 注意：在当前软件版本中，室内控制装置现在也支持主机名而非 IP 地址
  • UUID：只有 Global Caché 设备才需要，并遵循"GlobalCache_[MAC]。"
  • 端口：端口定义连接的设备
    • ID：这是设备的代码名称。 应遵循 JSON 变量格式
    • 名称：这是用户在界面上看到的友好名称
    • 方法方法定义了用户界面的各个部分
      • 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" ：{
                    "波特率" ："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"
                                          }
                                          ],
                               "类型":"操作" 
                                },
...

在 "方法 "下面，可以使用一个附加部分："response_filter".响应过滤器是一种信标，可让下面定义的响应过滤器了解要监听的连接。该区域未定义任何功能。响应式筛选器如何与其他部分配合，将在这些部分中介绍。

风格

样式控制界面元素的视觉样式。调整的范围不是很大，所以学习起来并不难。

界面上有许多图标。从空调到免提电话，应有尽有。以下图标为当前列表，但该列表会定期扩充。

设备	名称	图片
空调	图标_空调
有线电视	图标_有线电视
天花板麦克风	天花板麦克风图标
帷幕	图标窗帘
DVD 播放器	图标 DVD 播放器
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：支持"概述","填充","圆形","锐利" 和"双色"

"example.icon=mdi:local_airport:two_tone"

请注意，应全部使用小写字母。在图标名称中使用下划线 (_) 代替空格。如果无法下载图标，将显示默认图标。

您可能还会注意到，在这一行中，我们还定义了设备的主方法（Main Method）。 主方法会将您定义的引用命令拉到设备的标题栏中，并将其放在显眼的位置，就像这样：

我们将电源命令定义为主方法，因此它显示在上栏，与其他命令分开。

第三种样式是可见性。可见性允许程序员定义一个函数，但在用户界面上完全隐藏该函数。 它的定义也同样简单：

"example.power.invisible=true"

遵循"device.command.invisible=true 的格式"允许对房间用户完全隐藏该命令。

规则

规则是室内控制的自动化引擎。在这一领域，自行发生的事情会被定义。例如，如果我想让我的显示屏只在会议激活时才激活，我可以利用"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 版起，规则内可用的库存缩放命令已得到扩展。会议开始/结束事件现在也适用于第三方互操作会议，包括Microsoft Teams 直接访客加入会议。 其他事件不适用于本版本中的第三方互操作会议。
• 房间控制用户可在 JSON 配置中指定"events only" ，以隐藏不必要的房间控制界面。如果在 JSON 中特别定义了该字段，则不会在 Zoom Rooms 控制器上显示 "本地房间控制 "用户界面。在同时使用 NRC 事件和 Zoom App 的部署中，"房间控制 "按钮可直接启动 Zoom App 界面，而不会显示空的房间控制页面。

注意：操作时间事件的操作时间在 Zoom Rooms 设置页面中设置。

也可以简单地添加自己的响应过滤器。在规则部分，您还可以使用下面讨论的触发事件，通过外部输入驱动自己的自动化。

"规则":{
       "operation_time_started":[
                               "light.power.on"
],
       "user_customized_event1":[
                               "light.power.off"
]
         }

在本例中，我们的"user_customized_event1" 正在关闭受控灯光。这可能是由按钮输入驱动的，也可能是运动传感器失灵驱动的，甚至可能是由第三方系统（如预订系统）向房间发送更新信息，说明没有用户登记参加会议。如何使用这一功能主要取决于您的想象力。

场景

Zoom Rooms 5.13.0 的新功能 "场景 "让房间控制的忠实用户终于可以在他们的用户体验中添加宏（在单个按钮上叠加多个命令）。 这对于场景调用或依赖设备（如降低投影仪屏幕以及打开投影仪电源）很有帮助。

与 "规则 "或 "适配器 "一样，"场景 "也是 JSON 文件中的顶级部分。 目前，最多可配置 20 个场景。 在这些场景中，最多可支持 50 个独立命令。

配置完成后，这些新场景按钮就会出现在房间控制窗口的顶部。

要配置场景，可参考下面的代码示例。

在复制这些内容之前，请注意"//text "部分是供您参考的注释，不能包含在最终的 JSON 文件中。

"场景":[
     {
         "id":"scene_1", //required
         "name":"Turn on all lights", //optional, shown if name and icon are empty
         "图标":"icon_light", //可选，参见图标列表
         "命令" ：[ //必须
              "light1.power.on" 、
"light2.power.on"
]
     },
     {
         "id":"scene 2" 、
         "名称":"关闭所有灯光"
         "图标":"icon_light"
         "命令" ：[
              "light1.power.off" 、
"light2.power.off"
]
      }
  ]

响应过滤器

响应滤波器是室内控制功能的一大进步。这些过滤器会读取从指定设备返回的信息，并即时扫描匹配的短语。当在该连接上识别到该短语（或表达式）时，就会触发规则触发事件（如上所述）。

每个响应过滤器都由三个要素组成：

• "name": 该名称用于"methods" 的"ports" 部分。 当响应过滤器与"ports" 区域中的名称相匹配时，就会开始跨定义的连接
• "filter_regex" ：regex（或正则表达式）是响应过滤器试图匹配的字符集。当匹配发生时，"trigger_event" 将激活
• "trigger_event" ：触发事件用于规则部分。当"filter_regex" 激活时，在规则中该触发器事件内定义的自动化将发生

如何使用房间控制器

在 Zoom Rooms 控制器上，只需轻点房间控制 图标，即可访问这些新增功能。

不开会时，可在主菜单中找到会议室控制图标。

会议期间，点击控制器窗口右上方的图标将显示相同的会议室控制。

故障排除

故障排除是任何自定义配置的重要组成部分。虽然室内控制可以很简单，但在需要时也可以很灵活地变得复杂。以下部分应有助于解决可能出现的障碍。

房间控制错误

样本文件

这些文件是从各种来源汇编而来的，仅供参考。可能需要进行一些改动才能适合您的应用。

• 通用文件
  • Zoom Room Control JSON 配置文件
  • 带有附加注释的 Zoom Room 控制 JSON 配置文件
  • 通用照明 JSON 配置文件（中继）
  • 通用照明 JSON 配置文件（串行）
• Avocor
  • JSON 配置文件 (IP)
• 中大西洋
  • Racklink JSON 配置文件（IP）
• 舒尔
  • MXA910 JSON 配置文件（IP）
• DTEN
  • DTEN 板 D7（USB 串行接口）