应用资产

描述

ISDP+智能安监集成ISDP+视频下沉能力，提供视频监控的基本服务，可以快速开发需要视频监控的业务应用。

开放能力

ISDP+智能安监包含一个APP资产和一个BO资产，APP资产提供页面能力，BO资产提供服务能力。

• APP资产提供的页面：

  页面	说明
  设备列表	设备列表页面分页展示接入ISDP+的所有设备（包含智能终端和摄像头），并在设备列表页面集成ISDP+系统的单个设备视频播放页面。单击每个设备后的“进入视频”，进入集成的视频播放页面。
  智能安监	智能安监页面集成ISDP+系统三个视角的智能安监看板页面：智能监控（视频）、智能监控（设备）和智能监控（地图）。
  设备地图	设备地图页面按设备位置在地图上展示设备，单击设备可以进入视频通话。

• BO资产提供的服务：

  服务	说明
  分页获取设备列表	该服务用于获取ISDP+的所有设备。
  获取单个设备详情	该服务用于获取单个设备的详情。
  获取设备位置信息	该服务用于获取设备的经纬度等位置信息。
  添加设备	该服务用于添加设备。
  删除设备	该服务用于删除设备。
  查询项目列表	该服务用于获取ISDP+的所有项目。

智能安监页面集成方法说明

1. 联系对接的ISDP+系统管理员分配单点登录认证凭证（client_id，client_secret）。
   1. 以超级管理员账号登录ISDP+管理员系统（console）（登录地址：https://ISDP+的域名/console#/sysAdmin/home），如图1所示。
      图1 ISDP+管理员系统（console）
      
   2. 选择“初始设置 > oauth2集成配置”，进入“oauth2集成配置”页面，如图2所示。
      图2 进入oauth2集成配置
      
   3. 单击“新建”，如图3所示，配置oauth2集成信息，配置参数说明请参见表1。
      图3 新建配置
      

      表1 配置参数说明

      参数	配置说明	示例
      客户端ID	手动输入客户端ID。	test
      授权协议	下拉选择授权协议。	authorization_code,password,refresh_token
      跳转地址	手动输入URL格式跳转地址，如有多个地址，请用英文逗号分隔。	-
      Token失效时间(s)	手动输入整数，默认Token失效时间12小时。	1200
      刷新Token失效时间(s)	手动输入整数，默认刷新Token失效时间30天。	43200

   4. 单击“确定”，新建成功后会弹出密钥详情页面，如图4所示。
      单击“复制”，可复制密码。

      图4 密钥详情
      

      客户端ID和密码，即为分配的单点登录认证凭证（client_id，client_secret）。

2. 获取对接ISDP+的服务器的IP地址，并提供给ISDP+系统管理员配置到ISDP+的IP白名单。
   1. ISDP+系统管理员登录nacos控制台。
   2. 如图5所示，选择“配置管理 > 配置列表”，进入“配置管理”页面。
      图5 进入配置管理
      
   3. 在文件中配置要添加的IP地址。
      • OP版本：配置文件application.yaml
        1. 如图6所示，查询到“application.yaml”文件。
           图6 查询“application.yaml”文件
           
        2. 单击“application.yaml”文件对应的“编辑”，进入该文件的“编辑配置”页面。
        3. 在文件中添加如下配置，如图7所示。
           其中示例中appcube_sso，为1中分配的单点登录认证凭证中的“客户端ID”，IP地址为要添加到ISDP+白名单的服务器IP地址，请根据实际情况修改。

           oauth2:
             serverAuth:
               clientMap:
                 appcube_sso:
                    ipList:
                      - 10.10.10.10

           图7 配置示例
           
        4. 单击“发布”。
      • OC版本：配置文件plat-oauth2-server.yaml
        1. 如图8所示，查询到“plat-oauth2-server.yaml”文件。
           图8 查询“plat-oauth2-server.yaml”文件
           
        2. 单击“plat-oauth2-server.yaml”文件对应的“编辑”，进入该文件的“编辑配置”页面。
        3. 在文件中添加如下配置，如图9所示。
           其中示例中appcube_sso，为1中分配的单点登录认证凭证中的“客户端ID”，IP地址为要添加到ISDP+白名单的服务器IP地址，请根据实际情况修改。

           oauth2:
             serverAuth:
               clientMap:
                 appcube_sso:
                    ipList:
                      - 10.10.10.10

           图9 配置示例
           
        4. 单击“发布”。

