API 使用案例

Mirror API 提供一組建構模塊,可用來建構 Glass 服務。由於 Glass 服務與您自行開發的軟體可能不同,因此可能不清楚如何搭配使用 Mirror API 的功能。

許多服務都屬於幾個 API 用量類別。以下為您說明如何結合 Mirror API 的功能來建立 Glass 服務。

貓咪資料

使用 Google Mirror API 時,將內容提交至 Glass 時間軸是簡單又強大的用途。 《Cat Facts》樣本用玻璃軟體向使用者提供貓的真相, 系統可能會遵循以下流程:

  1. 使用者造訪您的網頁應用程式,並透過 OAuth 2.0 進行驗證來訂閱。
  2. 您的服務每小時會為每位使用者提供一個新的貓咪資訊 (Cat Fact)玻璃。

可以透過時間軸插入方法實作類別資料:

貓咪資料流動

  1. 驗證 OAuth 2.0 驗證使用者訂閱後
  2. Cat Facts 儲存使用者及其憑證的索引
  3. 《Cat Facts》每小時都會發布新款貓咪知識。做法是疊代所有已儲存的使用者,並在時間軸中插入時間軸項目。

那就新增貓咪吧

人類技術進步的每一步,都會讓貓咪相片的散佈方式更臻完善。Project Glass 也是如此

由於每張相片都最好是貓,因此使用者可以隨機建立貓咪圖片,以及用 Glass 拍攝的相片。

  1. 使用者造訪您的網頁應用程式,並透過 OAuth 2.0 驗證以安裝「Add a Cat to That」。
  2. 您的服務會在使用者的 Glass 上建立新的聯絡人,命名為「Add a Cat to That」。
  3. 當您的使用者拍攝相片時,會透過「Add Cat to That」(加入貓加入而加入) 的方式分享相片。
  4. 你的服務會在共享相片中隨機合成貓咪圖片。
  5. 最後,您的服務會將貓修飾相片傳送到使用者的 Glass。

從架構上來說,這項服務將遵循以下 API 流程:

在該流程中新增貓

  1. 您的使用者授權 OAuth 2.0。您的服務會儲存他們的憑證。
  2. 等到 OAuth 2.0 舞蹈完成後,您的服務就會插入一個名為「Add a Cat to That」的聯絡人。
  3. 接著,您的服務可以插入 timeline 集合的訂閱項目,在這位使用者的時間軸中訂閱更新內容。新增 Cat to That 現已設定完畢。
  4. 你的使用者會慢慢拍照。
  5. 使用者透過「Add a Cat to That」(新增貓咪) 功能分享相片。這樣服務就能存取與這張相片相關聯的時間軸資訊卡。
  6. 您的服務必須訂閱時間表更新,因此服務會收到通知。這則通知會連結到含有共享相片的時間軸項目。
  7. 您的服務會檢查通知,並使用隨附的 id 擷取包含相片的時間軸資訊卡。
  8. 接著,您的服務會檢查時間軸項目,並使用附件 ID 擷取相片的位元組。
  9. 你的服務會隨機選擇貓咪的圖片,並合成到共享相片中。
  10. 最後,您的服務會建立新的時間軸資訊卡,插入使用者的時間軸資訊卡,並附加貓咪修飾相片。

附近的寵物店

對貓或貓的相片來說,這個事實只好比貓或貓的圖片還要好,而且這是真實的貓科貓。Mirror API 可以確保你知道距離最近的寵物店位置,讓情況更加輕鬆。

使用方式如下:

  1. 使用者造訪您的網頁應用程式,並透過 OAuth 2.0 進行驗證來訂閱。
  2. 您的服務會決定使用者的位置。
  3. 你的服務會搜尋該位置附近的寵物店。
  4. 你的服務會在時鐘左側插入一張卡片,上面會列出這些附近的寵物店。
  5. Glass 會在使用者的位置通知您的服務。
  6. 你的服務會針對每則通知重複搜尋寵物商店,並更新固定資訊卡,反映最近的幾間寵物店。

按照以下 API 流程實作這項服務:

附近的寵物店

  1. 您的使用者授權 OAuth 2.0。除了一般的 glass.timeline 範圍外,應用程式也會要求 glass.location 範圍存取權。
  2. 在 OAuth 2.0 舞蹈作業完成後,您的服務就會訂閱使用者位置的更新。
  3. 接著,您的服務會從位置端點擷取使用者的最新位置。
  4. 你的服務會搜尋使用者附近的寵物店。
  5. 你的服務會建立「timeline」資訊卡,列出寵物店搜尋結果。為了將這張資訊卡保留在時鐘畫面的左側,你的服務會固定這張卡片。
  6. 使用者移動時,系統會更新他們的最新位置資訊。
  7. 您的服務必須訂閱位置更新通知,因此服務會傳送通知給您。這則通知會連結至「location」集合中的 latest 個項目。
  8. 根據通知,您的服務會從 location 集合擷取使用者的 latest location
  9. 接著,你的服務會搜尋使用者附近的寵物店。
  10. 最後,您的服務會使用 patch 方法,更新在步驟 5 中插入的時間軸項目主體。