Mirror API 提供一組建構模塊,可用來建構 Glass 服務。由於 Glass 服務與您自行開發的軟體可能不同,因此可能不清楚如何搭配使用 Mirror API 的功能。
許多服務都屬於幾個 API 用量類別。以下為您說明如何結合 Mirror API 的功能來建立 Glass 服務。
貓咪資料
使用 Google Mirror API 時,將內容提交至 Glass 時間軸是簡單又強大的用途。 《Cat Facts》樣本用玻璃軟體向使用者提供貓的真相, 系統可能會遵循以下流程:
- 使用者造訪您的網頁應用程式,並透過 OAuth 2.0 進行驗證來訂閱。
- 您的服務每小時會為每位使用者提供一個新的貓咪資訊 (Cat Fact)玻璃。
可以透過時間軸插入方法實作類別資料:
- 驗證 OAuth 2.0 驗證使用者訂閱後
- Cat Facts 儲存使用者及其憑證的索引
- 《Cat Facts》每小時都會發布新款貓咪知識。做法是疊代所有已儲存的使用者,並在時間軸中插入時間軸項目。
那就新增貓咪吧
人類技術進步的每一步,都會讓貓咪相片的散佈方式更臻完善。Project Glass 也是如此
由於每張相片都最好是貓,因此使用者可以隨機建立貓咪圖片,以及用 Glass 拍攝的相片。
- 使用者造訪您的網頁應用程式,並透過 OAuth 2.0 驗證以安裝「Add a Cat to That」。
- 您的服務會在使用者的 Glass 上建立新的聯絡人,命名為「Add a Cat to That」。
- 當您的使用者拍攝相片時,會透過「Add Cat to That」(加入貓加入而加入) 的方式分享相片。
- 你的服務會在共享相片中隨機合成貓咪圖片。
- 最後,您的服務會將貓修飾相片傳送到使用者的 Glass。
從架構上來說,這項服務將遵循以下 API 流程:
- 您的使用者授權 OAuth 2.0。您的服務會儲存他們的憑證。
- 等到 OAuth 2.0 舞蹈完成後,您的服務就會插入一個名為「Add a Cat to That」的聯絡人。
- 接著,您的服務可以插入
timeline
集合的訂閱項目,在這位使用者的時間軸中訂閱更新內容。新增 Cat to That 現已設定完畢。 - 你的使用者會慢慢拍照。
- 使用者透過「Add a Cat to That」(新增貓咪) 功能分享相片。這樣服務就能存取與這張相片相關聯的時間軸資訊卡。
- 您的服務必須訂閱時間表更新,因此服務會收到通知。這則通知會連結到含有共享相片的時間軸項目。
- 您的服務會檢查通知,並使用隨附的
id
擷取包含相片的時間軸資訊卡。 - 接著,您的服務會檢查時間軸項目,並使用附件 ID 擷取相片的位元組。
- 你的服務會隨機選擇貓咪的圖片,並合成到共享相片中。
- 最後,您的服務會建立新的時間軸資訊卡,插入使用者的時間軸資訊卡,並附加貓咪修飾相片。
附近的寵物店
對貓或貓的相片來說,這個事實只好比貓或貓的圖片還要好,而且這是真實的貓科貓。Mirror API 可以確保你知道距離最近的寵物店位置,讓情況更加輕鬆。
使用方式如下:
- 使用者造訪您的網頁應用程式,並透過 OAuth 2.0 進行驗證來訂閱。
- 您的服務會決定使用者的位置。
- 你的服務會搜尋該位置附近的寵物店。
- 你的服務會在時鐘左側插入一張卡片,上面會列出這些附近的寵物店。
- Glass 會在使用者的位置通知您的服務。
- 你的服務會針對每則通知重複搜尋寵物商店,並更新固定資訊卡,反映最近的幾間寵物店。
按照以下 API 流程實作這項服務:
- 您的使用者授權 OAuth 2.0。除了一般的
glass.timeline
範圍外,應用程式也會要求glass.location
範圍存取權。 - 在 OAuth 2.0 舞蹈作業完成後,您的服務就會訂閱使用者位置的更新。
- 接著,您的服務會從位置端點擷取使用者的最新位置。
- 你的服務會搜尋使用者附近的寵物店。
- 你的服務會建立「
timeline
」資訊卡,列出寵物店搜尋結果。為了將這張資訊卡保留在時鐘畫面的左側,你的服務會固定這張卡片。 - 使用者移動時,系統會更新他們的最新位置資訊。
- 您的服務必須訂閱位置更新通知,因此服務會傳送通知給您。這則通知會連結至「
location
」集合中的latest
個項目。 - 根據通知,您的服務會從
location
集合擷取使用者的latest
location
。 - 接著,你的服務會搜尋使用者附近的寵物店。
- 最後,您的服務會使用
patch
方法,更新在步驟 5 中插入的時間軸項目主體。