# 1. 对接方式
# 1.1 授权方案
控端系统，如APP、小程序、车机、电视等厂商，可以通过接入美的IoT云，实现对美的不同品类智能设备的远程控制以及配网
如果只需要控制美的设备，有以下方案可供选择：
| 授权方案 | 说明 | 使用限制 |
|---|---|---|
| 授权码授权 | 授权过程会弹出美居登录页面，用户可以选择使用美居账号和密码或者美居手机号和验证码进行登录授权。 | 用户需要使用美居账号，第三方应用上需要有个美居授权入口，获取授权后方可使用用户在美居上的数据。 |
| 扫码授权 | 先申请授权二维码，再使用美居 APP 扫描二维码获取授权。 | 类似授权码授权方案，只是调用方式换成了使用美居 APP 扫码，所以用户需要先注册美居账号。 |
# 1.1.1 美居用户名密码登录授权
用户名密码授权为三方提供用户名和密码认证，登录需要用户已经在美居APP注册过，用已有的用户名和密码进行登录授权，授权服务会根据用户填写的用户名和密码进行校验，通过校验会向第三方派发授权码，三方根据授权码向授权服务请求访问令牌和刷新令牌，用来访问美居开放接口。访问令牌有一定的失效时间，失效后三方根据刷新令牌进行刷新访问令牌，直到刷新令牌也过期再重新发起用户认证。
授权步骤：
1、三方APP上选择美居授权并调起美居授权页面
2、用户输入用户名密码进行用户验证
3、开放平台向三方云发放通过用户认证的授权码
4、三方云请求令牌
5、访问开放接口
6、三方云在访问令牌失效时发起刷新令牌请求
# 1.1.2 美居用户手机验证码登录授权
用户可以使用手机验证码进行授权，授权时如果是新用户，会为用户申请注册验证码，如果是已有用户，则申请登录注册码，授权服务会根据用户填写的手机和验证码进行校验，通过校验会向第三方派发授权码，三方根据授权码向授权服务请求访问令牌和刷新令牌，用来访问美居开放接口。访问令牌有一定的失效时间，失效后三方根据刷新令牌进行刷新访问令牌，直到刷新令牌也过期再重新发起用户认证。
授权步骤：
1、三方APP上选择美居授权并调起美居授权页面
2、用户输入用户手机并点击发送验证码，收到验证码后输入验证码进行用户验证
3、开放平台向三方云发放通过用户认证的授权码
4、三方云请求令牌
5、访问开放接口
6、三方云在访问令牌失效时发起刷新令牌请求
# 1.1.3 美居用户扫码登录授权
对于带屏的三方，三方云可以通过屏端显示的二维码，使用美居APP进行扫码授权，由美居APP先进行用户校验，通过用户校验的授权请求，则向开放平台授权服务发起扫码认证，开放平台校验二维码信息，通过校验会向第三方派发授权码，三方根据授权码向授权服务请求访问令牌和刷新令牌，用来访问美居开放接口。访问令牌有一定的失效时间，失效后三方根据刷新令牌进行刷新访问令牌，直到刷新令牌也过期再重新发起用户认证。
授权步骤：
1、生态合作方客户端或者云端调开放平台“获取授权二维码”接口，该接口需要根据开放平台分配的Client Id和合作方带屏设备的UUID（用Client Sec加密）核心参数做唯一性区分，同一UUID只有最新二维码有效，二维码有效期10分钟，合作方客户端根据有效期进行倒计时，过期自行刷新
2、开放平台判断合法UUID返回二维码信息（用开发平台Key加密后的UUID + Random Code + TS），记录UUID和二维码信息对应关系，设置有效期10分钟，有效期可以再确认
3、用户使用美居APP扫描生态合作方客户端上显示的二维码，进行美居用户认证，对已登录的美居用户发起开放平台授权请求
4、请求开放平台授权验证，带上二维码信息和美居用户ID，开发平台根据是否有授权过和二维码信息有效期判断是否生成授权码，鉴权通过则分配授权码并由美居APP回调合作方回调地址
5、三方云请求令牌
6、访问开放接口
7、三方云在访问令牌失效时发起刷新令牌请求
# 1.2 设备配网
如果除了控制外，还希望对美的设备进行配网，则有以下方案可供选择：
| 配网方式 | 说明 | 使用限制 |
|---|---|---|
| 美居 APP 配网 | 用户使用美居 APP 进行美的设备配网操作，后续第三方再通过云云对接控制美的设备。 | 用户需要使用两个APP，且云云对接的授权方案只能选择授权码授权方案，否则加载不了用户美居账号下的设备数据。 |
| SDK 配网 | 第三方拥有自己的 APP，可以通过集成美的提供的 openSDK 进行 SDK 配网，用户无需使用美居进行设备配网。 | 第三方需要维护用户和设备的关系，云云对接控制设备时，需要使用主人进行控制，否则控制失败。 |
# 1.3 设备控制
平台提供了控制美的系智能设备的能力。具体步骤如下:
现支持的具体品类如下：
| 支持的品类 | 品类码 |
|---|---|
| 家用空调 | AC |
| 洗碗机 | E1 |
| 干衣机 | DC |
| 电压力锅 | EC |
| 小烤箱 | B4 |
| 净水机 | ED |
| 中央空调暖家 | CF |
| 晾衣架 | 17 |
| 灶具 | B7 |
| 滚筒洗衣机 | DB |
| 空气能热水器 | CD |
| 中央空调 | CC |
| 蒸汽炉 | B2 |
| 豆浆机 | EF |
| 插座 | 10 |
| 波轮洗衣机 | DA |
| 电磁炉 | E7 |
| 大烤箱 | B1 |
| 慢炖锅 | E8 |
| 中央空调新风 | CE |
| 净化器 | FC |
| 吸顶灯 | 13 |
| 电风扇 | FA |
| 抽油烟机 | B6 |
| 扫地机器人 | B8 |
| 取暖器 | FB |
| 复式洗衣机 | D9 |
| 电热水器 | E2 |
| 除湿机 | A1 |
| 微波烤箱 | 9A |
| 面包机 | E9 |
| 燃气热水器 | E3 |
| 破壁机 | F1 |
| 烹饪机炒菜机 | EB |
| 加湿器 | FD |
| 微波炉 | B0 |
| 空气ball | A9 |
| 电饭煲 | EA |
| 智能遥控 | 11 |
| 空气盒子 | 12 |
| 智能窗帘 | 14 |
| 智能水壶 | 15 |
| 智能路由 | 1B |
| 音箱 | 1C |
| 空调伴侣 | 1D |
| 五谷杂粮机 | 1E |
| 燃气传感器 | 1F |
| 垃圾粉碎机 | 22 |
| 烹饪机器人 | 23 |
| 快速烹饪机器 | 24 |
| 跑步机 | 25 |
| 浴霸 | 26 |
| 红外转发器 | 27 |
| 机器人 | 28 |
| 摄像头 | 2B |
| 传感器盒子 | 2C |
| 冷塔扇 | 90 |
| 消毒柜 | B3 |
| 多头炉 | B9 |
| 橱柜 | BA |
| HI炒灶 | BB |
| 传感器 | BC |
| 养生壶 | BD |
| 微波蒸汽烤箱 | BF |
| 厨房秤 | C0 |
| 壁挂炉 | C1 |
| 智能坐便器 | C2 |
| 集中采暖热水 | C3 |
| 冰箱 | CA |
| 蒸汽烤箱 | 9B |
| 集成灶 | 9C |
| 彩屏集控器 | 9D |
| 水能源系统 | E4 |
| 烘焙机 | E5 |
| 空调扇 | FE |
| 蒸脸仪 | 0A |
| 按摩披肩 | 0B |
| 塑身腰带 | 0C |
| 美胸仪 | 0D |
| 健康秤 | 0F |
| 电视机 | AA |
| 发热板 | 2E |
| 食材机 | 06 |
| 血糖仪 | 07 |
| 语音贴 | 08 |
# 1.4设备订阅
平台提供了通知开发者其所有拥有的设备的状态变更。开发者可以根据实际需要订阅这些事件。请点击查看 设备通知相关接口
← 2. 云云对接 2. 云控制操作流程 →