API 使用案例

Mirror API 提供一組構成要素，可用來建構 Google Glass 服務。Glass 服務可能與您開發的其他軟體不同，因此顯然並不容易想見 Mirror API 的功能。

許多服務分為幾個類別的 API 使用方式。以下故事說明如何結合 Mirror API 的功能來建立 Glass 服務。

貓咪資訊

將內容傳送至 Glass 時間軸是簡單又強大的 Google Mirror API 用途。Cat Facts 範例 Glassware 提供貓咪的事實資訊，且可能會採用以下流程：

1. 您的使用者造訪您的網路應用程式，並透過 OAuth 2.0 進行驗證。
2. 每小時一度，您的服務會在每位使用者的 Google Glass 上傳送新的貓咪事實。

請使用時間軸插入方法實作貓咪事實：

1. 使用者透過 OAuth 2.0 進行驗證
2. Cat Facts 會儲存使用者及其憑證的索引
3. 每小時，Cat Facts 會發布新的 Cat Fact。方法是逐一查看所有儲存的使用者，並在時間軸中插入時間軸項目。

新增貓

人類技術發展中的每個步驟都有助於改善貓咪相片的散佈方法。Project Glass 則不同。

由於每張相片的拍攝品質都更勝貓，因此這項服務可讓使用者在「貓咪」相片中，隨機挑選貓咪照片。

1. 您的使用者造訪您的網路應用程式，並利用 OAuth 2.0 進行安裝，在當中新增「貓」。
2. 您的服務會在使用者的 Glass 中建立新的聯絡人，並將名稱為「加入貓咪」。
3. 當使用者拍照時，他們就會透過「新增貓咪」功能分享相片。
4. 您的服務會將貓的隨機圖片合成在分享的相片上。
5. 最後，您的服務會將貓咪修飾的相片傳送到使用者的 Google Glass。

在架構上，這項服務會遵循這個 API 流程：

1. 您的使用者使用 OAuth 2.0 授權。您的服務會儲存其憑證。
2. 完成 OAuth 2.0 舞蹈後，您的服務就會插入名為「Add Cat to That」的聯絡人資料。
3. 接著，您的服務會訂閱這個使用者時間軸的更新，方法是為「timeline」集合插入訂閱項目。新增「到」的貓咪 現已完成設定
4. 您的使用者長期下來就能拍照，
5. 你的使用者將相片加入了「新增貓咪」。讓服務可存取與這張相片相關的時間軸資訊卡。
6. 您的服務訂閱了時間軸更新通知，因此通知會傳送到您的服務。這則通知會連結至含有分享相片的時間軸項目。
7. 您的服務會檢查通知，並使用隨附的 id 擷取包含相片的時間軸資訊卡。
8. 接下來，您的服務會檢查時間軸項目，並使用附件 ID 擷取相片的位元組。
9. 您的服務會挑選一張貓的隨機圖片，然後將其合併成分享的相片。
10. 最後，您的服務會建立新的時間軸資訊卡，然後插入「時間軸」資訊卡中，並在當中加入「貓咪修飾相片」。

注意：做為增添趣味的做法，您可以將內建的 SHARE 選單項目新增至時間軸資訊卡。這樣即可與「其他服務」分享「貓咪修飾」相片，或重複與「新增貓咪」分享，藉此為相片加上多個貓咪。

附近的寵物店

只對貓咪或是貓咪的相片更有幫助了，這其實是實體的毛貓。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 中插入的時間軸項目內文。