# CsharpNlecloud

**Repository Path**: youryouth/CsharpNlecloud

## Basic Information

- **Project Name**: CsharpNlecloud
- **Description**: 封装了新大陆的一些API（C#）
- **Primary Language**: C#
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 3
- **Forks**: 1
- **Created**: 2020-08-04
- **Last Updated**: 2021-03-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 更新说明

于2020-8-5号更新



<hr>



# 使用说明

项目工程需要添加NLECloudSDK的引用

新建一个类库Device，把代码复制，把缺少的引用添加。

封装的API使用了Console，可在项目右键属性->输出类型->改成控制台应用程序



# 	初始化Cloud

```csh

//传入设备ID.
Cloud cloud = new Cloud("90596");
```

<br>

在登录界面中如果使用了UserLogin，那么在其他窗体中，可以如下使用：

```cs
Cloud cloud = new Cloud();
cloud.cmds("xxx","xxx");
...
    ...
```





# 用户登录

```csharp
///<param name = "userName">用户名</param>
///<param name = "passWord">密码</param>
///<returns>true表示成功,false表示失败
///</returns>
bool UserLogin(String userName, String passWord);
```

例如：

```cs
bool flag = cloud.UserLogin("xxxx","xxxx");
```





<hr>

# 上传传感数据

```cs
///<param name = "sensorData">sensordata结构体</param>
///<returns>true表示成功,false表示设备不在线或传感器设备出错.
///</returns>
///<summary>上传传感数据</summary>
bool AddSensorData(sensorData sensordata);
bool AddSensorDatas(List<sensorData> sensorDatas);
```



例如：

上传一条数据，先声明结构体sensorData

```cs
var data = new sensorData
{
    apiTag = "Lux",
    time = "2020-08-02 01:01:01",
    value = "59"
};
bool flag = cloud.AddSensorData(data);
```



上传多条数据

```cs
List<sensorData> data = new List<sensorData>()
{
    new sensorData
    {
        apiTag = "Lux",
        time = "2020-08-02 01:01:01",
        value = "59"
    },
    new sensorData
    {
        apiTag = "Lux",
        time = "2020-08-02 01:01:01",
        value = "99"
    }
};
bool flag = cloud.AddSensorDatas(data);
```



<hr>

# 随机上传传感数据

```cs
/// <summary>
/// 随机上传传感数据
/// </summary>
/// <param name="apiTags">标识符数组</param>
/// <param name="minValue">随机最小值</param>
/// <param name="maxValue">随机最大值</param>
/// <param name="count">默认5条</param>
/// <returns>true表示成功,false表示失败</returns>
public bool RandomAddSensorDatas(String[] apiTags, int[] minValue, int[] maxValue, int count=5)
```

例如：

```cs
String[] apiTags = {"Lux","Humidity"};
int[]minValue = {0,10};
int[]maxValue = {1,20};
RandomAddSensorDatas(apiTags,minValue,maxValue);
RandomAddSensorDatas(apiTags,minValue,maxValue,10);
```





<hr>

# 控制命令

```cs
///<param name = "apiTag">传感器标识符</param>
///<param name = "data">数据</param>
///<returns>true表示成功,false表示设备不在线或传感器设备出错.
///</returns>
bool cmds(String apiTag,object data)
```

例如：

```cs
bool flag = cloud.cmds("Led","1");
```



<hr>

# 模糊查询传感数据

```cs
///<param name = "apiTag">传感器标识符</param>
///<param name="sort">排序方式</param>
///<summary>获取传感数据，会上抛异常，使用try..catch
///</summary>
///<returns>一个列表.value表示数据,time表示时间
///</returns>
List<Dictionary<string, string>> GetSensorDatas(String apiTag,String sort="DESC")
```

例如：

```cs
List<Dictionary<string, string>> sensorInfos = cloud.GetSensorDatas("Lux");
try{
    foreach (Dictionary<string, string> dictionary in sensorInfos)
    {
        Console.WriteLine(dictionary["value"], dictionary["time"]);
    }
}catch(Exception){
    Console.WriteLine("无此传感器");
}
```



<hr>

# 设备模拟在线

```cs
///<param name = "deviceTag">设备标识符</param>
///<param name = "secretKey">秘钥</param>
///<returns>true表示成功,false表示设备不在线或传感器设备出错.
///</returns>
///<summary>设备模拟在线</summary>
public bool DeviceOnline(String deviceTag,String secretKey)
```

例如：

