TWS 개요

TWS API는 기기가 True Wireless Stereo 기기인지, 현재 TWS 연결이 활성 상태인지 알려 줍니다.

기능 개요

📄️TWS 기기 여부 확인

기기가 True Wireless Stereo 기기로 식별되는지 확인

📄️TWS 연결 상태 확인

현재 TWS 연결 상태 조회

AI를 활용해 구현

AI로 구현

AI로 이 워크플로 구현

공식 “AIBuds TWS 상태 확인” 스킬을 사용해 앱에 맞게 구현하세요.

https://docs-aibuds.github.io/ko/skills/inspect-aibuds-tws을 읽고 지침을 따르세요. 이 스킬로 “AIBuds TWS 상태 확인”을 이 iOS 프로젝트에 구현하고 검증하세요.

공식 스킬 보기↗

시작하기

1. 기기 가져오기 - 연결되었거나 검색된 DeviceConvertible 인스턴스를 사용합니다.
2. 프로토콜 확인 - DeviceTWSAPI 지원 여부를 확인합니다.
3. 기기 유형 확인 - isTws를 읽습니다.
4. 연결 상태 확인 - isTwsConnected를 읽고 필요하면 연결 변경을 관찰합니다.

핵심 개념

기기 유형과 연결 상태

• isTws는 기기가 TWS 기기인지 나타냅니다.
• isTwsConnected는 현재 TWS 연결 상태 스냅샷을 나타냅니다.
• TWS 기기도 현재 연결이 끊겨 있을 수 있으므로 두 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 페어링, 연결 또는 연결 해제를 시작하지 않습니다.
• SDK는 이 API에서 스테레오 라우팅이나 채널 동작을 정의하지 않습니다.