Режим работы

В этом разделе описаны API AIBuds SDK для работы с режимами устройства, включая обычный и игровой режим.

Возможности

📄️Получение режима работы

Получение текущего режима работы устройства 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 не определяет влияние режима на звук или задержку для конкретного устройства.