# 七、设备
# （一）概述
设备数据是登记在门户系统中的物联产品。
# （二）设备集合[DeviceSet]
设备集合是设备要素的集合，用户可按实际需求将不同设备要素划分到不同的设备集合中去。每个设备仅能从属于一个设备集合。其常用属性如下：
| 属性名 | 值类型 | 属性描述 |
|---|---|---|
| name | String | 设备集合名称 |
| remark | String | 备注 |
| icon | Icon | 图标 |
| symbol | PointSymbol | 点符号 |
| deviceProduct | DeviceProduct | 设备产品分类 |
| isPublish | Boolean | 是否发布 |
常用方法如下：（get/set方法略）
| 方法名 | 返回类型 | 方法描述 |
|---|---|---|
| queryDevices | void | 查询集合下的所有设备要素 |
| createDevice | void | 创建设备 |
| updateDevice | void | 更新设备信息 |
| deleteDevice | void | 删除设备 |
| queryMonitorConfig | void | 获取监控量配置信息 |
# 1、获取设备集合
初始化成功后，可直接从Cellsys的organization对象中获取到组织下所有的设备集合。
/*执行初始化成功后，可直接获取到设备集合*/
let deviceSets = Cellsys.shared.organization.deviceSets //deviceSets可能为nil
if (deviceSets != nil ) {
let deviceSet = deviceSets.first
let name = deviceSet.name //集合名称
let remark = deviceSet.remark //集合备注信息
let deviceProduct = deviceSet.deviceProduct
let icon = deviceSet.icon //获取图标对象
let pointSymbol = deviceSet.symbol//获取地图符号对象
}
1
2
3
4
5
6
7
8
9
10
2
3
4
5
6
7
8
9
10
# （1）获取监控量配置信息
不同的设备产品有不同的监测功能，提供不同的监控量信息。如 产品-温湿度传感器 会提供“温度”、“湿度”两种监控量。而升级版产品-野外气象站，除了“温度”、“湿度”外，还会提供“光照强度”、“风向”、“风速”等监控量。
而这些配置信息可以从设备集合对象中查询。查询方法如下：
//查询配置信息
deviceSet.queryMonitorConfig { obj, errorMessage in
//成功
if (obj != nil) {
let monitorConfigs = object.data
for monitorConfig in monitorConfigs {
let dataType = monitorConfig.dataType//获取监控量类型
let monitorMetaDatas = monitorConfig.monitorMetaDatas
for monitorMetaData in monitorMetaDatas {
let name = monitorMetaData.name //监控值名称,例：温度
let key = monitorMetaData.key//监控值key,例：temperture
let unit = monitorMetaData.measureUnit //监控值单位，例：℃
let formatType = monitorMetaData.formatType//数据格式类型
}
}
}
//失败
if (errorMessage != nil) {
let errorCode = errorMessage?.code //错误码
let errorMsg = errorMessage?.message //错误信息
}
});
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
# 2、新增设备集合
设备集合通过组织[Organization]对象创建。具体操作见代码示例：
organization.createDeviceSet(name: "设备集合名称", remark: "备注信息", deviceProduct: DeviceProduct.DriftingBall, icon: Icon.new(jsonIcon: ["iconId": 205,"rotate": 0,"fillColor":"#096dd9","fillOpacity": 1])!) { obj, errorMessage in
//成功
if (obj != nil) {
let deviceSet = obj?.data as? DeviceSet
}
//失败
if (errorMessage != nil) {
let errorCode = errorMessage?.code //错误码
let errorMsg = errorMessage?.message //错误信息
}
}
1
2
3
4
5
6
7
8
9
10
11
2
3
4
5
6
7
8
9
10
11
# 3、修改设备集合
设备集合通过组织[Organization]对象修改。具体操作见代码示例：
deviceSet.remark = "修改备注信息"
organization.updateDeviceSet(deviceSet: deviceSet) { obj, errorMessage in
//成功
if (obj != nil) {
}
//失败
if (errorMessage != nil) {
let errorCode = errorMessage?.code //错误码
let errorMsg = errorMessage?.message //错误信息
}
}
1
2
3
4
5
6
7
8
9
10
11
2
3
4
5
6
7
8
9
10
11
# 4、删除设备集合
设备集合通过组织[Organization]对象删除。具体操作见代码示例：
organization.deleteDeviceSet(deviceSet: deviceSet) { obj, errorMessage in
//成功
if (obj != nil) {
}
//失败
if (errorMessage != nil) {
let errorCode = errorMessage?.code //错误码
let errorMsg = errorMessage?.message //错误信息
}
}
1
2
3
4
5
6
7
8
9
10
2
3
4
5
6
7
8
9
10
# （三）设备要素[DeviceFeature]
一个实体设备可用一个设备要素对象表示。其常用属性如下：
| 属性名 | 值类型 | 属性描述 |
|---|---|---|
| name | String | 设备集合名称 |
| remark | String | 备注 |
| icon | Icon | 图标 |
| symbol | PointSymbol | 点符号 |
| location | Location | 设备位置 |
| bluetoothMac | MacAddress | 设备蓝牙Mac地址 |
| bindMember | CommonInfo | 设备关联人员的简易信息 |
设备要素的常用方法如下：（get/set方法略）
| 方法名 | 返回类型 | 方法描述 |
|---|---|---|
| queryMonitorReports | void | 查询监控量报告 |
| queryBindMember | void | 查询具体的关联人员信息 |
# 1、获取设备要素
设备集合[DeviceSet]提供了query方法来查询自身集合中的设备要素。具体操作见代码示例:
deviceSet.queryDevices { obj, errorMessage in
//成功
if (obj != nil) {
/*分页信息-查询方法特有*/
let pageInfo = object.pageInfo //查询接口特有的分页信息
let totalCount = pageInfo.totalCount //数据总数
let totalPage = pageInfo.totalPage //总页数
let pageNo = pageInfo.pageNo //当前页码(从1开始）
let pageSize = pageInfo.pageSize //每页查询数量（注意！不一定和当前查询的数据总量匹配）
/*获取查询结果*/
let deviceFeatures = object.data
if (deviceFeatures != nil ) {//查询结果可能为nil
for deviceFeature in deviceFeatures {
/*设备要素基础信息获取示例*/
let name = deviceFeature.name //设备要素名称
let remark = deviceFeature.remark //备注
let pointSymbol = deviceFeature.symbol //路线符号
let location = deviceFeature.location //设备位置,可能为null
let macAddress = deviceFeature.bluetoothMac
let mac = macAddress.formatString //formatString是带冒号的标准格式，如：10:51:1C:65:48:3E
let bindMemberInfo = deviceFeature.bindMember
let binderName = bindMemberInfo.name //绑定人姓名
}
}
}
//失败
if (errorMessage != nil) {
let errorCode = errorMessage?.code //错误码
let errorMsg = errorMessage?.message //错误信息
}
});
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
# （1）获取监控量报告[MonitorReport]
登记在[Cellsys 时空管理平台](广州空天通讯技术服务有限公司 (airkoon.com) (opens new window))上的物联产品中，有通讯联网（包括互联网、卫星通讯、其他无线通讯技术）能力的设备可将数据回传到云设备上，形成监控报告。目前监控报告主要由传感器产品回传，显示产品监测到的环境数值。
deviceFeature.queryMonitorReports { obj, errorMessage in
//成功
if (obj != nil) {
let monitorReports = object.data
if (monitorReports != nil ) {
for monitorReport in monitorReports {
/*监控报告数据*/
let dateTime = monitorReport.reportTime //监控报告汇报时间
let monitorItems = monitorReport.monitorItems
for monitorValue in monitorItems {
let formatString = monitorValue.formatString //监控报告项的格式化输出（不同报告项有不同的输出结果）。用于界面显示。例：99.3%
let name = monitorValue.name//监控量名称。例：电量
let value = monitorValue.value//监控量数值。例99.3
let unit = monitorValue.measureUnit//监控量单位。例：%
}
}
}
}
//失败
if (errorMessage != nil) {
let errorCode = errorMessage?.code //错误码
let errorMsg = errorMessage?.message //错误信息
}
});
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
# （2）查询绑定的成员
注意：一个设备只能与一个成员进行关联绑定。当有其他成员绑定设备时，会自动与之前的成员解绑。
deviceFeature.queryBindMember { obj, errorMessage in
//成功
if (obj != nil) {
let memberFeature = object.data.first//绑定人信息
}
//失败
if (errorMessage != nil) {
let errorCode = errorMessage?.code //错误码
let errorMsg = errorMessage?.message //错误信息
}
});
1
2
3
4
5
6
7
8
9
10
11
12
2
3
4
5
6
7
8
9
10
11
12
# （3）设备Mac
let bluetoothMac = deviceFeature.bluetoothMac //设备Mac信息
let formatStringMac = bluetoothMac.formatString //带冒号的标准格式,例：AA:BB:CC:DD:EE:FF
let valueMac = bluetoothMac.value //不带冒号，例：AABBCCDDEEFF
1
2
3
2
3
设备的Mac地址使用MacAddress类，可避免设备Mac字符串格式不统一问题。
# （4）设备定位
let location = deviceFeature.location //设备定位信息
let mapPoint = location.mapPoint //定位坐标
let coordinateSystem = mapPoint.coordinateSystem //定位坐标系
let latitude = mapPoint.latitude //纬度
let longitude = mapPoint.longitude //经度
let dateTime = location.time //定位时间
let timeStamp = dateTime.value //定位时间的时间戳格式（毫秒级）
1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
Location定位类，同时包含定位坐标、定位时间两样数据。
# 2、新增设备要素
设备集合[DeviceSet]提供了create方法来新增自身集合中的设备要素。具体代码示例如下：
let name = "设备名称"
let remark = "备注信息"
let mac = MacAddress.new(value: "AABBCCDAFEDD")
deviceSet.createDevice(name: name, remark: remark, mac: mac) { obj, errorMessage in
//成功
if (obj != nil) {
let device = obj?.data as? DeviceFeature
}
//失败
if (errorMessage != nil) {
let errorCode = errorMessage?.code //错误码
let errorMsg = errorMessage?.message //错误信息
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
2
3
4
5
6
7
8
9
10
11
12
13
14
# 3、修改设备要素
设备集合[DeviceSet]提供了update方法来修改自身集合中的设备要素。具体代码示例如下：
device.remark = "备注信息"
deviceSet.updateDevice(device: device, callback: { obj, errorMessage in
//成功
if (obj != nil) {
}
//失败
if (errorMessage != nil) {
let errorCode = errorMessage?.code //错误码
let errorMsg = errorMessage?.message //错误信息
}
})
1
2
3
4
5
6
7
8
9
10
11
12
2
3
4
5
6
7
8
9
10
11
12
# 4、删除设备要素
设备集合[DeviceSet]提供了delete方法来修改自身集合中的设备要素。具体代码示例如下：
deviceSet.deleteDevice(device: device) { obj, errorMessage in
//成功
if (obj != nil) {
}
//失败
if (errorMessage != nil) {
let errorCode = errorMessage?.code //错误码
let errorMsg = errorMessage?.message //错误信息
}
}
1
2
3
4
5
6
7
8
9
10
11
2
3
4
5
6
7
8
9
10
11
# 5、设备的绑定与解绑
设备与成员的绑定、解绑操作有成员要素[MemberFeature]发起。具体代码示例如下：
/*设备绑定*/
memberFeature.bindDevice(device: device) { obj, errorMessage in
//成功
if (obj != nil) {
}
//失败
if (errorMessage != nil) {
let errorCode = errorMessage?.code //错误码
let errorMsg = errorMessage?.message //错误信息
}
}
/*设备解绑*/
memberFeature.unbindDevice(device: device) { obj, errorMessage in
//成功
if (obj != nil) {
}
//失败
if (errorMessage != nil) {
let errorCode = errorMessage?.code //错误码
let errorMsg = errorMessage?.message //错误信息
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25