Kisah Penggunaan API

Mirror API menyediakan kumpulan elemen penyusun yang dapat Anda gunakan untuk membuat layanan untuk Glass. Karena layanan Glass mungkin berbeda dengan software lain yang telah Anda kembangkan, mungkin kurang jelas cara menggabungkan fitur Mirror API.

Banyak layanan termasuk dalam beberapa kategori penggunaan API. Berikut adalah beberapa cerita yang menggambarkan cara menggabungkan fitur Mirror API untuk membuat layanan Glass.

Fakta Kucing

Mengirimkan konten ke linimasa Glass adalah penggunaan Google Mirror API yang sederhana tetapi efektif. Contoh Cat Facts Glassware menyampaikan fakta tentang kucing kepada pengguna dan berpotensi mengikuti alur ini:

  1. Pengguna Anda mengunjungi aplikasi web dan berlangganan dengan mengautentikasi OAuth 2.0.
  2. Setiap jam, setiap jam, layanan Anda memberikan Fakta Kucing baru ke setiap Glass pengguna Anda.

Cat Facts akan diterapkan menggunakan metode penyisipan linimasa:

Alur Cat Facts

  1. Pengguna berlangganan dengan mengautentikasi OAuth 2.0
  2. Cat Facts menyimpan indeks pengguna dan kredensialnya
  3. Setiap jam, Cat Facts memublikasikan Fakta Kucing baru. Hal ini dilakukan dengan mengiterasi semua pengguna yang disimpan dan menyisipkan item linimasa ke dalam linimasanya.

Tambahkan kucing ke dalamnya

Setiap langkah dalam kemajuan teknologi manusia menyediakan metode yang lebih baik untuk mendistribusikan foto kucing. Begitu pula dengan Project Glass.

Karena setiap foto lebih baik dengan kucing, layanan ini memungkinkan pengguna menggabungkan gambar kucing acak dan foto yang diambil dengan Glass.

  1. Pengguna mengunjungi aplikasi web dan menginstal Add a Cat to That dengan mengautentikasi OAuth 2.0.
  2. Layanan Anda membuat kontak baru pada Glass pengguna Anda yang disebut "Tambahkan Kucing ke Itu".
  3. Saat pengguna mengambil foto, mereka membagikannya dengan Menambahkan Kucing ke Itu.
  4. Layanan Anda menggabungkan gambar acak kucing ke foto yang dibagikan.
  5. Terakhir, layanan Anda mengirimkan foto yang disempurnakan kucing ke Glass pengguna Anda.

Secara arsitektur, layanan ini akan mengikuti alur API ini:

Menambahkan kucing ke alur tersebut

  1. Pengguna Anda memberi otorisasi dengan OAuth 2.0. Layanan Anda menyimpan kredensial mereka.
  2. Tepat setelah tarian OAuth 2.0 selesai, layanan Anda menyisipkan kontak yang disebut "Tambahkan Kucing ke Itu".
  3. Selanjutnya, layanan Anda akan berlangganan update di linimasa pengguna ini dengan memasukkan langganan untuk koleksi timeline. Menambahkan Cat ke That sekarang sudah disiapkan sepenuhnya.
  4. Seiring waktu, pengguna Anda akan mengambil foto.
  5. Pengguna Anda berbagi foto dengan Tambahkan Kucing ke Itu. Hal ini membuat kartu linimasa yang terkait dengan foto ini dapat diakses oleh layanan Anda.
  6. Karena layanan berlangganan langganan linimasa, notifikasi dikirim ke layanan Anda. Notifikasi ini berkaitan dengan item linimasa yang berisi foto yang dibagikan.
  7. Layanan Anda memeriksa notifikasi dan menggunakan id yang disertakan untuk mengambil kartu linimasa yang berisi foto tersebut.
  8. Selanjutnya, layanan Anda memeriksa item linimasa dan menggunakan ID lampiran untuk mengambil byte foto.
  9. Layanan Anda memilih gambar acak kucing, dan menyusunnya menjadi foto bersama.
  10. Terakhir, layanan Anda membuat kartu linimasa baru dan memasukkannya ke dalam kartu linimasa pengguna dengan foto yang disempurnakan dengan kucing.

Toko hewan peliharaan terdekat

Hanya ada satu hal yang lebih baik dari fakta tentang kucing atau gambar kucing, dan kucing yang sebenarnya itu adalah fisik. Mirror API dapat mempermudahnya dengan memastikan Anda selalu tahu di mana toko hewan peliharaan terdekat berada.

Penggunaannya mengikuti alur berikut:

  1. Pengguna Anda mengunjungi aplikasi web dan berlangganan dengan mengautentikasi OAuth 2.0.
  2. Layanan Anda menentukan lokasi pengguna.
  3. Layanan Anda menelusuri toko hewan peliharaan di dekat lokasi tersebut.
  4. Layanan Anda memasukkan kartu di sebelah kiri jam yang mencantumkan toko hewan peliharaan terdekat ini.
  5. Glass memberi tahu layanan Anda tentang lokasi pengguna Anda.
  6. Untuk setiap notifikasi, layanan Anda akan mengulangi penelusuran toko hewan peliharaan dan memperbarui kartu yang disematkan untuk mencerminkan kumpulan toko hewan peliharaan terdekat.

Menerapkan layanan ini mengikuti alur API ini:

Toko hewan peliharaan terdekat

  1. Pengguna Anda memberi otorisasi dengan OAuth 2.0. Selain cakupan glass.timeline yang biasa, aplikasi Anda juga meminta akses cakupan glass.location.
  2. Tepat setelah tarian OAuth 2.0 selesai, layanan Anda berlangganan pembaruan tentang lokasi pengguna Anda.
  3. Selanjutnya, layanan Anda akan mengambil lokasi terbaru pengguna dari endpoint lokasi.
  4. Layanan Anda menelusuri toko hewan peliharaan di dekat pengguna.
  5. Layanan Anda membuat kartu timeline yang mencantumkan hasil penelusuran toko hewan peliharaan. Agar kartu ini tetap berada di sisi kiri layar jam, layanan akan menyematkan kartu ini.
  6. Saat pengguna Anda berpindah, lokasi terbaru mereka akan diperbarui.
  7. Karena layanan berlangganan langganan pembaruan lokasi, notifikasi akan dikirim ke layanan. Notifikasi ini tertaut ke item latest dalam koleksi location.
  8. Berdasarkan notifikasi, layanan Anda mengambil latest location pengguna dari koleksi location.
  9. Selanjutnya, layanan Anda menelusuri toko hewan peliharaan di dekat pengguna.
  10. Terakhir, layanan Anda menggunakan metode patch untuk memperbarui isi item linimasa yang disisipkan di langkah 5.