Core Ultra Wideband (UWB)

Dichiara le dipendenze

Per aggiungere una dipendenza al core, devi aggiungere il repository Maven di Google al tuo progetto. Per saperne di più, consulta il repository Maven di Google.

Aggiungi le dipendenze per gli artefatti necessari nel file build.gradle per la tua app o il tuo modulo:

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

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

Per saperne di più sulle dipendenze, consulta Aggiungere dipendenze di build.

Feedback

Il tuo feedback ci aiuta a migliorare Jetpack. Facci sapere se riscontri nuovi problemi o hai idee per migliorare questa raccolta. Prima di segnalare un nuovo problema, dai un'occhiata ai problemi esistenti in questa raccolta. Puoi aggiungere il tuo voto a un problema esistente facendo clic sul pulsante a forma di stella.

Crea un nuovo problema

Per saperne di più, consulta la documentazione di Issue Tracker.

Versione 1.0

Versione 1.0.0-beta01

11 marzo 2026

androidx.core.uwb:uwb:1.0.0-beta01 e androidx.core.uwb:uwb-rxjava3:1.0.0-beta01 sono state rilasciate. La versione 1.0.0-beta01 contiene questi commit.

Versione 1.0.0-alpha11

3 dicembre 2025

androidx.core.uwb:uwb:1.0.0-alpha11 e androidx.core.uwb:uwb-rxjava3:1.0.0-alpha11 sono state rilasciate. La versione 1.0.0-alpha11 contiene questi commit.

Modifiche alle API

• Introduzione della nuova API RangingResultFailure per segnalare l'errore e il motivo della sessione di misurazione della distanza. L'errore di inizializzazione della misurazione della distanza includerà un motivo nel callback RangingResultPeerDisconnected esistente (If3715)

Versione 1.0.0-alpha10

11 dicembre 2024

androidx.core.uwb:uwb:1.0.0-alpha10 e androidx.core.uwb:uwb-rxjava3:1.0.0-alpha10 sono state rilasciate. La versione 1.0.0-alpha10 contiene questi commit.

Modifiche alle API

• Aggiunge i codici motivo STATE_CHANGE_REASON_UNKNOWN, STATE_CHANGE_REASON_SYSTEM_POLICY e STATE_CHANGE_REASON_COUNTRY_CODE_ERROR per la modifica dello stato UWB. (I43e36)
• Aggiungi la nuova API RangingResult#RangingResultInitialized per inviare l'evento quando viene inizializzata una sessione di ranging. (I386bb)
• Aggiungi le nuove API subscribeToUwbAvailability(observer: UwbAvailabilityCallback) e unsubscribeFromUwbAvailability() al listener dell'evento di modifica dello stato UWB. Aggiungi una nuova interfaccia UwbAvailabilityCallback per consentire all'utente di definire la funzione di callback quando viene osservato un evento di modifica dello stato UWB. (I37191).

Versione 1.0.0-alpha09

16 ottobre 2024

androidx.core.uwb:uwb:1.0.0-alpha09 e androidx.core.uwb:uwb-rxjava3:1.0.0-alpha09 sono state rilasciate. La versione 1.0.0-alpha09 contiene questi commit.

Modifiche alle API

• Aggiunge una nuova API isAvailable() per verificare la disponibilità di UWB. (If6fc6)
• Aggiunge una nuova API addControleeWithSessionParams per supportare l'aggiunta di un caso di chiave individuale p-sts del controllato. (Ie7849)

Versione 1.0.0-alpha08

24 gennaio 2024

androidx.core.uwb:uwb:1.0.0-alpha08 e androidx.core.uwb:uwb-rxjava3:1.0.0-alpha08 sono state rilasciate. La versione 1.0.0-alpha08 contiene questi commit.

Modifiche alle API

• Aggiunge nuove funzionalità e parametri per consentire all'app di terze parti di impostare l'intervallo di misurazione, la durata dello slot e attivare/disattivare AoA. Aggiunge una nuova API per supportare la riconfigurazione dell'intervallo di misurazione e della notifica dei dati di distanza. (Iebd18)

Versione 1.0.0-alpha07

23 agosto 2023

androidx.core.uwb:uwb:1.0.0-alpha07 e androidx.core.uwb:uwb-rxjava3:1.0.0-alpha07 sono state rilasciate. La versione 1.0.0-alpha07 contiene questi commit.

Correzioni di bug

• È stato risolto un problema per cui il backend AOSP non viene utilizzato quando sui dispositivi CN sono installati i servizi Google Play.

Versione 1.0.0-alpha06

26 luglio 2023

