快速上手指南

注意：如要访问MixIO开发者文档，请移步 dev-api

MixIO是一个组件化的物联网应用构建平台。在MixIO平台中，你可以便捷地连接、控制、监控各类可编程设备，快速打造易用的物联网应用，并将创意共享给他人。

MixIO平台的全部通信均基于开源的MQTT协议。这意味着，凡是支持MQTT协议的硬件设备都能够使用MixIO的开放能力。在本指南描述的应用场景中，MixIO平台是与Mixly图形化编程软件结合使用的。

创建 / 导入项目

假定您已经完成了账号注册并成功登录到了MixIO平台。在打开的“项目管理”页面中，点击右上角的按钮，即可开始创建一个MixIO项目。
在弹出的对话框中，您需要为项目指定一个名称。点击按钮，即可完成项目创建。
如果您想基于其他用户的现有项目创建项目，您也可以通过点击右上角的按钮以导入项目（需要该用户为您提供一个授权码）。

连接设备

成功创建或导入项目后，“项目管理”页面中将出现对应的项目。点击项目缩略图下方的按钮，即可进入该项目。
进入项目页面后，您可以首先点击右上角的按钮以运行项目。
在项目运行状态下，点击右上角的按钮，可以查看硬件连接所需的用户名/密码。注意：此密码与您MixIO账号的登录密码不同。
在Mixly图形化编程软件中，选择物联网→MixIO分区，使用“创建MQTT客户端并连接”程序块，依次键入用户名、硬件连接密码、项目名称，即可完成设备的连接。设备的连接信息将被实时显示在按钮呼起的对话框中，设备名称为硬件的MAC地址。

添加组件

一个空的MixIO项目仅起到了汇聚设备、共享MQTT连接的作用；要实现控制、监控等特定功能，需要您为项目添加恰当的组件。在运行模式下，项目是不可编辑的；您需要点击右上角的按钮停止项目，以重新进入编辑模式。
在编辑模式下，点击右上角的按钮，可以呼起“添加组件”对话框。MixIO平台提供了15种不同的组件，组件的具体功能与见下一章节“组件说明”。
添加组件时，您需要为组件指定一个“组件名称”（用以在项目中特异标记该组件），并设定“消息主题”（用以与该组件进行输入/输出交互）。在Mixly图形化编程软件中，使用“发布”与“订阅”程序块，并遵循下一章节“组件说明”中的输入/输出规范，即可充分调用组件功能。
在编辑模式下，项目组件的位置是可以自由移动的，组件的各项属性是可以自由更改的。在完成更改后，请您点击右上角的按钮以保存项目布局。

组件说明

MixIO平台提供了13种预设组件，以下为每种组件的功能与输入/输出规范进行详细介绍。

组件总览

组件名称	功能简介
按键 / 开关	以按键和开关两种模式响应用户输入，向设定主题发送0/1信号。
滑杆	以滑动形式响应用户输入，向设定主题发送数值信息；监听设定主题的数值信息，并进行实时呈现。
文本输入	将用户输入的文本信息发送到设定主题。
摇杆手柄	以摇杆形式响应用户输入，向设定主题发送输入位置坐标字符串。
RGB色盘	支持用户自由选色，将色彩对应的R/G/B通道数值发送到设定主题；监听设定主题的数值信息，并将其实时合成为对应的颜色。
指示灯	监听设定主题的数值信号，呈现对应的熄灭/点亮色彩。
文本显示屏	监听设定主题的文本信息，将信息进行原样呈现。
折线图表	监听设定主题的数值信息，以折线图形式进行呈现，支持多数据源与图表转换。
直方图表	监听设定主题的文本信息，以直方图形式进行筛选呈现，支持图表转换。
数据表格	监听设定主题的文本信息，以表格形式进行筛选呈现。
仪表盘	监听设定主题的数值信息，进行动态呈现。
数据地图	监听设定主题下特定格式的消息，在地图上进行包含时空两维信息的可视化呈现。
实时气象仪	获取设定地区的实时天气，并向设定主题发送。