Teams UCQ字符串描述符
UCQ描述符全称Unified Communications Qualification (UCQ) descriptor。是由 telephony HID device发向商用Skype一组字段,用于表明设备支持的功能。
要求:设备应支持UCQ描述符,以告知Skype for Business其独特的功能。
Skype for Business使用UCQ描述符来确定音频设备的基本功能。
Skype for Business通过索引标准USB字符串描述符请求该字符串0x33。完整的UCQ字符串长度为17个字符(包括字符“UCQ”)。如果UCQ字符串被截断,任何缺少的元素都将被视为“0”值。目前Skype不使用UCQ说明,但所有经过Skype认证的设备都必须支持这一点,以便能够在如果Skype将来支持UCQ和USB HID,则Skype for Business和是未来的证明。
UCQ字符串描述符的定义
下表显示了UCQ描述符的字段和关联值:
偏移 | 字段 | 描述 | 值 |
---|---|---|---|
0 | Qualified Skype for Business devices | “UCQ” | UCQ |
3 | Display Supported | “0” No / “1” Yes | 1 |
4 | Speakerphone | “0” No / “1” Yes | 0 |
5 | Handset | “0” No / “1” Yes | 1 |
6 | Headset | “0” No / “1” Yes | 0 |
7 | AEC | “0” No / “1” Yes | 0 |
8 | RESERVED | NOT USED | 000 |
11 | Wireless | “0” No / “1” Yes | 0 |
12 | Skype for Business HID Version(major) | 0x01 /2007 R2 | 01 |
14 | Skype for Business HID Version(MINOR) | 0x00 /2007 R2 | 00 |
16 | SIP endpoint | Always “0” | 0 |
- 前3位字符串(字符“UCQ”后)表明支持命名功能。
- 保留字段RESERVED用于传统系统设备供应商应将其设置为“000”。其他值如果使用,可能会导致以后Skype for Business Release出现问题。
- Skype for Business HID版本(major)用于确定Skype for Business兼容性。根据当前Skype for Business devices实现的USB设备规范应将Skype for Business HID版本声明为“01”。截至2010年10月,2 Skype for Business HID的现有版本:
- 版本“00”适用于2007 R2客户端之前的Lync客户端版本
- 版本“01”适用于Skype for Business client form 2007 R2客户端及更高版本
- 截至2010年10月,Skype for Business HID版本(minor)只有一个选项。须将此元素设置为“00”。
如果设备报告Skype for Business HID版本(主要版)的版本为“00”,则HID功能(如用于通话显示)将受到限制。
UCQ字符串描述符示例
“UCQ10100000001000”字符串表示此UC设备具有LCD显示屏(遵循Skype for Business HID显示协议),是一款手机,支持为2007 R2客户端或更高版本发布的Skype for Business HID。
UCQ字符串描述符的验证
要验证UCQ字符串,请使用USB总线分析仪(例如Beagle 12 USB分析仪和Total Phase软件)。
1.将设备和分析仪连接到运行Total Phase软件的计算机上。
2.启动总体阶段。
3.从Analyzer菜单中选择Connect To Analyzer。
4.开始抓捕。
5.启动Skype for Business。
6.Skype for Business完全启动后立即停止捕获,并查找记录“Get String”描述符“带数据”索引=0x33
7.验证UCQ字符串与设备预期的字符串。
bmRequestType(1) | bRequest(1) | wValue(2) | wIndex(2) | wLength(2) |
---|---|---|---|---|
80 | 06 | 类型(高字节)和索引(低字节) | 0或语言ID | 接收的描述符长度 |
80 | 06 | 0x03 | 0x33 | 19=17+2接收的描述符长度 |