本贴是园区视频调阅调试FAQ总结帖，持续跟新 1，园区支持哪些视视频转码服务？答：目前支持奥看和登虹 2，园区目前对接哪些视频云？答：目前主要对接了华为的IVS3800， IVS1800。其他平台的暂时还没支持 3，如何调试园区的视频调阅功能？答： 针对不通的使用场景，调试视频调阅功能文档如下20.3 spc2 版本 综合安防 :https://support.huawei.com/bescloud/Smart%20Campus/20.3.0.SPC2/topic/view.do?projectid=623221184&lang=zh&pidid=pid_bookmap_0173399978&topicid=TOPIC_019409820121.2 版本 智慧安防场景：https://support.huawei.com/bescloud/Smart%20Campus/21.2/topic/view.do?projectid=328572906&lang=zh&pidid=pid_bookmap_0000001075549332&topicid=TOPIC_00000010747697634，目前视频码流播放样式有哪几种?画面播放时，有两种播放样式可选择（默认标准）：填充：画面铺满播放窗口。该模式不会出现画面两边有黑框的现象。标准：根据获取到的视频流画面按比例播放。该模式不会出现画面压缩变形的情况。5，摄像头不支持云台控制，视频巡更过程通过云台操作上下旋转，无反应，也没有任何提示信息。原因分析只有“球机”类型的摄像头且“设施信息管理”中，摄像头的实例属性中的“摄像机类型”设置为“2”时，才支持云台控制功能。摄像头主要有如下类型：0：固定枪机1：云台枪机2：球机3：半球-固定摄像机4：筒机解决方法如果摄像头不是“球机”类型，界面给出提示信息“此设备为非球机，不支持云台控制”。如果想要云台控制功能，请更换“球机”类型的摄像头。如果是“球机”类型，但是摄像头的实例属性中的“摄像机类型”属性值设置不是“2”时，界面给出提示信息“此设备为非球机，不支持云台控制”。如果想要云台控制功能，请修改该属性值。6，摄像头不支持缩放功能，视频巡更过程通过云台操作放大或者缩小界面，无反应？原因分析目前“枪机”类型的摄像头不支持缩放功能。摄像头主要有如下类型：0：固定枪机1：云台枪机2：球机3：半球-固定摄像机4：筒机解决方法如果摄像头是“枪机”类型，想要缩放功能，请更换其他类型的摄像头。如果摄像头不是“枪机”类型，但是摄像头的实例属性中的“摄像机类型”属性值设置是“0”或“1”时，请修改该属性值为“2”或“3”或“4”。7，摄像头不能回放视频问题现象视频监控中摄像头不能回放视频（如下图）。错误提示信息：This is a modal window.The media could not be loaded, either because the server or network failed or because the format is not supported.图1 报错页面图2 页面请求请求：https://192.168.109.80:32000/service/VideoProxy/0.1.0/playback?async=true&cameraCode=05434850000000000101%23844a6a17272e423789d9d37bf7cb1749&mediaType=MP4&startTime=1602660120000&endTime=1602660180000参数：async=true&cameraCode=05434850000000000101%23844a6a17272e423789d9d37bf7cb1749&mediaType=MP4&startTime=1602660120000&endTime=1602660180000响应报文：{"resCode":"0","resMsg":"成功","result":[{"url":"http://192.168.109.48:8081/snap/054348500000000001012020101407220020201014072300060.mp4?vpath=rtsp%3A%2F%2F192.168.125.7%3A554%2F05434850000000000101%3FDstCode%3D01%26ServiceType%3D4%26ClientType%3D1%26StreamID%3D1%26SrcTP%3D2%26DstTP%3D2%26SrcPP%3D0%26DstPP%3D1%26MediaTransMode%3D0%26BroadcastType%3D0%26SV%3D1%26TimeSpan%3D20201014T072200Z-20201014T072300Z%26Token%3DV31YwEeQ-6XzziE8sAOaMJa-pUp-4Hqw%26Multiplex%3DARrkCJ8KNbGZBEOdmABlZ3gwqTc8HA3I%26DomainCode%3D4cab6ad0e3fc4de1a5bd20b70fcb2c0a%26UserId%3D6%26\u0026duration=60\u0026offset=0\u0026scale=255"}]}原因分析返回的url是http格式的地址，https的页面上播放http的url会出现播放异常问题，需要获取https的播放地址。解决方法调用“获取回放地址”接口时，“protocolType”参数的值需要设置为“2”，接口详情请参见《业务资产说明》或者参考https://support.huawei.com/bescloud/Smart%20Campus/21.2/topic/view.do?projectid=328572906&lang=zh&pidid=pid_bookmap_0172866781&topicid=TOPIC_02015550138，dmax上面预置视频播放组件不能显示视频问题现象1、dmax上面预置视频播放组件不能显示视频2、上面的prefix到底是配置什么？文档里没有写清楚。解决方法单独使用视频播放组件无法直接放视频。需要用其他组件将下图这个动作的变量传过来 事件与动作的配置可以参考以下文档：https://support.huawei.com/bescloud/BES%20Cloud%20Open%20Platform/1.2/topic/view.do?projectid=bes_cloud_platform_zh&lang=zh&pidid=pid_129668509270112493999&topicid=ZH-CN_TOPIC_01851519769，从roma获取摄像头视频流url，使用本地VLC能够播放，但IOC请求视频流url失败问题现象1、点击右侧摄像头列表： 2、查看network：* 视频代理BO的接口：/service/VideoProxy/0.1.0/liveservice/VideoProxy/0.1.0/live 返回一个视频流url （url正确，与roma侧调试的一致）* 请求这个视频流url 请求失败：  3、复制这段视频流url，在本地使用VLC工具，打开串行流，能够正常播放视频：  原因分析 IOC是https协议的，而视频地址是http的，所以无法正常请求解决方法将视频地址换成https协议即可

