设备IO的需求园区一般集成了多种设备，不同设备上报的消息体、格式各不相同，业务平台（AppCube平台）对消息格式有统一化的要求，因此需要在集成平台（ROMA平台）对上报的消息进行拆分、格式化处理，从而屏蔽设备原始消息与标准消息之间的差异问题。基线通过设备IO来实现设备原始消息转化为标准消息的功能。设备IO的功能介绍设备通过IoT（例如新基点IoT）系统接入到ROMA平台。设备IO用于处理设备上报给ROMA平台的消息，以及ROMA平台下发给设备的指令数据，而消息上报和指令下发都要通过IoT（如新基点IoT）来实现。图1 设备IO功能下面以新基点IoT系统、人行闸机设备IO为例，介绍设备IO的消息处理流程，如表1所示。表1 设备IO的消息流程功能流程消息上报人行闸机设备数据变化/告警消息，由新基点IoT IO拆分成设备数据变化或者设备告警消息，并转发给人行闸机设备IO。人行闸机设备IO对数据格式进行转换标准化，并发送到标准Topic完成消息上报。指令下发设备管理标准接口应用路由业务侧的指令到IO Adapter应用。IO Adapter依据“channel”参数确定指令要路由到哪个IoT（南向物联网系统）。“channel”参数用于多IoT平台的场景。例如要将指令路由到新基点IoT，那么业务侧指令应该携带的“channel”值为“basepoint.connectionmax.iot”。南向物联网系统对应的IO通过消息体中的“deviceType”参数，确定要路由的设备IO，并携带accessToken。设备IO将业务侧下发的指令转换为实际物理设备可以执行的指令，并调用南向物联网系统的指令下发接口。

连接实验室认证扩展IO这部分设备IO扩展包随基线版本发布，但默认不安装，项目可根据需要选装。表2 连接实验室认证扩展IO条数分类设备IO“统一设备服务”端对应的设备规格1电气火灾监测系统设备故障电弧探测器设备ArcFaultDetectionDevice2电气火灾检测系统探测器设备ElectrFireMonitorSysDetector3消防电源监控系统设备FirePowerMonitorSys4照明系统路灯设备StreetLight5室外景观照明设备OutdoorLandscapeLighting6室内多回路照明控制器设备IndoorMultLoopLightingController7环境空间监测系统震动传感器设备Vibrating8GPS定位器设备GPSLocator9智能手环设备SmartBand10垃圾桶设备Trashcans11擦手纸余量检测设备TissuePaper12厕纸余量检测设备ToiletPaper13客流统计设备PassengerFlow14多媒体点评器设备Evaluator15洗手液余量检测设备SoapDispenser16井盖检测器设备ManholeCoverDetector17路灯显示屏设备StreetLightDisplayScreen18激光探测器设备LaserDetector19应急指示灯设备EmergencyLamp20水文监测系统水位水质监测设备WaterQualityMonitoring21水文监测设备HydrologicalTelemetery22能耗管理系统能耗管理系统设备EnergyConsumption23智能水表设备SmartWaterMeter24热量表设备HeatMeter25冷量表设备CoolCapacityMeter26火灾自动报警系统报警主机设备AlarmHost27入侵报警系统电子围栏设备ElectronicFence28门磁探测器设备ElecLockDetector29报警主机防区设备AlarmHostDefenceArea30环境空间告警系统管线甲烷气体探测器设备PipelineCH4Detector31管线硫化氢气体探测器设备PipelineH2SDetector32管线温湿度探测器设备PipelineTempAndHumidityDetector33管线压力探测器设备PipelinePressureDetector34管线氧气气体探测器设备PipelineO2Detector35紧急按钮设备EmergencyButton36温湿度监测设备TemperatureHumidity37管道流量监测设备PipelineTrafficMonitoring38液压检测设备HydraulicPressureDetector39水浸检测设备WaterImmersion40液位检测设备LiquidLevelDetector41CH探测器设备CH4Detector42红外探测器设备InfraredDetector43一氧化碳探测器设备CODetector44氨气探测器设备AmmoniaDetector45空气质量探测器设备AirAualityDetector46地埋侧循环泵设备BuriedSideCirculatingPump47定压水泵设备ConstantPressurePump48水处理仪设备WaterTreatmentInstrument49地源热泵机组设备GroundSourceHeatPumpUnit50锅炉补水箱设备BoilerSupplyTank51二次水循环泵设备SecondaryCirculationPump52消防监测系统消防栓监测设备HydrantDetector53消防管道监测设备FireControlPipeDetector54BA400V进线设备InLine400V5510kV进线设备InLine10kV56400V出线设备OutLine400V57电力变压器温控器设备TransformerTempController58交流电通断检测器设备ACDetector59空气断路器设备AirCircuitBreaker60电箱温度传感器设备TempDetector61母联设备BusTieSwitch62电容器设备Capacitance6335kV出线设备Capacitance64主变压器设备MainTransformer6510kV出线设备OutLine10kV66站变设备StationTransformer67110kV分段设备Subsection110kV68直流屏设备DirectCurrentPanel69110kV进线间隔设备IncomingLineInterval110kV70双电源转换开关DualPowerSwitch71TV监控设备TVMonitoringDevice72母线保护设备BusbarProtection73光伏发电设备PhotovoltaicGenerator74柴油发电设备DieselGenerator75电动天窗电动天窗设备PowerSunroof76电梯及扶梯扶梯设备Escalator

