Azione dispositivo

Gli utenti possono richiedere che un fornitore esegua un'azione. Se l'azione è supportata dal provider, deve essere riconosciuta ed eseguita, altrimenti deve essere ignorata.

Nome gruppo di messaggi Valore
Evento azione dispositivo 0x04
Nome codice azione del dispositivo Valore
Squilla 0x01

Chiamare un dispositivo

Un caso d'uso per queste azioni è la persona che cerca, che chiede al provider di squillare, ad esempio quando un utente ha smarrito il dispositivo e deve trovarlo. Quando viene ricevuta l'azione di squillo, il provider deve iniziare a riprodurre un file audio precaricato a un volume sufficientemente elevato da consentire all'utente di individuarlo. Consigliamo di aumentare il volume da un volume basso a quello massimo nel tempo. Lo squillo deve continuare fino a quando non viene ricevuta un'altra azione che indica l'interruzione o il timeout.

Verranno inclusi dati aggiuntivi nel messaggio per indicare se lo squillo deve essere avviato o interrotto, ma è possibile espanderlo in modo da supportare i fornitori con più componenti (auricolare sinistro e destro). Nel primo byte, i bit verranno impostati su 1 per richiedere l'avvio di un anello o 0 per richiedere l'arresto di un anello.

Ad esempio, se il primo byte di dati aggiuntivi è impostato su:

  • 0x00 (0b00000000): tutti i componenti non devono più squillare
  • 0x01 (0b00000001): squilla a destra, smetti di suonare a sinistra
  • 0x02 (0b00000010): squillo a sinistra, smetti di suonare a destra
  • 0 x 03 (0b00000011): squilla sia a sinistra che a destra

Per i provider che non supportano la suoneria individuale, è necessario considerare solo 1 bit:

  • 0x00 (0b00000000): squilla
  • 0x01 (0b00000001): inizia a squillare

Il secondo byte in dati aggiuntivi, se presente, rappresenta il timeout in secondi. Questo valore deve essere utilizzato dal provider per determinare la durata del suono prima di disattivare l'audio. In base all'esempio di anello destro sopra riportato e a un timeout di 60 secondi, 0x013C verrebbe passato come dato aggiuntivo.

Sincronizzazione dello stato dello squillo con le persone che cercano

I fornitori potrebbero voler informare un richiedente quando cambia lo stato dello squillo, ad esempio se un gesto fa sì che lo squillo venga interrotto. Il richiedente può quindi ricevere il messaggio e aggiornare la UI, se necessario.

Il provider deve seguire lo stesso formato del messaggio definito nell'esempio precedente. I cercatori sentiranno questo messaggio e confermeranno la ricezione.

Accettazione di un'azione

Quando un'azione viene ricevuta, deve essere accertata in modo che il richiedente sappia se l'azione è stata eseguita o meno. Se non viene ricevuta una conferma entro un secondo dall'invio di un'azione (o una conferma negativa), il richiedente presume che l'azione non sia al momento supportata.