androidx.core.uwb:uwb:1.0.0-alpha06 e androidx.core.uwb:uwb-rxjava3:1.0.0-alpha06 sono state rilasciate. La versione 1.0.0-alpha06 contiene questi commit.

Nuove funzionalità

• Aggiunta del supporto per STS con provisioning. Ora gli utenti possono scegliere Provisioned STS per la misurazione UWB se il dispositivo è in grado di supportare Provisioned STS. (I19812)

Modifiche alle API

• Aggiungi subSessionId e subSessionKeyInfo a rangingParameters. Aggiungi nuovi ID configurazione per supportare STS di provisioning. (I19812)
• Sono stati uniti i file API pubblici e sperimentali per i percorsi a, b e c (I8cfee, b/278769092).
• N/A, le modifiche ai file API riguardano solo il riordino dei metodi (I5fa95)
• È stato eseguito il trasferimento del gruppo androidx.core per utilizzare i file API pubblici uniti (Ifdef4, b/278769092)
• Aggiungi minRangingInterval, supportedChannels e supportedConfigIds a rangingCapabilities come nuovi campi. (I2a204)

Correzioni di bug

• Risolvi il problema per cui non è possibile creare il client UWB nell'area non GMS.

Versione 1.0.0-alpha05

5 aprile 2023

androidx.core.uwb:uwb:1.0.0-alpha05 e androidx.core.uwb:uwb-rxjava3:1.0.0-alpha05 sono state rilasciate. La versione 1.0.0-alpha05 contiene questi commit.

Modifiche alle API

• Rinomina RangingParameters#CONFIG_ID_1 in CONFIG_UNICAST_DS_TWR.
• Aggiungi un nuovo ID configurazione RangingParameters#CONFIG_MULTICAST_DS_TWR. (I2f1b7)

Correzioni di bug

• Correzione di un bug che impedisce agli utenti di avviare più sessioni di misurazione in parallelo.

Versione 1.0.0-alpha04

7 dicembre 2022

androidx.core.uwb:uwb:1.0.0-alpha04 e androidx.core.uwb:uwb-rxjava3:1.0.0-alpha04 sono state rilasciate. La versione 1.0.0-alpha04 contiene questi commit.

Nuove funzionalità

• Quando non è presente il supporto di GMS, l'API AndroidX tenterà di utilizzare il servizio di backend UWB AOSP distribuito agli OEM tramite la piattaforma AOSP.(532de0)

Modifiche alle API

• Aggiunta dell'annotazione @JvmDefaultWithCompatibility (I8f206)

Versione 1.0.0-alpha03

10 agosto 2022

androidx.core.uwb:uwb:1.0.0-alpha03 e androidx.core.uwb:uwb-rxjava3:1.0.0-alpha03 sono state rilasciate. La versione 1.0.0-alpha03 contiene questi commit.

Nuove funzionalità

• Ti presentiamo un nuovo profilo di misurazione, Controller. I dispositivi UWB con profilo Controller possono determinare il canale di misurazione che verrà utilizzato da due dispositivi.

Modifiche alle API

• Aggiunta del supporto del controller per UWB (I52a71)

Versione 1.0.0-alpha02

29 giugno 2022

androidx.core.uwb:uwb-rxjava3:1.0.0-alpha02 è stato rilasciato. La versione 1.0.0-alpha02 contiene questi commit.

Nuove funzionalità

• Introduzione di un artefatto interoperabile Java per il modulo UWB. Il nuovo artefatto dipende da rxjava3 e sarà utilizzabile per i client Java.

Versione 1.0.0-alpha02

15 giugno 2022

androidx.core.uwb:uwb:1.0.0-alpha02 è stato rilasciato. La versione 1.0.0-alpha02 contiene questi commit.

Nuove funzionalità

• Ti presentiamo un UWB_CONFIG_ID_1 pubblico

Modifiche alle API

• La distanza di RangingResultPosition ora può essere nulla

Versione 1.0.0-alpha01

1° giugno 2022

androidx.core.uwb:uwb:1.0.0-alpha01 è stato rilasciato. La versione 1.0.0-alpha01 contiene questi commit.

Nuove funzionalità

• La libreria UWB fornisce un insieme di API per consentire agli sviluppatori di interagire con i dispositivi abilitati alla tecnologia UWB. Il caso d'uso sarà limitato ai dispositivi partner che già assumono il profilo Controller delle sessioni di misurazione UWB, con il supporto del profilo Controller pianificato nel prossimo futuro. Questa release iniziale include due superfici API di primo livello, UwbManager e UwbClientSessionScope.