本贴是统一地理空间服务对接调试FAQ总结帖，持续跟新1，什么是统一地理空间服务？答：在IoT业务中，有许多场景需要业务应用和GIS系统产生交互，包括展示设备、展示告警、展示规划路径、展示人员热力、获取设备位置等。为了使业务应用的开发人员能    更方便高效地实现与GIS系统交互的功能，园区对GIS系统相关的交互进行业务抽象，封装为统一地理空间服务。它包括如下三个部分：GIS BO，用于管理GIS厂商的连接信息以及地图实例数据对应关系。GIS SDK（2D/3D），封装各个GIS厂商的SDK，对业务提供了归一化的SDK，供页面集成。伙伴可以基于GIS SDK开发项目特定的Widget。GIS Widget，基于AppCube提供的GIS组件，可以直接被AppCube开发的IOC或者高级页面集成。2 ，园区已经对接了哪些GIS厂商的地图？答： 对接了伟岸纵横2D、3D，超图2D、3D，中地数码，数字冰雹，51 VR，睿呈时代，或者其他的互联网地图，如高德，百度. 3，项目中该如何调试地图？答：项目中调试地图分为两部分：，AppCube与GIS对接https://support.huawei.com/bescloud/Smart%20Campus/21.2/topic/view.do?projectid=1150885542&lang=zh&pidid=pid_bookmap_0000001137862713&topicid=TOPIC_0000001132788016，GIS服务的配置https://support.huawei.com/bescloud/Smart%20Campus/20.3.0.SPC2/topic/view.do?projectid=623221184&lang=zh&pidid=pid_bookmap_0173399978&topicid=TOPIC_0000001184756498 4，项目中使用的地图，不在已经对接的地图范围内的地图，该如何对接？答：如果不在已经对接范围内，那么项目中需要伙伴或者GIS厂商按照标准说明自行对接，主要有以下两点，1，开发地图与园区GIS BO的适配器。2，在App Cube中配置地图服务的Nginx 代理。具体操作可以参考：https://support.huawei.com/bescloud/Smart%20Campus/21.2/topic/view.do?projectid=1150885542&lang=zh&pidid=pid_bookmap_0000001137862713&topicid=TOPIC_0000001132788054 5，GIS BO中上传数据包报错，导致地图数据包上传报错的原因是厂商地图服务器出现问题。问题现象在GIS BO的地图权限管理上传数据包，会看到如下图所示的报错信息原因分析地图厂商服务器出现问题，导致数据包上传失败。解决方法联系地图厂商解决服务器问题。查看运行态是否可以正常加载出地图，若能加载出地图则说明厂商服务器已经恢复正常。  6，运行态报地图实例找不到问题，导致地图加载不出来的原因是没有给使用项目的页面添加地图实例，导致页面无法显示地图？问题现象在运行态页面地图加载不出来，如下图1所示的报错，按下F12，会看到如下图2所示的报错信息。图1 报错信息1图2 报错信息2原因分析GIS BO的地图权限管理中没有配置地图实例或者地图实例被删除了，导致运行态加载地图找不到地图实例。解决方法登录AppCube平台。单击“管理>应用管理>BO配置”。单击“GIS”，进入GIS管理界面单击“地图权限管理”，进入地图权限管理界面。单击“动态地图属性”，进入动态地图属性配置界面。单击地图所在的项目名称操作列下的编辑图标，进入项目地图属性详情界面单击“地图类型”选择所需的地图，例如选择伟岸纵横地图，选择地图类型名称，例如伟岸纵横地图名称areaJwazh完成配置后，单击“保存”。进入运行态界面，可看到地图加载出来，按下F12，即可查看到之前的报错已经解决。   