园区基线预集成的设备IO包含：基线设备IO、连接实验室认证扩展IO。当对应设备接入园区时无需开发任何代码，可直接接入使用。基线设备IO：随基线版本一起安装，订购园区基线后默认安装好，如表1所示。连接实验室认证扩展IO：IO扩展包随基线版本发布，但默认不安装，项目可根据需要选装，如表2所示。扩展IO详情见连接实验室认证扩展IO。基线设备IO这部分设备IO随基线版本一起安装，订购园区基线后默认安装好。表1 基线设备IO条数分类设备IO“统一设备服务”端对应的设备规格1保安系统设备门禁设备IOAccessControl2泄露电缆设备IOLeakyCable3人行闸机设备IOTurnstile4消防系统设备消防烟感设备IOSmokeDetector5消防温感设备IOTemperatureSensor6消防手报设备IOManualFireAlarmActivation7声光报警设备IOAcoustoOpticAlarm8消防栓按钮设备IOFireHydrantButton9可燃气体探测器设备IOCombustibleGasDetector10能耗系统设备水表设备IOWaterMeter11电表设备IOElectricMeter12燃气表设备IOGasMeter13资产管理设备新基点IoT射频识别标签设备IORFID14新基点IoT射频识别读卡器设备IORFIDReader15环境监测设备户外环境监测设备IOOutdoorEnvSensor16室内环境监测设备IOIndoorEnvSensor17建筑BA设备空调机组设备IOAirHandleUnit18新风机组设备IOPreCoolingAirHandlingUnit19送风机设备IOSupplyAirFan20排风机设备IOExhaustAirFan21冷机设备IOChiller22冷冻水泵设备IOChillerWaterPump23冷却水泵设备IOCoolDownWaterPump24冷却塔设备IOCoolingTower25冷源补水箱设备IOColdSourceSupplyTank26冷源补水泵设备IOColdSourceSupplyPump27冷冻水总管设备IOChilledWaterMainPipe28冷却水总管设备IOCoolDownWaterMainPipe29管道设备IOMainPipe30膨胀水箱设备IOExpansionTank31蓄冷罐设备IOColdStorageTank32电热锅炉设备IOElectricBoiler33锅炉热水泵设备IOBoilerHotWaterPump34供热水泵设备IOHeatingWaterPump35排水泵设备IODrainagePump36生活水泵设备IODomesticWaterPump37集水井设备IOSumpPit38生活水箱设备IODomesticWaterTank39减压阀设备IOPressureReliefValve40室内照明控制器设备室内照明控制器设备IOIndoorLightingController41厕位检测设备厕位检测设备IOToiletPositionDetector42工位检测设备工位检测设备IOWorkStationDetector43升降电梯设备升降电梯设备IOElevator44电梯群控器设备电梯群控器设备IOElevatorClusterController

