이 페이지는 Cloud Translation API를 통해 번역되었습니다.

코어 초광대역(UWB)

지원되는 기기에 UWB(초광대역)를 구현합니다.

최근 업데이트	안정화 버전	출시 후보 버전	베타 버전	알파 버전
2025년 12월 3일	-	-	-	1.0.0-alpha11

종속 항목 선언

Core의 종속 항목을 추가하려면 프로젝트에 Google Maven 저장소를 추가해야 합니다. 자세한 내용은 Google Maven 저장소를 읽어보세요.

다음과 같이 앱 또는 모듈의 build.gradle 파일에 필요한 아티팩트의 종속 항목을 추가합니다.

Groovy

dependencies {
    // Use to implement UWB (ultra-wideband) on supported devices
    implementation "androidx.core.uwb:uwb:1.0.0-alpha11"
}

Kotlin

dependencies {
    // Use to implement UWB (ultra-wideband) on supported devices
    implementation("androidx.core.uwb:uwb:1.0.0-alpha11")
}

종속 항목에 관한 자세한 내용은 빌드 종속 항목 추가를 참고하세요.

의견

제출하신 의견은 Jetpack을 개선하는 데 도움이 됩니다. 새로운 문제를 발견하거나 라이브러리 개선을 위한 아이디어가 있다면 Google에 알려 주세요. 새 문제를 제출하기 전에 이 라이브러리의 기존 문제를 살펴보시기 바랍니다. 별표 버튼을 클릭하여 기존 문제에 투표할 수 있습니다.

새로운 문제 제출하기

자세한 내용은 Issue Tracker 문서를 참고하세요.

버전 1.0

버전 1.0.0-alpha11

2025년 12월 3일

androidx.core.uwb:uwb:1.0.0-alpha11 및 androidx.core.uwb:uwb-rxjava3:1.0.0-alpha11이 출시되었습니다. 버전 1.0.0-alpha11에는 이러한 커밋이 포함되어 있습니다.

API 변경사항

범위 지정 세션 실패 및 이유를 보고하는 새로운 API RangingResultFailure 도입, 범위 지정 시작 실패에는 기존 RangingResultPeerDisconnected 콜백 (If3715)에 이유가 포함됨

버전 1.0.0-alpha10

2024년 12월 11일

androidx.core.uwb:uwb:1.0.0-alpha10 및 androidx.core.uwb:uwb-rxjava3:1.0.0-alpha10이 출시되었습니다. 버전 1.0.0-alpha10에는 이러한 커밋이 포함되어 있습니다.

API 변경사항

UWB 상태 변경을 위한 이유 코드 STATE_CHANGE_REASON_UNKNOWN, STATE_CHANGE_REASON_SYSTEM_POLICY, STATE_CHANGE_REASON_COUNTRY_CODE_ERROR 추가 (I43e36)
범위 지정 세션이 초기화될 때 이벤트를 전송하는 새 API RangingResult#RangingResultInitialized 추가 (I386bb)
UWB 상태 변경 이벤트를 리스너에 새 API subscribeToUwbAvailability(observer: UwbAvailabilityCallback) 및 unsubscribeFromUwbAvailability() 추가 사용자가 UWB 상태 변경 이벤트가 관찰될 때 콜백 함수를 정의할 수 있도록 새 인터페이스 UwbAvailabilityCallback 추가 (I37191)

버전 1.0.0-alpha09

2024년 10월 16일

androidx.core.uwb:uwb:1.0.0-alpha09 및 androidx.core.uwb:uwb-rxjava3:1.0.0-alpha09이 출시되었습니다. 버전 1.0.0-alpha09에는 이러한 커밋이 포함되어 있습니다.

API 변경사항

UWB 사용 가능 여부를 확인하는 새 API isAvailable() 추가 (If6fc6)
관리 대상 p-sts 개별 키 사례 추가를 지원하는 새 API addControleeWithSessionParams 추가 (Ie7849)

버전 1.0.0-alpha08

2024년 1월 24일

androidx.core.uwb:uwb:1.0.0-alpha08 및 androidx.core.uwb:uwb-rxjava3:1.0.0-alpha08이 출시되었습니다. 버전 1.0.0-alpha08에 포함된 커밋을 확인하세요.

API 변경사항

서드 파티 앱이 범위 지정 간격, 슬롯 기간을 설정하고 AoA를 사용 설정/사용 중지할 수 있도록 새로운 기능과 매개변수를 추가합니다. 범위 지정 간격 및 범위 데이터 알림의 재구성을 지원하는 새 API를 추가합니다. (Iebd18)

버전 1.0.0-alpha07

2023년 8월 23일

androidx.core.uwb:uwb:1.0.0-alpha07 및 androidx.core.uwb:uwb-rxjava3:1.0.0-alpha07이 출시되었습니다. 버전 1.0.0-alpha07에 포함된 커밋을 확인하세요.

버그 수정

