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"
}

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

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

6 maggio 2026

Sono state rilasciate le versioni androidx.core.uwb:uwb:1.0.0 e androidx.core.uwb:uwb-rxjava3:1.0.0. La versione 1.0.0 contiene questi commit.

Versione 1.0.0-rc01

8 aprile 2026

Sono state rilasciate le versioni androidx.core.uwb:uwb:1.0.0-rc01 e androidx.core.uwb:uwb-rxjava3:1.0.0-rc01. La versione 1.0.0-rc01 contiene questi commit.

Versione 1.0.0-beta01

11 marzo 2026

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

Versione 1.0.0-alpha11

3 dicembre 2025

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

Modifiche alle API

• È stata introdotta la 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

Sono state rilasciate le versioni androidx.core.uwb:uwb:1.0.0-alpha10 e androidx.core.uwb:uwb-rxjava3:1.0.0-alpha10. 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)
• Aggiunge la nuova API RangingResult#RangingResultInitialized per inviare un evento quando viene inizializzata una sessione di misurazione della distanza. (I386bb)
• Aggiunge le nuove API subscribeToUwbAvailability(observer: UwbAvailabilityCallback) e unsubscribeFromUwbAvailability() al listener per l'evento di modifica dello stato UWB. Aggiunge la 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

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

Modifiche alle API

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

Versione 1.0.0-alpha08

24 gennaio 2024

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

Modifiche alle API

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

Versione 1.0.0-alpha07

23 agosto 2023

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

Correzioni di bug

• È stato risolto un problema per cui il backend AOSP non veniva utilizzato quando sui dispositivi CN erano installati i Google Play Services.

Versione 1.0.0-alpha06

26 luglio 2023

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

Nuove funzionalità

• È stato aggiunto il supporto per STS con provisioning. Ora gli utenti possono scegliere STS con provisioning per la misurazione della distanza UWB se il dispositivo è in grado di supportare STS con provisioning. (I19812)

Modifiche alle API

• Sono stati aggiunti subSessionId e subSessionKeyInfo a rangingParameters. Sono stati aggiunti nuovi ID di configurazione per supportare STS con 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 passaggio del gruppo androidx.core all'utilizzo dei file API pubblici uniti (Ifdef4, b/278769092)
• Sono stati aggiunti minRangingInterval, supportedChannels e supportedConfigIds a rangingCapabilities come nuovi campi. (I2a204)

Correzioni di bug

• È stato risolto il problema per cui non era possibile creare il client UWB nell'area non GMS.

Versione 1.0.0-alpha05

5 aprile 2023

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

Modifiche alle API

• È stato rinominato RangingParameters#CONFIG_ID_1 in CONFIG_UNICAST_DS_TWR.
• È stato aggiunto un nuovo ID di configurazione RangingParameters#CONFIG_MULTICAST_DS_TWR. (I2f1b7)

Correzioni di bug

• È stato risolto un bug per cui gli utenti non potevano avviare più sessioni di misurazione della distanza in parallelo.

Versione 1.0.0-alpha04

7 dicembre 2022

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

Nuove funzionalità

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

Modifiche alle API

• È stata aggiunta l'annotazione @JvmDefaultWithCompatibility (I8f206)

Versione 1.0.0-alpha03

10 agosto 2022

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

Nuove funzionalità

• È stato introdotto un nuovo profilo di misurazione della distanza, Controller. I dispositivi UWB con profilo Controller possono determinare il canale di misurazione della distanza di due dispositivi.

Modifiche alle API

• È stato aggiunto il supporto del controller per UWB (I52a71)

Versione 1.0.0-alpha02

29 giugno 2022

È stata rilasciata la versione androidx.core.uwb:uwb-rxjava3:1.0.0-alpha02. La versione 1.0.0-alpha02 contiene questi commit.

Nuove funzionalità

• È stato introdotto 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

È stata rilasciata la versione androidx.core.uwb:uwb:1.0.0-alpha02. La versione 1.0.0-alpha02 contiene questi commit.

Nuove funzionalità

• È stato introdotto 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

È stata rilasciata la versione androidx.core.uwb:uwb:1.0.0-alpha01. La versione 1.0.0-alpha01 contiene questi commit.

Nuove funzionalità

• La libreria UWB fornisce un insieme di API per gli sviluppatori per interagire con i dispositivi che supportano la tecnologia UWB. Il caso d'uso sarà limitato ai dispositivi partner che già presuppongono il profilo Controller delle sessioni di misurazione della distanza UWB, con il supporto per il profilo Controller previsto nel prossimo futuro. In questa release iniziale sono incluse due superfici API di primo livello: UwbManager e UwbClientSessionScope.