在租户升级之前，需要备份在数字平台开发环境上定制的代码。例如：应用（含Addon应用），定制的IO资产。AppCube上的定制应用备份参考随基线版本发布的文档《华为智慧园区解决方案 XXX 二次开发指南》的“获取应用的zip包”和“归档应用的实例化数据”章节进行备份定制应用。ROMA上的定制IO资产备份支持直接从ROMA平台导出IO包到本地。登录ROMA平台。选择“管理控制台 > 模型管理 > 导入导出管理”，进入“导入导出管理”界面。对于多个IO的情况：导出后，如果后续需要通过ROMA前台再导入到目标环境，多个IO包请同时导出，即导出为一个zip包。导出后，如果后续需要通过工具从ROMA后台再导入到目标环境，多个IO包请分别导出，即每个IO导出一个zip包。图1 导出IO勾选需要导出的IO后，单击“导出”，可以将IO包保存到本地。

创建系统管理员账号“系统管理员”是园区基线版本预置的一个角色，具有智慧园区运营中心（SmartCampus Operation Center，以下简称IOC）所有菜单的操作权限。属于“系统管理员”角色的用户账号，一经创建就不允许修改角色，也不能重置密码。登录AppCube平台。依次选择“管理>应用管理>应用导航”，搜索“System Management”。单击预览按钮，进入系统管理运行态。选择“用户管理”，单击“创建”，弹出“创建用户”对话框。输入用户账号等信息，选择“用户角色”为“系统管理员”，选择“添加组织”的组织为“集团有限公司”和组织岗位为“经理”，单击“确定”，创建完成。首次登录，系统会强制要求修改初始密码。切换“统一门户”应用页面，单击后，单击“单击进入智慧园区运营中心”。跳转到如下登录页面表示系统正常。图1 IOC页面输入管理员账号登录IOC，单击各个子菜单检查业务显示是否正常。

原生服务客户端配置在客户端需要创建并配置OAuth鉴权信息。创建子账号。因为沃土平台的要求，必须先完成租户实名认证，才能新增子账号。访问沃土数据平台官网。使用客户AppCube租户账号登录。鼠标放在界面右上角的租户名称上，单击“个人中心”。选择“我的账号 > 子账号管理”，进入子账号管理界面。单击“新增”。填写账号名、密码、邮箱、手机号。单击“提交”。账号名建议配置为租户名_Batch_API_USER。修改子账号的Profile。使用客户AppCube租户账号登录AppCube生产环境。选择“管理 > 用户管理 > 用户”。在用户列表中可以看到上一步在华为沃土数据平台上创建的子账号。该子账号的默认Profile是“Developer Profile”。单击用户名，打开用户编辑界面，将其Profile修改为“BatchServiceProfile”。选择“管理 > 系统管理 > OAuth”，单击“新建”创建一个OAuth。“用户”选择上一步创建的用户。创建成功后，在OAuth界面单击后面“操作”列中的下载文件，获取client_id和client_secret。选择“管理 > 应用管理 > BO配置”。单击“BatchFile”，进入批量操作BO配置页面。单击“租户鉴权配置”，单击“新建”配置。鉴权ID和鉴权密钥分别为3中获取的client_id和client_secret。每个租户只能配置一条记录，如果已存在可以直接修改。单击“批量参数配置”，单击“新建”配置相关参数。配置“BATCHFILE_STORAGE”为“SmartCampus__Object_Storage_Restricted”。批处理相关文件保存的文档使用的对象存储代理连接器。图1 模板参数配置

背景说明当某一个租户下安装的原生服务需要提供给其他租户服务时，安装了的原生服务的租户为服务端，需要使用原生服务的租户为客户端。在客户端还需要配置原生服务的相关参数和AppCube平台的URL地址。操作步骤以其他需要使用原生服务的租户用户登录AppCube平台。选择“管理 > 应用管理 > BO配置”。单击“Template”，进入模板BO配置页面。单击“模板功能配置”，若是参数不存在，则新增以下相关参数；若参数已存在，则修改其参数值。表1 新增模板参数参数名说明BUCKET桶名称。取值请在“应用管理 > 连接器 > 对象存储代理”中获取对应对象存储代理使用的桶名称。建议获取SmartCampus__FileOperator对象存储代理使用的桶名称。CONNECTOR_NAME连接器名称。取值请在“应用管理 > 连接器 > 对象存储代理”中获取对象存储代理的名称。建议值：SmartCampus__FileOperator。单击“系统参数配置”，配置TemplateBO_URL系统参数。TemplateBO_URL设置为提供原生服务的AppCube平台的URL，例如https://abc_dev.test.com。

