In diesem Leitfaden finden Sie UX-Richtlinien für die Gestaltung nahtloser Geräteberechtigungen und Freigaben für die Google Home APIs beim Onboarding in Ihrer Anwendung.
Die wichtigsten Themen, die hier beschrieben werden, sind:
- Warum sollte ich Geräte mit Google Home teilen?
- Wichtige Phasen des Freigabeprozesses
- Technische Implementierung
- UX Best Practices
Warum Geräte mit Google Home teilen?
Damit Nutzer die Funktionen der Home APIs nutzen können, müssen sie ihre Geräte mit Google Home teilen, weil:
- Es ist eine technische Anforderung, dass Google diese Geräte in automatisierten Abläufen verwenden kann.
- So bleibt die Nutzung von Google Home einheitlich und flexibel.
- Es ist wichtig, dass Geräte in allen Home API-fähigen Apps einheitlich dargestellt werden, um eine fragmentierte und verwirrende Nutzererfahrung zu vermeiden, bei der Nutzer zwischen Apps wechseln müssen, um grundlegende Aufgaben zu erledigen.
Wichtige Komponenten des Freigabeprozesses
| Komponente | Programm | Beschreibung |
|---|---|---|
| Permissions API unter Android | Home APIs für Berechtigungen unter Android | Fordert Nutzer auf, deiner App Berechtigungen zu erteilen. Bevor deine App die Home APIs verwenden kann, muss sie die Berechtigung haben, auf Geräte im Zuhause des Nutzers (in der API als Gebäude bezeichnet) zuzugreifen. Die Reihenfolge, in der dieser Schritt ausgeführt wird, hängt jedoch vom Entwicklerszenario ab und ist in der technischen Implementierung enthalten. |
| Cloud-zu-Cloud-Verknüpfung | Cloud-to-Cloud für die Kontoverknüpfung | Damit kannst du den Prozess zur Kontoverknüpfung starten, um mit der Cloud verbundene Geräte über deine App mit Google Home zu teilen. Um die Nutzerfreundlichkeit zu verbessern, empfehlen wir, die Deeplink-Funktion (sowohl für Android als auch für iOS verfügbar) zu verwenden, die Nutzer direkt zu deiner spezifischen Seite zur Kontoverknüpfung in der GHA weiterleitet. |
| Commissioning API unter Android | Matter-Inbetriebnahme | Die API wird im Allgemeinen als API zur Inbetriebnahme neuer Matter-Geräte angesehen. Du kannst sie aber auch verwenden, um die Google-Fabric zu Matter-Geräten hinzuzufügen, die bereits für eine andere Fabric in Betrieb genommen wurden. Daher ist dies ein nützliches Tool für den Onboarding-Prozess. |
Technische Implementierung
Wie Sie die Freigabeflüsse erstellen, hängt davon ab, welche Geräte Sie mit Google teilen möchten.
Für die folgenden Szenarien empfehlen wir, die Schritte in der angegebenen Reihenfolge auszuführen. Dies trägt dazu bei, die Nutzerfreundlichkeit insgesamt zu verbessern.
Du stellst nur Matter-Geräte her.
Sie stellen Matter-kompatible Geräte her, die Sie in Google Home einbinden möchten.
Rufen Sie die Permissions API unter Android auf.
Rufe die Commissioning API für Android auf jedem Matter-Gerät auf, das zuvor einer anderen Fabric hinzugefügt wurde.
- Da die Matter-Freigabe für jedes Gerät einzeln durchgeführt werden muss und viele Bildschirme Nutzereingaben erfordern, empfehlen wir, den Nutzer durch diesen Prozess zu führen:
- Nutzern eine Liste von Matter-Geräten bereitstellen, die nicht mit Google geteilt werden.
- Nutzern erlauben, den Prozess zur Gerätefreigabe (über die Commissioning API) zu starten, indem sie auf Geräte in dieser Liste klicken.
- Rückkehr zur Liste der Matter-Geräte, auf der dem Nutzer der Fortschritt der Aufgabe und der Freigabestatus angezeigt werden.
- Da die Matter-Freigabe für jedes Gerät einzeln durchgeführt werden muss und viele Bildschirme Nutzereingaben erfordern, empfehlen wir, den Nutzer durch diesen Prozess zu führen:
Sie stellen nur Geräte her, die über Cloud-to-Cloud APIs mit Google geteilt werden.
Cloud-to-cloud-Deeplinks einrichten Dadurch werden die Geräte dem Google Home Graph hinzugefügt.
- Wir empfehlen, zuerst die Cloud-to-cloud-Verknüpfung durchzuführen, um potenziell verwirrende Situationen zu vermeiden, z. B. dass dem Nutzer eine Liste mit Geräten angezeigt wird, die mit Google geteilt werden, und Geräten, die nicht mit Google geteilt werden.
Rufen Sie die Permissions API unter Android auf.
Du stellst sowohl Cloud-zu-Cloud- als auch Matter-Geräte her.
Cloud-to-cloud-Deeplinks einrichten
- Wir empfehlen, zuerst die Cloud-to-cloud-Verknüpfung durchzuführen, um potenziell verwirrende Situationen zu vermeiden, z. B. dass dem Nutzer eine Liste mit Geräten angezeigt wird, die mit Google geteilt werden, und Geräten, die nicht mit Google geteilt werden.
Rufen Sie die Permissions API unter Android auf.
Rufe die Commissioning API für Android auf jedem Matter-Gerät auf, das zuvor in einer anderen Fabric in Betrieb genommen wurde.
- Da die Matter-Freigabe für jedes Gerät einzeln durchgeführt werden muss und viele Bildschirme Nutzereingaben erfordern, empfehlen wir, den Nutzer durch diesen Prozess zu führen:
- Nutzern eine Liste von Matter-Geräten bereitstellen, die nicht mit Google geteilt werden.
- Nutzern erlauben, den Prozess zur Gerätefreigabe (über die Commissioning API) zu starten, indem sie auf Geräte in dieser Liste klicken.
- Rückkehr zur Liste der Matter-Geräte, auf der dem Nutzer der Fortschritt der Aufgabe und der Freigabestatus angezeigt werden.
- Da die Matter-Freigabe für jedes Gerät einzeln durchgeführt werden muss und viele Bildschirme Nutzereingaben erfordern, empfehlen wir, den Nutzer durch diesen Prozess zu führen:
Du hast keine Geräte, die du mit Google teilen kannst
Rufen Sie die Permissions API auf.
UX Best Practices
In diesem Abschnitt werden einige wichtige Critical User Journeys beschrieben, die du bei der Entwicklung einer App mit den Home APIs berücksichtigen solltest.
Wo die Gerätefreigabe in der App eingeführt werden soll
Diese Liste ist nicht vollständig. Es gibt möglicherweise noch weitere Gelegenheiten, deinen Nutzern Google Home vorzustellen und sie die Funktionen ausprobieren zu lassen.
Diese schließen sich nicht gegenseitig aus und es gibt mehrere Einstiegspunkte:
Über das Menü „Einstellungen“
Da Nutzer wahrscheinlich daran gewöhnt sind, Verbindungen zu ihren Google Home-Ökosystemen über ein Einstellungsmenü einzurichten, können sie mit dieser Methode dieses Paradigma beibehalten.
Möglicherweise möchtest du die Gerätefreigabe (Cloud-to-cloud-Verknüpfung und die Matter Commissioning API) von der App-Berechtigung (Permissions API) trennen. So können Nutzer steuern, welche Schritte sie ausführen, und du hast die Möglichkeit, den Verbindungsstatus anzuzeigen.
Bei der Verwendung von Geräten in von Google ausgeführten automatisierten Abläufen
Auf dem Tab „Automatisierungen“ können Nutzer auf einen Einstiegspunkt für den Freigabevorgang tippen, einen Bildschirm mit den Vorteilen lesen, auf dem die Vorteile des Fortfahrens klar erläutert werden, und dann schnell den Berechtigungsvorgang durchlaufen.
Nur ab Inbetriebnahme
Dieses Szenario ist hauptsächlich für Partner gedacht, die nur Matter-Geräte (keine Cloud-to-cloud-Geräte) herstellen und keine eigene Matter-Fabric haben. Der Einstiegspunkt für den Nutzer kann direkt nach einem Out-of-Box-Bildschirm erfolgen, auf dem die Freigabe von Matter-Geräten (über die Commissioning API) und die App-Berechtigung (über die Permissions API) Teil desselben Nutzererfahrungsablaufs sind.
Logik für die Freigabe
Hier einige Vorschläge für Nutzer-Prompts:
Im Allgemeinen sollten Sie Nutzer nur auffordern, die fehlenden Schritte auszuführen, die für die Registrierung auf der Plattform erforderlich sind. Langjährige Kunden teilen beispielsweise möglicherweise bereits die Geräte eines OEM mit Google. In diesem Fall müssen sie nur den Prozess zur Erteilung von Berechtigungen für die Home APIs durchlaufen, um der App Zugriff auf ihr Google Home zu gewähren.
Mehrere Google Home-Administratoren können ein Google Home-Zuhause gemeinsam nutzen. In einigen Fällen wird möglicherweise nur ein Konto verwendet, um Geräte mit Google zu teilen. Daher sollte die Verknüpfung mit Cloud-to-cloud keine Voraussetzung für die Aufforderung zur Erteilung von Berechtigungen für die Home APIs sein.
Vorschläge für das visuelle Design
Ein klarer Vorteil der Einbindung in Google Home (z. B. „Erstelle erweiterte automatisierte Abläufe mit Google Home“ oder „Steuere Geräte mit Apps deiner Wahl“).
Ein Call-to-Action (z. B. „Jetzt starten“) und eine Möglichkeit zum Abbrechen, falls der Nutzer nicht fortfahren möchte.
Wenn der Platz es zulässt, eine Erklärung dazu, was passiert, wenn der Nutzer die Bildschirme durchläuft.
Speziell für Matter: Wenn der Nutzer dir zuvor über die Home APIs Zugriff auf sein Zuhause gewährt hat, kannst du es ihm ermöglichen, die Geräte in seinem Zuhause bei der Inbetriebnahme neuer Geräte mit Google Home zu teilen. Du kannst beispielsweise ein Matter-Gerät zu deiner Fabric hinzufügen und den Nutzer dann auffordern, dieses Gerät zur Google-Fabric hinzuzufügen.
Inhaltsvorschläge
Nutzer vertrauen eher etwas, das sie verstehen und das ihnen einen Mehrwert bietet. Stellen Sie Nutzern Informationen zur Verfügung, damit sie fundierte Entscheidungen treffen können, einschließlich der Abwägung von Vor- und Nachteilen.
Der entscheidende Pitch
Nutzer werden Geräte nur dann teilen, wenn es dafür einen starken Anreiz gibt.
- Achten Sie besonders darauf, wie Sie das Angebot positionieren.
- Machen Sie es verlockend, aber versprechen Sie nicht zu viel.
- Wenn der Nutzer ein Gerät benötigt, das in deinem Pitch erwähnt wird, solltest du das klar angeben, damit er nicht auf ein unerwartetes Hindernis stößt.
- Sie haben möglicherweise nur eine Chance, diese Nutzer zu gewinnen. Nutzen Sie sie.
Best Practices
- Beginnen Sie mit der Perspektive der Nutzer – dem Ansatz „Was habe ich davon?“.
- Schreiben Sie nicht mehr als vier Zeilen Inhalt in einen Abschnittsblock. Mehr Wörter könnten die Aufmerksamkeit der Nutzenden verlieren. Klarheit und Verständlichkeit können jedoch wichtiger sein als Kürze.
- Automatisierungen machen Spaß! Wählen Sie ein spannendes, aber hilfreiches Beispiel aus, wenn der Platz es zulässt.
- Versuchen Sie es mit einem spielerischen Tonfall, wenn dies zu Ihrer Gesamtstrategie passt.
- Verwenden Sie handlungsorientierte Formulierungen wie „Jetzt starten“.