米家生态常见名词解释
更新时间：2023/09/21
MODEL
Model 是小米 IoT 开发者平台为开发者的产品指定的唯一标识（用户不可见）。主要由“企业开发组”、“产品类型”和“产品型号”构成。产品创建后产品 Model 将无法修改。
如 xiaomi.lock.demo 指企业组 xiaomi 里面的产品型号为 demo 的锁产品(lock)。
UID
用户 ID(Uesr ID)，标识用户的唯一识别码。在开发者平台中特指登录米家 App 的小米账号 ID。
开发者可以在 米家 App - 我的 - <个人头像> - 小米ID 处查询自己的 uid。
DID
设备 ID(Device ID)是小米 IoT 开发者平台分配的，用于唯一识别某一个具体设备的唯一标识。使用小米智能模组的设备，模组中自带 DID。使用 Linux/Andorid SDK 开发的产品，DID 包含在申请的三元组中。
PID
产品 ID(Product ID)由小米 IoT 开发者平台自动分配指定，用于识别产品。该标识用户不可见，产品创建后自动生成且无法修改，主要功能是在配网阶段起到识别作用。
Spec
又称 MIOT-Spec，为 MIoT Specification 的缩写。Spec 是描述设备功能的协议规范，对设备的功能性进行规范化描述。其主要用于各种方式接入米家平台的设备上。
通过 MIOT-Spec 协议接入米家平台的设备我们通常叫做 Spec 接入。采用统一的 Spec 协议接入，设备除了可实现与云端、插件的通信，还可以轻松获取到平台消息推送、自动化联动、小爱语控（需品类支持）、快捷卡片（需品类支持）等通用能力。
有关 Spec 的详细介绍请参考 Spec 知识。
SIID
服务 ID(service-iid)，MIOT-Spec 协议中某项服务的唯一标识。服务(Service)指某一类互相有联系的功能合集，其内部包含各种属性(Property)、事件(Event)和方法(Action)。
在计算机程序中，同一类属性和方法等往往会放进类(Class)中。Spec 协议中的服务也像 Class 一样，如灯品类的 light 服务中，包含了开关、亮度调节、色温调节等功能。
PIID
属性 ID(property-iid)，MIOT-Spec 协议中某项服务中属性的唯一标识。单一的功能操作可以定义为属性，属性支持被查询、控制、订阅。例如灯的开关、亮度调节、色温调节。
AIID
方法 ID(action-iid)，MIOT-Spec 协议中方法的唯一标识，主要用于向设备下发控制指令。方法可支持同时下发多个属性（以属性作为输入、输出参数），如电饭煲开始煮饭。
EIID
事件 ID(event-iid)，MIOT-Spec 协议中事件的唯一标识，主要用于设备向云端上报组合数据。事件可支持上报多个属性（以属性作为输出参数），如门锁被打开。
OT
一般指 OT 通道。OT 通道是 SDK 提供的核心功能之一，它在 IoT 设备和米家服务器之间建立了一个长连接，供业务 RPC 传输使用。开发者无需关心与云端的链路管理，只需要负责业务 RPC 处理即可。
OT 通道工作在 IP 层之上，传输层支持 UDP/TCP/TLS 三种方式，默认使用 TLS 的安全链路。OT 通道的核心作用是在 IoT 设备与云端之间提供业务 RPC 透传，即 SDK 对 OT 通道内的业务 RPC 仅做上下行转发，无其他额外处理。
OT Client
实现 OT 通道功能的设备端程序。如标准模组固件，SDK 二次开发的模组固件等，就称之为 OT Client。
RPC
RPC 是远程过程调用(Remote Procedure Call)的缩写形式。接入米家的设备，其远程云端控制以及小爱语控，自动化场景等功能的实现，依赖云与设备之间的数据通信，也属于一种 RPC，数据传输协议使用的是 MIOT-SPEC。
例如下面的示例就是一条完整的符合 MIOT-SPEC 协议的 RPC 指令。
json
{
“from”: “4”,
“id”: 39950136,
“method”: “set_properties”,
“params”: [
{
“did”: “462033xxx”,
“piid”: 1,
“siid”: 2,
“value”: true
}
]
}
三元组
三元组，指从小米 IoT 平台申请的一段包含 DID、KEY、MAC 信息的文本。使用 Linux/Andorid SDK 开发的设备接入米家，需要上述 DID、KEY、MAC 三个信息才能入网，因此简称为三元组。
设备配网
指智能设备获得连接互联网能力的过程，如通过米家 App 获取路由器 SSID 及密码，连接路由器访问网络。
设备绑定
指设备和米家 App 连接后，将其绑定到小米帐号下。一般而言设备配网流程会包含设备绑定操作，故设备配网成功即代表设备绑定成功。设备绑定后，通常需要在米家 App 上解除绑定或设备重置后才能再次进行绑定。
畅快连
指米家 SDK 提供的畅快连功能，包含靠近配网、一键配网、改密同步三个功能。
自动升级
即设备自动进行 OTA 更新固件。开启了此功能的产品，会在凌晨 2:00～凌晨 6:00 时间段进行静默升级，不打扰用户。更新记录和通知会在第二天早上 10 点后统一推送。
扩展程序
米家扩展程序，又称米家 App 插件，是由各接入厂商开发的，在米家 App 中用于查看硬件产品实时信息和控制硬件产品的子程序。
在米家 App 设备页面，点击设备宫格进入到的设备控制界面即是扩展程序界面。
有关扩展程序开发的详细介绍参考扩展程序快速入门。
快捷卡片
指米家 App 提供的一种无需进入产品扩展程序，就能在设备宫格页面快速控制产品的功能。
如需使用快捷卡片功能，可前往 米家 App - 我的 - 设置 - 快捷卡片 - 打开快捷操作 进行开启。
消息推送
指米家 App 或者小爱语控完成某类操作后，设备耗材信息和报警信息会推送到用户手机上告知用户。
智能场景
又称自动化，是一个用于控制厂商自己的设备与其他已接入 MIoT 平台的设备间进行联动的功能。
例如：用户可以控制门锁和入户灯之间的联动，配置好相关的智能场景后，实现用户开锁后，入户灯自动打开的效果。
INC 独立二次开发
也称为独立二次开发、基于小米 SDK 标准接口的独立模块开发、Wasm SDK 开发。它与 SDK 二次开发主要区别是引入了 Wasm 虚拟机隔离，延续了二次开发成本低的优势，且降低了开发难度，集合了传统二次开发与 MCU+ 通用模组两种开发方式的优点。