Działanie urządzenia
Poszukiwacze mogą poprosić o podjęcie działania przez dostawcę. 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 | 0 x 4 |
Nazwa kodu działania urządzenia | Wartość |
---|---|
Dzwonek | 0x01 |
Dzwonek urządzenia
Przykładem takiego działania jest uzyskanie odpowiedzi przez dostawcę na prośbę o nawiązanie połączenia z dostawcą, na przykład gdy użytkownik zgubił urządzenie i musi je znaleźć. Po otrzymaniu pierścienia dostawca powinien zacząć odtwarzać wstępnie wczytany plik dźwiękowy z głośnością na tyle, aby użytkownik mógł go zlokalizować. Zalecamy, aby dźwięk stopniowo zmniejszał się do niskiej. Dzwonek będzie kontynuowany, dopóki nie zostanie odebrane dodatkowe działanie, które wskazywałyby zatrzymanie lub limit czasu oczekiwania.
Do wiadomości zostaną dołączone dodatkowe dane wskazujące, czy dzwonienie ma być uruchomione czy zatrzymywane. Można je rozwinąć, aby obsługiwało dostawców obejmujących wiele komponentów (lewa i prawa słuchawka). W pierwszym bajcie bity będą ustawione na 1, aby żądać pierścienia, lub 0, aby poprosić o dzwonek.
Jeśli na przykład pierwszy bajt dodatkowych danych jest ustawiony na:
- 0x00 (0b00000000): wszystkie komponenty powinny przestać dzwonić
- 0x01 (0b00000001): Dzwoń w prawo, zatrzymaj dzwonek w lewo
- 0x02 (0b00000010): Dzwoń w lewo, zatrzymaj dzwonek w prawo
- 0x03 (0b00000011): zadzwoń zarówno w lewo, jak i w prawo
W przypadku dostawców, którzy nie obsługują dzwonków indywidualnych, należy uwzględniać tylko 1 bit:
- 0x00 (0b00000000): Wyłącz dzwonienie
- 0x01 (0b00000001): Zacznij dzwonić
Drugi bajt (w dodatkowych danych) oznacza limit czasu w sekundach. Ta wartość powinna być używana przez dostawcę do określenia, jak długo ma dzwonić, zanim zostanie wyciszony. Biorąc pod uwagę pierwotny przykład dotyczący pierścienia, który przekroczył limit czasu wynoszący 60 sekund, 0x013C
zostanie przekazany jako dane dodatkowe.
Synchronizuję stan dzwonka dla szukających
Usługodawcy mogą chcieć powiadomić Lookera o zmianie stanu dzwonienia, na przykład gdy gest zatrzymuje dzwonienie. Łużnik może wówczas otrzymać wiadomość i w razie potrzeby zaktualizować interfejs użytkownika.
Dostawca powinien stosować ten sam format wiadomości, jak określono w powyższym przykładzie. Usługa Looker będzie czekać na tę wiadomość i potwierdzić jej otrzymanie
Potwierdzanie działania
Otrzymane działanie należy potwierdzić, aby użytkownik wiedział, czy zostało ono wykonane. Jeśli nie otrzymasz potwierdzenia w ciągu 1 sekundy od wysłania działania (lub otrzyma negatywną odpowiedź), użytkownik przyjmie, że działanie nie jest obecnie obsługiwane.