TWS 概述

TWS API 报告设备是否为真无线立体声设备，以及其 TWS 连接当前是否活动。

功能概览

📄️识别 TWS 设备

读取设备是否将自身标识为真无线立体声设备

📄️查看 TWS 连接状态

读取当前 TWS 连接状态

使用 AI 辅助实现

使用 AI 开发

让 AI 帮助实现此工作流

使用官方“查看 AIBuds TWS 状态”技能，根据你的 App 完成实现。

请阅读并遵循 https://docs-aibuds.github.io/zh-Hans/skills/inspect-aibuds-tws，使用该技能在当前 iOS 项目中完成“查看 AIBuds TWS 状态”，并验证结果。

查看官方技能↗

开始使用

1. 获取设备：使用已连接或已发现的 DeviceConvertible 实例。
2. 检查协议支持：确认设备支持 DeviceTWSAPI。
3. 读取设备类型：使用 isTws。
4. 读取连接状态：使用 isTwsConnected，并按需监听连接变化。

关键概念

设备类型与连接

• isTws 标识设备是否为 TWS 设备。
• isTwsConnected 报告当前 TWS 连接快照。
• TWS 设备当前也可能处于断开状态，因此两个 Boolean 值不能互换。

协议参考

TWS 信息由 DeviceTWSAPI 提供：

Swift

Swift

guard let device = device as? DeviceTWSAPI else {
    print("Device does not expose TWS information")
    return
}

Objective-C

Objective-C

id<AIBudsDeviceTWSAPI> device = (id<AIBudsDeviceTWSAPI>)self.device;
if (![device conformsToProtocol:@protocol(AIBudsDeviceTWSAPI)]) {
    NSLog(@"Device does not expose TWS information");
    return;
}

最佳实践

1. 检查协议支持：SDK 没有提供异步的 TWS 支持查询。
2. 区分两个值：不要将已断开的 TWS 设备视为非 TWS 设备。
3. 监听连接变化：实时 UI 应实现 didTwsConnectionStatusChanged。

注意事项

• 公开协议不会发起 TWS 配对、连接或断开。
• SDK 未通过该 API 定义立体声路由或声道行为。