Podstawowe łącze ultraszerokopasmowe (UWB)

Deklarowanie zależności

Aby dodać zależność od podstawowych funkcji, musisz dodać do projektu repozytorium Maven Google. Więcej informacji znajdziesz w artykule Repozytorium Maven Google.

Dodaj zależności od potrzebnych artefaktów w pliku build.gradle aplikacji lub modułu:

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

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

Więcej informacji o zależnościach znajdziesz w artykule Dodawanie zależności kompilacji.

Prześlij opinię

Twoja opinia pomoże nam ulepszyć Jetpacka. Daj nam znać, jeśli znajdziesz nowe problemy lub masz pomysły na ulepszenie tej biblioteki. Zanim utworzysz nowy problem, zapoznaj się z istniejącymi problemami w tej bibliotece. Możesz zagłosować na istniejący problem, klikając przycisk gwiazdki.

Utwórz nowy problem

Więcej informacji znajdziesz w dokumentacji narzędzia Issue Tracker.

Wersja 1.1

Wersja 1.1.0-alpha02

9 września 2026 r.

Opublikowano wersje androidx.core.uwb:uwb:1.1.0-alpha02 i androidx.core.uwb:uwb-rxjava3:1.1.0-alpha02. Wersja 1.1.0-alpha02 zawiera te zmiany.

Zmiany w interfejsie API

• Dodano obsługę fuzji danych z czujników opartych na odometrii, która zapewnia szacowanie kąta nadejścia sygnału i dostosowuje pomiary zasięgu do lokalnego ruchu urządzenia. (I191a9)

Wersja 1.1.0-alpha01

19 maja 2026 r.

Opublikowano wersje androidx.core.uwb:uwb:1.1.0-alpha01 i androidx.core.uwb:uwb-rxjava3:1.1.0-alpha01. Wersja 1.1.0-alpha01 zawiera te zmiany.

Zmiany w interfejsie API

• Dodano nowy interfejs API close() dla UwbManager, aby odłączyć usługę UWB. (I4606f, b/498499531)

Wersja 1.0

Wersja 1.0.0

6 maja 2026 r.

Opublikowano wersje androidx.core.uwb:uwb:1.0.0 i androidx.core.uwb:uwb-rxjava3:1.0.0. Wersja 1.0.0 zawiera te zmiany.

Wersja 1.0.0-rc01

8 kwietnia 2026 r.

Opublikowano wersje androidx.core.uwb:uwb:1.0.0-rc01 i androidx.core.uwb:uwb-rxjava3:1.0.0-rc01. Wersja 1.0.0-rc01 zawiera te zmiany.

Wersja 1.0.0-beta01

11 marca 2026 r.

Opublikowano wersje androidx.core.uwb:uwb:1.0.0-beta01 i androidx.core.uwb:uwb-rxjava3:1.0.0-beta01. Wersja 1.0.0-beta01 zawiera te zmiany.

Wersja 1.0.0-alpha11

3 grudnia 2025 r.

Opublikowano wersje androidx.core.uwb:uwb:1.0.0-alpha11 i androidx.core.uwb:uwb-rxjava3:1.0.0-alpha11. Wersja 1.0.0-alpha11 zawiera te zmiany.

Zmiany w interfejsie API

• Wprowadzamy nowy interfejs API RangingResultFailure, który informuje o nieudanej sesji pomiaru odległości i jej przyczynie. W przypadku nieudanej inicjacji pomiaru odległości przyczyna zostanie uwzględniona w istniejącym wywołaniu zwrotnym RangingResultPeerDisconnected (If3715).

Wersja 1.0.0-alpha10

11 grudnia 2024 r.

Opublikowano wersje androidx.core.uwb:uwb:1.0.0-alpha10 i androidx.core.uwb:uwb-rxjava3:1.0.0-alpha10. Wersja 1.0.0-alpha10 zawiera te zmiany.

Zmiany w interfejsie API

