感谢您的反馈。

概述

独立房间导航仪以前没有报告 温度和湿度等环境指标。 随着最近的改进，这些环境指标现在通过专用的新 xAPI 节点 公开。 这使客户能够独立于内部房间传感器收集和监控 环境数据，从而提供更大的 灵活性和对房间条件的洞察力。

通过利用第三方占用传感器和 独立Navigators扩展的环境遥测功能，组织可以提高工作空间利用率的准确性并获得 宝贵的环境见解，从而优化舒适度、安全性和能源效率。

第三方占用传感器

RoomOS 目前提供 RoomAnalytics RoomInUse 状态作为衡量房间 是否被占用的主要指标。 此状态源自各种 RoomOS 信号，例如 活跃通话、本地活动、人员在线状态和人数，具体取决于设备 功能、传感器和配置。

新的第三方占用率输入可能会影响相同的 RoomAnalytics RoomInUse 状态。 通过宏或外部集成，现在可以根据来自 外部占用传感器的事件来设置 RoomInuse。

此功能对以下方面特别有用：

• 补充设备的内置感应能力。
• 报告没有完整视频系统的空间的占用情况，例如聚焦室、 健康室、母亲房间或其他占用数据非常 宝贵的共享区域。
• 支持独立Room Navigator部署，用于房间预订和入住率 报告。

在独立的Room Navigator房间预订设置中，即使房间中没有安装视频系统，RoomInuse 也可以在配置的情况下启用 Cisco 的 自动入住/退房行为。

房间环境 xAPI

RoomOS 现在报告室内和室外 位置的汇总环境指标，这些指标来自配备环境传感器的思科房间导航器。

• 配置为房间内部的导航器有助于实现 Inside Room 房间级别的环境状态。
• 配置为房间外的导航器有助于实现室 外房间级别的环境状态。

以前，来自外部Navigators的环境读数不是通过 房间级别的xAPI值来公开的，室内环境数据是按设备报告的， 而不是以房间级别的汇总值报告的。

这些环境指标包括温度、湿度和空气质量，使 设施经理和分析工具能够 有效地监控和优化工作空间条件。

房间环境 xAPI 清单

此版本引入了增强的 xAPI 功能，以支持第三方占用传感器 和思科Room Navigator设备的全面环境监控。

第三方占用率输入

现在，您可以使用第三方占用传感器通过以下 命令设置 roomInuse 状态：

xCommand RoomAnalytics RoomInUse Set

参数：

State: InUse or NotInUse
ID: Identifier for the sensor or integration
Duration: Duration in seconds for which the state should be maintained

示例：

xCommand RoomAnalytics RoomInUse Set State: InUse ID: "third-party-sensor-1" Duration: 300

占用状态监控

xStatus RoomAnalytics OccupancySensor[n] ID
xStatus RoomAnalytics OccupancySensor[n] RoomInUse
xStatus RoomAnalytics RoomInUse

总体数据xStatus RoomAnalytics RoomInUse包括作为房间占用状态一部分的第三方占用率 输入。

室内环境状况

可通过以下方式访问来自室内 Cisco Room Navigators 的汇总环境数据：

xStatus RoomAnalytics InsideRoom AmbientTemperature
xStatus RoomAnalytics InsideRoom RelativeHumidity
xStatus RoomAnalytics InsideRoom AirQualityIndex

室外的环境状况

可通过以下方式访问来自室外 Cisco Room Navigators 的汇总环境数据：

xStatus RoomAnalytics OutsideRoom AmbientTemperature
xStatus RoomAnalytics OutsideRoom RelativeHumidity
xStatus RoomAnalytics OutsideRoom AirQualityIndex

限制

当前的实现不支持以下内容：

• 第三方占用传感器的原生发现、配对或供应商特定设置。
• 为特定的第三方传感器供应商预建的集成。
• 第三方环境传感器集成。
• 来自第三方占用率 输入的人数、温度、湿度或空气质量数据

要求

要验证第三方的占用率信息，您需要：

• 对设备 xAPI 的管理员、集成者或房间控制级别的访问权限。
• 一种能够执行 xAPI 调用的宏、本地集成或外部服务。
• 可通过您选择的宏或 集成访问的第三方占用传感器或系统。

要验证环境价值，您需要：

• 具有支持环境感知功能的思科房间导航器。
• 必须 通过触摸屏配置为每个导航器分配一个特定的位置（InsideRoom 或 OutsideRoom）。

RoomOS 使用导航器的配置位置将其环境读数放入相应 的房间级汇总中：InsideRoom或。 OutsideRoom

占用整合示例

典型的第三方占用集成的工作原理是这样的：

1. 第三方传感器可检测占用情况。
2. 宏集成或外部集成接收传感器事件。
3. 集成调用 xAPI 进行设置RoomInUse。
4. RoomOS 更新RoomAnalytics RoomInUse。
5. 随着传感器输入的变化，集成会刷新或清除状态。

检测到占用情况时的示例：

xCommand RoomAnalytics RoomInUse Set State: InUse ID: "sensor-1" Duration: 300

传感器报告房间不再 被占用的示例：

xCommand RoomAnalytics RoomInUse Set State: NotInUse ID: "sensor-1"

如果使用持续时间，则如果房间仍被占用，则集成应在持续时间到期 之前刷新InUse状态。

如果使用多个第三方占用源，则每个来源都应使用马厩， ID以便可以单独监控其状态。

环境 xAPI 行为

环境 xAPI 报告房间级别的值，而不是每个面板的原始读数。

对于房间内部值，RoomOS 会汇总配置为房间内的导航器的读数。

对于室外值，RoomOS 会汇总配置为房间外的导航器的读数。

这使得集成、监控工具和仪表板可以通过 xAPI 消耗 室内和室外的环境价值。

环境 xAPI 值基于支持的思科Room Navigator环境 读数。 此版本不采集或汇总来自第三方 传感器的环境数据。

已知行为和局限性

• 仅限第三方占用率输入控件RoomInUse状态。 它 不提供人数、温度、湿度或空气质量数据。
• 将第三方占用传感器 连接到 RoomOS 需要进行宏观或外部集成。 RoomOS 不会直接发现或管理第三方传感器。
• 如果在设置时使用持续时间 RoomInUse，则第三方 集成负责在持续时间到期之前刷新状态。
• 环境状态取决于支持的思科Room Navigator硬件、布局 和配置的触摸屏位置。