如何编写Zoom Rooms原生中控JSON配置以控制索尼电视与Control4？

核心问题解答 #

• Zoom Rooms原生房间控制完全支持HTTP GET请求，可通过配置文件中http类型的设备条目实现对Control4这类基于HTTP API的系统的控制。

完整配置示例 #

{
  "devices": [
    // 索尼KD65X80K电视配置（SSIP协议）
    {
      "name": "Sony KD65X80K TV",
      "type": "tcp",
      "ip": "10.4.201.228",
      "port": 20060,
      "commands": {
        "power_on": "*SCPOWR0000000000000001\n",
        "power_off": "*SCPOWR0000000000000000\n",
        "volume_up": "*SCVOLU0000000000000001\n",
        "volume_down": "*SCVOLU0000000000000000\n"
      }
    },
    // Control4自动化系统配置（HTTP GET协议）
    {
      "name": "Control4 Automation",
      "type": "http",
      "base_url": "http://10.4.201.195:49412",
      "commands": {
        "tv_one_on": "/tvOneOn",
        "tv_one_off": "/tvOneOff",
        "scene_meeting_start": "/meetingStartScene",
        "scene_meeting_end": "/meetingEndScene"
      },
      "method": "GET",
      "headers": {}
    }
  ],
  "room_controls": [
    {
      "name": "电视控制",
      "items": [
        {
          "name": "开机",
          "command": "Sony KD65X80K TV.power_on"
        },
        {
          "name": "关机",
          "command": "Sony KD65X80K TV.power_off"
        },
        {
          "name": "音量+",
          "command": "Sony KD65X80K TV.volume_up"
        },
        {
          "name": "音量-",
          "command": "Sony KD65X80K TV.volume_down"
        }
      ]
    },
    {
      "name": "Control4场景",
      "items": [
        {
          "name": "开启电视1",
          "command": "Control4 Automation.tv_one_on"
        },
        {
          "name": "关闭电视1",
          "command": "Control4 Automation.tv_one_off"
        },
        {
          "name": "会议开始场景",
          "command": "Control4 Automation.scene_meeting_start"
        },
        {
          "name": "会议结束场景",
          "command": "Control4 Automation.scene_meeting_end"
        }
      ]
    }
  ]
}

配置说明 #

Control4部分关键字段解释 #

• type: 必须设为http，告知Zoom该设备采用HTTP协议通信
• base_url: Control4 API的基础地址，包含IP和端口
• commands: 自定义指令名对应API路径，最终会自动拼接为完整GET请求（比如tv_one_on对应http://10.4.201.195:49412/tvOneOn）
• method: 指定请求方法为GET，匹配你的需求
• headers: 若Control4 API需要自定义请求头，可在此添加（如身份验证字段），无需求则留空

注意事项 #

1. 确认Zoom Rooms主机与Control4设备网络连通，防火墙规则允许HTTP请求通行
2. 确保指令路径与Control4实际提供的API路径完全一致
3. 配置前可先用浏览器或curl工具手动发送GET请求验证API有效性
4. 配置文件需上传至Zoom房间管理后台，生效可能需要重启Zoom Rooms主机

内容的提问来源于stack exchange，提问作者T-killa