• Dodano kody przyczyn STATE_CHANGE_REASON_UNKNOWN, STATE_CHANGE_REASON_SYSTEM_POLICY i STATE_CHANGE_REASON_COUNTRY_CODE_ERROR dotyczące zmiany stanu UWB. (I43e36)
• Dodano nowy interfejs API RangingResult#RangingResultInitialized, który wysyła zdarzenie po zainicjowaniu sesji pomiaru odległości. (I386bb)
• Dodano nowe interfejsy API subscribeToUwbAvailability(observer: UwbAvailabilityCallback) i unsubscribeFromUwbAvailability() do nasłuchiwania zdarzenia zmiany stanu UWB. Dodano nowy interfejs UwbAvailabilityCallback, aby użytkownik mógł zdefiniować funkcję wywołania zwrotnego, gdy zostanie zaobserwowane zdarzenie zmiany stanu UWB. (I37191).

Wersja 1.0.0-alpha09

16 października 2024 r.

Opublikowano wersje androidx.core.uwb:uwb:1.0.0-alpha09 i androidx.core.uwb:uwb-rxjava3:1.0.0-alpha09. Wersja 1.0.0-alpha09 zawiera te zmiany.

Zmiany w interfejsie API

• Dodano nowy interfejs API isAvailable(), który umożliwia sprawdzenie dostępności UWB. (If6fc6)
• Dodano nowy interfejs API addControleeWithSessionParams, który obsługuje dodawanie kontrolowanego urządzenia w przypadku klucza indywidualnego p-sts. (Ie7849)

Wersja 1.0.0-alpha08

24 stycznia 2024 r.

Opublikowano wersje androidx.core.uwb:uwb:1.0.0-alpha08 i androidx.core.uwb:uwb-rxjava3:1.0.0-alpha08. Wersja 1.0.0-alpha08 zawiera te zmiany.

Zmiany w interfejsie API

• Dodano nowe możliwości i parametry, które umożliwiają aplikacji innej firmy ustawianie interwału pomiaru odległości, czasu trwania przedziału i włączanie/wyłączanie AoA. Dodano nowy interfejs API, który obsługuje rekonfigurację interwału pomiaru odległości i powiadomienia o danych dotyczących odległości. (Iebd18)

Wersja 1.0.0-alpha07

23 sierpnia 2023 r.

Opublikowano wersje androidx.core.uwb:uwb:1.0.0-alpha07 i androidx.core.uwb:uwb-rxjava3:1.0.0-alpha07. Wersja 1.0.0-alpha07 zawiera te zmiany.

Poprawki błędów

• Rozwiązaliśmy problem polegający na tym, że backend AOSP nie był używany, gdy na urządzeniach z Chin były zainstalowane Usługi Google Play.

Wersja 1.0.0-alpha06

26 lipca 2023 r.

Opublikowano wersje androidx.core.uwb:uwb:1.0.0-alpha06 i androidx.core.uwb:uwb-rxjava3:1.0.0-alpha06. Wersja 1.0.0-alpha06 zawiera te zmiany.

Nowe funkcje

• Dodano obsługę Provisioned STS. Użytkownicy mogą teraz wybrać Provisioned STS do pomiaru odległości UWB, jeśli urządzenie obsługuje tę funkcję. (I19812)

Zmiany w interfejsie API

• Dodano subSessionId i subSessionKeyInfo do rangingParameters. Dodano nowe identyfikatory konfiguracji, aby obsługiwać Provisioned STS. (I19812)
• Scalono pliki publicznych i eksperymentalnych interfejsów API dla ścieżek a, b i c (I8cfee, b/278769092).
• Nie dotyczy, zmiany w pliku API polegają tylko na zmianie kolejności metod (I5fa95).
• Przeniesiono grupę androidx.core do korzystania ze scalonych plików publicznych interfejsów API (Ifdef4, b/278769092).
• Dodano nowe pola minRangingInterval, supportedChannels i supportedConfigIds do rangingCapabilities. (I2a204)