중국 기기에 Google Play 서비스가 설치된 경우 AOSP 백엔드가 사용되지 않는 문제 수정

버전 1.0.0-alpha06

2023년 7월 26일

androidx.core.uwb:uwb:1.0.0-alpha06 및 androidx.core.uwb:uwb-rxjava3:1.0.0-alpha06이 출시되었습니다. 버전 1.0.0-alpha06에 포함된 커밋을 확인하세요.

새로운 기능

프로비저닝된 STS 지원 추가 이제 사용자는 기기가 프로비저닝된 STS를 지원하는 경우 UWB 범위 측정에 프로비저닝된 STS를 선택할 수 있습니다. (I19812)

API 변경사항

subSessionId 및 subSessionKeyInfo를 rangingParameters에 추가합니다. 프로비저닝된 STS를 지원하기 위해 새 구성 ID 추가 (I19812)
a,b,c 경로의 공개 및 실험용 API 파일이 병합되었습니다. (I8cfee, b/278769092)
해당 사항 없음, API 파일 변경사항은 메서드 재정렬뿐임 (I5fa95)
병합된 공개 API 파일을 사용하도록 androidx.core 그룹을 이전했습니다 (Ifdef4, b/278769092).
minRangingInterval, supportedChannels, supportedConfigIds를 rangingCapabilities에 새 필드로 추가합니다. (I2a204)

버그 수정

UWB 클라이언트를 gms가 아닌 영역에서 만들 수 없는 문제 수정

버전 1.0.0-alpha05

2023년 4월 5일

androidx.core.uwb:uwb:1.0.0-alpha05 및 androidx.core.uwb:uwb-rxjava3:1.0.0-alpha05이 출시되었습니다. 버전 1.0.0-alpha05에 포함된 커밋을 확인하세요.

API 변경사항

RangingParameters#CONFIG_ID_1의 이름을 CONFIG_UNICAST_DS_TWR로 바꿉니다.
새 구성 ID RangingParameters#CONFIG_MULTICAST_DS_TWR 추가 (I2f1b7)

버그 수정

사용자가 여러 범위 지정 세션을 동시에 시작할 수 없는 버그 수정

버전 1.0.0-alpha04

2022년 12월 7일

androidx.core.uwb:uwb:1.0.0-alpha04 및 androidx.core.uwb:uwb-rxjava3:1.0.0-alpha04가 출시되었습니다. 버전 1.0.0-alpha04에 포함된 커밋을 확인하세요.

새로운 기능

GMS 지원이 없으면 AndroidX API는 AOSP 플랫폼을 통해 OEM에 배포되는 AOSP UWB 백엔드 서비스를 사용하려고 시도합니다. (532de0)

API 변경사항

@JvmDefaultWithCompatibility 주석을 추가합니다. (I8f206)

버전 1.0.0-alpha03

2022년 8월 10일

androidx.core.uwb:uwb:1.0.0-alpha03 및 androidx.core.uwb:uwb-rxjava3:1.0.0-alpha03이 출시되었습니다. 버전 1.0.0-alpha03에 포함된 커밋을 확인하세요.

새로운 기능

새로운 범위 지정 프로필인 컨트롤러를 도입합니다. 컨트롤러 프로필이 있는 UWB 기기는 두 기기의 범위가 지정될 범위 지정 채널을 결정할 수 있습니다.

API 변경사항

UWB의 컨트롤러 지원을 추가합니다. (I52a71)

버전 1.0.0-alpha02

2022년 6월 29일

androidx.core.uwb:uwb-rxjava3:1.0.0-alpha02가 출시되었습니다. 버전 1.0.0-alpha02에 포함된 커밋을 확인하세요.

새로운 기능

uwb 모듈에 상호 운용할 수 있는 자바 아티팩트를 도입합니다. 새 아티팩트는 rxjava3에 종속되며 자바 클라이언트에서 사용할 수 있습니다.

버전 1.0.0-alpha02

2022년 6월 15일

androidx.core.uwb:uwb:1.0.0-alpha02가 출시되었습니다. 버전 1.0.0-alpha02에 포함된 커밋을 확인하세요.

새로운 기능

공개 UWB_CONFIG_ID_1 도입

API 변경사항

이제 RangingResultPosition의 거리는 null이 허용됩니다.

버전 1.0.0-alpha01

2022년 6월 1일

androidx.core.uwb:uwb:1.0.0-alpha01이 출시되었습니다. 버전 1.0.0-alpha01에 포함된 커밋을 확인하세요.

새로운 기능

UWB 라이브러리는 개발자가 UWB 지원 기기와 상호작용할 수 있는 API 모음을 제공합니다. 사용 사례는 UWB 범위 지정 세션의 컨트롤러 프로필을 이미 가정하고 있는 파트너 기기로 제한되며 조만간 컨트롤러 프로필을 지원할 예정입니다. 이 초기 출시에는 두 가지 최상위 API 노출 영역(UwbManager 및 UwbClientSessionScope)이 포함되어 있습니다.