操作步骤进入AppCube的租户管理台。依次选择“管理 > 应用管理> BO配置”，单击“GIS”，进入GIS BO配置界面。（可选）单击“GIS系统参数”菜单，检查对应的GIS地图相关的系统参数。GIS地图服务的地址，管理员账户和密码已经在开通时配置完成，可参考《调测指南》中的“调测参考-BO配置 > 配置GIS BO”章节，检查对应GIS厂商的相关参数是否已经配置。单击“GIS类型管理”，创建GIS系统用户。表1 创建GIS系统用户参数如何配置GIS厂商根据实际GIS服务选择，例如“伟岸纵横”，“超图”。GIS用户名配置需要创建的GIS用户名，建议配置为租户名。（可选）单击“地图权限管理”，进入地图权限管理页面。单击“上传地图”，显示地图上传弹窗。开发环境中已经导入了华为基地J区的地图。默认可以直接使用。如果要用项目其他区域的地图，则还需要自己导入。“地图名称”：自定义“GIS厂商”：从下拉框中选择对应GIS厂商。“单击上传”：需要向地图供应商获取。“权限编码”：用户自定义权限编码，“权限编码”是地图的唯一标识符，用户根据需要自行填写，具有唯一性。（可选）修改基线应用中使用的GIS地图。默认基线应用中的地图使用的是超图，如果需要在GIS BO中切换APP的地图为伟岸纵横，可以参考《调测指南》中的“调测参考-系统间对接 > AppCube平台与GIS对接 > 在运行态切换地图服务”章节切换。

设置参数。以普通用户账号登录ROMA Portal。在ROMA管理控制台的菜单栏中，切换到“XXX__华为视频分析平台”，XXX对应当前的登录用户名。选择“服务集成 > Live Data > 资源管理 > 环境配置”，进入“环境配置”页面。编辑如表2中的参数。多环境场景下有多套环境变量，每套环境变量对应一套华为视频分析平台，环境变量通过环境编号后缀区分。channel值确定了路由到哪个IO适配包，环境编号后缀确定了同一个适配包路由到哪个南向子系统，目前仅预置了2套环境变量，可根据实际环境情况，新增环境变量。园区基线版本默认对接的是0号环境。与环境变量对应的channel值为“video.huawei.vcm”，“video.huawei.vcm_1”.......，后缀可依次递增。表2 参数说明参数名称参数说明dstIp0号环境IVS服务端地址，用于判断是否NAT（Network Address Translation）场景。南向是IVS1800时，配置为IVS1800在防火墙上的Nginx 18531端口对应的IP，可从网络规划中查看。南向是IVS3800时，配置为CSP上“NAT组网管理”中“VCMMediaProcService”的“映射IP地址”。图2 VCMMediaProcService映射IP地址romaEIPROMA网关绑定的EIP地址和端口，用于NAT场景。地址类型是“https://IP:port”，具体地址和端口请向运维人员获取。注意：如果ROMA平台网关地址公开或者绑定了EIP、公网、大网，请在属性设置中设置该地址，以便南向环境将数据推送到ROMA平台，主要解决ROMA平台和南向环境不在同一网络中的问题，否则无需设置。southIP0号环境IVS服务的IP，例如“10.171.5.153”。南向是IVS3800时获取方法如下：如果ROMA能通过私网访问IVS：登录CSP，进入“应用配置 > 配置管理 > 双机管理”，查看“NGINX”的“外部业务地址”，如图3所示。图3 NGINX的外部业务地址如果ROMA不能通过私网访问IVS：配置为图3中IP映射到公网的IP。southPort0号环境IVS服务的端口。南向为IVS1800时，配置为“18531”。南向为IVS3800时，配置为VCM NGINX对第三方平台开放服务的端口，默认为“443”。使用小网地址时，请保持默认值；使用公网地址时，配置为实际的映射到公网的端口号。southUrl0号环境IVS服务地址，地址的类型是“https://IP:port”，或者“https://域名”。可以通过此参数的值也可以通过southIP与southPort的值登录IVS系统，如果两种都设置了，以southUrl的值为准。southUser0号环境IVS系统登录用户名。需要创建专用的IVS对接账号，一个IVS用户只对接一套IO环境。不能使用admin用户登录IVS，因为admin用户只允许单点在线，会导致admin用户不能登录IVS系统，做其他操作。南向为IVS1800时，IVS对接账号角色为“普通操作员”即可，该账号需要分配摄像机查看权限，并取消勾选“是否启用账户有效期”。南向为IVS3800时，账号要求如下：先创建“普通角色”和“智能角色”，再创建用户，密码设置为永不过期。创建账号后需要立即修改密码。如果账号密码或IP更改了，需要重新对接。IVS登录用户需要具备“设备管理”和“用户管理”的权限。timeZone0号环境IVS服务时区，例如“Asia/Shanghai”。dstIp_11号环境IVS服务端地址，用于判断是否NAT场景。southIP_11号环境IVS服务的IP。southPort_11号环境IVS服务的端口。southUrl_11号环境IVS服务地址，地址的类型可以是https://IP:port，或者是https://域名。可以通过此参数的值也可以通过southIP_1与southPort_1的值登录IVS系统，如果两种都设置了，以southUrl_1的值为准。southUser_11号环境IVS系统登录用户名。timeZone_11号环境IVS服务时区。mqsHostTopic的URL。获取方法请参见“获取ROMA MQS服务地址”。publisherAppIdTopic的发布应用的ID。配置为“XXX__video.huawei.vcm”，XXX对应当前登录的用户名。enableEnvironmentList多环境场景下，哪套华为视频分析平台生效。可配置多个值，用“,”分隔。选中所有参数，单击“全部发布”。选择“服务集成 > Live Data > 资源管理 > 密码箱管理”，配置VCM登录密码，编辑如表3中的参数。表3 参数说明（VCM登录密码）参数名称参数说明视频分析VCM登录密码所属应用：XXX__华为视频分析平台key：southSecret类型：密码密码：0号环境IVS系统登录密码视频分析VCM登录密码_1所属应用：XXX__华为视频分析平台key：southSecret类型：密码密码：1号环境IVS系统登录密码。华为视频分析平台Topic的发布应用的密钥所属应用：XXX__华为视频分析平台Key：publisherAppKey类型：密码密码：发布MQS消息的应用密钥，配置为“华为视频分析平台”应用的请求密钥，获取方法请参见“获取ROMA应用的请求密钥”。选择“服务集成 > Live Data > 资源管理 > 定时任务”，只能启动如下定时任务中的一个，其它定时任务都不能启动。对接的南向系统版本是ivs1800时，启动“用户保活定时任务”定时任务。对接的南向系统版本是ivs3800时，启动“华为视频分析平台登录”定时任务。单击定时任务操作列的“记录详情”，“resultCode”返回200时表示登录成功。验证对接以调用“获取摄像机列表”接口为例，验证ROMA是否与华为视频分析平台对接成功。选择“服务集成 > API网关 > API测试”。搜索“获取摄像机列表”，单击“测试”。设置请求参数，单击“测试API”。body体参数设置如下：page：单次查询页码编号。limit：单页内显示记录数，最小值为1，最大值为5000。{ "query": { "page": "1", "limit": "1" } }返回类似如下消息，表示接口调用成功。ROMA与华为视频分析平台对接成功。{ "response": { "result": { "code": "0", "errmsg": "Success." }, "onlineCount": "14", "count": "10", "total-count": "20", "camera-list": { "camera": [{ "camera-use": "0", "resolution-type": "1280*720 (720P)", "plat-name": "vcn", "sub-status": "0", "address": "", "mount-height": "0", "latitude": "", "groupId": "0", "field-no": "a30b886e9cab43d2be92e04c985c34bc", "nvr": "bb14b856376040a8b4e24e4831b100ff20181127171338", "camera-feature": "0", "vcnCameraUse": "0", "compass": "0", "stream-url": "172.xxx.xxx.20", "name": "172_20", "taskTypeList": { "taskType": ["2"] }, "id": "24", "sn": "07247090000000000101#a30b886e9cab43d2be92e04c985c34bc", "analysisList": { "analysisType": ["0010"] }, "camera-type": "2", "lane": "0", "camera-state": "0", "direction": "", "longitude": "" }] } } }

