Bande ultralarge (BUL) Core

  
Implémentez la BUL (bande ultralarge) sur les appareils compatibles.
Dernière mise à jour Version stable Version finale Version bêta Version alpha
3 décembre 2025 - - - 1.0.0-alpha11

Déclarer des dépendances

Pour ajouter une dépendance sur Core, vous devez ajouter le dépôt Maven de Google à votre projet. Pour en savoir plus, consultez la section Dépôt Maven de Google.

Ajoutez les dépendances correspondant aux artefacts dont vous avez besoin dans le fichier build.gradle de votre application ou de votre module :

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

Pour en savoir plus sur les dépendances, consultez Ajouter des dépendances de compilation.

Commentaires

Vos commentaires nous aident à améliorer Jetpack. N'hésitez pas à nous contacter si vous découvrez de nouveaux problèmes ou si vous avez des idées pour améliorer cette bibliothèque. Veuillez consulter les problèmes existants de cette bibliothèque avant d'en signaler un nouveau. Vous pouvez ajouter votre vote à un problème existant en cliquant sur le bouton en forme d'étoile.

Signaler un nouveau problème

Pour en savoir plus, consultez la documentation sur l'outil Issue Tracker.

Version 1.0

Version 1.0.0-alpha11

3 décembre 2025

Publication d'androidx.core.uwb:uwb:1.0.0-alpha11 et d'androidx.core.uwb:uwb-rxjava3:1.0.0-alpha11. La version 1.0.0-alpha11 contient ces commits.

Modifications apportées à l'API

  • Nous avons ajouté une nouvelle API RangingResultFailure pour signaler l'échec et la raison de l'échec d'une session de mesure de distance. L'échec de l'initialisation de la mesure de distance inclura une raison dans le rappel RangingResultPeerDisconnected existant (If3715).

Version 1.0.0-alpha10

11 décembre 2024

Publication d'androidx.core.uwb:uwb:1.0.0-alpha10 et d'androidx.core.uwb:uwb-rxjava3:1.0.0-alpha10. La version 1.0.0-alpha10 contient ces commits.

Modifications apportées à l'API

  • Ajoute les codes de motif STATE_CHANGE_REASON_UNKNOWN, STATE_CHANGE_REASON_SYSTEM_POLICY et STATE_CHANGE_REASON_COUNTRY_CODE_ERROR pour le changement d'état UWB. (I43e36)
  • Ajout de la nouvelle API RangingResult#RangingResultInitialized pour envoyer un événement lorsqu'une session de mesure de distance est initialisée. (I386bb)
  • Ajout de nouvelles API subscribeToUwbAvailability(observer: UwbAvailabilityCallback) et unsubscribeFromUwbAvailability() à l'écouteur pour l'événement de changement d'état UWB. Ajoutez une nouvelle interface UwbAvailabilityCallback pour que l'utilisateur puisse définir une fonction de rappel lorsqu'un événement de changement d'état UWB est observé. (I37191).

Version 1.0.0-alpha09

16 octobre 2024

Publication d'androidx.core.uwb:uwb:1.0.0-alpha09 et d'androidx.core.uwb:uwb-rxjava3:1.0.0-alpha09. La version 1.0.0-alpha09 contient ces commits.

Modifications apportées à l'API

  • Ajout de la nouvelle API isAvailable() pour vérifier la disponibilité de la BUL. (If6fc6)
  • Ajoute une nouvelle API addControleeWithSessionParams pour prendre en charge l'ajout d'une clé individuelle p-sts contrôlée. (Ie7849)

Version 1.0.0-alpha08

24 janvier 2024

Publication d'androidx.core.uwb:uwb:1.0.0-alpha08 et d'androidx.core.uwb:uwb-rxjava3:1.0.0-alpha08. Liste des commits de la version 1.0.0-alpha08

Modifications apportées à l'API

  • Ajoute de nouvelles fonctionnalités et de nouveaux paramètres pour permettre à l'application tierce de définir l'intervalle de mesure de distance, la durée du créneau et d'activer/désactiver l'AoA. Ajoute une nouvelle API pour permettre la reconfiguration de l'intervalle de mesure de distance et de la notification des données de distance. (Iebd18)

Version 1.0.0-alpha07

23 août 2023

Publication d'androidx.core.uwb:uwb:1.0.0-alpha07 et d'androidx.core.uwb:uwb-rxjava3:1.0.0-alpha07. Liste des commits de la version 1.0.0-alpha07

Correction de bugs

  • Correction d'un problème qui empêchait l'utilisation du backend AOSP lorsque les services Google Play étaient installés sur des appareils CN.

Version 1.0.0-alpha06

26 juillet 2023

