TWS 概要

TWS API は、デバイスが True Wireless Stereo デバイスかどうかと、現在 TWS 接続中かどうかを示します。

機能概要

📄️TWS デバイスの識別

デバイスが True Wireless Stereo デバイスかどうかを取得

📄️TWS 接続状態の確認

現在の TWS 接続状態を取得

AI を活用して実装

AI で実装

AI でこのワークフローを実装

公式の「AIBuds TWS 状態の確認」スキルを使い、アプリに合わせて実装します。

https://docs-aibuds.github.io/ja/skills/inspect-aibuds-tws を読み、その指示に従ってください。このスキルで「AIBuds TWS 状態の確認」をこの iOS プロジェクトに実装し、検証してください。

公式スキルを見る↗

はじめに

1. デバイスを取得 - 接続済みまたは検出済みの DeviceConvertible インスタンスを使用します。
2. プロトコル準拠を確認 - DeviceTWSAPI への対応を確認します。
3. デバイスタイプを取得 - isTws を読み取ります。
4. 接続状態を取得 - isTwsConnected を読み取り、必要に応じて接続変化を監視します。

主要な概念

デバイスタイプと接続状態

• isTws はデバイスが TWS デバイスかどうかを示します。
• isTwsConnected は現在の TWS 接続状態を示します。
• TWS デバイスでも現在は未接続の場合があるため、2 つの Boolean 値を同じ意味として扱わないでください。

プロトコルリファレンス

TWS 情報は DeviceTWSAPI から取得します。

Swift

Swift

guard let device = device as? DeviceTWSAPI else {
    print("Device does not expose TWS information")
    return
}

Objective-C

Objective-C

id<AIBudsDeviceTWSAPI> device = (id<AIBudsDeviceTWSAPI>)self.device;
if (![device conformsToProtocol:@protocol(AIBudsDeviceTWSAPI)]) {
    NSLog(@"Device does not expose TWS information");
    return;
}

ベストプラクティス

1. プロトコル準拠を確認：TWS 対応を確認する非同期 API はありません。
2. 値を区別：未接続の TWS デバイスを非 TWS デバイスとして扱わないでください。
3. 接続変化を監視：リアルタイムに UI を更新する場合は didTwsConnectionStatusChanged を実装します。

注意事項

• 公開プロトコルから TWS のペアリング、接続、切断を開始することはできません。
• この API ではステレオのルーティングやチャンネル動作を定義していません。