Проверка локального голосового помощника

Перед отображением элементов выбора режима узнайте возможности голосового помощника подключённого устройства.

Предварительные условия

• Устройство подключено и готово.
• Устройство соответствует OnDeviceVoiceAssistantAPI.

API Reference

Framework

AIBuds.xcframework

Import

Swift

Swift

import AIBuds
import AIBudsFoundation

Objective-C

Objective-C

#import <AIBuds/AIBuds-Swift.h>

Declaration

Swift

Swift

/// The protocol for the on-device voice assistant API.
protocol OnDeviceVoiceAssistantAPI: DeviceAPI {
    /// The capability of the on-device voice assistant.
    var onDeviceVoiceAssistantCapability: OnDeviceVoiceAssistantCapability { get }
}

Objective-C

Objective-C

/// The protocol for the on-device voice assistant API.
@protocol AIBudsOnDeviceVoiceAssistantAPI <AIBudsDeviceAPI>
/// The capability of the on-device voice assistant.
@property(nonatomic, readonly)
    AIBudsOnDeviceVoiceAssistantCapability onDeviceVoiceAssistantCapability;
@end

См. onDeviceVoiceAssistantCapability и OnDeviceVoiceAssistantCapability.

Примеры использования

Swift

Swift

guard let voiceAssistant = device as? OnDeviceVoiceAssistantAPI else {
    supportLabel.text = "Not supported"
    return
}

switch voiceAssistant.onDeviceVoiceAssistantCapability {
case .none:
    supportLabel.text = "No voice-command capability"
case .keywordWakeup:
    supportLabel.text = "Keyword wake-up"
case .common:
    supportLabel.text = "Common voice commands"
}

Objective-C

Objective-C

id<AIBudsOnDeviceVoiceAssistantAPI> voiceAssistant =
    (id<AIBudsOnDeviceVoiceAssistantAPI>)self.device;

if (![voiceAssistant conformsToProtocol:@protocol(AIBudsOnDeviceVoiceAssistantAPI)]) {
    self.supportLabel.text = @"Not supported";
    return;
}

switch (voiceAssistant.onDeviceVoiceAssistantCapability) {
case AIBudsOnDeviceVoiceAssistantCapabilityNone:
    self.supportLabel.text = @"No voice-command capability";
    break;
case AIBudsOnDeviceVoiceAssistantCapabilityKeywordWakeup:
    self.supportLabel.text = @"Keyword wake-up";
    break;
case AIBudsOnDeviceVoiceAssistantCapabilityCommon:
    self.supportLabel.text = @"Common voice commands";
    break;
}

Примечания

• Соответствие протоколу и наличие возможности проверяются отдельно. Соответствующее протоколу устройство всё равно может вернуть .none.
• Возможность представлена свойством, а не асинхронным запросом.
• Используйте возможность устройства, чтобы ограничить набор режимов в интерфейсе.