TWS 接続状態の確認

TWS デバイスが現在接続されているかどうかを読み取ります。

前提条件

• デバイスが DeviceTWSAPI に準拠していること。
• UI でデバイスタイプと接続状態を区別する場合は isTws を使用します。

API Reference

フレームワーク

AIBuds.xcframework

インポート

Swift

Swift

import AIBuds

Objective-C

Objective-C

#import <AIBuds/AIBuds-Swift.h>
#import <AIBuds/AIBuds.h>

プロトコル

接続状態は DeviceTWSAPI から取得します。

Swift

Swift

/// The protocol for device True Wireless Stereo (TWS) related API.
protocol DeviceTWSAPI: DeviceAPI {
    /// Indicates whether the TWS device is currently connected.
    var isTwsConnected: Bool { get }
}

Objective-C

Objective-C

/// The protocol for device True Wireless Stereo (TWS) related API.
@protocol AIBudsDeviceTWSAPI <AIBudsDeviceAPI>
/// Indicates whether the TWS device is currently connected.
@property(nonatomic, readonly) BOOL isTwsConnected;
@end

プロパティ

プロパティ	型	説明
isTwsConnected	Bool / BOOL	現在の TWS 接続状態。

使用例

Swift

Swift

import AIBuds

guard let device = device as? DeviceTWSAPI else {
    print("TWS information is unavailable")
    return
}

guard device.isTws else {
    print("This is not a TWS device")
    return
}

print(device.isTwsConnected ? "TWS connected" : "TWS disconnected")

Objective-C

Objective-C

id<AIBudsDeviceTWSAPI> device = (id<AIBudsDeviceTWSAPI>)self.device;
if ([device conformsToProtocol:@protocol(AIBudsDeviceTWSAPI)] && device.isTws) {
    NSLog(@"%@", device.isTwsConnected ? @"TWS connected" : @"TWS disconnected");
}

エラー処理

このプロパティはエラーを返しません。特定時点のスナップショットとして扱い、プロトコル非対応は別に処理してください。

ベストプラクティス

1. 変更を監視：リアルタイム表示には didTwsConnectionStatusChanged を実装します。
2. 接続コマンドとして使わない：このプロトコルはペアリングや再接続を開始しません。
3. UI を安全に更新：必要に応じて、デリゲートからの UI 更新をメインキューへディスパッチします。

注意事項

• false は現在 TWS 接続中ではないことを示します。デバイスが TWS 非対応であることまでは意味しません。
• SDK Demo はこのプロパティを直接表示し、デバイスデリゲートから更新します。