```cs
bool flag = cloud.DeviceOnline("SmartHomeLucky", "4094ef2dbebf44b78601a54d2a39c451");
```



### 发送数据

```cs
///<param name = "sensor">sensorData结构体成员</param>
///<returns>true表示成功,false表示设备不在线或传感器设备出错.
///</returns>
///<summary>设备模拟发送数据</summary>
public bool SocketSendData(sensorData sensor)
```

例如：

```cs
var data = new sensorData()
{
    apiTag = "Lux",
    time = "2020-08-03 08:01:01",
    value = "400"
};
cloud.SocketSendData(data);
```



<hr>

# 查询单个传感器

```cs
/// <summary>
/// 查询单个传感器
/// </summary>
/// <param name="apiTag"></param>
/// <returns></returns>
public String GetSensorInfo(String apiTag)
```



例如：

```cs
cloud.GetSensorInfo("Lux");
```



<hr>

# 图表控件

**在nuget包中下载livechart.**

在xaml中声明

```xml
<Grid x:Name="mygrid">
        <lvc:CartesianChart Series="{Binding SeriesCollection}" LegendLocation="Left">
            <lvc:CartesianChart.AxisX>
                <lvc:Axis Title="Time" Labels="{Binding Labels}" FontSize="14"></lvc:Axis>
            </lvc:CartesianChart.AxisX>
            <lvc:CartesianChart.AxisY>
                <lvc:Axis MaxValue="50" MinValue="0" MinRange="2" MaxRange="10"/>
            </lvc:CartesianChart.AxisY>
        </lvc:CartesianChart>
    </Grid>
```

[![aBqBrT.png](https://s1.ax1x.com/2020/08/04/aBqBrT.png)](https://imgchr.com/i/aBqBrT)



在cs中

```cs
/// <summary>
    /// chart.xaml 的交互逻辑
    /// </summary>
    public partial class chart : Page
    {
        public SeriesCollection SeriesCollection { get; set; }
        public List<string> Labels { get; set; }
        private double[] _trend;
        private double[] temp = { 0,0,0,0,0,0 };
        private Cloud cloud = new Cloud();
        private String[] apiTags = { "Lux", "Humidity","Temperature" };
        public chart()
        {
            InitializeComponent();
            //实例化一条折线图
            SeriesCollection = new SeriesCollection { };
            _trend = new double[3];
            for (var i = 0; i < apiTags.Length; i++)
            {
                LineSeries mylineseries = new LineSeries();
                //设置折线的标题
                mylineseries.Title = apiTags[i];
                //折线图直线形式
                mylineseries.LineSmoothness = 0;
                //折线图的无点样式
                mylineseries.PointGeometry = null;
                //添加横坐标
                Labels = new List<string> { "0", "0", "0", "0", "0", "0" };
                //添加折线图的数据
                mylineseries.Values = new ChartValues<double>(temp);
                SeriesCollection.Add(mylineseries);
                _trend[i] = i;
            }
            linestart();
            DataContext = this;
        }
        //连续折线图的方法
        public void linestart()
        {
            Task.Run(() =>
            {
                while (true)
                {

                    read();
                    Thread.Sleep(2000);
                    //通过Dispatcher在工作线程中更新窗体的UI元素
                    Application.Current.Dispatcher.Invoke(() =>
                    {
                        //更新横坐标时间
                        Labels.Add(DateTime.Now.ToString());
                        Labels.RemoveAt(0);
                        //更新纵坐标数据
                        for(var i = 0; i < apiTags.Length; i++)
                        {
                            SeriesCollection[i].Values.Add(_trend[i]);
                            SeriesCollection[i].Values.RemoveAt(0);
                        }
                    });
                }
            });
        }
        private void read()
        {
            for (var i = 0; i < apiTags.Length; i++)
            {
                _trend[i] = Convert.ToDouble(cloud.GetSensorInfo(apiTags[i]));
            }
            //随机上报数据
            List<sensorData> sensorDatas = new List<sensorData>();
            var r = new Random();
            for (var i = 0; i < apiTags.Length; i++)
            {
                sensorData sensor = new sensorData()
                {
                    apiTag = apiTags[i],
                    value = r.Next(30, 40).ToString(),
                    time = DateTime.Now.ToString()
                };
                sensorDatas.Add(sensor);
            }

            cloud.AddSensorDatas(sensorDatas);
        }
```



[![aBOODf.png](https://s1.ax1x.com/2020/08/04/aBOODf.png)](https://imgchr.com/i/aBOODf)