获取离线语音助手支持能力

显示模式控制前，先读取已连接设备的离线语音助手能力。

前提条件

• 设备已连接并就绪。
• 设备遵循 OnDeviceVoiceAssistantAPI。

API 参考

框架

AIBuds.xcframework

导入

Swift

Swift

import AIBuds
import AIBudsFoundation

Objective-C

Objective-C

#import <AIBuds/AIBuds-Swift.h>

声明

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。
• 能力是属性，而不是异步查询。
• 使用能力限制 UI 可展示的模式。