音乐控制概述

音乐控制通过已连接的 AIBuds 设备发送播放和播放音量命令。

功能概览

📄️控制音乐播放

控制播放、曲目切换、静音和播放音量

开始使用

1. 连接设备：等待设备已连接且就绪。
2. 检查协议支持：确认设备支持 DeviceMusicControlAPI。
3. 选择命令：播放、暂停、切换上一首或下一首，或调整播放音量。
4. 处理完成结果：仅在命令报告成功后更新应用 UI。

关键概念

播放命令

• playMusic 开始或继续播放。
• pauseMusic 暂停播放。
• playNextMusic 和 playPreviousMusic 用于切换播放队列。
• 公开协议未定义停止命令。

播放音量命令

• musicVolumeUp 和 musicVolumeDown 按设备定义的一个步长调整。
• mute 和 unmute 控制播放静音。
• setMusicVolume 接受 0 到 100 的明确级别。

协议参考

音乐控制通过 DeviceMusicControlAPI 访问：

Swift

Swift

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

Objective-C

Objective-C

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

最佳实践

1. 检查协议支持：SDK 没有提供单独的 Boolean 支持查询。
2. 处理每次完成结果：检查 success，命令失败时报告 error。
3. 为滑块防抖：避免发送每个中间音量值。
4. 监听播放变化：UI 需要跟随设备通知时使用 didMediaPlayStatusChanged。

注意事项

• SDK 不通过该协议公开当前播放器、曲目元数据或播放队列。
• 命令成功仅确认命令已执行，不表示永久播放状态。
• 音量控制与音乐控制是两个独立协议，尽管都包含音量相关操作。