文档首页> 应用魔方 AppCube> 快速入门> 进阶实战> 智慧烟感行业应用开发> 步骤2：自定义应用

更新时间：2022-04-27 GMT+08:00

查看PDF

步骤2：自定义应用

添加并配置设备

该应用已预置监控4个设备数据，您可新增需要监控的设备，例如新增智慧烟感和监控摄像头设备，并设置告警触发阈值。智慧烟感设备需要关联相应的摄像头，用于进行实时监控。该章节将逐步指导您完成这些操作。

新增设备属性“关联设备”，该属性值用于标识烟感设备所关联的具体摄像头设备。

登录AppCube开发环境，单击页面上方的“管理”，进入管理台页面。
选择“应用管理 > BO配置”，单击具体的BO“Device”，该BO主要提供设备实例管理接口以及设备规格属性的相关配置。
图1 选择“Device”
选择“设备属性配置 > 属性定义”，单击“新建”。
图2 新增设备属性

如下图所示新增属性，单击“保存”。

图3 新增属性定义

图4 配置属性名称

表1 参数说明
参数名	参数说明	本实例需要填写的值
属性编码	属性的编码。	relatedDevice
属性名称	属性的名称，为多语言字段。	单击该参数配置框时弹出“多语言信息”界面，选中“创建或更新多语言”，设置“名称”为“relatedDevice”，“中文”为“关联设备”。单击“确定”。
属性类型	属性的类型。	AttrString

基于“智慧烟感”模板创建应用后，系统预置了“SmokeDetector”设备规格，编辑该设备规格，为其增加自定义设备规格属性，用于映射烟感上报的数据字段。

在BO“Device”配置页面，选择“设备规格配置 > 设备规格定义”，在标识符中输入“SmokeDetector”，单击搜索，在搜索结果列表单击编辑按钮。
图5 编辑“SmokeDetector”
选择“属性”页签，单击“新建”。
图6 新建属性

按表2中的信息，在“属性”页签依次新增如图7、图8及图9所示3个设备规格属性，单击“确定”。

表2 设备规格属性
名称	属性类型	属性定义	外部编码	备注
RelatedDevice 手动填写	INSTANCE 下拉框选择	选择“relatedDevice”。该属性为1新增的“关联设备”属性。	RelatedDevice 手动填写，外部编码不同于属性定义中的属性编码，外部编码值需要区分大小写。	关联设备
AlarmStatus 手动填写	DYNAMIC 下拉框选择	选择“alarmStatus”。该属性由系统已预置好。	AlarmStatus 手动填写	设备告警状态
Smoke_Value 手动填写	DYNAMIC 下拉框选择	选择“OverCurrent”。该属性由系统已预置好。	Smoke_Value 手动填写	烟雾值

【信息】属性类型“INSTANCE”表示实例属性，在设备实例中需要设置具体的值；属性类型“DYNAMIC”表示动态属性，属性值随时间会动态变化，具体的值要从设备上读取出来（或上报）。

“RelatedDevice”表示关联的摄像头设备，设备实例中需要配置为对应监控摄像头设备的拉流地址，每个具体摄像头的地址不同，该规格属性的属性类型需要配置为“INSTANCE”。“AlarmStatus”表示设备当前的告警状态，“Smoke_Value”表示设备的烟雾值，两者的值都是动态变化的，都需要配置为动态属性“DYNAMIC”。

图7 新增规格属性“RelatedDevice”

图8 新增规格属性“AlarmStatus”

图9 新增规格属性“Smoke_Value”

单击“保存”。
图10 保存设备规格定义

配置好设备规格属性后，在“Facility Management”设施管理应用中新增监控摄像头以及烟雾传感器设备实例。

在AppCube开发环境上方单击“首页”，选择“库”页签，单击“Facility Management”。“Facility Management”主要用于设备实例的管理功能，包括新增、禁用删除以及设备告警触发器的配置。
图11 进入“Facility Management”应用
在应用开发工作台左侧菜单栏单击，预览该应用。

