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 möglicherweise nicht offensichtlich, wie die Funktionen der Mirror API zusammengefügt werden.

Viele Dienste fallen in verschiedene Kategorien der API-Nutzung. Im Folgenden wird gezeigt, wie Sie die Funktionen der Mirror API kombinieren, um Glass-Dienste zu erstellen.

Fakten über Katzen

Die Übermittlung von Inhalten an die Glass-Zeitachse ist eine einfache, aber leistungsstarke Nutzung der Google Mirror API. Die Beispiel-Glassware „Cat Facts“ liefert Informationen über Katzen an die Nutzer und könnte möglicherweise diesem Ablauf folgen:

1. Der Nutzer besucht Ihre Webanwendung und abonniert das Abo über OAuth 2.0.
2. Ihr Dienst liefert stündlich zur vollen Stunde eine neue Katzenfakten an die Google Glass.

„Cat Facts“ würde mit der Timeline-Einfügemethode implementiert werden:

1. Nutzer abonnieren ein Abo durch Authentifizierung mit OAuth 2.0
2. Cat Facts speichert einen Index der Nutzer und deren Anmeldedaten
3. Jede Stunde veröffentlicht Cat Facts einen neuen Artikel über „Cat Facts“. Dazu iteriert sie durch alle gespeicherten Nutzer und fügt ein Zeitachsenelement in ihre Zeitachsen ein.

Dem eine Katze hinzufügen

Jeder Schritt des technologischen Fortschritts liefert 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 mit Glass aufgenommenes Foto zusammensetzen.

1. Der Nutzer besucht Ihre Webanwendung und installiert „Add a Cat to That“ durch eine Authentifizierung mit OAuth 2.0.
2. Ihr Dienst erstellt in Glass Ihres Nutzers einen neuen Kontakt namens "Add a Cat to That" (Katze hinzufügen).
3. Nutzer, die Fotos aufnehmen, teilen diese über die Funktion „Katze hinzufügen“.
4. Ihr Dienst erstellt auf dem geteilten Foto ein zufälliges Bild einer Katze.
5. Schließlich liefert Ihr Dienst das mit der Katze optimierten Foto an das Glass-Gerät Ihrer Nutzer.

Architektonisch folgt dieser Dienst diesem API-Ablauf:

1. Der Nutzer autorisiert die Autorisierung mit OAuth 2.0. Die Anmeldedaten werden von Ihrem Dienst gespeichert.
2. Kurz nach Abschluss des OAuth 2.0-Tanzes fügt Ihr Dienst einen Kontakt namens "Add a Cat to That" (Katze hinzufügen) ein.
3. Als Nächstes abonniert Ihr Dienst Updates in der Zeitachse dieses Nutzers, indem er ein Abo für die Sammlung timeline hinzufügt. Die Option „Eine Katze hinzufügen“ ist jetzt vollständig eingerichtet.
4. Im Laufe der Zeit machen Nutzende Fotos.
5. Ihr 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 verwendet das enthaltene id, um die Zeitachsenkarte abzurufen, die das Foto enthält.
8. Als Nächstes prüft Ihr Dienst das Zeitachsenelement und ruft mithilfe der Anhangs-ID die Byte des Fotos ab.
9. Ihr Dienst wählt ein zufälliges Bild einer Katze aus und fügt es dem geteilten Foto hinzu.
10. Abschließend erstellt Ihr Dienst eine neue Zeitachsenkarte und fügt sie in die Zeitachse des Nutzers ein, der das mit Katze optimierte Foto beigefügt ist.

Hinweis: Als zusätzlichen Bonus können Sie das integrierte Menüelement SHARE zur Zeitachse hinzufügen. So können mit Katzen optimierte Fotos mit anderen Diensten oder wiederholt über „Eine Katze hinzufügen“ geteilt werden, um mehrere Katzen zu einem Foto hinzuzufügen.

Zoohandlungen in der Nähe

Es gibt nur eine Sache besser als Fakten über Katzen oder Bilder von Katzen, und das sind echte, physische, pelzige Katzen. Mit der Mirror API ist dies einfacher, da Sie immer wissen, wo die nächste Tierhandlung ist.

Die Nutzung erfolgt nach diesem Ablauf:

1. Der Nutzer besucht Ihre Webanwendung und abonniert das Abo über OAuth 2.0.
2. Ihr Dienst ermittelt den Standort des Nutzers.
3. Ihr Dienst sucht nach Tierhandlungen in der Nähe dieses Standorts.
4. Ihr Dienst fügt links neben der Uhr eine Karte ein, auf der diese Tierhandlungen in der Nähe aufgeführt sind.
5. Glass benachrichtigt Ihren Dienst über den Standort Ihrer Nutzer.
6. Ihr Dienst wiederholt die Suche nach Tierhandlungen für jede Benachrichtigung und aktualisiert die angepinnte Karte entsprechend den neuen nächsten Tierhandlungen.

Die Implementierung dieses Dienstes folgt diesem API-Ablauf:

1. Der Nutzer autorisiert die Autorisierung mit OAuth 2.0. Neben dem üblichen glass.timeline-Bereich fordert Ihre Anwendung auch den Zugriff auf den Bereich glass.location an.
2. Kurz nach Abschluss des OAuth 2.0-Tanzes abonniert Ihr Dienst Updates zum Standort Ihrer Nutzer.
3. Als Nächstes ruft der Dienst den aktuellen Standort des Nutzers vom Standortendpunkt ab.
4. Ihr Dienst sucht nach Tierhandlungen in der Nähe Ihrer Nutzer.
5. Ihr Dienst erstellt eine timeline-Karte, auf der die Suchergebnisse für die Zoohandlung aufgeführt sind. Damit diese Karte auf der linken Seite des Uhrenbildschirms angezeigt wird, wird sie von deinem Dienst angepinnt.
6. Während sich ein Nutzer bewegt, wird sein letzter Standort aktualisiert.
7. Da Ihr Dienst Standortupdates abonniert hat, wird eine Benachrichtigung an ihn gesendet. Diese Benachrichtigung ist mit dem Element „latest“ in der Sammlung „location“ verknüpft.
8. Anhand der Benachrichtigung ruft Ihr Dienst die latest location Ihres Nutzers aus der Sammlung location ab.
9. Als Nächstes sucht Ihr Dienst nach Tierhandlungen in der Nähe Ihres Nutzers.
10. Schließlich verwendet der Dienst die Methode patch, um den Textkörper des in Schritt 5 eingefügten Zeitachsenelements zu aktualisieren.