オンデバイス音声アシスタントの対応確認

モード選択 UI を表示する前に、接続中デバイスの音声アシスタント対応機能を確認します。

前提条件

• デバイスが接続済みで、使用可能な状態であること。
• デバイスが OnDeviceVoiceAssistantAPI に準拠していること。

API Reference

フレームワーク

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 を返す場合があります。
• Capability はプロパティであり、非同期クエリではありません。
• Capability に基づいて、UI に表示するモードを制限してください。