Poprawki błędów

• Rozwiązaliśmy problem polegający na tym, że nie można utworzyć klienta UWB w obszarze innym niż GMS.

Wersja 1.0.0-alpha05

5 kwietnia 2023 r.

Opublikowano wersje androidx.core.uwb:uwb:1.0.0-alpha05 i androidx.core.uwb:uwb-rxjava3:1.0.0-alpha05. Wersja 1.0.0-alpha05 zawiera te zmiany.

Zmiany w interfejsie API

• Zmieniono nazwę RangingParameters#CONFIG_ID_1 na CONFIG_UNICAST_DS_TWR.
• Dodano nowy identyfikator konfiguracji RangingParameters#CONFIG_MULTICAST_DS_TWR. (I2f1b7)

Poprawki błędów

• Rozwiązaliśmy problem polegający na tym, że użytkownicy nie mogą równolegle uruchamiać wielu sesji pomiaru odległości.

Wersja 1.0.0-alpha04

7 grudnia 2022 r.

Opublikowano wersje androidx.core.uwb:uwb:1.0.0-alpha04 i androidx.core.uwb:uwb-rxjava3:1.0.0-alpha04. Wersja 1.0.0-alpha04 zawiera te zmiany.

Nowe funkcje

• Gdy nie ma obsługi GMS, interfejs API AndroidX spróbuje użyć usługi backendu UWB AOSP, która jest dystrybuowana do producentów OEM za pomocą platformy AOSP (532de0).

Zmiany w interfejsie API

• Dodawanie @JvmDefaultWithCompatibility adnotacji (I8f206).

Wersja 1.0.0-alpha03

10 sierpnia 2022 r.

Opublikowano wersje androidx.core.uwb:uwb:1.0.0-alpha03 i androidx.core.uwb:uwb-rxjava3:1.0.0-alpha03. Wersja 1.0.0-alpha03 zawiera te zmiany.

Nowe funkcje

• Wprowadzamy nowy profil pomiaru odległości – Kontroler. Urządzenia UWB z profilem Kontroler mogą określać kanał pomiaru odległości, z którego będą korzystać 2 urządzenia.

Zmiany w interfejsie API

• Dodano obsługę kontrolera dla UWB (I52a71).

Wersja 1.0.0-alpha02

29 czerwca 2022 r.

Opublikowano wersję androidx.core.uwb:uwb-rxjava3:1.0.0-alpha02. Wersja 1.0.0-alpha02 zawiera te zmiany.

Nowe funkcje

• Wprowadzamy artefakt interoperacyjny z Javą dla modułu uwb. Nowy artefakt jest zależny od rxjava3 i będzie używany przez klientów Javy.

Wersja 1.0.0-alpha02

15 czerwca 2022 r.

Opublikowano wersję androidx.core.uwb:uwb:1.0.0-alpha02. Wersja 1.0.0-alpha02 zawiera te zmiany.

Nowe funkcje

• Wprowadzamy publiczny identyfikator UWB_CONFIG_ID_1.

Zmiany w interfejsie API

• Odległość RangingResultPosition może teraz przyjmować wartość null.

Wersja 1.0.0-alpha01

1 czerwca 2022 r.

Opublikowano wersję androidx.core.uwb:uwb:1.0.0-alpha01. Wersja 1.0.0-alpha01 zawiera te zmiany.

Nowe funkcje

• Biblioteka UWB udostępnia deweloperom zestaw interfejsów API do interakcji z urządzeniami obsługującymi UWB. Przypadki użycia będą ograniczone do urządzeń partnerskich, które już przyjmują profil Kontroler sesji pomiaru odległości UWB. Obsługa profilu Kontroler jest planowana w najbliższej przyszłości. Ta wstępna wersja zawiera 2 interfejsy API najwyższego poziomu: UwbManager i UwbClientSessionScope.