Kisah Penggunaan API

Mirror API menyediakan kumpulan elemen penyusun yang dapat Anda gunakan untuk membangun layanan Glass. Layanan Glass mungkin berbeda dari perangkat lunak lain yang telah Anda kembangkan, sehingga mungkin tidak jelas cara menyesuaikan fitur Mirror API.

Banyak layanan termasuk dalam beberapa kategori penggunaan API. Berikut ini beberapa kisah yang menggambarkan cara menggabungkan berbagai fitur Mirror API untuk membuat layanan Glass.

Fakta Kucing

Pengiriman konten ke linimasa Glass adalah penggunaan Google Mirror API yang sederhana tetapi efektif. Contoh Glass Facts Cat Facts memberikan fakta tentang kucing kepada pengguna dan dapat mungkin mengikuti alur ini:

  1. Pengguna Anda mengunjungi aplikasi web Anda dan berlangganan dengan melakukan autentikasi dengan OAuth 2.0.
  2. Setiap jam dan setiap jam layanan Anda memberikan Cat Fact baru kepada setiap pengguna Kaca.

Fakta Kucing akan diimplementasikan menggunakan metode penyisipan linimasa:

Alur Fakta Kucing

  1. Pengguna berlangganan dengan mengautentikasi menggunakan OAuth 2.0
  2. Cat Facts menyimpan indeks pengguna dan kredensial mereka
  3. Setiap jam, Cat Facts memublikasikan Cat Facts yang baru. Hal ini dilakukan dengan mengulangi semua pengguna yang disimpan dan memasukkan item {i>timeline<i} ke dalam {i>timeline<i} mereka.

Tambahkan kucing

Setiap langkah dalam kemajuan teknologi manusia memberikan metode yang lebih baik untuk pendistribusian foto kucing. Sama halnya dengan Project Glass.

Karena setiap foto lebih baik digunakan bersama kucing, layanan ini memungkinkan pengguna menggabungkan gambar kucing acak dan foto yang mereka ambil dengan Glass.

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

Secara arsitektur, layanan ini akan mengikuti alur API ini:

Tambahkan kucing ke flow

  1. Pengguna Anda memberi otorisasi dengan OAuth 2.0. Layanan Anda menyimpan kredensialnya.
  2. Tepat setelah tarian OAuth 2.0 selesai, layanan Anda menyisipkan kontak yang disebut "Add a Cat to That".
  3. Selanjutnya, layanan Anda akan berlangganan update di linimasa pengguna ini dengan menyisipkan langganan untuk koleksi timeline. Tambahkan Cat ke That sudah sepenuhnya siap.
  4. Seiring waktu, pengguna Anda mengambil foto.
  5. Pengguna Anda berbagi foto dengan Add a Cat to That. Tindakan ini membuat kartu linimasa yang terkait dengan foto ini dapat diakses oleh layanan Anda.
  6. Karena layanan Anda berlangganan pembaruan linimasa, notifikasi dikirim ke layanan Anda. Notifikasi ini tertaut ke item linimasa yang berisi foto yang dibagikan.
  7. Layanan Anda akan memeriksa notifikasi dan menggunakan id yang disertakan untuk mengambil kartu linimasa yang berisi foto.
  8. Selanjutnya, layanan Anda akan memeriksa item linimasa dan menggunakan ID lampiran untuk mengambil byte foto.
  9. Layanan Anda memilih gambar acak seekor kucing, dan menggabungkannya ke dalam foto bersama.
  10. Terakhir, layanan Anda membuat kartu linimasa baru dan memasukkannya ke kartu linimasa pengguna dengan melampirkan foto kucing.

Toko hewan peliharaan terdekat

Hanya ada satu hal yang lebih baik daripada fakta tentang kucing atau gambar kucing, dan itu benar-benar kucing berbulu fisik. Mirror API dapat mempermudah hal ini dengan memastikan Anda selalu mengetahui lokasi toko hewan peliharaan terdekat.

Penggunaannya mengikuti alur ini:

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

Mengimplementasikan layanan ini mengikuti alur API ini:

Toko hewan peliharaan terdekat

  1. Pengguna Anda memberi otorisasi dengan OAuth 2.0. Selain cakupan glass.timeline 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 mengambil lokasi terbaru pengguna dari endpoint lokasi.
  4. Layanan Anda mencari toko hewan peliharaan di dekat pengguna Anda.
  5. Layanan Anda membuat kartu timeline yang mencantumkan hasil penelusuran toko hewan peliharaan. Untuk menyimpan kartu ini di sisi kiri layar jam, layanan Anda menyematkan kartu ini.
  6. Saat pengguna berpindah tempat, lokasi terakhir mereka akan diperbarui.
  7. Karena layanan Anda berlangganan pembaruan lokasi, pemberitahuan dikirimkan ke layanan Anda. Notifikasi ini tertaut ke item latest dalam koleksi location.
  8. Berdasarkan notifikasi tersebut, layanan Anda mengambil latest location pengguna dari koleksi location.
  9. Selanjutnya, layanan Anda akan menelusuri toko hewan peliharaan di dekat pengguna.
  10. Terakhir, layanan Anda akan menggunakan metode patch untuk memperbarui isi item linimasa yang disisipkan dalam langkah 5.