Publication d'androidx.core.uwb:uwb:1.0.0-alpha06 et d'androidx.core.uwb:uwb-rxjava3:1.0.0-alpha06. Liste des commits de la version 1.0.0-alpha06

Nouvelles fonctionnalités

  • Ajout de la prise en charge de STS provisionné. Les utilisateurs peuvent désormais choisir le STS provisionné pour la mesure de distance UWB si l'appareil est compatible avec le STS provisionné. (I19812)

Modifications apportées à l'API

  • Ajoutez subSessionId et subSessionKeyInfo à rangingParameters. Ajoutez de nouveaux ID de configuration pour prendre en charge le STS provisionné. (I19812)
  • Fusion des fichiers d'API publiques et expérimentales pour les chemins a, b et c. (I8cfee, b/278769092)
  • N/A, les modifications apportées au fichier d'API consistent uniquement à réorganiser les méthodes (I5fa95)
  • Migration du groupe androidx.core pour utiliser les fichiers d'API publiques fusionnés (Ifdef4, b/278769092)
  • Ajoutez minRangingInterval, supportedChannels et supportedConfigIds à rangingCapabilities en tant que nouveaux champs. (I2a204)

Correction de bugs

  • Correction du problème qui empêchait la création du client UWB dans une zone non-GMS.

Version 1.0.0-alpha05

5 avril 2023

Publication d'androidx.core.uwb:uwb:1.0.0-alpha05 et d'androidx.core.uwb:uwb-rxjava3:1.0.0-alpha05. Liste des commits de la version 1.0.0-alpha05

Modifications apportées à l'API

  • RangingParameters#CONFIG_ID_1 a été renommé CONFIG_UNICAST_DS_TWR.
  • Ajoutez un ID de configuration RangingParameters#CONFIG_MULTICAST_DS_TWR. (I2f1b7)

Correction de bugs

  • Correction d'un bug qui empêchait les utilisateurs de démarrer plusieurs sessions de mesure de distance en parallèle.

Version 1.0.0-alpha04

7 décembre 2022

Publication d'androidx.core.uwb:uwb:1.0.0-alpha04 et androidx.core.uwb:uwb-rxjava3:1.0.0-alpha04. Liste des commits de la version 1.0.0-alpha04

Nouvelles fonctionnalités

  • Si les services Google Mobile ne sont pas pris en charge, l'API AndroidX essaie d'utiliser le service de backend BUL AOSP distribué aux OEM via la plate-forme AOSP (532de0).

Modifications apportées à l'API

  • Ajout de l'annotation @JvmDefaultWithCompatibility (I8f206)

Version 1.0.0-alpha03

10 août 2022

Publication d'androidx.core.uwb:uwb:1.0.0-alpha03 et androidx.core.uwb:uwb-rxjava3:1.0.0-alpha03. Liste des commits de la version 1.0.0-alpha03

Nouvelles fonctionnalités

  • Présentation d'un nouveau profil de mesure des distances : Contrôleur. Les appareils BUL avec le profil Contrôleur peuvent déterminer le canal de mesure des distances entre deux appareils.

Modifications apportées à l'API

  • Ajout de la prise en charge du contrôleur pour la BUL. (I52a71)

Version 1.0.0-alpha02

29 juin 2022

Publication de androidx.core.uwb:uwb-rxjava3:1.0.0-alpha02. Liste des commits de la version 1.0.0-alpha02

Nouvelles fonctionnalités

  • Présentation d'un artefact interopérable Java pour le module UWB. Le nouvel artefact dépend de rxjava3 et pourra être utilisé par les clients Java.

Version 1.0.0-alpha02

15 juin 2022

Publication de androidx.core.uwb:uwb:1.0.0-alpha02. Liste des commits de la version 1.0.0-alpha02

Nouvelles fonctionnalités

  • Présentation d'un UWB_CONFIG_ID_1 public.

Modifications apportées à l'API

  • La distance de RangingResultPosition peut désormais être nulle.

Version 1.0.0-alpha01

1er juin 2022

Publication de androidx.core.uwb:uwb:1.0.0-alpha01. Liste des commits de la version 1.0.0-alpha01

Nouvelles fonctionnalités

  • La bibliothèque BUL fournit un ensemble d'API permettant aux développeurs d'interagir avec les appareils compatibles avec la BUL. Ce cas d'utilisation sera limité aux appareils associés qui utilisent déjà le profil Contrôleur pour les sessions de mesure des distances de BUL, la compatibilité avec le profil Contrôleur étant prévue dans un avenir proche. Deux surfaces d'API de niveau supérieur sont incluses dans cette version initiale : UwbManager et UwbClientSessionScope.