文档

基本概念

更新时间:

本文介绍Link Visual(标准版)的常用产品名词。

Link Visual(标准版)控制台相关概念

名词

描述

产品管理

方便开发者对自己阿里云账号下的产品进行统一的管理和维护。

具体包括根据具体业务情况和产品类型先创建项目、并在项目下创建产品以及对产品进行功能定义、功能配置、开发调试和产品发布等。

App管理

方便开发者对自己阿里云账号下的App进行统一的管理和维护。

具体包括App的创建,支持创建Android/iOS/PC三种客户端应用,App配置、App SDK下载等,最终实现App与具体产品的交互。

激活码管理

方便开发者对激活码类型和数量进行统一的管理和分配,为后续量产做准备。

具体包括激活码的购买、分配、库存情况和操作记录进行管理和查看等。

说明

这里的激活码只是配额,并不代表平台的认证证书凭证。

量产管理

方便开发者根据具体产品的激活码配额情况,生成云端用于设备认证的证书,以便于后续设备量产的时候进行批量烧录。

具体包括设备认证证书的生成、下载以及量产记录等管理和查询。

项目相关概念

名词

描述

自建项目

开发者在阿里云账号下创建的项目,每个项目具有唯一ID,项目间的数据相互隔离。开发者可以为不同客户或者不同产品类型创建不同项目。

产品相关概念

名词

描述

功能定义

平台为每个视频品类都提供了标准功能,即标准的物模型属性、事件和服务;若标准功能不满足,平台也支持自定义功能。

功能定义支持编辑草稿态和历史版本管控,避免误操作和方便版本回滚。

产品配置

平台为产品提供关联App配置、绑定配置、设备告警规格配置等,其中一个产品可以关联多个App。

设备调试

产品开发阶段,需要使用设备进行各种调试,包括设备在线调试、功能自动化测试等。

产品发布

产品开发完成之后,可以发布产品。产品发布后,不能修改产品的各项功能定义和配置。撤销产品发布后,才能修改产品的各项功能定义和配置。

设备相关概念

名词

描述

测试设备

平台提供的虚拟测试设备,是指产品开发过程中,用于设备调试的虚拟设备,测试设备包含设备证书(ProductKey、DeviceName和DeviceSecret)。每个产品仅提供50个测试设备,且不能作为量产设备使用。

视频激活码

视频激活码是在云端预注册后颁发的设备认证证书,包含ProductKey、DeviceName和DeviceSecret,开发者可下载到本地(Excel文件),用于产线批量烧录,设备上线时根据该凭证进行认证鉴权。量产视频设备时,需购买视频激活码。

App相关概念

名词

描述

平台自建

开发者可以根据产品需求创建Android/iOS/PC的客户端应用。

功能配置

支持App关联产品配置、一方账号和三方账号配置、离线消息推送配置等。一个App可以关联多个产品。

物联网相关概念

名词

描述

产品

设备的集合,通常指一组具有相同功能的设备。平台为每个产品颁发全局唯一的ProductKey。

设备

归属于某个产品下的具体设备。平台为设备颁发产品内唯一的证书DeviceName。设备可以直接连接或作为子设备通过网关连接平台。

网关

能够直接连接平台的设备,且具有子设备管理功能,能够代理子设备连接云端。

子设备

本质上也是设备。子设备不能直接连接物联网平台,只能通过网关连接物联网平台。

设备证书

设备证书指ProductKeyDeviceNameDeviceSecret的组合。

  • ProductKey:是平台为产品颁发的全局唯一标识。

  • DeviceName:在注册设备时,自定义的或系统生成的设备名称,具备产品维度内的唯一性。

  • DeviceSecret:平台为设备颁发的设备密钥,和DeviceName成对出现。

重要

设备证书的三个参数很重要,在设备认证以及通信过程中都会用到,需要妥善保管。

ProductSecret

由平台颁发的产品密钥,通常与ProductKey成对出现,可用于一型一密的认证方案。该参数很重要,需要妥善保管。

RRPC

全称:Revert-RPC。RPC(Remote Procedure Call)采用客户机/服务器模式,用户不需要了解底层技术协议,即可远程请求服务。RRPC则可以实现由服务端请求设备端,并能够使设备端响应的功能。

标签

标签分为产品标签、设备标签和分组标签。

  • 产品标签:描述同一个产品下,所有设备所具有的共性信息。

  • 设备标签:通常根据设备的特性为设备添加的特有标记,您可以自定义标签内容。

  • 分组标签:描述同一个分组下,所有设备所具有的共性信息。

Alink协议

阿里云定义的设备与云端之间的通信协议。

物模型

是对设备在云端的功能描述,包括设备的属性、服务和事件。平台通过定义一种物的描述语言来描述物模型,称之为TSL(即 Thing Specification Language),采用JSON格式,您可以根据TSL组装上报设备的数据。

属性

设备的功能模型之一,一般用于描述设备运行时的状态,如环境监测设备所读取的当前环境温度等。属性支持GET和SET请求方式。应用系统可发起对属性的读取和设置请求。

服务

设备的功能模型之一,设备可被外部调用的能力或方法,可设置输入参数和输出参数。相比于属性,服务可通过一条指令实现更复杂的业务逻辑,如执行某项特定的任务。

事件

设备的功能模型之一,设备运行时的事件。事件一般包含需要被外部感知和处理的通知信息,可包含多个输出参数。例如,某项任务完成的信息,或者设备发生故障或告警时的温度等,事件可以被订阅和推送。

一型一密

同一产品下所有设备可以烧录相同产品证书(即ProductKey和ProductSecret)。设备发送激活请求时,平台对其携带的产品证书信息进行认证,认证通过,下发该设备接入所需的信息。设备再携带这些信息与物联网平台建立连接。

一机一密

每个设备烧录其唯一的设备证书(ProductKey、DeviceName和DeviceSecret)。当设备与平台建立连接时,平台对其携带的设备证书信息进行认证。