对接流程给如下API添加白名单，白名单地址配置为VCM的服务地址。VCM可以调用该API推送告警消息。对于“人员检索”、“人脸库对比”和“车辆检索”场景，因为不需要推送告警消息，所以无需添加白名单。南向是IVS1800时：需要给“IVS1800告警回调接口”、“推送VCM告警消息（ivs1800）”接口添加白名单。南向是IVS3800时：需要给“IVSSDC车辆告警回调”、“推送VCM告警消息”接口添加白名单。设置参数：将登录VCM的参数和MQS相关的参数设入ROMA平台。启动定时任务：启动“华为视频分析平台登录”定时任务。对接操作添加白名单。“人员检索”、“人脸库对比”和“车辆检索”场景不需要执行本步骤。以“admin”用户登录ROMA平台。admin用户的密码请向运维人员获取。切换应用到“华为视频分析平台”。选择“服务集成 > API网关 > API授权”。单击如下接口对应的“授权”，分别为它们添加白名单。南向是IVS1800时：需要给“IVS1800告警回调接口”、“推送VCM告警消息（ivs1800）”接口添加白名单。南向是IVS3800时：需要给“IVSSDC车辆告警回调”、“推送VCM告警消息”接口添加白名单。表1 配置白名单参数名称参数说明应用ID选择需要授权的应用ID：xxx__video.huawei.vcm。白名单如果是南向系统是IVS1800，配置为IVS的业务IP。如果是南向系统是IVS3800XF，配置为IVS的PDPC的“外部业务IP”，IP之间用“,”隔开。获取方法：登录IVS的CSP Portal，选择“应用配置 > 配置管理 > 节点管理”，搜索“PDPC”，查看PDPC容器的外部业务IP。线下ROMA平台的浮动IP地址，在ROMA平台“服务集成 > API网关 > 网关管理 > 网关域管理”中获取。注意：白名单中的IP地址可以访问ROMA API，存在安全风险，请慎重配置。插件配置添加插件：插件名称：sign request插件值：{"enable": "false"}绿色通道打开开关。注意：白名单配合绿色通道同时使用，标识白名单中的IP地址是否需要身份验证。关闭：白名单中IP地址访问ROMA API时，需要进行密钥认证或JWT认证。开启：白名单中IP地址访问ROMA API时，不需要进行密钥认证或JWT认证。开启后，系统将以白名单中应用IP地址作为绿色通道入口，此模式存在安全风险，请慎重选择。API参数无需配置。流控配置无需配置。图1 API授权并添加白名单

