使用领域服务

更新时间:2019-08-28 10:49:29

通常做一个社区智能化项目,需要集成很多智能化系统,包括智能停车系统、智能人行系统、安防系统、设施设备管理系统等,为了更好支撑客户集成这些系统,阿里云IoT人居平台提供领域服务,南向接入各种领域系统,并抽象出标准的API来屏蔽系统的差异化,然后客户可以基于标准API集成各种领域系统。下图就是领域服务简单的产品架构图。

image.png


图1. 领域服务的产品架构


名词解释:

  • 领域ISV:提供领域应用的合作伙伴

  • 领域应用:领域ISV已经开发成熟的应用,例如停车应用、门禁应用、梯控应用等,这些应用系统有可能是本地部署,也有可能是云端部署

  • 领域服务:是对领域应用在云端的功能描述,包括数据模型和服务模型。平台通过领域服务南向接领域应用,并将其开放成为标准的API,客户可以基于这些API集成各种领域系统。

领域服务使用手册

这一章节主要讲解客户如何使用领域服务,主要分为三步:

  1. 您需要在线上人居平台开通领域服务、配置领域应用,阿里云审核通过之后,会驱动对应的供应商部署应用。
  2. 供应商部署应用之后,会相应的生成一个AppID,您需要线下获取这个AppID,并且在人居平台填入,完成您的AppKey与该领域应用的授权。
  3. 基于之前的授权,您最后就可以调用阿里云提供的领域服务API,进行集成开发。

下图是领域服务的主要使用流程图。

image.png
图2. 领域服务的使用流程图

1. 开通领域服务

您需要基于领域服务的API进行集成开发,首先需要登录阿里云人居平台,选择领域服务菜单,然后点击您需要领域服务进行开通,如下图。这里阿里云人居平台会根据地产社区智能化需要不断丰富领域服务。

image.png


点击开通,会提交到阿里云后台进行审核。

2. 配置领域应用

开通领域服务,阿里云审核通过之后,您就可以配置领域应用。每一种领域服务背后都会有一家或者多家供应商的领域应用对接,您可以根据供应商选择领域应用,您也可以根据领域的应用形态或者部署方式来选择领域应用。如下图:


image.png

名词解释:

  • 单租户应用,指的是该应用在部署的时候,为客户单独部署一份实例。

  • 多租户应用,指的是该应用在部署的时候仅部署一份实例,交付给客户的是一个账号。

  • 云端部署:指的是该应用部署在云端,例如阿里云。

  • 边缘部署,指的是该应用部署在本地,例如社区本地机房。

云端应用

如果您选择的领域应用是云端部署,那么点击申请之后,会提交审核给阿里云,阿里云审核通过之后,会通知领域ISV部署领域应用。如下图:

image.png

边缘应用

如果您选择的领域应用是边缘部署,就意味着该领域应用要部署在您的本地机房,我们提供了一套应用分发机制,可以将领域应用分发到您的机器上。

  • 要完成分发的流程,我们需要您在物联网边缘托管服务上创建集群,如果该服务还未开通,请提交工单。开通之后,需要创建集群并关联到您的本地机器上,具体请参考教程

  • 您创建集群之后,需要在人居平台上将选择该集群授权给领域ISV,这样领域ISV可以将应用部署到您的集群上。请参考下图:

image.png

  • 操作完成之后,也会提交审核给阿里云,阿里云审核通过之后,会通知领域ISV部署领域应用到您的集群上。

特别注意:如果您有多个项目需要部署多次同一个应用,这种场景,您就多次申请同一应用即可。

3. 授权领域应用

申请成功之后,可以在“我的服务”->“领域应用”中查看。如下图:

image.png


领域ISV部署应用之后,平台会给该应用生成AppID,用于标识这个领域应用,这个AppID会提供给领域ISV,您需要线下跟领域ISV去获取这个AppID,然后将该AppID与您的AppKey建立授权,这样您基于自己的AppKey就可以调用领域服务的API,然后平台会根据授权关系路由到AppID对应的领域应用,实现领域应用的集成。人居平台上授权如下图:


image.png


授权成功之后,您账号下所有AppKey都会与该AppID建立授权关系,同时平台也可以支持修改和删除,一旦修改或者删除成功,原有的授权关系就会被解除,新的授权关系会建立,请谨慎操作。

4. 调用领域服务开发

完成授权之后,您就可以调用领域服务的API进行开发,实现领域应用的集成。具体领域服务的API文档请参考。

results matching ""

    No results matching ""