3. 配置ISDP+的登录账户，或者将自己系统的用户账号同步到ISDP+中（通过OpenAPI的方式）。

   通过API“添加人员账号”同步用户账号到ISDP+，API的使用方法请参见添加人员账号。

4. 集成页面。

   智能安监开放的5个页面以及URL如下：

   • 单个设备的视频播放页面

     URL

     • 智能终端：https://isdp+的域名/embed/#/qc/sceneWork/videoIntellectManager?isdpDeviceId=device_001-0&showmenu=false

       

     • 摄像头：hhttps://isdp+的域名/embed/#/qc/sceneWork/videoEnterHolosen?deviceId=2102412502WLL6000771&channelId=0

       

   • 智能监控（视频）

     URL：https://isdp+的域名/embed/#/qc/holosens/IntelligentMonitor?uiType=videoScreen

     

   • 智能监控（设备）

     URL：https://isdp+的域名/embed/#/qc/holosens/IntelligentMonitor?uiType=tableList

     

   • 智能监控（地图）

     URL：https://isdp+的域名/embed/#/qc/holosens/IntelligentMonitor?uiType=map

     

   页面可以通过iframe嵌入方式集成，也可以通过跳转方式集成：

   • 单个设备的视频播放页面
     1. 调用ISDP+获取token接口https://isdp+的域名/oauth2/oauth/rest_token，得到access_token。
     2. 将获取到的access_token拼接到页面的URL上。

        示例

        智能终端：https://isdp+的域名/embed/?access_token=XXXXXXXXXXXX#/qc/sceneWork/videoIntellectManager?isdpDeviceId=device_001-0&showmenu=false

        摄像头：hhttps://isdp+的域名/embed/?access_token=XXXXXXXXXXXX#/qc/sceneWork/videoEnterHolosen?deviceId=2102412502WLL6000771&channelId=0

   • 智能监控（视频）
     1. 调用ISDP+获取token接口https://isdp+的域名/oauth2/oauth/rest_token，得到access_token。
     2. 将获取到的access_token拼接到页面的URL上。

        示例：https://isdp+的域名/embed/?access_token=XXXXXXXXXXXX#/qc/holosens/IntelligentMonitor?uiType=videoScreen

   • 智能监控（设备）
     1. 调用ISDP+获取token接口https://isdp+的域名/oauth2/oauth/rest_token，得到access_token。
     2. 将获取到的access_token拼接到页面的URL上。

        示例：https://isdp+的域名/embed/?access_token=XXXXXXXXXXXX#/qc/holosens/IntelligentMonitor?uiType=tableList

   • 智能监控（地图）
     1. 调用ISDP+获取token接口https://isdp+的域名/oauth2/oauth/rest_token，得到access_token。
     2. 将获取到的access_token拼接到页面的URL上。

        示例：https://isdp+的域名/embed/?access_token=XXXXXXXXXXXX#/qc/holosens/IntelligentMonitor?uiType=map

   ISDP+智能安监APP中页面集成示例：

   • 设备列表页面，使用跳转的方式集成单个设备的视频播放页面，单击“进入视频”，跳转到视频播放页面。

     

   • 智能安监页面，过iframe嵌入方式集成智能安监系统三个视角的页面。

     

服务集成实现方法

1. 在对接的ISDP+系统创建应用，并记录下“应用ID”和“令牌”。

   相关操作请参见创建应用。

