使用领域服务
更新时间：2019-08-28 10:49:29
通常做一个社区智能化项目，需要集成很多智能化系统，包括智能停车系统、智能人行系统、安防系统、设施设备管理系统等，为了更好支撑客户集成这些系统，阿里云IoT人居平台提供领域服务，南向接入各种领域系统，并抽象出标准的API来屏蔽系统的差异化，然后客户可以基于标准API集成各种领域系统。下图就是领域服务简单的产品架构图。
图1. 领域服务的产品架构
名词解释：
领域ISV：提供领域应用的合作伙伴
领域应用：领域ISV已经开发成熟的应用，例如停车应用、门禁应用、梯控应用等，这些应用系统有可能是本地部署，也有可能是云端部署
领域服务：是对领域应用在云端的功能描述，包括数据模型和服务模型。平台通过领域服务南向接领域应用，并将其开放成为标准的API，客户可以基于这些API集成各种领域系统。
领域服务使用手册
这一章节主要讲解客户如何使用领域服务，主要分为三步：
- 您需要在线上人居平台开通领域服务、配置领域应用，阿里云审核通过之后，会驱动对应的供应商部署应用。
- 供应商部署应用之后，会相应的生成一个AppID，您需要线下获取这个AppID，并且在人居平台填入，完成您的AppKey与该领域应用的授权。
- 基于之前的授权，您最后就可以调用阿里云提供的领域服务API，进行集成开发。
下图是领域服务的主要使用流程图。
图2. 领域服务的使用流程图
1. 开通领域服务
您需要基于领域服务的API进行集成开发，首先需要登录阿里云人居平台，选择领域服务菜单，然后点击您需要领域服务进行开通，如下图。这里阿里云人居平台会根据地产社区智能化需要不断丰富领域服务。
点击开通，会提交到阿里云后台进行审核。
2. 配置领域应用
开通领域服务，阿里云审核通过之后，您就可以配置领域应用。每一种领域服务背后都会有一家或者多家供应商的领域应用对接，您可以根据供应商选择领域应用，您也可以根据领域的应用形态或者部署方式来选择领域应用。如下图：
名词解释：
单租户应用，指的是该应用在部署的时候，为客户单独部署一份实例。
多租户应用，指的是该应用在部署的时候仅部署一份实例，交付给客户的是一个账号。
云端部署：指的是该应用部署在云端，例如阿里云。
边缘部署，指的是该应用部署在本地，例如社区本地机房。
云端应用
如果您选择的领域应用是云端部署，那么点击申请之后，会提交审核给阿里云，阿里云审核通过之后，会通知领域ISV部署领域应用。如下图：
边缘应用
如果您选择的领域应用是边缘部署，就意味着该领域应用要部署在您的本地机房，我们提供了一套应用分发机制，可以将领域应用分发到您的机器上。
要完成分发的流程，我们需要您在物联网边缘托管服务上创建集群，如果该服务还未开通，请提交工单。开通之后，需要创建集群并关联到您的本地机器上，具体请参考教程。
您创建集群之后，需要在人居平台上将选择该集群授权给领域ISV，这样领域ISV可以将应用部署到您的集群上。请参考下图：
- 操作完成之后，也会提交审核给阿里云，阿里云审核通过之后，会通知领域ISV部署领域应用到您的集群上。
特别注意：如果您有多个项目需要部署多次同一个应用，这种场景，您就多次申请同一应用即可。
3. 授权领域应用
申请成功之后，可以在“我的服务”->“领域应用”中查看。如下图：
领域ISV部署应用之后，平台会给该应用生成AppID，用于标识这个领域应用，这个AppID会提供给领域ISV，您需要线下跟领域ISV去获取这个AppID，然后将该AppID与您的AppKey建立授权，这样您基于自己的AppKey就可以调用领域服务的API，然后平台会根据授权关系路由到AppID对应的领域应用，实现领域应用的集成。人居平台上授权如下图：
授权成功之后，您账号下所有AppKey都会与该AppID建立授权关系，同时平台也可以支持修改和删除，一旦修改或者删除成功，原有的授权关系就会被解除，新的授权关系会建立，请谨慎操作。
4. 调用领域服务开发
完成授权之后，您就可以调用领域服务的API进行开发，实现领域应用的集成。具体领域服务的API文档请参考。