教育行业场景开发包

近年来，我国学生近视率在逐年上升，其中教室照明问题是重要原因之一。随之而来的是大规模的教育照明改造。面对教室照明的种种痛点问题、改造需求，我们该如何低成本短时间地完成满足智能化、节能化、健康化功能的教室照明改造？

涂鸦以 Zigbee 协议、Bluetooth mesh 协议为基础，通过对教室内常用智能设备的管控，形成了一套行之有效的教室智能照明解决方案，并已完成了较大规模的项目落地工作。

我们基于已有的智慧教室整体解决方案，整理完成了智慧教室模板。该模板可接入涂鸦开发者依据此开发包完成一键配置教室环境需要的智能场景。

包含的功能

• 用途体系设置
• 教室标准照明场景
• 感应控制规则配置

智慧教室配置设备推荐

护瞳 LED 教室灯（微晶款）

LED 黑板灯

• 采用最接近自然光色谱的光源芯片，模拟自然光环境。
• 采用教室灯专用微晶防眩面板，严格控制眩光，可达到 UGR＜16。
• 灯具效能高，更节能。
• 高显色指数 Ra 及 R9，更好地还原物体本色。
• 确保无蓝光危害 RG0，光频闪危害为无显著影响，对人体的电磁辐射符合安全规定。
• 灯具尺寸：长：1200 mm，宽：295 mm。
• 配 2 根钢性中空铝制吊杆，吊杆直径 12 mm、壁厚 ≥1 mm，能容纳灯具导线，表面采用阳极氧化戒喷塑处理。
• 灯具主体材料为不易变形抗氧化金属材料，连接方式为嵌入加螺丝螺帽连接固定。
• 电源外置，可固定在灯具背面，方便安装与维护。

Zigbee 六路彩屏场景开关

场景功能：内置 32 个本地场景，用户可自行切换。同时按下按键 3 和按键 4 大约 5 秒，场景图标闪烁，短按按键实现场景互相切换。无操作 3 秒后，退出设置，场景图标长亮。

微波人体存在传感器

运用毫米波多普勒雷达，感知人体生物运动，从而实现特定场所中有人/无人的状态检测。该产品还具备光照度检测功能。

智慧教室配置 API

前置步骤

1. 联系商务开通商户。
2. 参考 创建项目和空间。
3. 使用涂鸦集智光控设备配网。更多信息，请参考 其他设备控制 API。

配置 API

请求方式	API	描述
POST	/v1.0/light/devices/edu/purpose	设置教育行业设备用途。目前，6 个模式基于基础照明用途和黑板照明用途设计。完成设置后，调用生成以下的各个场景。
POST	/v1.0/light/smart/edu-template/class	一键生成上课模式。
POST	/v1.0/light/smart/edu-template/class-over	一键生成下课模式。
POST	/v1.0/light/smart/edu-template/siesta	一键生成午休模式。
POST	/v1.0/light/smart/edu-template/projection	一键生成投影模式。
POST	/v1.0/light/smart/edu-template/exam	一键生成考试模式。
POST	/v1.0/light/smart/edu-template/study	一键生成自习模式。
POST	/v1.0/light/smart/edu-template/reaction	一键生成空间感应配置。

设置教育行业设备用途

功能描述

为教学楼里的各个设备分配以下的设备用途。涂鸦商照的内置模板将为各个教室一键生成各种场景或联动。

接口地址

POST /v1.0/light/devices/edu/purpose

请求参数

参数名	类型	参数类型	说明	是否必需	示例
device_ids	String[]	body	设备 ID 列表	true	uQvUFxMm9J
roomId	String	body	空间 ID	true	uQvUFxMm9J
device_purpose	String	body	教育行业设备用途。 basicLighting：基础照明 atmosphereLighting：氛围照明 emergencyLighting：应急照明 functionLighting：功能照明 blackboardLighting：黑板照明 windowLighting：靠窗照明 aisleLighting：过道照明 internalLighting：内部照明 auxiliaryLighting：辅助照明	true	basicLighting

返回参数

参数名	类型	说明
code	Integer	响应码（详情见错误码章节），成功时为空
success	Boolean	是否成功。true：成功，false：失败
msg	String	请求失败的信息，成功时为空
t	Long	返回时间戳，13 位
result	Object	返回结果

请求示例

POST /v1.0/light/devices/edu/purpose
{
  "device_ids": [
    "0Mmpmallta"
  ],
  "room_id": "f3OhK5UIub",
  "device_purpose": "basicLighting"
}

响应示例

{
  "success": true,
  "t": 1573441137
}

一键生成上课模式

