Steuere deine Geräte

Die Nutzer können die Aktion eines Dienstleisters beantragen. Wenn die Aktion vom Anbieter unterstützt wird, sollte sie bestätigt und ausgeführt werden. Andernfalls sollte sie ignoriert werden.

Name der Nachrichtengruppe Wert
Geräteaktion 0x04
Name des Geräteaktionscodes Wert
Ring 0x01

Gerät klingeln lassen

Ein Anwendungsfall für diese Aktionen ist der Suchende, der den Anbieter zum Klingeln anfordert, z. B. wenn ein Nutzer das Gerät verloren hat und es orten muss. Wenn das Klingeln empfangen wird, sollte der Anbieter eine vorab geladene Tondatei in einer ausreichend großen Lautstärke abspielen, damit der Nutzer sie finden kann. Es wird empfohlen, den Ton im Laufe der Zeit von einer niedrigen auf die maximale Lautstärke zu erhöhen. Das Klingeln sollte so lange fortgesetzt werden, bis eine zusätzliche Aktion zum Stoppen eines Stopps oder eine Zeitüberschreitung erreicht wird.

Zusätzliche Daten werden in die Nachricht aufgenommen, um anzugeben, ob das Klingeln gestartet oder beendet werden soll. Sie können dann auf Anbieter mit mehreren Komponenten (linker und rechter Kopfhörer) erweitert werden. Im ersten Byte werden die Bits auf 1 gesetzt, um einen Ring zum Starten anzufordern, oder 0, um einen Ring zum Beenden anzufordern.

Wenn beispielsweise das erste Byte mit zusätzlichen Daten auf Folgendes eingestellt ist:

  • 0 x 00 (0b00000000): Alle Komponenten sollten nicht mehr klingeln.
  • 0x01 (0b00000001): rechts klingeln lassen, nicht mehr klingeln
  • 0x02 (0b00000010): Links klingeln lassen, rechts klingeln lassen
  • 0x03 (0b00000011): Links und rechts klingeln lassen

Bei Anbietern, die das individuelle Klingeln nicht unterstützen, sollte nur ein Bit berücksichtigt werden:

  • 0x00 (0b00000000): Klingeln beenden
  • 0x01 (0b00000001): Klingeln lassen

Das zweite Byte in zusätzlichen Daten, falls vorhanden, stellt das Zeitlimit in Sekunden dar. Dieser Wert sollte vom Anbieter verwendet werden, um zu bestimmen, wie lange er klingeln soll, bevor er sich selbst stummschaltet. Ausgehend vom Beispiel oben rechts und einem Zeitlimit von 60 Sekunden würde 0x013C als zusätzliche Daten übergeben.

Klingelstatus wird wieder mit Seeker synchronisiert

Dienstleister möchten möglicherweise einen Suchenden benachrichtigen, wenn er den Klingelstatus ändert, z. B. wenn das Klingeln durch eine Bewegung beendet wird. Er kann dann die Nachricht empfangen und die UI bei Bedarf aktualisieren.

Der Anbieter sollte dasselbe Nachrichtenformat wie im Beispiel oben verwenden. Diese Nachricht wird vom Empfänger erfasst und dient als Bestätigung.

Aktion bestätigen

Wenn eine Aktion empfangen wird, sollte sie bestätigt werden, damit der Seere weiß, ob die Aktion ausgeführt wurde. Wenn innerhalb von einer Sekunde nach dem Senden einer Aktion keine Bestätigung (oder eine negative Bestätigung) empfangen wird, geht der Nutzer davon aus, dass die Aktion derzeit nicht unterstützt wird.