监听实时数据推送-JAVA SDK-有人云

> 监听云平台推送的数据，所有数据都需要订阅后才可以收到推送的数据，订阅前必须先定义回调，相同的推送仅需订阅一次即可

### 联网设备数据点数据监听
#### 说明
接收联网设备下发数据点实时数据推送
#### 函数
订阅所有联网设备数据点数据：`subscribeAllDeviceDataPoint()`
订阅某个联网设备数据点数据：`subscribeDeviceDataPoint(String deviceId)`
数据回调：`setDeviceDataPointHandler(callback)`
* callback: 回调函数，参数(String deviceId,DeviceDataPointReceiveDto deviceDataPointReceiveDto)
	* deviceId:设备sn
	* deviceDataPointReceiveDto
		* deviceId：设备sn
		* deviceName: 设备名称
		* dataPoints: 数据点信息列表
			* dataPointId:数据点id
			* slaveName：从机名称
			* variableName：变量名称
			* value：值
			* timeMs: 时间戳（毫秒）
			* err：错误码
			            //   0：正常，非0异常。
                        //   1：从机无应答  
                        //   2：从机给了一个错误应答   
                        //   3：无法连接
                        //  4: 无此key
                        //   5：NaN（无效数）
                        //   6：-NaN（无效数）
                        //   7：INF（无穷大）
                        //   8：-INF（无穷大）
                        //   20、crc校验错误
                        //   21、寄存器地址不存在
                        //   22、非法的数据值
                        //   23、从机设备故障
                        //   24、从机设备忙
					
			
			
#### 示例

```java
 usrCloud.setDeviceDataPointHandler((deviceId, deviceDataPointReceiveDto) -> {
            System.out.println("deviceId:" + deviceId);
            deviceDataPointReceiveDto.getDataPoints().forEach((item) -> {
                System.out.println("data point id:" + item.getDataPointId() + "value:" + item.getValue());
            });
        });
        //订阅指定设备数据点数据推送
        usrCloud.subscribeDeviceDataPoint("deviceId123");
```

### 订阅场景数据点推送
#### 函数
订阅所有场景数据点数据推送：subscribeAllSceneDataPoint()
订阅某个场景数据点数据推送：subscribeSceneDataPoint(Integer sceneId)
回调：setSceneDataPointHandler(callback)
* callback: 回调函数，参数(Integer sceneId, SceneDataPointReceiveDto sceneDataPointReceiveDto)
	* sceneId:场景id
	* sceneDataPointReceiveDto：
		* dataPoints：数据点列表
			* sceneDataPointId:场景数据点列表
			* value：值
			* timeMs: 时间戳（毫秒）
			* err:
					//   0：正常，非0异常。
					//   1：从机无应答  
					//   2：从机给了一个错误应答   
					//   3：无法连接
					//   4: 无此key 
					//   5：NaN（无效数）
					//   6：-NaN（无效数）
					//   7：INF（无穷大）
					//   8：-INF（无穷大）
					//   20、crc校验错误
					//   21、寄存器地址不存在
					//   22、非法的数据值
					//   23、从机设备故障
					//   24、从机设备忙

#### 示例

```java
usrCloud.setSceneDataPointHandler((sceneId, sceneDataPointReceiveDto) -> {
      System.out.println("sceneId:" + sceneId);
      sceneDataPointReceiveDto.getDataPoints().forEach((item) -> {
      	System.out.println("data point id:" + item.getSceneDataPointId() + "value:" + item.getValue());
      });
});
//订阅场景数据点数据推送
usrCloud.subscribeAllSceneDataPoint();
```

### 订阅联网设备透传数据推送
> 注：只有设备绑定透传模板且没有开启透传组才可以接收到透传数据推送

#### 函数
订阅某个联网设备透传数据推送：subscribeTransmission(String deviceId)
订阅所有联网设备透传数据推送：subscribeTransmission()
回调：setTransmissionHandler(callback)
* callback: 回调函数，参数(String deviceId, byte[] content)
	* deviceId:设备sn
	* content：byte[]类型原始数据

#### 示例

```java
usrCloud.setTransmissionHandler((deviceId, content) -> {
       System.out.println("deviceId:" + deviceId);
       System.out.println("content:" + new String(content));
});
usrCloud.subscribeTransmission();
```