Remote+
功能说明
通过Remote+功能创建一个由控件组成的网页，可用于远程控制M5Stack设备。该页面与设备的API KEY相关联，将长期保存在M5服务中，并提供固定的访问链接，用户可随时随地访问与分享设备信息或远程操控设备。
注意:
1. 该功能需使用在线版UIFlow
2. 离线下载运行时，需添加WiFi连接程序至setup.
查看WiFi连接程序说明
3. 使用前需先推送程序，然后才可以获取访问页面的二维码/URL
QRCODE
在程序块菜单中，REMOTE+提供了一个绘制二维码block，能够将访问控制网页的URL通过二维码的形式显示到设备屏幕上。
点击Remote+功能，在页面的右侧将出现预览窗口用于添加控件，用户可以通过拖拽的方式，往页面空白处添加控件。
在配置好所有控件且完成程序推送后，点击预览窗口上方的二维码能够获取控制页面链接。
Remote qrcode show in x y size
- 指定二维码的size(宽度)，以及显示位置的坐标x, y
Title
添加一个文本Title到控制页面中
控件属性
| 属性 | 描述 |
|---|---|
| Label | Title内容 |
| Color | Title字体颜色 |
| Background | Title背景颜色 |
| Font Size | Title字体大小 |
Button
添加一个触控按键到控制页面中, 每添加一个按键，在编程区域将自动生成一个对应的Callback函数, 按下按键后将触发执行函数的内容。
控件程序
Button x Callback
- 按下按键后将触发执行函数的内容
控件属性
| 属性 | 描述 |
|---|---|
| Name | 控件标题 |
| Show Title | 是否显示控件标题 True/False |
| Color | Title字体颜色 |
| Background | Title背景颜色 |
| Edges | 按键边缘样式， sharp/Pill |
| Style | 设置按键填充样式. Outline/Solid |
Switch
添加一个切换开关到控制页面中, 每添加一个切换开关，在编程区域将自动生成一个对应的Callback函数, 开关动作时将触发执行函数的内容，并通过变量switch_value传递开关状态。
控件程序
Switch x Callback with: switch_value
- 开关动作时将触发执行函数的内容，并通过变量
switch_value传递开关状态。switch_value: 1(ON)/0(OFF)
控件属性
| 属性 | 描述 |
|---|---|
| Name | 控件标题 |
| Show Title | 是否显示控件标题 True/False |
| Off Label | 关闭状态标识 |
| On Label | 打开状态标识 |
| Off Color | 关闭状态字体颜色 |
| On Color | 打开状态字体颜色 |
| Off Background | 关闭状态背景颜色 |
| On Background | 打开状态背景颜色 |
Slider
添加一个滑动条到控制页面中, 每添加一个滑动条，在编程区域将自动生成一个对应的Callback函数, 滑动条动作时将触发执行函数的内容，并通过变量slider_value传递开关状态。
控件程序
Slider x Callback with: slider_value
- 滑动条动作时将触发执行函数的内容，并通过变量
slider_value传递滑动条位置状态。slider_value: 可通过控件属性配置数值范围。
控件属性
| 属性 | 描述 |
|---|---|
| Name | 控件标题 |
| Show Title | 是否显示控件标题 True/False |
| Show Value | 是否显示当前滑动条数值 True/False |
| Color | 滑动条颜色 |
| Min Value | 滑动条范围最小值 |
| Max Value | 滑动条范围最大值 |
Label
添加一个显示标签到控制页面中, 每添加一个显示标签，在编程区域将自动生成一个对应的Event定时器函数, 设备程序运行时将自动按照指定间隔时间上传数据内容(默认间隔为3000ms)，上传的内容将自动更新显示到页面控件上。
控件程序
Label 1 Event interval(ms): 3000 Set Data x
- 设备程序运行时将自动按照指定间隔时间上传数据内容(默认间隔为3000ms)，上传的内容将自动更新显示到页面控件上。可通过控件属性配置上传间隔，建议间隔大于3000ms。
控件属性
| 属性 | 描述 |
|---|---|
| Name | 控件标题 |
| Show Title | 是否显示控件标题 True/False |
| Font Size | 文本字体大小 |
| Color | 数据文本显示颜色 |
| Interval(ms) | 数据上报间隔时间/ms |
Input
添加一个输入文本框到控制页面中, 每添加一个输入文本框，在编程区域将自动生成一个对应的Callback函数, 输入框文本变动时将触发执行函数的内容，并通过变量input_value传递输入文本。
控件程序
Input 1 Callback with:input_value
- 输入框文本变动时将触发执行函数的内容，并通过变量
input_value传递输入文本。
控件属性
| 属性 | 描述 |
|---|---|
| Name | 控件标题 |
| Show Title | 是否显示控件标题 True/False |
| Font Size | 文本字体大小 |
| Color | 数据文本显示颜色 |
| Hint | - 输入文本提示 |
| Character Limit | 输入字符长度限制，默认为8 |
Image
添加一个图像控件到控制页面中, 访问控制页面时候，页面将按照指定间隔时间向指定URL获取图片数据(默认间隔为3000ms)，并更新显示到页面控件上。
控件属性
| 属性 | 描述 |
|---|---|
| Name | 控件标题 |
| Show Title | 是否显示控件标题 True/False |
| Interval(ms) | 数据上报间隔时间/ms |
| Fallback URL | 请求的图像的URL |
Stepper
添加一个Stepper到控制页面中, 每添加一个滑动条，在编程区域将自动生成一个对应的Callback函数, Stepper动作时将触发执行函数的内容，并通过变量stepper_value传递当前数值状态。
控件程序
Stepper x Callback with: stepper_value
- Stepper动作时将触发执行函数的内容，并通过变量
stepper_value传递当前数值状态。
控件属性
| 属性 | 描述 |
|---|---|
| Name | 控件标题 |
| Show Title | 是否显示控件标题 True/False |
| Min Value | Stepper范围最小值 |
| Max Value | Stepper范围最大值 |
| Step | 设置每次点击的Step值 |
Chart
添加一个图标到控制页面中, 该图标需通过 Ezdata功能 指定数据来源，支持配置图表刷新间隔与基本样式。
注意:
1. 使用前请点击此处，了解Ezdata的基本使用
2. Ezdata结合Chart使用, 需使用到的数据保存方式是 List，不是 Topic
3. 传递数据时候需要使用map(字典)传递key-value形式的数据。其中key需要对应chart控件中的X，Y Data Source字段, 如留空会造成数据无法显示。
控件属性
| 属性 | 描述 |
|---|---|
| Name | 控件标题 |
| Show Title | 是否显示控件标题 True/False |
| Theme | 设置图表主题 Light/Dark |
| Color | 设置图表元素颜色 |
| Chart Type | 设置图表类型, Bar/Line |
| Interval(ms) | 设置图表刷新间隔 |
| Show Legend | 显示图例 True/False |
| Dataset Name | 配置数据集名称 |
| Y Axis Label Suffix | 配置Y轴数据后缀 |
| EzData Token | 配置EzData数据源Token |
| List | EzData数据源的指定List |
| X Data Source | 设置List数据中的某一字段为X轴内容 (通常使用时间作为数据，形成历史记录) |
| Y Data Source | 设置List数据中的某一字段为Y轴内容 (通常使用监测内容作为数据，形成数据变化趋势) |
| Max Count | 当前图表最大显示数据量 |
Joystick
添加一个摇杆控件到控制页面中, 每添加一个摇杆控件，在编程区域将自动生成一个对应的Callback函数, 摇杆控件移动时将触发执行函数的内容，并通过变量joystick_x_value和joystick_y_value传递当前摇杆状态。
控件程序
Jpystick x Callback with: joystick_x_value,joystick_y_value
- 摇杆控件移动时将触发执行函数的内容，并通过变量
joystick_x_value和joystick_y_value传递当前摇杆状态
控件属性
| 属性 | 描述 |
|---|---|
| Name | 控件标题 |
| Show Title | 是否显示控件标题 True/False |
| Color | 摇杆颜色 |
| Auto Return | 释放摇杆时，是否自动回到原点 True/False |
| X Min | X轴最小位置数值 |
| X Max | X轴最大位置数值 |
| Y Min | Y轴最小位置数值 |
| Y Max | Y轴最大位置数值 |
Gauge
添加一个仪表盘到控制页面中, 每添加一个仪表盘，在编程区域将自动生成一个对应的Event定时器函数, 设备程序运行时将自动按照指定间隔时间上传数据内容(默认间隔为3000ms)，上传的内容将自动更新显示到页面控件上。
控件程序
Gauge 1 Event interval(ms): 3000 Set Data x
- 设备程序运行时将自动按照指定间隔时间上传数据内容(默认间隔为3000ms)，上传的内容将自动更新显示到页面控件上。可通过控件属性配置上传间隔，建议间隔大于3000ms。
控件属性
| 属性 | 描述 |
|---|---|
| Name | 控件标题 |
| Show Title | 是否显示控件标题 True/False |
| Label | 仪表盘标题 |
| Color | 仪表盘显示颜色 |
| Suffix | 仪表盘数据后缀 |
| Min Value | 仪表盘量程最小值 |
| Max Value | 仪表盘量程最大值 |
| Interval(ms) | 数据上报间隔时间/ms |
案例程序
使用说明:
1. 该案例程序中，包含多数REMOTE+控件的使用
2.
点击下载示例程序M5F文件
并在在线版UIFlow中打开，将程序推送至M5设备。
3. 点击REMOTE+预览窗上的二维码按钮，使用手机扫描弹出的二维码或是复制URL访问控制页面，开始进行远程控制与数据监控。
