Core Ultra Wideband (UWB)

  
Implementa la tecnologia UWB (banda ultralarga) sui dispositivi supportati.
Ultimo aggiornamento Release stabile Candidato per la release Release beta Release alpha
3 dicembre 2025 - - - 1.0.0-alpha11

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:

Groovy

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

Kotlin

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

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

Feedback

Il tuo feedback ci aiuta a migliorare Jetpack. Facci sapere se riscontri nuovi problemi o hai idee per migliorare questa libreria. 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 ulteriori informazioni, consulta la documentazione di Issue Tracker.

Versione 1.0

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 stati rilasciati. 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 stati rilasciati. 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 una 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 per l'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 stati rilasciati. 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 stati rilasciati. 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 stati rilasciati. 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 stati rilasciati. La versione 1.0.0-alpha06 contiene questi commit.

Nuove funzionalità

  • Aggiungi il supporto per STS di 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 stati rilasciati. 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 stati rilasciati. 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 stati rilasciati. 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 è annullabile

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.