Core Ultra Wideband (UWB)

  
Implemente a UWB (banda ultralarga) em dispositivos com suporte.
Atualização mais recente Versão estável Versão candidata a lançamento Versão Beta Versão Alfa
3 de dezembro de 2025 - - - 1.0.0-alpha11

Declarar dependências

Para adicionar uma dependência à Core, adicione o repositório Maven do Google ao seu projeto. Consulte mais informações em Repositório Maven do Google.

Adicione as dependências dos artefatos necessários ao arquivo build.gradle do seu app ou módulo:

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

Para mais informações sobre dependências, consulte Adicionar dependências de build.

Feedback

Seu feedback ajuda a melhorar o Jetpack. Avise se você descobrir novos problemas ou tiver ideias para melhorar esta biblioteca. Consulte os problemas conhecidos nesta biblioteca antes de criar um novo. Adicione seu voto a um problema clicando no botão de estrela.

Criar novo problema

Consulte a documentação do Issue Tracker para saber mais.

Versão 1.0

Versão 1.0.0-alpha11

3 de dezembro de 2025

Lançamento de androidx.core.uwb:uwb:1.0.0-alpha11 e androidx.core.uwb:uwb-rxjava3:1.0.0-alpha11. A versão 1.0.0-alpha11 contém estes commits.

Mudanças na API

  • Apresentamos a nova API RangingResultFailure para informar a falha e o motivo da sessão de alcance. A falha na inicialização do alcance vai incluir um motivo no callback RangingResultPeerDisconnected atual (If3715).

Versão 1.0.0-alpha10

11 de dezembro de 2024

Lançamento de androidx.core.uwb:uwb:1.0.0-alpha10 e androidx.core.uwb:uwb-rxjava3:1.0.0-alpha10. A versão 1.0.0-alpha10 contém estes commits.

Mudanças na API

  • Adiciona os códigos de motivo STATE_CHANGE_REASON_UNKNOWN, STATE_CHANGE_REASON_SYSTEM_POLICY e STATE_CHANGE_REASON_COUNTRY_CODE_ERROR para mudança de estado da UWB. (I43e36)
  • Adição da nova API RangingResult#RangingResultInitialized para enviar um evento quando uma sessão de alcance é inicializada. (I386bb).
  • Adição de novas APIs subscribeToUwbAvailability(observer: UwbAvailabilityCallback) e unsubscribeFromUwbAvailability() ao listener para o evento de mudança de estado da UWB. Adicione a nova interface UwbAvailabilityCallback para que o usuário defina a função de callback quando um evento de mudança de estado da UWB for observado. (I37191).

Versão 1.0.0-alpha09

16 de outubro de 2024

Lançamento de androidx.core.uwb:uwb:1.0.0-alpha09 e androidx.core.uwb:uwb-rxjava3:1.0.0-alpha09. A versão 1.0.0-alpha09 contém estes commits.

Mudanças na API

  • Adiciona a nova API isAvailable() para verificar a disponibilidade da UWB. (If6fc6).
  • Adiciona a nova API addControleeWithSessionParams para oferecer suporte ao caso de chave individual de p-sts de controle de adição. (Ie7849).

Versão 1.0.0-alpha08

24 de janeiro de 2024

Lançamento de androidx.core.uwb:uwb:1.0.0-alpha08 e androidx.core.uwb:uwb-rxjava3:1.0.0-alpha08. A versão 1.0.0-alpha08 contém estas confirmações.

Mudanças na API

  • Adiciona novos recursos e parâmetros para permitir que apps de terceiros definam o intervalo de alcance, a duração do slot e ativem/desativem o AoA. Adiciona uma nova API para oferecer suporte à reconfiguração do intervalo de alcance e da notificação de dados de alcance. (Iebd18).

Versão 1.0.0-alpha07

23 de agosto de 2023

Lançamento de androidx.core.uwb:uwb:1.0.0-alpha07 e androidx.core.uwb:uwb-rxjava3:1.0.0-alpha07. A versão 1.0.0-alpha07 contém estas confirmações.

Correções de bugs

  • Correção de um problema em que o back-end do AOSP não era usado quando os dispositivos CN tinham o Google Play Services instalado.

Versão 1.0.0-alpha06

26 de julho de 2023

