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

• Aggiungi la 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

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

• 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

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

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

• Aggiungi subSessionId e subSessionKeyInfo a rangingParameters. Aggiungi 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)
• Aggiungi minRangingInterval, supportedChannels e supportedConfigIds a rangingCapabilities come nuovi campi. (I2a204)

Correzioni di bug

• Risolto il problema per cui non è 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

• Rinomina RangingParameters#CONFIG_ID_1 in CONFIG_UNICAST_DS_TWR.
• Aggiungi 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à

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

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

• È 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 abilitati per 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.