工作模式概述

本节介绍 AIBuds SDK 的设备工作模式 API，包括普通模式和游戏模式。

功能概览

📄️获取工作模式

读取 AIBuds 设备当前的工作模式

开始使用

使用工作模式功能时，请按以下步骤操作：

1. 连接设备：与 AIBuds 设备建立连接。
2. 检查协议支持：确认设备支持 DeviceWorkModeAPI。
3. 获取当前模式：读取 workMode 属性。
4. 设置模式：调用 setWorkMode(_:completion:)，并传入 WorkMode 值。

关键概念

工作模式

WorkMode 定义以下值：

可选模式

WorkMode 对外提供的枚举值及其在模式选择中的用途。

3

.unknown

当前模式不可用或无法识别。该回退值不可选择。

AIBudsWorkModeUnknown

-1

.normal

设备的普通工作模式；SDK 不定义具体产品的音频行为。

AIBudsWorkModeNormal

0

.game

设备的游戏模式；SDK 不定义具体产品的延迟和音频处理策略。

AIBudsWorkModeGame

1

WorkMode.allCases 只包含 normal 和 game。不要将 unknown 传给 setWorkMode。

协议参考

工作模式功能通过 DeviceWorkModeAPI 协议访问：

Swift

Swift

guard let device = device as? DeviceWorkModeAPI else {
    print("Device does not support DeviceWorkModeAPI")
    return
}

Objective-C

Objective-C

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

最佳实践

1. 检查协议支持：始终确认设备支持 DeviceWorkModeAPI。
2. 处理模式变化：需要设备代理接收更新时，实现 device(_:didWorkModeChanged:)。
3. 提供反馈：模式更改成功后通知用户。
4. 尊重用户意图：仅在适当的应用或用户操作触发时更改工作模式。

注意事项

• 并非所有设备都支持多种工作模式。
• 可用模式取决于设备能力。
• 公开 API 未定义模式对应的设备特定音频或延迟效果。