Core Ultra Wideband (UWB)

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:

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

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

Versão 1.1.0-alpha02

9 de setembro de 2026

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

Mudanças na API

• Adição de suporte à fusão de sensores baseada em odometria, que fornece estimativa de ângulo de chegada do software e ajusta as medições de alcance para o movimento do dispositivo local. (I191a9)

Versão 1.1.0-alpha01

19 de maio de 2026

Lançamento de androidx.core.uwb:uwb:1.1.0-alpha01 e androidx.core.uwb:uwb-rxjava3:1.1.0-alpha01. A versão 1.1.0-alpha01 contém essas confirmações (link em inglês).

Mudanças na API

• Adição da nova API close() para UwbManager para desvincular o serviço UWB. (I4606f, b/498499531)

Versão 1.0

Versão 1.0.0

6 de maio de 2026

Lançamento de androidx.core.uwb:uwb:1.0.0 e androidx.core.uwb:uwb-rxjava3:1.0.0. A versão 1.0.0 contém essas confirmações (link em inglês).

Versão 1.0.0-rc01

8 de abril de 2026

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

Versão 1.0.0-beta01

11 de março de 2026

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

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 estas confirmações.

Mudanças na API

• Introdução da nova API RangingResultFailure para informar a falha e o motivo da sessão de alcance. A falha de inicialização do alcance vai incluir um motivo no callback RangingResultPeerDisconnected (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 estas confirmações.

Mudanças na API

• Adição dos códigos de motivo STATE_CHANGE_REASON_UNKNOWN, STATE_CHANGE_REASON_SYSTEM_POLICY e STATE_CHANGE_REASON_COUNTRY_CODE_ERROR para a mudança de estado da UWB. (I43e36)
• Adição da nova API RangingResult#RangingResultInitialized para enviar eventos quando uma sessão de alcance é inicializada. (I386bb)
• Adição das novas APIs subscribeToUwbAvailability(observer: UwbAvailabilityCallback) e unsubscribeFromUwbAvailability() ao listener para o evento de mudança de estado da UWB. Adição da nova interface UwbAvailabilityCallback para que o usuário defina a função de callback quando um evento de mudança de estado da UWB é 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 estas confirmações.

Mudanças na API

• Adição da nova API isAvailable() para verificar a disponibilidade da UWB. (If6fc6)
• Adição da nova API addControleeWithSessionParams para oferecer suporte à adição do caso de chave individual p-sts do controlee. (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

• Adição de novos recursos e parâmetros para permitir que o app de terceiros defina o intervalo de alcance, a duração do slot e ative/desative o AoA. Adição de 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 ao STS provisionado. Agora, os usuários podem escolher o STS provisionado para o alcance da UWB se o dispositivo for capaz de fazer isso. (I19812)

Mudanças na API

• Adição de subSessionId e subSessionKeyInfo a rangingParameters. Adição de novos IDs de configuração para oferecer suporte ao STS provisionado. (I19812)
• Mesclagem de arquivos de API públicos e experimentais para caminhos a, b e c (I8cfee, b/278769092)
• Não aplicável, as mudanças no arquivo de API são apenas métodos de reordenação (I5fa95)
• Migração do grupo androidx.core para usar arquivos de API públicos mesclados (Ifdef4, b/278769092)
• Adição de minRangingInterval, supportedChannels e supportedConfigIds a rangingCapabilities como novos campos. (I2a204)

Correções de bugs

• Correção do problema em que o cliente UWB não podia ser criado em uma área não 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.
• Adição de 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.