在校验人脸通行权限时，北向的人员类型是按照项目需求配置的，IO支持人员类型映射表配置，把北向的人员类型映射成对应PAD支持的人员类型。以普通用户登录ROMA Portal。在ROMA管理控制台的菜单栏中，切换到“XXX__依图闸机通行PAD接口IO”，XXX对应当前的登录用户名。依次选择“环境管理 > 服务配置”。系统进入“服务配置”页面。新增参数。以“STAFF”为例，方法如下：单击“新增”。补充必填信息。“key”对应AppCube平台人员BO配置的“人员类型定义”的“标识符”。“value”可选为11或者12，“模块”为“APIC”。表1 参数说明参数名称参数说明STAFF依图闸机通行PAD拍照发送给园区人员通行服务后，返回的值，可配置。该参数的值可配置为“11”，代表可以通行，根据实际情况配置。VISTOR依图闸机通行PAD拍照发送给园区人员通行服务后，返回的值，可配置。该参数的值可配置为“12”，代表不可以通行，根据实际情况配置。选中所有参数，单击“全部发布”。

IO Adapter用于将应用侧下发的请求，正确的路由到指定的IO适配包。创建AppCube用户。登录AppCube平台。选择“管理>用户管理>用户”，单击“新建”创建用户。输入用户信息，选择用户权限，单击“保存”。如下图所示。“权限”配置为实例化预置的“IOAdapterServiceProfile”。“用户名”建议配置为租户名_IO_User_Profile。如果是沃土平台的AppCube，无法在AppCube平台上创建用户，需要在沃土数字平台官网上单击“个人中心”。选择“我的账号 > 子账号管理”，创建子账号，子账号的默认Profile是“Standard User Profile”。必须先完成租户实名认证后才能新增子账号。实例化预置的“IOAdapterServiceProfile”拥有人员通行和人员管理应用的访问权限。如果用户名已经存在且权限是“IOAdapterServiceProfile”，不需要重复创建用户。获取AppCube的鉴权信息。登录AppCube平台。选择“管理 > 系统管理 > OAuth”。单击“新建”，输入名称，“授权类型”选择“客户端模式”，选择上个步骤创建的用户，并单击“保存”。系统会自动生成客户端ID和客户端密钥。每个OAuth都有特定的用途，因此需要为AppCube鉴权信息单独新建一个OAuth。该OAuth关联的用户需要具有访问相关API的权限，否则回调时会因为权限问题失败。单击，下载excel文件，从中获取AppCube平台鉴权ID和鉴权密钥。返回ROMA Portal，并打开“IO Adapter”应用。设置参数。选择“服务集成 > Live Data > 资源管理 > 环境配置”，编辑如下参数。表1 参数说明（IO Adapter）参数名称参数说明southDomainAppCube平台服务地址，可使用域名（例如dev.besclouds.com），也可使用IP地址加端口号（例如192.168.28.162:31134）。此参数与“southUrl”二选一。grantType鉴权模式，目前为固定模式：client_credentials。southUser客户端ID，即AppCube平台鉴权ID。southUrlAppCube平台服务地址。格式为https://+域名，或者https://+IP:端口号。此参数与“southDomain”二选一。选中所有参数，单击“全部发布”。选择“服务集成 > Live Data > 资源管理 > 密码箱管理”，编辑参数。表2 参数说明参数名称参数说明bingo服务鉴权密钥所属应用：XXX__IO Adapterkey：southSecret类型：选择“密码”。密码：AppCube平台鉴权密钥。启动定时任务。选择“服务集成 > Live Data > 资源管理 > 定时任务”。选中“ABC鉴权”，单击“启动”。单击“记录详情”，检查定时任务是否启动成功。如果日志返回中有"resultCode": "200"，表示启动成功。