在“设施信息管理”中依次单击“创建”，新增监控摄像头设备实例“我的摄像头”以及烟雾传感器设备实例“我的烟雾传感器”。

图12 新增摄像头设备

图13 新增烟雾传感器设备

表3 设备信息
外部编码	设备名称	设备规格	设备来源	状态	位置	经纬度	设备属性
CameraDevice001	我的摄像头	摄像头	VideoCloudHUAWEI 当选择设备规格后，设备来源会自动填入。	已启用保持默认	广东省	经度：114.08042542384054 纬度：22.538485490748407	动态属性中配置保持默认，在实例属性中配置“摄像机类型”属性值为“1”，用于标识固定枪机。
SmokeDevice001	我的烟雾传感器	消防烟感	basepoint.connectionmax.iot 当选择设备规格后，设备来源会自动填入。	已启用保持默认	广东省	经度：114.0804217282 纬度：22.5408551761	动态属性中配置保持默认，在实例属性中配置“关联设备”属性值为“CameraDevice001”，用于烟感设备关联到摄像头。

当“设备规格”选择“摄像头”或者“消防烟感”后，设备来源会自动填入。请勿手动设置“设备来源”，若“设备来源”手动设置错误，前端页面将不会显示告警数据。

在设备实例上新增设备告警触发器，用于监听设备实例“我的烟雾传感器”属性值的变化，超过阈值时触发报警。

预览应用“Facility Management”，在“设施告警配置”中单击“新建”。
图14 新建触发器

参考配图15和表4置触发器，单击“保存”。

图15 配置触发器

表4 触发器基本信息
参数名	参数说明	本实例需要填写的值
触发器名称	触发器实例名称，可自定义命名。	SmokeAlarmTrigger
触发器规格	系统已默认配置以下三种触发器：状态报警触发器：当设备状态发生变化并满足告警规则定义的条件时业务应用产生相应的告警。原始报警触发器：设置原始报警规则，当设备发生变化并满足告警规则定义时产生相应的告警。阈值报警触发器：当设备指标满足告警规则定义的阈值条件时业务应用产生相应的告警。	阈值报警触发器
触发器状态	触发器的状态，分启用、禁用。	启用
设备类型	设备的类型。	设备
关联设备	选择上一步创建的“我的烟雾传感器”。	我的烟雾传感器
动态属性	触发器监测的设备实例的动态属性，选择2.c中自定义的动态属性烟雾值，对应的属性定义为“OverCurrent”。	OverCurrent
生效时间	触发器生效起始时间。生效时间需要早于失效时间。	例如设置为当前时间
失效时间	触发器失效时间。	设置将来某一时间
告警规格编码	选择在告警BO中已预置好的烟感告警，对应告警规格编码为“SmokeDetectorAlarm”。	SmokeDetectorAlarm
告警级别	系统已默认配置四种告警级别：提示、普通、重要、严重	重要
告警状态属性编码	解除告警消息的属性编码。	alarmStatus
高阈值	烟雾浓度高值，上报大于此值将会触发告警。	200
低阈值	烟雾浓度低数值，上报小于此值将会触发告警。	--

预览验证

功能测试主要通过Postman模拟消息上报，通过数据接入接收消息转化为平台内部事件，再经过设备BO、告警BO的自动处理分析，生成告警并在页面上展示，此外还可以进行发送告警短信、关联摄像头查看以及告警自动清除等功能。

登录AppCube开发环境，在首页，单击“我的应用”下的“智慧烟感”，进入应用。
运行数据接入，运行后，可接收烟感数据变化的消息上报，并生成数据推送地址。
1. 选中“Logic”文件夹下的“FireAlarm_SmokeAlarmData Acces”，在页面上方单击，运行数据接入。
  图16 运行数据接入
  
  在数据接入页面，鼠标悬浮在图标元素上，单击，可查看具体配置信息。应用创建后，默认已配置好该数据接入且数据接入处于启用状态，不可编辑，在页面上方单击禁用图标，之后才可编辑，编辑后需要保存并单击启用。数据接入的具体配置请参考配置数据接入章节。
  图17 禁用或查看配置
  
   图18 查看输入源的元数据定义
