如何实现 WebHID耳机集成

3CX Update6 版本优化中，3CX启用了WebHID接口实现耳机集成，这个过程是如何实现的呢？

什么是WebHID？

WebHID作为访问硬件设备的新标准，对于那些必须通过特定驱动实现访问的设备，WebHID提供了更便捷的解决方案，在VoIP web客户端和支持电话的耳机设备之间，实现无缝和通用的双向CTI集成。

根据 USB 规范，首先耳机设备需要支持WebHID API，客户端将通过标准的HID电话页(0x0B)向耳机设备发送/接收HID消息。

了解 WebHID API，请访问 https://wicg.github.io/webhid/

WebHID耳机集成的运行原理？

将支持WebHID的耳机配置到3CX，当有电话呼入时，3CX网页客户端向设备发送HID消息，然后耳机设备通过激活LED指示灯进行响应；点击耳机按钮后，耳机向3CX客户端反馈HID消息，网页客户端进行HID消息数据处理，更改呼叫状态并将新的呼叫状态发送到耳机设备。

任何支持标准HID电话的耳机设备，都可以通过以上方式，实现与3CX的集成和访问，已经被验证的耳机品牌包括Jabra, Plantronics 和 Sennheiser，这种连接方式不仅节省3CX的配置时间，而且WebHID实现了同一个API接口访问多个应用，为设备厂商提供了方便。除了3CX，大家所熟知的微软Teams也启用了WebHID标准。

指令	十六进制	十进制	消息含义
OFF_HOOK	0x080017	524311	打开设备通话指示灯：设备正在接听电话关闭设备通话指示灯：设备处于闲置状态
RING	0x080018	524312	打开设备响铃：有呼入电话关闭设备响铃：无呼入电话
MUTE	0x080009	524297	静音设备：通话被静音解除设备静音：通话解除静音
HOLD	0x080020	524320	打开设备呼叫等待指示灯：通话正在等待关闭设备呼叫等待指示灯：无通话等待

应用向设备发送的消息指令

指令	十六进制	十进制	消息含义
PROGRAMMABLE_BUTTON	0x0b0007	589831	操作：双击或长按拒接按钮触发：拒绝接听当前来电
PROGRAMMABLE_TELEPHONY_BUTTON	0x090007	720903	操作：双击或长按拒接按钮触发：拒绝接听当前来电
HOOK_SWITCH	0x0b0020	720928	操作：点击呼叫按钮触发：1、如果有电话呼入，接听电话2、如果正在接听电话，挂断电话
FLASH	0x0b0021	720929	操作：双击或长按呼叫等待按钮触发：1、单通话，呼叫等待或解除呼叫等待2、多通话，设置当前通话为呼叫等待，并解除下一通电话的呼叫等待（切换电话）
PHONE_MUTE	0x0b002f	720943	操作：点击静音按钮触发：静音来电

设备向应用发送的消息指令

3CX集成耳机遇到问题？

对于部分耳机设备，即使支持WebHID接口，但是在实际配置使用过程中仍然会存在问题，例如指令执行错误，这种情况可能是设备厂商没有遵循统一的HID电话标准，而采取了自行约定的指令导致的。

例如，HOOK_SWITCH指令的通用十六进制消息为0x0b0020，如果3CX接收到设备传递消息为0x090020，3CX不会执行HOOK_SWITCH指令操作。

遇到这种情况，建议您直接联系耳机设备的厂商，让厂商定位设备的错误异常，例如厂商Jabra 或Sennheiser就曾定位了设备问题，针对3CX可能配合修复的异常，向3CX反馈了报错情况，以便3CX可以针对特定设备进行修复。所以强烈建议每位3CX用户，您在购买耳机设备时，请确保从正规渠道购买，以便发生设备适配问题及时反馈给厂商，厂商有责任确保其产品的API接口适配性。

什么浏览器支持WebHID？

目前，仅有谷歌Chrome和微软Edge浏览器支持WebHID，苹果Safari 和火狐 Firefox暂不支持，所以仅支持WebHID的浏览器可实现耳机配置。

什么类型的耳机支持WebHID？

由于安全机制的限制，目前桌面app的集成仅支持以下厂商的耳机：

Jabra
Sennheiser
Plantronics
Yealink

WebHID耳机在一台PC上能连接多个应用？

可以连，但不建议这么做。例如，您的耳机设备同时配置了两个应用，当电话呼入时，两个应用都响铃，您该用哪个接呢？这种情况会导致两个应用的使用感降低，所以不建议大家这样操作。

如何通过WebHID配置耳机？

1、登录3CX网页客户端

2、选择“设置 – 语音/视频”

3、在 “耳机集成” 中下拉列表，选择“通用耳机驱动（WebHID连接）”

4、确保您的耳机已经连接电脑，然后点击“连接耳机”

5、弹窗将提示配对，点击“连接”

文章源文：WebHID Headset Integration – How it works

源文作者：Nick Galea, CEO, CTO & Founder, 3CX

翻译编辑：Juli

查看更多文章→