接入文档：具备ERTC能力的萤石设备（比如S10设备）和客户端通话
文档：该文件是介绍ERTC设备与客户端之间的视频通话文档
背景介绍
设备介绍：前往查看
接入准备（默认已完成前置条件准备）
具备ERTC能力的设备端呼叫开发者客户端，（开发者客户端与服务端之间的连接需要开发者自行通过手机厂商推送/极光推送等三方厂商服务完成），其中webhook消息内会带上房间信息，开发者客户端需要使用对应客户端 SDK加入webhook消息中的房间。
用例1：设备呼叫App/Web客户端
1.用户操作设备上添加的联系人（依赖接入准备里的第4条添加设备联系人）发起呼叫
2.开发者监听webhook消息点击查看 ，获取到appId和房间号信息，通过开放平台接口获取到加入房间所需要的通话Token（原：资源token） 点击查看 ，在设备端调用对应sdk方法加入房间，进行通话
3.设备挂断/取消呼叫等操作，开发者都会收到对应的webhook消息，进行后续处理
用例2：App/Web客户端呼叫设备
1.生成客户端加入房间所需通话Token（原：资源token）
2.生成设备加入房间所需token
3.客户端调用sdk功能加入房间
4.调用开放平台接口 点击查看，呼叫设备 （注意，这里和未集成ERTC能力的萤石设备邀请入会是不同的接口）
5.客户端挂断/取消呼叫/拒接 等操作，同样调用开放平台相关接口 点击查看
用例3：设备呼叫小程序客户端
- 开发者先注册小程序
-
注册微信⼩程序开发者⾝份，并开通硬件设备能⼒，参考：小程序设备消息 | 微信开放文档
-
在微信开放平台认证设备，参考：设备认证 | 微信开放文档
- 开发者授权设备
实现⽤⼾授权设备 设备如果要向⽤⼾发起通话，需要⽤⼾在⼿机微信端先对设备进⾏授权。 参考：用户授权设备 | 微信开放文档
-
用户操作设备上添加的联系人（依赖接入准备里的第4条添加设备联系人）发起呼叫
-
开发者监听webhook消息点击查看 ，获取到appId和房间号信息，通过开放平台接口获取到加入房间所需要的通话Token（原：资源token） ，在设备端调用对应sdk方法加入房间，进行通话
-
设备挂断/取消呼叫等操作，开发者都会收到对应的webhook消息，进行后续处理
-
当设备呼叫微信联系人时，开放平台先把对应微信的消息通知（通过webhook）给开发者，开发者先调微信开放平台的接口，微信开放平台会分配相关房间给到开发者。
①开发者将该房间信息回调给萤石开放平台，通知开放平台邀请设备加入房间
该步骤，要通知开放平台加入微信房间，参考文档：文档概述 ·微信voip操作
②开发者同时将微信接听/拒绝的状态同步给开放平台，开放平台完成呼叫状态同步
③接听后，如果客户挂断电话，同样也要同步相关状态给萤石开放平台，完成挂断同步
用例4：微信小程序呼叫设备
-
开发者配置微信公众平台小程序回调地址 微信公众平台
-
开发者授权设备
实现⽤⼾授权设备 用户如果要向设备发起通话，需要⽤⼾在⼿机微信端先对设备进⾏授权。 参考：用户授权设备 | 微信开放文档
- 用户操作小程序上的授权设备列表，发起呼叫。参考：呼叫设备 | 微信开放文档
①开发者通过开放平台接口获取到加入房间所需要的通话Token（原：资源token）。
②开发者在微信回调中调用萤石开放平台呼叫接口。
- 开发者监听webhook消息点击查看 。
①设备接听/拒接/挂断等操作，开发者都会收到对应的webhook消息，通知开放平台加入/拒绝/退出微信房间。参考文档：微信voip操作。
- 通话中，如果小程序挂断电话，也要同步相关状态给萤石开放平台，完成挂断同步。
- 小程序取消呼叫时，也要调用开放平台取消呼叫接口。
萤石致力于成为全球领先的智能视觉物联网服务商，构建了全球领先的视觉物联网云平台，打造了硬件产品+软件云服务一体化的物联网服务体系。萤石云通过构建多数据中心+就近服务点的方式服务于全球客户。截至2025 年底，萤石物联网云平台在全球拥有超过120 个数据站点，平台上的IoT 设备接入数超过3.6 亿，其中视频类设备超过3 亿。在夯实自身平台能力的基础上，萤石进一步开放技术能力，将物联价值延伸至千行百业。萤石开放平台深度融合AI中台能力，涵盖音视频多媒体、消息通知处理、智能算法调度、视频存储备份、ERTC、大数据、物联接入等，已为智慧连锁、智慧养老、文教娱乐、畜牧养殖等42万余位行业客户提供数智化转型升级支撑；萤石物联专有云支持专有化部署，助力中大型企业和组织的数字化转型升级。