2. 在运行成功的提示框中复制数据推送地址（即https打头的地址），并进行保存，在后续Postman模拟消息发送请求时需要使用该地址。
  图19 运行成功
在应用开发工作台左侧菜单栏单击，预览该应用。

使用Postman发送请求，模拟消息上报。

在本地PC上下载并安装Postman工具，该工具仅用于测试使用。

使用Postman测试模拟数据变化时上报消息至AppCube。其中POST请求的URL配置为运行数据接入后生成的数据推送地址，请从2.b获取该地址；参考表5填写Body参数。

图20 Postman测试推送数据变化消息至应用端

表5 消息体说明
参数名	参数说明	本实例需要填写的值
notifyType	字段名必须要数据接入中输入源的元数据图18定义一致，为设备自身信息变化的接口标识。取值固定，不要修改。	deviceDataChanged
requestId	字段名必须要数据接入元数据一致，用于标识此次请求。值可修改，修改的值可标识该请求即可。	a57f3a1a-fbe8-4511-acc5-1333297e9d18
deviceId	字段名必须要数据接入元数据一致，标识是哪个设备。当前场景模拟生成烟雾告警，值与在表3中配置的“我的烟雾传感器”的“设备编码”的值保持一致。	SmokeDevice001
gatewayId	字段名必须要数据接入元数据一致，实际对接时，需要的字段。在用Postman模拟发送请求时，可随意修改该值。	GW001
platformId	字段名必须要数据接入元数据一致，标识自身是什么设备。当前场景模拟生成烟雾告警，值与在表3配置的“我的烟雾传感器”的“设备来源”的值保持一致。	basepoint.connectionmax.iot
Smoke_Value	字段名必须与设备规格属性一致，标识设备的烟雾值。当前场景模拟生成烟雾告警，值必须大于设备的高阈值或者低于设备的低阈值。高阈值或者低阈值在表4配置过。例如之前在表4配置的高阈值为“200”，则“Smoke_Value”字段值请填200以上，例如配置为“201”，会生成烟雾告警。	201

Body中填入如下参数：

{
   "notifyType":"deviceDataChanged",     
   "requestId":"a57f3a1a-fbe8-4511-acc5-1333297e9d18",      
   "deviceId":"SmokeDevice001",      
   "gatewayId":"GW001",     
   "platformId":"basepoint.connectionmax.iot",    
   "service": {          
                "data": { 
                           "Smoke_Value":"201" 
                 }      
              }  
}

查看预览应用页面告警页面，出现告警的警报显示。
图21 警报显示页面

若出现问题：页面没有显示警报，可在数据接入编辑页面上方单击，下载日志，查看日志进行定位。在右侧选择“消息跟踪”页签，单击“启动”，可启动消息跟踪，查看上报的报文处理情况。
图22 调试并进行消息跟踪
单击左侧告警列表中的记录时，可以看到烟感设备关联摄像头的视频流，打开发送告警短信开关，填入手机号，可发送告警信息给相关责任人。

请事先启动浏览器Chrome的Flash功能，启动方法：在Chrome的“设置 > 隐私设置和安全性 > 网站设置 > Flash”中开启“禁用网站运行Flash（推荐）”。

图23 查看视频流并发送告警短信

图24 短信消息内容

将Postman模拟发送Body中的数据“Smoke_Value”改成小于200的值，例如“100”，发送请求，“SmokeDevice001”设备我的烟雾传感器上的告警消失。

图25 修改烟雾值低于阈值

{ 
    "notifyType":"deviceDataChanged", 
    "requestId":"a57f3a1a-fbe8-4511-acc5-1333297e9d18", 
    "deviceId":"SmokeDevice001", 
    "gatewayId":"GW001", 
    "platformId":"basepoint.connectionmax.iot",
    "service": { 
        "data": { "Smoke_Value":"100" } 
    } 
}