命名空间：microsoft.graph
重要
Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。
表示硬件上的传感器，该传感器收集和报告有关物理或环境条件的数据，包括占用率、人数、推断占用率、温度、Wi-Fi 等。
属性
| 属性 | 类型 | 说明 |
|---|---|---|
| displayName | String | 传感器的显示名称。 可选。 |
| placeId | String | 传感器检测到的位置的唯一标识符。 如果设备安装在装有邮箱的会议室中，则此属性应与会议室邮箱的 ExternalDirectoryObjectId 或Microsoft Entra对象 ID 匹配。 如果传感器检测到与设备位置相同的位置，则可以省略 属性。 默认值为设备的地点标识符。 可选。 |
| sensorId | String | 设备上传感器的用户定义唯一标识符。 如果设备具有同一类型的多个传感器，则必须提供 属性来标识每个传感器。 如果设备只有一个类型的传感器，则可以省略 属性。 默认值为传感器类型。 可选。 |
| sensorType | workplaceSensorType | 传感器的类型。 可取值包括：occupancy、peopleCount、inferredOccupancy、heartbeat、badge、unknownFutureValue、wifi。 必须使用 Prefer: include-unknown-enum-members 请求标头来获取此 可演变枚举中的以下成员： wifi。 必填。 |
workplaceSensorType 值
| 成员 | 说明 |
|---|---|
| 占有 | 传感器检测位置是否被占用。 将其用于测量位置占用率的运动传感器或其他二进制传感器。 |
| peopleCount | 传感器计算该地点的人数。 将其用于报告人员计数为数字的传感器。 |
| inferredOccupancy | 传感器根据其他线索（例如笔记本电脑或背包的存在）估计该地点的占用状态。 将它用于不直接检测运动或人员计数的传感器。 |
| 心跳 | 传感器报告设备的检测信号。 它指示设备是否处于联机状态。 将其用于监视设备状态的传感器。 |
| 徽章 | 传感器报告人员的锁屏提醒轻扫事件。 将其用于接受活动用户交互的传感器。 |
| unknownFutureValue | 可演变枚举 sentinel 值。 请勿使用。 |
| wifi | 要上传的传感器 Wi-Fi 设备进行自动位置检测。 |
关系
无。
JSON 表示形式
以下 JSON 表示形式显示了资源类型。
{
"@odata.type": "#microsoft.graph.workplaceSensor",
"displayName": "String",
"placeId": "String",
"sensorId": "String",
"sensorType": "String"
}