更新时间:2023-08-15 GMT+08:00
分享

应用资产

描述

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 选择调用服务-公共接口

相关文档