Androidify mit Watch Face Push auf Wear OS

Vor einigen Monaten haben wir Androidify als App zum Erstellen personalisierter Android-Bots neu eingeführt. Mit Androidify können Sie Ihr Selfie mithilfe von Gemini und Imagen in einen lustigen Android-Bot verwandeln.

Da Android jedoch mehrere Formfaktoren umfasst, einschließlich unseres neuesten, XR, haben wir uns gefragt, wie wir den Spaß von Androidify auf Wear OS übertragen können.

Ein Androidify-Zifferblatt

Da Androidify-Bots sehr personalisiert sind, ist das Zifferblatt der natürliche Ort, um sie zu präsentieren. Es ist nicht nur die am häufigsten sichtbare Oberfläche, sondern auch die persönlichste, da ihr dort zeigen könnt, wer ihr seid.

Personalisiertes Androidify-Zifferblatt, das aus einem Selfie generiert wurde

Mit Androidify kann jetzt ein Zifferblatt dynamisch in der Smartphone-App generiert und dann an deine Smartwatch gesendet werden, wo es automatisch als Zifferblatt festgelegt wird. Das alles geschieht innerhalb von Sekunden.

High-Level-Design

End-to-End-Ablauf für die Erstellung und Installation von Zifferblättern

Um die End-to-End-Lösung zu realisieren, müssen verschiedene Technologien kombiniert werden, wie in diesem allgemeinen Designschema dargestellt.

Zuerst wird der Avatar des Nutzers mit einer vorhandenen Watch Face Format-Vorlage kombiniert und dann in ein APK verpackt. Das wird überprüft – aus Gründen, die wir gleich erläutern. – und an die Smartwatch gesendet.

Nachdem die Smartwatch das Zifferblatt empfangen hat, wird es mithilfe der neuen Watch Face Push API (Teil von Wear OS 6) installiert und aktiviert.

Sehen wir uns die Details an:

Zifferblattvorlagen erstellen

Das Zifferblatt wird aus einer Vorlage erstellt, die in Watch Face Designer entworfen wurde. Mit diesem neuen Figma-Plugin können Sie Zifferblätter im Watch Face-Format direkt in Figma erstellen.

Androidify-Zifferblattvorlage im Watch Face Designer

Mit dem Plug-in kann das Zifferblatt auf verschiedene Arten exportiert werden, unter anderem als WFF-Ressourcen (Watch Face Format). Diese können dann ganz einfach als Assets in die Androidify App eingebunden werden, um das endgültige Zifferblatt dynamisch zu erstellen.

Verpackung und Validierung

Nachdem Vorlage und Avatar kombiniert wurden, wird das Portable Asset Compiler Kit (Pack) verwendet, um eine APK zu erstellen.

In Androidify wird „Pack“ als native Bibliothek auf dem Smartphone verwendet. Weitere Informationen zur Interaktion von Androidify mit der Pack-Bibliothek finden Sie im GitHub-Repository.

Als letzten Schritt vor der Übertragung wird das APK vom Watch Face Push-Validator geprüft.

Mit diesem Validator wird geprüft, ob das APK für die Installation geeignet ist. Dazu gehört, dass der Inhalt der APK geprüft wird, um sicherzustellen, dass es sich um ein gültiges Zifferblatt handelt. Außerdem werden einige Leistungsprüfungen durchgeführt. Wenn sie gültig ist, wird vom Validator ein Token generiert.

Dieses Token ist für die Installation auf der Smartwatch erforderlich.

Zifferblatt wird gesendet

Die Androidify App unter Wear OS verwendet WearableListenerService, um auf Ereignisse in der Wearable Data Layer zu warten.

Die Smartphone-App überträgt das Zifferblatt mithilfe einer Kombination aus MessageClient zum Einrichten des Vorgangs und ChannelClient zum Streamen des APKs.

Zifferblatt auf der Smartwatch installieren

Sobald das Zifferblatt auf dem Wear OS-Gerät empfangen wurde, wird es von der Androidify-App über die neue Watch Face Push API installiert:

val wfpManager = 

    WatchFacePushManagerFactory.createWatchFacePushManager(context)

val response = wfpManager.listWatchFaces()



try {

    if (response.remainingSlotCount > 0) {

        wfpManager.addWatchFace(apkFd, token)

    } else {

        val slotId = response.installedWatchFaceDetails.first().slotId

        wfpManager.updateWatchFace(slotId, apkFd, token)

    }

} catch (a: WatchFacePushManager.AddWatchFaceException) {

    return WatchFaceInstallError.WATCH_FACE_INSTALL_ERROR

} catch (u: WatchFacePushManager.UpdateWatchFaceException) {

    return WatchFaceInstallError.WATCH_FACE_INSTALL_ERROR

}

Androidify verwendet je nach Szenario entweder die Methode addWatchFace oder updateWatchFace. Beim Push von Zifferblättern wird das Konzept von „Slots“ definiert – wie viele Zifferblätter eine bestimmte App gleichzeitig installiert haben kann. Bei Wear OS 6 ist dieser Wert tatsächlich 1.

Bei Androidify wird das Zifferblatt installiert, wenn ein verfügbarer Slot vorhanden ist. Andernfalls wird ein vorhandenes Zifferblatt durch das neue ersetzt.

Aktives Zifferblatt festlegen

Die programmatische Installation des Zifferblatts ist ein wichtiger Schritt, aber Androidify sorgt dafür, dass das Zifferblatt auch das aktive Zifferblatt ist. 

Mit Watch Face Push wird eine neue Laufzeitberechtigung eingeführt, die erteilt werden muss, damit Apps diese Funktion nutzen können:

com.google.wear.permission.SET_PUSHED_WATCH_FACE_AS_ACTIVE

Nachdem diese Berechtigung erteilt wurde, kann die Methode wfpManager.setWatchFaceAsActive() aufgerufen werden, um ein installiertes Zifferblatt als aktives Zifferblatt festzulegen.

Es gibt jedoch einige Aspekte, die bei Androidify berücksichtigt werden müssen:

• setWatchFaceAsActive kann nur einmal verwendet werden.
• SET_PUSHED_WATCH_FACE_AS_ACTIVE kann nicht noch einmal angefordert werden, nachdem der Nutzer die Anfrage abgelehnt hat.
• Möglicherweise ist Androidify bereits für das aktive Zifferblatt verantwortlich.

Weitere Informationen dazu, wie Androidify die Logik zum Festlegen der aktiven Konfiguration implementiert, finden Sie hier.

Erste Schritte mit der Watch Face Push API für Wear OS

Watch Face Push ist eine vielseitige API, die sich sowohl für die Erweiterung von Androidify als auch für die Entwicklung von Marktplätzen für Zifferblätter mit vollem Funktionsumfang eignet.

Vielleicht haben Sie bereits eine Smartphone-App und suchen nach Möglichkeiten, Ihre Nutzer noch besser zu erreichen und zu begeistern.

Oder sind Sie ein bestehender Zifferblattentwickler, der durch die Veröffentlichung einer Marketplace-App eine eigene Community und Galerie erstellen möchte?

Weitere Informationen:

• Watch Face Push
• Watch Face Format: Beachten Sie auch die bevorstehenden Richtlinienänderungen in Bezug auf die Veröffentlichung von Zifferblättern.
• Watch Face Designer
• Androidify-GitHub-Repository
• Androidify Google Play Store-Eintrag

In diesem Video erfahren Sie mehr darüber, wie wir Androidify für Wear OS entwickelt haben.

Wir sind schon gespannt, was du mit Watch Face Push alles anstellen wirst.