Управление музыкой

Управление музыкой отправляет на подключённое устройство AIBuds команды воспроизведения и громкости.

Возможности

📄️Управление воспроизведением музыки

Управление воспроизведением, переключением треков, отключением звука и громкостью

Начало работы

1. Подключите устройство — дождитесь подключения и готовности.
2. Проверьте протокол — убедитесь в поддержке DeviceMusicControlAPI.
3. Выберите команду — воспроизведение, пауза, следующий или предыдущий трек либо изменение громкости.
4. Обработайте завершение — обновляйте интерфейс только после успешного выполнения команды.

Основные понятия

Команды воспроизведения

• 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 нет.
2. Обрабатывайте завершение каждой команды: проверяйте success и показывайте error при ошибке.
3. Ограничивайте частоту ползунка: не отправляйте каждое промежуточное значение громкости.
4. Следите за воспроизведением: используйте didMediaPlayStatusChanged, если интерфейс должен учитывать уведомления устройства.

Примечания

• Этот протокол не предоставляет активный проигрыватель, метаданные трека или очередь воспроизведения.
• Успешная команда подтверждает выполнение, но не постоянное состояние воспроизведения.
• Volume Control и Music Control — разные протоколы, хотя оба содержат операции с громкостью.