设备通过IoT网关和平台接入园区时，集成架构如图1所示。图1 设备通过IoT接入南向设备接入的整个业务流程可以分为2部分：数据上报和指令下发，各模块的处理流程如下。数据上报IoT平台能力：南向设备通过IoT网关和IoT平台，将原始数据上报到ROMA MQS的原始topic中。基线预置能力：IoT Adapter IO依据消息类型将消息拆分，并根据设备类型和消息类型转发给对应设备IO的中间层topic。例如人行闸机上报的消息，会转发给“人行闸机设备IO”；门禁上报的消息会转发给“门禁设备IO”。设备IO能力：设备IO将消息转换成标准格式，并发送到“设备标准消息MQS Topic”。基线预置能力：统一设备服务消费标准topic中的消息，转换成事件供业务应用做逻辑判断。指令下发基线预置能力：统一设备服务提供标准化的设备模型和控制命令，无论是对哪种设备下发指令，业务应用都只需调用标准化的指令接口即可。基线预置能力：统一设备服务根据业务侧下发的指令，在设备的标准模型中查询到该设备的指令服务后回调ROMA侧的“设备标准IoT接口”。基线预置能力：ROMA侧的“设备标准IoT接口”依据指令中的“channel”和“deviceType”参数，将指令路由到设备IO。“channel”参数用于多IoT平台的场景，确定指令要下发给哪个IoT平台，例如新基点IoT平台的channel值为“basepoint.connectionmax.iot”。“deviceType”参数确定指令路由到哪个设备IO，deviceType的值来自统一设备服务中定义的标准模型。例如人行闸机的指令会路由到“人行闸机设备IO”，门禁的指令会路由到“门禁设备IO”。设备IO能力：设备IO将业务侧下发的指令转换为实际物理设备可以执行的指令，并回调南向IoT平台的指令下发接口。IoT平台能力：南向IoT平台向实际物理设备下发指令，控制设备的运行。在整个业务流程中，每种类型的设备，都需要有一个对应的设备IO，用于标准化实际设备上报的消息，以及转换业务下发给设备的指令，消息上报和指令下发通过IoT平台来实现。针对园区常见的一部分设备，基线已经预集成了对应的设备IO，无需开发任何代码，可直接接入使用，详细清单参见基线已集成设备。对于不在基线预置内的设备，只需开发对应的设备IO即可，其它部分不需要开发，整个上行/下行流程和业务侧都无需变动，开发流程详见基线未集成设备接入指导。

【功能模块】appcube【操作步骤&问题现象】1、如何隐藏侧边栏【截图信息】【日志信息】（可选，上传日志内容或者附件）

添加子账户，  所有信息填写完成以后，点击提交无反应。

多语言字段翻译函数。注意事项无。基本信息接口名称translate接口路径/service/Common/0.1.0/Common/translate接口协议HTTPS接口方法POST请求参数请求参数如表1所示。表1 请求参数说明参数名称类型必选（M）/可选（O）参数位置参数含义access-tokenStringMCookie | Header授权TOKEN。localeStringOHeader当前界面语言。如zh_CN。objectNameStringMBody对象名称。referenceStringMBody翻译源语言类型。referenceValueStringMBody待翻译源参数值。targetStringMBody翻译目标语言类型。请求样例 { "objectName": "SmartCampus__paramConfig__CST", "reference": "SmartCampus__paramNameCn__CST", "referenceValue": "最高供水温度", "target": "en_US" }响应参数响应参数如表2所示。表2 响应参数说明参数名称类型必选（M）/可选（O）位置参数含义resCodeStringMBody接口的返回码。resMsgStringOBody接口的返回消息。resultOutputs[]OBody接口的响应参数。表3 Outputs参数说明参数名称类型必选（M）/可选（O）位置参数含义valueStringMBody翻译目标值。响应样例{ "resCode": "0", "resMsg": "成功", "result": [ { "value": "" } ] }

基于页面多语言内容获取多语言ID。注意事项无。基本信息接口名称Common_queryResourceIdByLocalName接口路径/service/Common/0.1.0/queryResouceId接口协议HTTPS接口方法POST请求参数请求参数如表1所示。表1 请求参数说明参数名称类型必选（M）/可选（O）参数位置参数含义access-tokenStringMCookie | Header授权TOKEN。localeStringOHeader当前界面语言。如zh_CN。nameStringMBody页面多语言的内容。请求样例{ "name": "test" }响应参数响应参数如表2所示。表2 响应参数说明参数名称类型必选（M）/可选（O）位置参数含义resCodeStringMBody接口的返回码。resMsgStringOBody接口的返回消息。resultOutputs[]OBody接口的响应参数。表3 Outputs参数说明参数名称类型必选（M）/可选（O）位置参数含义resourceIdsString[]MBody/result/outputs包含该多语言内容的所有符合条件的多语言ID，最多返回 5000条数据。响应样例{ "resourceIds": [ "003J000000ZEhn5NPEX2", "003J000000ZLO4uOMJiy", "003J000000ZLOAC8FEJc", "003J000000ZLRfJl4tvc", "003J000000ZLRh8gagIy", "003J000000ZLScfGiUIi", "003J000000ZLSfKEmf0y", "003J000000ZLSpG4xMAK", "003J000000ZLSrrF8qSO", "003J000000ZxVC0H7Dxg", "003J000000a0UU8crER6", "003J000000a0UWVJV5yC", ... ] }