2. 使用创建的应用订阅API。

   相关操作请参见订阅API。

3. 配置系统参数。
   1. 进入到BO。
   2. 如图10所示，单击“配置”。
      图10 配置
      
   3. 单击“系统参数”，配置相关参数。
      需要配置的参数：

      • 应用ID和令牌
      • 获取ISDP+ token的接口地址
      • 订阅的API

      图11 配置系统参数
      

4. 配置完成后，在进行服务和脚本的编排时，首先调用ISDP+获取token接口，得到access_token，再调用其他API接口。
5. 配置业务权限凭证。

   通过业务权限凭证，可以控制AppCube的用户对于自定义公共接口的访问权限，如果用户权限中包含了某个业务权限凭证，该用户将能够调用配置了相应业务权限凭证的自定义公共接口。

   具体操作请参见如何控制接口访问权限。

如何使用资产

【APP资产】

1. 订购并安装部署ISDP+智能安监APP资产到对应的开发环境。

   相关操作请参见如何订购&部署资产。

2. 在开发环境首页的“项目”页签单击“行业应用”，再单击“创建Addon应用”。
3. 输入标签和名称，选择分类，选择依赖的APP“ISDP+智能安监”，单击“创建”。
   图12 创建Addon应用
   

4. 创建后，页面跳转到Addon应用开发页面，在页面上方为Addon应用定制内容，“External dependencies”里为依赖的应用目录树。
   图13 Addon应用开发页面
   

5. 开发定制内容，例如基于依赖App中的高级页面进行定制。
   1. 如图14所示，鼠标放在Addon应用定制目录下的Page文件夹旁会出现加号，单击加号，选择“高级页面”。
      图14 进入添加高级页面
      
   2. 如图15所示，在“添加高级页面”中选择“基于已有页面”，勾选基于的页面，单击“添加”。
      图15 添加高级页面
      

      添加后，在Addon应用定制目录下的Page文件夹下会出现该定制页面，可以基于该定制页面进行开发。

      图16 添加结果
      
      

      后续就是应用的开发过程，开发完成将Addon应用打包时，只能将定制内容打包出去，依赖的内容不会随Addon应用打包发布出去，在其他环境中也需要订购部署依赖的资产包。

【BO资产】

1. 订购并安装部署ISDP+智能安监BO资产到对应的开发环境。

   相关操作请参见如何订购&部署资产。

2. 在开发环境首页的“项目”页签，新建或进入已有的应用。
3. 如图17所示，在应用开发页面下“External dependencies”目录树旁单击加号，选择“BO服务”。
   图17 BO服务
   

4. 如图18所示，在“添加BO”页面选择BO，单击“添加”，导入BO。
   图18 添加BO
   

   导入后，该BO会出现在上层应用中，如图19所示。后续，您可在应用中调用该BO中的服务。

   图19 导入BO
   

5. 调用BO中的服务。

   例如在标准页面的服务模型中调用BO中的服务。

   1. 在应用中打开一个标准页面，或者新创建一个标准页面。
      添加方法如图20和图21所示。

      图20 添加标准页面1
      

      图21 添加标准页面2
      

      

      由于示例中，“External dependencies”依赖包含标准页面，所以该处展示的添加标准页面展示叠加页面，叠加页面中为External dependencies”依赖包中的标准页面。

      如果“External dependencies”依赖不包含标准页面，添加标准页面：

      

   2. 如图22所示，标准页面开发界面下侧，单击“模型视图”，切换到“模型视图”。
      图22 模型视图
      
   3. 如图23所示，单击“新增模型”，定义模型名称，选择来源为“服务”，单击“下一步”。
      图23 新增模型
      
   4. 如图24、图25或图26所示，选择调用ISDP+智能安监BO中的服务，后续可以基于服务进行定制开发。
      图24 选择调用服务-服务编排
      
      图25 选择调用服务-脚本
      
      图26 选择调用服务-公共接口