人员通行场景需要先定义出入口，并为出入口关联通行设备。创建出入口创建出入口的步骤如下。登录智慧园区运营中心。依次选择“便捷通行>出入口管理>配置出入口”。选择需要创建的出入口空间位置，单击“配置出入口”，单击“创建”。图1 “配置出入口”页面弹出“创建出入口”窗口，配置出入口相关信息。出入口管理员，用于在“便捷通行>通行权限管理>通行授权”页面，管理出入口的通行权限。只有出入口的管理员，才能给该出入口进行通行授权。图2 配置出入口相关信息选择已经配置好的出入口，单击此出入口后面的设备图标。为通行设施，为其他设施。校验设备规格编码为“PAD”时，控制设备的规格编码必须为“Turnstile”。校验设备规格编码不是“PAD”时，控制设备的规格编码都为“AccessControl”。图3 关联设施弹出关联设施页面，配置相关信息，控制设备与检验设备为同一设备。“基础信息”：选择控制方向。“选择校验设备”：关联已有的设备，用于校验人员通行权限。“选择控制设备”：关联已有的设备，用于控制人员出入。图4 通行设施信息列表图5 其他设施信息列表单击“确定”。创建出入口组创建出入口组，用于管理有关联的出入口，步骤如下。登录智慧园区运营中心。依次选择“便捷通行>出入口管理>配置出入口”。选择需要创建的出入口空间位置，单击“配置出入口组”，单击“创建”。图6 “配置出入口组”页面弹出“创建出入口组”窗口，配置出入口组相关参数。“关联出入口”：选择已创建的不同出入口，添加到出入口组中，便于管理。“管理员选择”：出入口组管理员，用于在“便捷通行>通行权限管理>通行授权”页面，管理出入口组的通行权限。只有出入口组的管理员，才能给该出入口组中的出入口进行通行授权。图7 配置出入口组相关信息单击“确定”。

登录IOC后，当IOC操作员一段时间内未操作系统，登录将失效；必须重新登录后才可重新操作。园区解决方案的登录会话管理使用的是AppCube平台会话管理机制。在AppCube平台设置会话时长，即可实现对园区操作员会话访问时长的管理。配置步骤AppCube默认的会话时长已在安装阶段配置，调测阶段默认不用修改，IOC操作人员可继承该会话时长。如果项目中需要修改，可根据需要为不同的“角色”设置访问凭证时长。登录AppCube平台。登录的AppCube账号，必须拥有System Administrator Profile权限，才能修改访问凭证时长。依次选择“管理 > 用户管理 > 权限配置”。单击需要配置的权限名称，进入详情页面。IOC角色与AppCube平台权限的对应关系如下表所示。表1 角色对应的权限名称IOC角色名称AppCube权限名称说明自定义角色Portal User Profile园区用户“自定义角色”的权限对应“Portal User Profile”，园区用户创建新的“自定义角色”时，会自动继承“Portal User Profile”的设置（“自定义角色”是指非园区系统预置的角色，由用户自己创建。系统管理员SM_Administrator园区系统预置角色“系统管理员”的权限对应“SM_Administrator”名称，园区创建新的“系统管理员”时，会自动继承“SM_Administrator”的设置。普通操作员SM_Operator园区系统预置角色“普通操作员”的权限对应“SM_Operator”名称，园区创建新的“普通操作员”时，会自动继承“SM_Operator”的设置。单击页面右上角的编辑图标，页面进入修改状态。图1 编辑图标选择“自定义”，设置“访问凭证时长”和“刷新凭证时长”。单击右上角图标，修改完成。“访问凭证时长”和“刷新凭证时长”必须同时设置“默认”或者“自定义”。图2 配置详情页面

问题现象登录AppCube平台时报如下错误，登录提示418您的请求疑似攻击行为（APP）。原因分析由于安全问题，某些IP可能无法访问，AppCube平台的域名或者IP被华为云WAF拦截了。解决方法在本BBS论坛提问题帖子，通知运营团队将您的运营商公网IP或您开发中使用的URL加入白名单里即可。

