房号下发规则
门禁机存在两种按照模式:一种是安装在单元楼下, 称为单元门口机,服务的范围为本单元的房屋。
另外一种是安装在小区大门口,称为围墙机,服务的范围是全小区,或者小区中的一片区域(多个楼栋)。
这两种模式却别由其服务的范围引入:单元门口机服务的是本单元房屋,所以在可视对讲中,输入房号即可定位到目标房屋。
围墙机服务的是小区,或者多个楼栋,那么需要输入具体的楼栋-单元-房号,才能定位到房屋。这将引入门禁机上交互的差异,以及在上文中提到下发组号和房间号的差异。
单元门口机下发的是房号,如上文中映射关系文件格式中提到的:groupId->roomId的规则下文重点对围墙机模式进行解释。
围墙机RoomId字段规则定义如下:
${楼幢}-${单元}-${房号}
例如示下:
1-3-1202
10-3A-1709
最长位数:
3位-3位-5位,规则数字+字母
门禁机交互界面:
1.支持输入 ${楼幢}-${单元}-${房号} 的规则
2.设备端需要有“围墙机模式”和“单元门口机模式”
在围墙机模式下,用户输入楼幢、单元、房号的信息
在单元门口机模式模式下,用户只需要输入房号
围墙机模式由物模型中ExtInfo字段进行下发或者设备端上报,具体的格式定义为:
ExtInfo:
{"intercomDeviceMode":0 //0 单元门口机,1围墙机,默认为单元门口机}
在ExtInfo中增加一个intercomDeviceMode的属性
属性定义如下:
主动查看视频及视频预览
当门禁机发起视频时,室内设备,如猫精,app等需要先行查看门禁视频的内容,再决定是否接听,避免用户与一些无关人员,或者不想会见的人员进行通话。
门禁发起视频门禁
在SIP标准协议中,支持earlymedia(信令:183)模式,在接通前投递音频及视频流。
门禁设备端需要支持呼叫时总是发起EarlyMedia呼叫。
配置EarlyMedia启用
在发起后启动摄像头采集
主动查看门禁视频
用户可以通过猫精端/App主动查看当前楼下门禁机的视频流,应对外卖/快递通过电话呼入的情况,进行二次确认。
主动查看门禁视频通过自动接听的方式完成,整体流程如下:
门禁设备端需要支持的点
配置自动接听
静默接听,不会发出响铃提示
通话时间60S【支持可配置】
使用限制
当门禁设备在呼叫中,无法查看。
同时只允许一个猫精进行查看。
开门事件图片上传
当远程开门时,需要进行开门事件图片留档,方便门禁管理方进行回溯,如下是一个典型的开门事件上报以及传图流程:
ststoken使用OssStsTokenRequest来进行请求,请求时指定需要获取的目标类型。
当前支持的目标类型有:
0:图片文件上传
1:文本文件上传
2:其他类型文件上传
下发的SendOssStsToken中Credentials字段是加密后的ststoken
加密方式为 AES加密,使用的秘钥为设备三元组中的DS前16位,加密模式为:AES/ECB/PKCS5Padding
加密前的源文格式:
{"securityToken":"XXXX","accessKeySecret":"xxxx","accessKeyId":"xxxxx","expiration":"XXXXX"} 服务端口定义
SIP服务接入规范
设备的远程开门服务请遵循人脸+二维码门禁对接中的remoteopen服务进行开门。
5.使用时长
建议设备端侧控制单次使用时长,1~5分钟,最好UI可配置。