SIP设备端对接说明

2. 业务流程

3. 可视对讲物模型说明

进行SIP物模型开发前，需要优先对接人脸和二维码门禁服务，具体对接手册请查看https://help.aliyun.com/document_detail/178726.html， 通过这份对接手册，您将明确怎么使用LinkKitSDK中物模型的开发。

可视对讲门禁物模型

映射关系文件格式示例

{"syncGroupRoomList": [{"groupId": "Group-1","roomId": "Room-1"},{"groupId": "Group-2","roomId": "Room-2"},{"groupId": "Group-3","roomId": "Room-3"},{"groupId": "Group-4","roomId": "Room-4"}]}

房号下发规则

门禁机存在两种按照模式：一种是安装在单元楼下， 称为单元门口机，服务的范围为本单元的房屋。另外一种是安装在小区大门口，称为围墙机，服务的范围是全小区，或者小区中的一片区域（多个楼栋）。这两种模式却别由其服务的范围引入：单元门口机服务的是本单元房屋，所以在可视对讲中，输入房号即可定位到目标房屋。围墙机服务的是小区，或者多个楼栋，那么需要输入具体的楼栋-单元-房号，才能定位到房屋。这将引入门禁机上交互的差异，以及在上文中提到下发组号和房间号的差异。

单元门口机下发的是房号，如上文中映射关系文件格式中提到的：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加密，使用的密钥为设备证书（ProductKey、DeviceName、DeviceSecret）中的DS前16位，加密模式为：AES/ECB/PKCS5Padding。

加密前的源文格式：

{"securityToken":"XXXX","accessKeySecret":"xxxx","accessKeyId":"xxxxx","expiration":"XXXXX"}

4. 对接注意事项

服务端口定义

多媒体格式

SIP服务接入规范

设备的远程开门服务请遵循人脸+二维码门禁对接中的remoteopen服务进行开门。

5.使用时长

建议设备端侧控制单次使用时长，1~5分钟，最好UI可配置。