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.1.0-alpha01"
}

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

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.1

Versione 1.1.0-alpha02

9 settembre 2026

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

Modifiche alle API

• Aggiunto il supporto per la fusione dei sensori basata sull'odometria, che fornisce la stima dell'angolo di arrivo del software e regola le misurazioni della distanza per il movimento del dispositivo locale. (I191a9)

Versione 1.1.0-alpha01

19 maggio 2026

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

Modifiche alle API

• Aggiunta della nuova API close() per UwbManager per annullare l'associazione del servizio UWB. (I4606f, b/498499531)

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

• 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

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)
• Aggiunta della nuova API RangingResult#RangingResultInitialized per inviare un evento quando viene inizializzata una sessione di misurazione della distanza. (I386bb)
• Aggiunta delle nuove API subscribeToUwbAvailability(observer: UwbAvailabilityCallback) e unsubscribeFromUwbAvailability() al listener per l'evento di modifica dello stato UWB. Aggiunta della 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

• Aggiunta della nuova API isAvailable() per verificare la disponibilità di UWB. (If6fc6)
• Aggiunta della nuova API addControleeWithSessionParams per supportare l'aggiunta del caso di chiave individuale p-sts del dispositivo controllato. (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

• Aggiunte 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 l'AoA. Aggiunta 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

• Risolto un problema per cui il backend AOSP non viene utilizzato quando sui dispositivi CN sono 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à

• 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

• Aggiunti subSessionId e subSessionKeyInfo a rangingParameters. Aggiunti nuovi ID di configurazione per supportare STS con provisioning. (I19812)
• Uniti i file API pubblici e sperimentali per i percorsi a, b e c (I8cfee, b/278769092)
• N/A, le modifiche ai file API sono solo metodi di riordinamento (I5fa95)
• Eseguita la migrazione del gruppo androidx.core per utilizzare i file API pubblici uniti (Ifdef4, b/278769092)
• Aggiunti minRangingInterval, supportedChannels e supportedConfigIds a rangingCapabilities come nuovi campi. (I2a204)

Correzioni di bug

• Risolto il problema per cui non è possibile creare il client UWB in un'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

• Rinominato RangingParameters#CONFIG_ID_1 in CONFIG_UNICAST_DS_TWR.
• Aggiunto un nuovo ID di configurazione RangingParameters#CONFIG_MULTICAST_DS_TWR. (I2f1b7)

Correzioni di bug

• Risolto un bug per cui gli utenti non possono 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

• Aggiunta dell'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à

• Introduzione di un nuovo profilo di misurazione della distanza, Controller. I dispositivi UWB con profilo Controller possono determinare il canale di misurazione della distanza con cui i due dispositivi misureranno la distanza.

Modifiche alle API

• 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à

• Introduzione di un artefatto interoperabile con 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à

• Introduzione di 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 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.