Smartphone-App für Push-Mitteilungen zu Zifferblättern konfigurieren

Für den kanonischen Marktplatz ist die Smartphone-App die Hauptmethode, mit der Nutzer mit der App interagieren.

Zifferblatt festlegen

Wenn der Nutzer ein Zifferblatt in der Smartphone-App auswählt, besteht der nachfolgende Ablauf zum Festlegen des Zifferblatts aus zwei Teilen:

  1. Installation:Installieren Sie das Zifferblatt über die Funktion „Zifferblatt-Push“, die über MessageClient gestartet wird. Dieser Schritt ist ganz einfach. Verwenden Sie entweder addWatchFace oder updateWatchFace, die über MessageClient vom Smartphone auf die Smartwatch ausgelöst werden.
  2. Aktivierung:Legen Sie das installierte Zifferblatt als „Aktiv“ fest. Je nach Berechtigungsstatus sind für diesen Schritt mehrere Pfade möglich:
    • Möglicherweise müssen Sie nichts unternehmen. Der Marktplatz hat möglicherweise bereits die Kontrolle über das aktive Zifferblatt.
    • Möglicherweise ist kein Nutzereingriff erforderlich. Die App hat die erforderlichen Berechtigungen, das aktive Zifferblatt festzulegen, und kann dies direkt über setWatchFaceAsActive() tun.
    • Möglicherweise ist Unterstützung erforderlich, z. B. wie Sie Berechtigungsanfragen akzeptieren oder das Zifferblatt manuell durch langes Drücken oder über eine Companion App festlegen.

Installationsantwort

Um die Aktivierungsphase zu vereinfachen, sollten in der Installationsphase die folgenden Informationen von der Smartwatch an das Smartphone zurückgegeben werden:

  • Das Ergebnis des Installationsversuchs
  • Das Ergebnis von isWatchFaceActive(), um festzustellen, ob die App bereits das aktive Zifferblatt hat.
  • Unabhängig davon, ob setWatchFaceAsActive() bereits in der Vergangenheit aufgerufen wurde, sollte die Wear OS-App diese Informationen lokal erfassen und speichern. Dieser API-Aufruf kann nur einmal verwendet werden.

Aktivierung

Nach der Installation kann die Antwort darauf hinweisen, dass die App das aktive Zifferblatt bereits hat. Andernfalls kann die App eine Schaltfläche zum Festlegen des Zifferblatts als aktiv anzeigen.

Szenario 1: Alle Versuche, das aktive Zifferblatt festzulegen, sind ausgeschöpft

Wenn die Antwort der Installation anzeigt, dass setWatchFaceAsActive() bereits in der Vergangenheit aufgerufen wurde, sollte die Schaltfläche auf dem Smartphone zu einem Bildschirm mit einer Anleitung führen, in der der Nutzer gezeigt wird, wie er das Zifferblatt durch Tippen und Halten manuell auf das gewünschte einstellen kann.

Szenario 2: Versuchen, das aktive Zifferblatt festzulegen

Das Smartphone sollte die Smartwatch anweisen, die erforderliche SET_PUSHED_WATCH_FACE_AS_ACTIVE-Berechtigung zu prüfen:

  • Wenn der Nutzer die Berechtigung bereits erteilt hat, rufe setWatchFaceAsActive() auf.
  • Wenn der Nutzer die Berechtigung zuvor abgelehnt hat, sollte die Smartwatch dies an das Smartphone zurückgeben. Dort kann ein Aufklärungsbildschirm angezeigt werden, in dem erklärt wird, warum die Berechtigung erforderlich ist und wie sie manuell gewährt werden kann.

  • Wenn die Berechtigung noch nicht angefordert wurde, sollte die Smartwatch das Smartphone anweisen, eine Informationsseite zu zeigen, auf der der Nutzer erfahren kann, wie er Berechtigungen auf der Smartwatch akzeptiert. Anschließend sollte die Smartwatch die Berechtigung anfordern.

    • Wenn der Nutzer die Berechtigung gewährt, sollte die Smartwatch setWatchFaceAsActive() aufrufen.
    • Andernfalls sollte die Smartwatch das Smartphone anweisen, einen Aufklärungsbildschirm zu zeigen, in dem die Notwendigkeit der Berechtigung und die Möglichkeit zum manuellen Gewähren erläutert werden.