主要用于通过对象名称查询选项列表。注意事项无。基本信息接口名称queryPicklistByObjName接口路径/service/Common/0.1.0/queryPicklistByObjName接口协议HTTPS接口方法POST请求参数请求参数如表1所示。表1 请求参数说明参数名称类型必选（M）/可选（O）参数位置参数含义access-tokenStringMCookie | Header授权TOKEN。localeStringOHeader当前界面语言。如zh_CN。modelNameStringMBody对象名称，长度范围最大60字符。请求样例{ "modelName": "AL_AlarmDef" }响应参数响应参数如表2所示。表2 响应参数说明参数名称类型必选（M）/可选（O）位置参数含义resCodeStringMBody接口的返回码。resMsgStringOBody接口的返回消息。resultOutputs[]OBody接口的响应参数。表3 Outputs参数说明参数名称类型必选（M）/可选（O）位置参数含义picklistDatapicklistData[]OBody返回picklistData的数组，数组的内容可以为空。表4 picklistData参数说明参数名称类型必选（M）/可选（O）位置参数含义itemNameStringMBody选项列表的标签。labelStringMBody选项列表某一条目的名称。valueStringMBody选项列表条某一目的对应的值。响应样例 { "resCode": "0", "resMsg": "成功", "result": [ { "picklistData": { "DefaultLevel": [ { "label": "INFO", "value": "INFO" }, { "label": "NORMAL", "value": "NORMAL" }, { "label": "MAJOR", "value": "MAJOR" }, { "label": "CRITICAL", "value": "CRITICAL" } ], "SourceType": [ { "label": "Manual", "value": "Manual" }, { "label": "ThirdSystem", "value": "ThirdSystem" } ] } } ] }

基于页面多语言内容获取多语言ID。注意事项无。基本信息接口名称Common_queryResourceIdByLocalName接口路径/service/Common/0.1.0/queryResouceId接口协议HTTPS接口方法POST请求参数请求参数如表1所示。表1 请求参数说明参数名称类型必选（M）/可选（O）参数位置参数含义access-tokenStringMCookie | Header授权TOKEN。localeStringOHeader当前界面语言。如zh_CN。nameStringMBody页面多语言的内容。请求样例{ "name": "test" }响应参数响应参数如表2所示。表2 响应参数说明参数名称类型必选（M）/可选（O）位置参数含义resCodeStringMBody接口的返回码。resMsgStringOBody接口的返回消息。resultOutputs[]OBody接口的响应参数。表3 Outputs参数说明参数名称类型必选（M）/可选（O）位置参数含义resourceIdsString[]MBody/result/outputs包含该多语言内容的所有符合条件的多语言ID，最多返回 5000条数据。响应样例{ "resourceIds": [ "003J000000ZEhn5NPEX2", "003J000000ZLO4uOMJiy", "003J000000ZLOAC8FEJc", "003J000000ZLRfJl4tvc", "003J000000ZLRh8gagIy", "003J000000ZLScfGiUIi", "003J000000ZLSfKEmf0y", "003J000000ZLSpG4xMAK", "003J000000ZLSrrF8qSO", "003J000000ZxVC0H7Dxg", "003J000000a0UU8crER6", "003J000000a0UWVJV5yC", ... ] }

【功能模块】【操作步骤&问题现象】1、智慧园区中通过使用用户角色权限功能，已配置好不同角色显示不同菜单2、将智慧园区内配置发布至生产环境，使用户可以直接登录进入系统，如何实现？【截图信息】图1图2图3

如何将园区中配置的菜单发布至正式环境，并可通过链接直接访问园区登录页