对接步骤配置系统参数。登录AppCube平台。依次选择“管理 > 应用管理> BO配置”，单击“GIS”，进入GIS BO配置界面。单击“系统参数”，配置如下系统参数。表1 配置系统参数系统参数值GIS_WazhMap_URL2D/3D伟岸纵横标准版/高级版地图服务地址。安装完GIS系统后，需要在AppCube平台的nginx中配置GIS系统的路由信息。配置规则是AppCube平台域名+GIS系统上下文根。如果已配置路由信息，则地图服务地址为：AppCube地址+/iserver_wazh。如：https://app.besclouds.com/iserver_wazh。GISBO_WazhAdminUserNameGIS厂商（2D/3D伟岸纵横标准版/高级版）管理员账户，安装服务器时的管理员账号。GISBO_WazhAdminPassWordGIS厂商（2D/3D伟岸纵横标准版/高级版）管理员密码，安装服务器时管理员账号的密码。GISBO_SecurityMode本参数仅影响：中地标准版2D/3D地图，超图2D、伟岸标准版2D。选择GIS服务安全模式，当SDK升级而地图服务器未升级时，该参数配置为1，默认为0。0：GIS SDK访问地图服务的时候，Token放在请求Header中。1：GIS SDK访问地图服务的时候，Token放在请求URL中。创建GIS用户。在GIS BO配置界面，单击“GIS类型管理”，进入类型管理页面。单击“新建”。根据选择的地图厂商创建GIS系统用户。GIS厂商：使用2D地图时，选择“伟岸纵横”；使用3D地图时，选择“伟岸纵横3D”。GIS用户名：自定义。图1 新建GIS用户单击“保存”。系统会使用系统参数中配置的GIS服务基地址、管理员账号、密码，在GIS系统中新建一个用户。（如果原来有伟岸纵横的记录，执行本操作会更新记录，使用新的GIS用户名，同一个厂商的GIS用户记录在AppCube上仅保留最后创建的一份）。创建地图权限编码。在GIS BO配置界面，单击“地图权限管理”，进入地图权限管理页面。单击“上传地图”，显示地图上传弹窗。图2 上传地图表2 上传地图参数说明参数名称说明地图名称自定义。GIS厂商使用伟岸纵横2D地图时：选择“伟岸纵横”。使用伟岸纵横3D地图时：选择“伟岸纵横3D”。权限编码自定义。地图数据包使用伟岸纵横2D地图时：单击“点击上传”按钮，选择地图厂商提供的地图数据包，上传到GIS BO中。使用伟岸纵横3D地图时：这里不需要上传，由地图厂商发布。地图服务如果地图数据包是在GIS BO中上传的，该参数无需配置。如果厂商在提供地图服务器时已经发布了项目需要的地图服务，该参数配置为厂商发布的地图服务的信息，由伟岸纵横厂商提供。伟岸纵横厂商给项目提供的DEMO中包含这个服务信息，可以直接获取。以areaJwazh服务为例，格式如下：[{"serviceType":"RESTMAP","serviceAddress":"map-VRGV/rest"}, {"serviceType":"RESTDATA","serviceAddress":"data-VRGV/rest"}, {"serviceType":"RESTADDRESSMATCH","serviceAddress":"addressmatch-VRGV/restjsr"}, {"serviceType":"RESTTRANSPORTATIONANALYST","serviceAddress":"transportationAnalyst-VRGV-VRGV/rest","dataset":"Park"}, {"serviceType":"RESTTRANSPORTATIONANALYST","serviceAddress":"transportationAnalyst-VRGV-VRGV-F01/rest","dataset":"F01"}, {"datasourceName":"VRGV"}, {"serviceType":"RESTTRANSPORTATIONANALYST", "serviceAddress":"transportationAnalyst-VRGV-VRGV-F02/rest","dataset":"F02"},{"serviceType":"RESTTRANSPORTATIONANALYST","serviceAddress":"transportationAnalyst-VRGV-VRGV-B01/rest","dataset":"B01"}, {"serviceType":"RESTTRANSPORTATIONANALYST","serviceAddress":"transportationAnalyst-VRGV-VRGV-B02/rest","dataset":"B02"}]外部编码仅在需要实现园区内地图与空间联动时，才需要配置。配置为当前地图对应的空间实例的“空间编码”，详见按空间切换地图。信息填充完成后，单击“保存”。切换基线APP的地图（基线预安装的APP默认使用的地图是超图，当使用其他地图时，可以在GIS BO中切换）。在GIS BO的配置界面，单击“动态地图属性配置”，单击“新建”，进入“项目地图属性详情”页面。图3 切换基线APP的地图配置基线APP的地图参数。表3 切换地图参数说明参数名称说明项目名称即AppCube中的应用名称，选择要切换哪个应用的地图，例如“FacilityManagement”。地图类型选择使用哪种地图类型。地图名称上传地图时填写的地图名称。地图中心经/纬度根据地图实际经纬度配置，尽量接近实际位置。如果偏差太远，会导致地图在页面外。例如J区的经纬度分别为：114.05771866980714、22.657455992129975。地图缩放级别仅2D地图需要配置，例如“17”。最小缩放级别仅2D地图需要配置，例如“1”。最大缩放级别仅2D地图需要配置，例如“22”。地图中心高度仅3D地图需要配置，例如“130”。倾斜角仅3D地图需要配置，例如“0”。俯视角仅3D地图需要配置，例如“-20”。旋转角仅3D地图需要配置，例如“-30”。