Działanie urządzenia

Osoby poszukujące pomocy mogą poprosić Usługodawcę o podjęcie określonych działań. Jeśli działanie jest obsługiwane przez dostawcę, należy je potwierdzić i wykonać. W przeciwnym razie należy je zignorować.

Nazwa grupy wiadomości Wartość
Zdarzenie dotyczące działania na urządzeniu 0x04
Nazwa kodu działania na urządzeniu Wartość
Dzwonek 0x01

Dzwonienie na urządzenie

Jednym z przykładów użycia tych działań jest prośba osoby szukającej o wywołanie urządzenia przez dostawcę, np. gdy użytkownik zgubił urządzenie i musi je zlokalizować. Gdy dostawca otrzyma działanie dzwonka, powinien zacząć odtwarzać wstępnie załadowany plik dźwiękowy z wystarczająco dużą głośnością, aby użytkownik mógł go zlokalizować. Zalecamy stopniowe zwiększanie głośności od niskiego do maksymalnego poziomu. Dzwonienie powinno trwać do momentu otrzymania dodatkowego działania, które spowoduje zatrzymanie, lub upłynięcia wartości limitu czasu.

Wiadomość będzie zawierać dodatkowe dane wskazujące, czy dzwonienie ma się rozpocząć, czy zakończyć. Można je rozszerzyć, aby obsługiwać dostawców z wieloma komponentami (lewa i prawa słuchawka). W pierwszym bajcie bity będą ustawione na 1, aby rozpocząć dzwonienie, lub na 0, aby je zatrzymać.

Jeśli na przykład pierwszy bajt danych dodatkowych ma wartość:

  • 0x00 (0b00000000): wszystkie komponenty powinny przestać dzwonić
  • 0x01 (0b00000001): dzwonek z prawej strony, wyłączanie dzwonka z lewej strony
  • 0x02 (0b00000010): dzwonek z lewej strony, wyłączony z prawej
  • 0x03 (0b00000011): dzwonek na obu słuchawkach

W przypadku dostawców, którzy nie obsługują indywidualnego dzwonka, należy wziąć pod uwagę tylko 1 bit:

  • 0x00 (0b00000000): wyłącz dzwonek.
  • 0x01 (0b00000001): rozpocznij dzwonienie

Drugi bajt w danych dodatkowych (jeśli występuje) reprezentuje limit czasu w sekundach. Ta wartość powinna być używana przez dostawcę do określania, jak długo ma dzwonić urządzenie, zanim zostanie wyciszone. Na podstawie powyższego przykładu dzwonka i limitu czasu wynoszącego 60 sekund jako dodatkowe dane zostanie przekazana wartość 0x013C.

Synchronizowanie stanu dzwonienia z osobami poszukującymi

Dostawcy mogą chcieć powiadomić osobę poszukującą pomocy, gdy zmieni się stan dzwonka, np. gdy gest spowoduje zatrzymanie dzwonka. Wyszukiwarka może wtedy odebrać wiadomość i w razie potrzeby zaktualizować interfejs.

Dostawca powinien używać formatu wiadomości takiego jak w przykładzie powyżej. Urządzenie wyszukujące będzie nasłuchiwać tej wiadomości i po jej otrzymaniu wyśle potwierdzenie.

Potwierdzanie działania

Po otrzymaniu działania należy je potwierdzić, aby wyszukujący wiedział, czy zostało ono wykonane. Jeśli w ciągu 1 sekundy od wysłania działania nie zostanie odebrane potwierdzenie (lub zostanie odebrane potwierdzenie negatywne), wyszukiwarka uzna, że działanie nie jest obecnie obsługiwane.