TWS 연결 상태 확인

TWS 기기의 현재 연결 여부를 읽습니다.

사전 요구 사항

• 기기가 DeviceTWSAPI를 준수합니다.
• UI에서 기기 유형과 연결 상태를 구분해야 하면 isTws를 사용합니다.

API 참고

프레임워크

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 업데이트: delegate에서 수행하는 UI 작업은 필요할 때 메인 큐로 전달하세요.

참고

• false는 현재 TWS 연결이 활성 상태가 아니라는 의미이며 기기가 TWS 기기가 아님을 의미하지는 않습니다.
• SDK Demo는 이 속성을 직접 표시하고 기기 delegate를 통해 값을 갱신합니다.