Ação do dispositivo

Os usuários podem solicitar que um provedor realize uma ação. Se o provedor oferecer suporte à ação, ela precisará ser confirmada e realizada. Caso contrário, será ignorada.

Nome do grupo de mensagens Valor
Evento de ação no dispositivo 0x04
Nome do código de ação do dispositivo Valor
Ring 0x01

Tocar em um dispositivo

Um caso de uso para essas ações é a busca pelo provedor para tocar, por exemplo, quando um usuário perde o dispositivo e precisa localizá-lo. Quando a ação de toque é recebida, o provedor precisa começar a reproduzir um arquivo de som pré-carregado em um volume alto o suficiente para que o usuário possa o localizar. É recomendável que o som seja aumentado de um volume baixo para um volume máximo ao longo do tempo. O toque continuará até que uma ação adicional seja recebida direcionando uma parada ou um valor de tempo limite tenha passado.

Mais dados serão incluídos na mensagem para indicar se o toque precisa ser iniciado ou interrompido, o que pode ser expandido para oferecer suporte a provedores com vários componentes (fones esquerdo e direito). No primeiro byte, os bits serão definidos como 1 para solicitar que um anel comece ou 0 para solicitar a interrupção.

Por exemplo, se o primeiro byte de dados adicionais for definido como:

  • 0x00 (0b00000000): todos os componentes devem parar de tocar
  • 0x01 (0b00000001): tocar à direita, parar de tocar à esquerda
  • 0x02 (0b00000010): tocar à esquerda, parar de tocar à direita
  • 0x03 (0b00000011): tocar à esquerda e à direita

Em provedores que não oferecem suporte ao toque individual, considere apenas um bit:

  • 0x00 (0b00000000): Parar de tocar
  • 0x01 (0b00000001): começar a tocar

O segundo byte em outros dados, se presente, representa o tempo limite em segundos. Esse valor precisa ser usado pelo provedor para determinar por quanto tempo ele tocará antes de silenciar-se. Com base no exemplo do anel para direita acima e um tempo limite de 60 segundos, 0x013C seria transmitido como os dados adicionais.

Sincronizando o status do toque com as pessoas que estão procurando

Os provedores podem querer notificar uma pessoa quando ela muda o status de toque, por exemplo, se um gesto interromper o toque. Em seguida, o buscador pode receber a mensagem e atualizar a IU, se necessário.

O provedor precisa seguir o mesmo formato de mensagem definido no exemplo acima. A pessoa vai buscar essa mensagem e fornecer uma confirmação quando ela for recebida.

Como confirmar uma ação

Quando uma ação é recebida, ela precisa ser confirmada para que a pessoa saiba se a ação foi realizada. Se uma confirmação não for recebida dentro de um segundo após o envio de uma ação (ou uma confirmação negativa for recebida), o Buscador entenderá que a ação não é compatível no momento.