API-Nutzungsgeschichten

Die Mirror API bietet eine Reihe von Bausteinen, mit denen Sie Dienste für Glass erstellen können. Da sich Glass-Dienste wahrscheinlich von anderer Software unterscheiden, die Sie entwickelt haben, ist es möglicherweise nicht offensichtlich, wie die Funktionen der Mirror API aneinander angepasst werden.

Viele Dienste lassen sich in verschiedene Kategorien der API-Nutzung unterteilen. Hier finden Sie einige Beispiele, wie Sie die Funktionen der Mirror API kombinieren, um Glass-Dienste zu erstellen.

Katzenfakten

Die Bereitstellung der Inhalte auf der Glass-Zeitachse ist eine einfache, aber leistungsstarke Verwendung der Google Mirror API. Die Beispiel-Glassware für Cat Facts liefert Informationen zu Katzen für Nutzer und könnte diesem Ablauf folgen:

1. Ihr Nutzer besucht Ihre Webanwendung und abonniert ihn durch die Authentifizierung mit OAuth 2.0.
2. Zu jeder Stunde stellt Ihr Service jedem der Glass-Daten Ihrer Nutzer ein neues Katzenfakt bereit.

Fakten zu Katzen werden mit der Methode zum Einfügen der Zeitachse implementiert:

1. Nutzer abonnieren durch Authentifizierung mit OAuth 2.0
2. Cat Facts speichert einen Index der Nutzer und ihrer Anmeldedaten
3. Cat Facts veröffentlicht stündlich neue Katzenfakten. Dazu werden alle gespeicherten Nutzer iteriert und ein Zeitachsenelement in ihre Zeitachsen eingefügt.

Füge eine Katze hinzu

Jeder Schritt der technologischen Weiterentwicklung bietet verbesserte Methoden für die Verbreitung von Katzenfotos. Das gilt auch für Project Glass.

Da jedes Foto mit einer Katze besser ist, können Nutzer mit diesem Dienst ein zufälliges Katzenbild und ein Foto, das sie mit Glass aufgenommen haben, zusammenstellen.

1. Ihr Nutzer ruft Ihre Webanwendung auf und installiert die Katze mithilfe von OAuth 2.0.
2. Ihr Dienst erstellt im Glass des Nutzers einen neuen Kontakt namens „Katze hinzufügen“.
3. Wenn dein Nutzer Fotos aufnimmt, teilt er sie mit „Katze hinzufügen“.
4. Ihr Dienst stellt auf dem geteilten Foto ein zufälliges Bild einer Katze zusammen.
5. Schließlich stellt Ihr Dienst das für Katzen optimierte Foto dem Glass Ihres Nutzers zur Verfügung.

Architektonisch würde dieser Dienst dem folgenden API-Ablauf folgen:

1. Ihr Nutzer autorisiert mit OAuth 2.0. Die Anmeldedaten werden vom Dienst gespeichert.
2. Kurz nach Abschluss des OAuth 2.0-Dance fügt Ihr Dienst einen Kontakt namens „Add a Cat to That“ ein.
3. Als Nächstes abonniert dein Dienst Updates auf der Zeitachse dieses Nutzers, indem er ein Abo für die Sammlung timeline einfügt. „Katze zu“ hinzufügen, ist jetzt vollständig eingerichtet.
4. Mit der Zeit nimmt Ihr Nutzer Fotos auf.
5. Dein Nutzer teilt ein Foto mit „Eine Katze hinzufügen“. Dadurch kann Ihr Dienst auf die mit diesem Foto verknüpfte Zeitachse zugreifen.
6. Da Sie für Ihren Dienst Zeitachsenaktualisierungen abonniert haben, wird eine Benachrichtigung an Ihren Dienst gesendet. Diese Benachrichtigung ist mit dem Zeitachsenelement verknüpft, das das geteilte Foto enthält.
7. Ihr Dienst prüft die Benachrichtigung und ruft die enthaltene id ab, um die Zeitachsenkarte abzurufen, die das Foto enthält.
8. Als Nächstes prüft Ihr Dienst das Zeitelement und verwendet die Anhang-ID, um die Bytes des Fotos abzurufen.
9. Ihr Dienst wählt ein zufälliges Bild einer Katze aus und setzt sie auf das geteilte Foto ein.
10. Abschließend erstellt der Dienst eine neue Zeitachse mit der angehängten Katzenkarte in die Zeitachse der Nutzer.

Hinweis: Als zusätzlichen Bonus kannst du das integrierte Menüelement SHARE zur Zeitachse hinzufügen. Dadurch können Fotos, die mit Katzen optimiert wurden, mit anderen Diensten oder wiederholt mit „Katze hinzufügen“ geteilt werden, um einem Foto mehrere Katzen hinzuzufügen.

Tierhandlungen in der Nähe

Es gibt nur eine Sache, die besser ist als Fakten über Katzen oder Bilder von Katzen. Das sind echte, pelzige Katzen. Mit der Mirror API ist dies ganz einfach. Sie wissen immer, wo sich die nächste Tierhandlung befindet.

Die Nutzung läuft so ab:

1. Ihr Nutzer besucht Ihre Webanwendung und abonniert ihn durch die Authentifizierung mit OAuth 2.0.
2. Ihr Dienst bestimmt den Standort des Nutzers.
3. Ihr Dienst sucht nach Tierhandlungen in der Nähe dieses Standorts.
4. Ihr Dienst setzt eine Karte links neben der Uhr ein, auf der diese Tierhandlungen in der Nähe aufgeführt sind.
5. Glass informiert Ihren Dienst über den Standort Ihres Nutzers.
6. Bei jeder Benachrichtigung wiederholt Ihr Dienst die Tierhandlung und aktualisiert die angeheftete Karte, um die neue Tierhandlung in der Nähe widerzuspiegeln.

Die Implementierung dieses Dienstes folgt diesem API-Ablauf:

1. Ihr Nutzer autorisiert mit OAuth 2.0. Neben dem üblichen Bereich glass.timeline fordert Ihre Anwendung auch den Zugriffsbereich glass.location an.
2. Kurz nach Abschluss des OAuth 2.0-Tanzes abonniert der Dienst Updates zum Standort des Nutzers.
3. Als Nächstes ruft Ihr Dienst den letzten Standort Ihres Nutzers vom Standortendpunkt ab.
4. Ihr Dienst sucht nach Tierhandlungen in der Nähe Ihres Nutzers.
5. Ihr Dienst erstellt eine timeline-Karte, auf der die Ergebnisse der Zoohandlung aufgeführt sind. Damit diese Karte auf der linken Seite des Ziffernblatts angezeigt wird, pinnen Sie sie an.
6. Während der Nutzer bewegt sich sein aktueller Standort.
7. Da der Dienst Standortupdates abonniert hat, wird eine Benachrichtigung an den Dienst gesendet. Diese Benachrichtigung ist mit dem latest-Element in der Sammlung location verknüpft.
8. Basierend auf der Benachrichtigung ruft der Dienst die latest location Ihres Nutzers aus der location-Sammlung ab.
9. Als Nächstes sucht Ihr Dienstleister nach Tierhandlungen in der Nähe Ihres Nutzers.
10. Schließlich verwendet Ihr Dienst die Methode patch, um den Text der Zeitachse zu aktualisieren, der in Schritt 5 eingefügt wurde.