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.