Visão geral

A API Nearby Messages é de publicação/assinatura que permite transmitir pequenos payloads binários entre dispositivos Android e iOS conectados à Internet. Os dispositivos não precisam estar na mesma rede, mas precisam estar conectados à Internet.

O recurso "Por perto" usa o Bluetooth Low Energy para comunicar um código de pareamento único entre dispositivos. O servidor facilita a troca de mensagens entre dispositivos que detectam o mesmo código de pareamento. Quando um dispositivo detecta um código de pareamento de um dispositivo próximo, ele o envia ao servidor do Nearby Messages para validação e para verificar se há mensagens a serem entregues para o conjunto atual de assinaturas do aplicativo.

O Nearby Messages não está autenticado e não requer uma Conta do Google.

O mecanismo exato para troca de dados pode variar de acordo com a versão. A sequência a seguir mostra os eventos que levam à troca de mensagens:

  1. Um app de publicação faz uma solicitação para associar um payload binário (a mensagem) a um código de pareamento em tempo único (token). O servidor faz uma associação temporária entre o payload da mensagem e o token.

  2. O dispositivo de publicação usa o Bluetooth Low Energy para tornar o token detectável por dispositivos próximos. O dispositivo editor também usa o Bluetooth Low Energy para procurar tokens de outros dispositivos.

  3. Um app assinante associa a assinatura a um token e usa o Bluetooth Low Energy para enviar o token e detectar o token do editor.

  4. Quando um dos lados detecta o token do outro, ele o informa ao servidor.

  5. O servidor facilita a troca de mensagens entre dois dispositivos quando ambos estão associados a um token comum, e as chaves de API usadas pelos apps de chamada estão associadas ao mesmo projeto no Google Developers Console.

Ao usar o SDK do Nearby do Google Play Services, as análises de uso são coletadas para melhorar a experiência.

  • Métricas de desempenho:a duração das publicações e assinaturas e o número de mensagens recebidas são coletados ao usar o SDK do Nearby.
  • Informações do dispositivo:o modelo do dispositivo, o país, a versão do build e o nome do pacote do aplicativo são coletados e associados às métricas de desempenho para identificar frações regionais e específicas do dispositivo.
  • Publicações do Nearby Messages:os dados publicados pelo Nearby Messages são armazenados pelo Google até que a mensagem não seja mais publicada. Esses dados são compartilhados com assinantes que estão próximos ao dispositivo.

Os usuários finais podem permitir ou negar essa coleta em Configurações > Google > Uso e diagnósticos.