功能描述

一键为教室配置上课模式场景。

接口地址

POST /v1.0/light/smart/edu-template/class

请求参数

参数名	类型	参数类型	说明	是否必需
roomId	String	body	空间 ID	true

返回参数

参数名	类型	说明
code	Integer	响应码（详情见错误码章节），成功时为空
success	Boolean	是否成功。true：成功，false：失败
msg	String	请求失败的信息，成功时为空
t	Long	返回时间戳，13 位
result	String	返回结果

请求示例

POST /v1.0/light/smart/edu-template/class

响应示例

{
  "success": true,
  "t": 1573441137
}

一键生成下课模式

功能描述

一键为教室配置下课模式场景。

接口地址

POST /v1.0/light/smart/edu-template/class-over

请求参数

参数名	类型	参数类型	说明	是否必需
roomId	String	body	空间 ID	true

返回参数

参数名	类型	说明
code	Integer	响应码（详情见错误码章节），成功时为空
success	Boolean	是否成功。true：成功，false：失败
msg	String	请求失败的信息，成功时为空
t	Long	返回时间戳，13 位
result	String	返回结果

请求示例

POST /v1.0/light/smart/edu-template/class-over

响应示例

{
  "success": true,
  "t": 1573441137
}

一键生成午休模式

功能描述

一键为教室配置午休模式场景。

接口地址

POST /v1.0/light/smart/edu-template/siesta

请求参数

参数名	类型	参数类型	说明	是否必需
roomId	String	body	空间 ID	true

返回参数

参数名	类型	说明
code	Integer	响应码（详情见错误码章节），成功时为空
success	Boolean	是否成功。true：成功，false：失败
msg	String	请求失败的信息，成功时为空
t	Long	返回时间戳，13 位
result	String	返回结果

请求示例

POST /v1.0/light/smart/edu-template/siesta

响应示例

{
  "success": true,
  "t": 1573441137
}

一键生成投影模式

功能描述

一键为教室配置投影模式场景。

接口地址

POST /v1.0/light/smart/edu-template/projection

请求参数

参数名	类型	参数类型	说明	是否必需
roomId	String	body	空间 ID	true

返回参数

参数名	类型	说明
code	Integer	响应码（详情见错误码章节），成功时为空
success	Boolean	是否成功。true：成功，false：失败
msg	String	请求失败的信息，成功时为空
t	Long	返回时间戳，13 位
result	String	返回结果

请求示例

POST /v1.0/light/smart/edu-template/projection

响应示例

{
  "success": true,
  "t": 1573441137
}

一键生成考试模式

功能描述

一键为教室配置考试模式场景。

接口地址

POST /v1.0/light/smart/edu-template/exam

请求参数

参数名	类型	参数类型	说明	是否必需
roomId	String	body	空间 ID	true

返回参数

参数名	类型	说明
code	Integer	响应码（详情见错误码章节），成功时为空
success	Boolean	是否成功。true：成功，false：失败
msg	String	请求失败的信息，成功时为空
t	Long	返回时间戳，13 位
result	String	返回结果

请求示例

POST /v1.0/light/smart/edu-template/exam

响应示例

{
  "success": true,
  "t": 1573441137
}

一键生成自习模式

功能描述

一键为教室配置自习模式场景。

接口地址

POST /v1.0/light/smart/edu-template/study

请求参数

参数名	类型	参数类型	说明	是否必需
roomId	String	body	空间 ID	true

返回参数

参数名	类型	说明
code	Integer	响应码（详情见错误码章节），成功时为空
success	Boolean	是否成功。true：成功，false：失败
msg	String	请求失败的信息，成功时为空
t	Long	返回时间戳，13 位
result	String	返回结果

请求示例

POST /v1.0/light/smart/edu-template/study

响应示例

{
  "success": true,
  "t": 1573441137
}

一键生成空间感应配置

功能描述

一键生成空间感应配置。

接口地址

POST /v1.0/light/smart/edu-template/reaction

请求参数

参数名	类型	参数类型	说明	是否必需
roomId	String	body	空间 ID	true

返回参数

参数名	类型	说明
code	Integer	响应码（详情见错误码章节），成功时为空
success	Boolean	是否成功。true：成功，false：失败
msg	String	请求失败的信息，成功时为空
t	Long	返回时间戳，13 位
result	String	返回结果

请求示例

POST /v1.0/light/smart/edu-template/reaction

响应示例

{
  "success": true,
  "t": 1573441137
}

错误码

以下为该接口常见的业务异常。更多的异常错误，请参见 全局错误码。

错误码	说明
500	系统错误