Lançamento de androidx.core.uwb:uwb:1.0.0-alpha06 e androidx.core.uwb:uwb-rxjava3:1.0.0-alpha06. A versão 1.0.0-alpha06 contém estas confirmações.

Novos recursos

  • Adição de suporte para STS provisionado. Agora, os usuários podem escolher o STS provisionado para alcance UWB se o dispositivo for compatível com ele. (I19812)

Mudanças na API

  • Adicione subSessionId e subSessionKeyInfo a rangingParameters. Adicione novos IDs de configuração para oferecer suporte ao STS provisionado. (I19812)
  • Os arquivos de API pública e experimental foram mesclados para caminhos a, b e c (I8cfee, b/278769092).
  • Não aplicável. As mudanças no arquivo de API apenas reordenam métodos (I5fa95).
  • O grupo androidx.core foi migrado para usar arquivos de API pública combinados (Ifdef4, b/278769092).
  • Adicione minRangingInterval, supportedChannels e supportedConfigIds a rangingCapabilities como novos campos. (I2a204).

Correções de bugs

  • Correção do problema que impedia a criação do cliente UWB em áreas fora do GMS.

Versão 1.0.0-alpha05

5 de abril de 2023

Lançamento de androidx.core.uwb:uwb:1.0.0-alpha05 e androidx.core.uwb:uwb-rxjava3:1.0.0-alpha05. A versão 1.0.0-alpha05 contém estas confirmações.

Mudanças na API

  • RangingParameters#CONFIG_ID_1 foi renomeado como CONFIG_UNICAST_DS_TWR.
  • Adicione um novo ID de configuração RangingParameters#CONFIG_MULTICAST_DS_TWR. (I2f1b7).

Correções de bugs

  • Correção de um bug que impedia os usuários de iniciar várias sessões de alcance em paralelo.

Versão 1.0.0-alpha04

7 de dezembro de 2022

Lançamento de androidx.core.uwb:uwb:1.0.0-alpha04 e androidx.core.uwb:uwb-rxjava3:1.0.0-alpha04. A versão 1.0.0-alpha04 contém estas confirmações.

Novos recursos

  • Quando não houver suporte ao GMS, a API AndroidX vai tentar usar o serviço de back-end de UWB do AOSP distribuído para OEMs pela plataforma AOSP (532de0).

Mudanças na API

  • A anotação @JvmDefaultWithCompatibility foi adicionada (I8f206).

Versão 1.0.0-alpha03

10 de agosto de 2022

Lançamento de androidx.core.uwb:uwb:1.0.0-alpha03 e androidx.core.uwb:uwb-rxjava3:1.0.0-alpha03. A versão 1.0.0-alpha03 contém estas confirmações.

Novos recursos

  • Apresentamos um novo perfil de alcance, chamado Controlador. Os dispositivos de UWB com o perfil de controlador podem determinar com qual canal de alcance dois dispositivos vão variar.

Mudanças na API

  • Foi adicionado suporte ao perfil de controlador para UWB (I52a71).

Versão 1.0.0-alpha02

29 de junho de 2022

Lançamento de androidx.core.uwb:uwb-rxjava3:1.0.0-alpha02. A versão 1.0.0-alpha02 contém estas confirmações.

Novos recursos

  • Lançamos um artefato Java interoperável para o módulo uwb. O novo artefato depende do rxjava3 e vai ser consumível para clientes Java.

Versão 1.0.0-alpha02

15 de junho de 2022

Lançamento de androidx.core.uwb:uwb:1.0.0-alpha02. A versão 1.0.0-alpha02 contém estas confirmações.

Novos recursos

  • Um elemento UWB_CONFIG_ID_1 público foi introduzido.

Mudanças na API

  • A distância da RangingResultPosition agora pode ser um valor nulo.

Versão 1.0.0-alpha01

1º de junho de 2022

Lançamento de androidx.core.uwb:uwb:1.0.0-alpha01. A versão 1.0.0-alpha01 contém estas confirmações.

Novos recursos

  • A biblioteca UWB oferece um conjunto de APIs para os desenvolvedores interagirem com os dispositivos com UWB ativada. O caso de uso é limitado a dispositivos parceiros que já presumem o perfil de controlador das sessões de alcance da UWB, com suporte ao perfil de controlador planejado em breve. Duas plataformas de API de nível superior estão incluídas nesta versão inicial, UwbManager e UwbClientSessionScope.