附录播放器界面按钮功能表2 播放器界面按钮功能按钮功能详情备注标题栏显示设置后的title，建议设置为cameraName，视频调阅名称。无关闭按钮点击后关闭播放器无屏幕双击屏幕视频全屏播放无暂停按钮播放按钮点击后暂停或播放录像回放无控制云台按钮点击后打开或关闭云台控制台无截屏按钮点击后，进行屏幕图像截取。无全屏按钮点击后视频全屏播放点击按键Esc退出全屏云台控制台功能表3 云台控制功能云台控制台功能详情备注控制云台转向按钮点击后摄像机向按钮标识方向进行转动按住按钮摄像机开始转动，当停止按住按钮时，摄像机转动停止。缩小按钮点击后，通过改变摄像机变焦，使视野变小，画面变大。按住按钮摄像机开始变焦，当停止按住按钮时，摄像机变焦停止。放大按钮点击后，通过改变摄像机变焦，使视野变大，画面变小。按住按钮摄像机开始变焦，当停止按住按钮时，摄像机变焦停止。四屏直播表4 四屏直播功能四屏播放功能功能详情备注实时浏览（单摄像机）在选中的屏幕中，播放相对应摄像机的视频重复选择同一屏幕进行播放，则仅最后传入的对应摄像机编码的视频。实时浏览（URL）在选中的屏幕中，播放相对应URL的视频重复选择同一屏幕进行播放，则仅最后传入的对应URL的视频。实时浏览（多摄像机）播放传入的播放相对应摄像机编码的实时视频使用该功能将取消所有正在播放的视频。录像回放四屏转为单屏，播放相对应摄像机编码，相对应时间的回放视频无录像回看（URL）四屏转为单屏，播放相对应URL的回放视频无传参表5 传参功能事件参数实时浏览（单摄像机）thisObj.triggerEvent("startLive",params);cameraCode, cameraName实时浏览（URL）thisObj.triggerEvent("startLiveUrl", param);url, title实时浏览（多摄像机）thisObj.triggerEvent("startLives",params);cameraCodes录像回放thisObj.triggerEvent("startPlayBack",params);cameraCode,cameraName,startTime,endTime录像回看（url）thisObj.triggerEvent('startPlayBackUrl', param);url, title设置详情表6 设置详情设置基础说明Custom Config组件名称默认为widget+数字Window Type可选择单屏（Single Screen）或四屏播放（Four Screens）Live Media Type播放视频直播的类型，如HTMLPlay Back Media Type播放视频回看的类型，如HTMLSwitch To Live Or Record Mode允许或禁止直播与录像功能切换ServerLive Url/VideoProxy/0.1.0/livePlayback Url/VideoProxy/0.1.0/playbackPTZ Url/VideoProxy/0.1.0/ptzScreen Capture Url/VideoProxy/0.1.0/live/shotScreen Capture PlayBack Url/VideoProxy/0.1.0/playback/shotGet Video Proxy Config/VideoProxy/0.1.0/getConfigPlayer StyleWidth设置组件宽度Height设置组件高度Position可选择组件位置样式，默认（default）或固定（fixed）Top距离页面顶部的距离Bottom距离页面底部的距离Left距离页面左侧的距离Right距离页面右侧的距离z-index堆叠层级保活时间间隔无保活服务地址无ParametersTitle视频标题Move可选择组件是否可拖拽标题改变位置，不可拖拽（Non-dragging）或可拖拽（dragging）Show Head可选择是否显示头部Show Close Button可选择是否显示关闭按钮Show Player可选择是否显示组件Show ToolBar可选择是否显示工具栏Show Slider可选择是否显示进度条Show Play Button可选择是否显示播放按钮Show Opt Button可选择是否显示控制按钮Show FullScreen Button可选择是否显示全屏按钮ParametersZoomZoom说明：当设置为“Zoom”时，可以缩放播放框的大小，最小播放框为默认大小，最大为999*666 px。设置桥接器无FlowConnector_POST可选择组件桥接器POST请求类型FlowConnector_GET可选择组件桥接器GET请求类型FlowConnector_PUT可选择组件桥接器PUT请求类型FlowConnector_DELETE可选择组件桥接器DELETE请求类型建议测试设置表7 设置详情设置基础说明Custom ConfigWindow TypeSingle ScreenLive Media Type奥看HTTP-FLV，登虹HTMLPlay Back Media Type奥看HTTP-FLV，登虹HTMLSwitch To Live Or Record Mode允许切换ServerLive Url/VideoProxy/0.1.0/livePlayback Url/VideoProxy/0.1.0/playbackPTZ Url/VideoProxy/0.1.0/ptzScreen Capture Url/VideoProxy/0.1.0/live/shotScreen Capture PlayBack Url/VideoProxy/0.1.0/playback/shotGet Video Proxy Config/VideoProxy/0.1.0/getConfigParametersMoveNon-draggingShow HeadshowShow Close ButtonshowShow PlayershowShow ToolBarshowShow SliderhideShow Play ButtonshowShow Opt ButtonshowShow FullScreen ButtonshowZoomZoom设置桥接器无FlowConnector_POSTAPIConnector_POSTFlowConnector_GETAPIConnector_GETFlowConnector_PUTAPIConnector_PUTFlowConnector_DELETEAPIConnector_DELETE依赖表8 依赖#依赖类型依赖对象依赖描述1后台API: camera.direction.post基线默认提供camera.direction.post来操控摄像机。在项目定制中可以替换为其他后台API。动作表9 动作#动作名称动作说明入参1Open Camera Window打开指定摄像机的视频流播放小窗口。Camera：要打开的摄像机信息。包含摄像机的设备ID、摄像机的视频流地址URL。2Close Camera Window关闭指定摄像机的视频流播放小窗口。Camera：要关闭的摄像机信息。