סיפורים לשימוש ב-API

Mirror API מספק קבוצה של אבני בניין שבהן ניתן להשתמש כדי לבנות שירותים ל-Glass. מכיוון ששירותי Glass שונים ככל הנראה מתוכנות אחרות שפיתחתם, ייתכן שלא ברור מאליו איך להתאים תכונות של Mirror API יחד.

שירותים רבים מתחלקים לכמה קטגוריות של שימוש ב-API. הנה כמה סיפורים הממחישים כיצד לשלב את התכונות של Mirror API כדי ליצור שירותי Glass.

עובדות על חתולים

העברת תוכן לציר הזמן של Glass היא שימוש פשוט אך עוצמתי ב-Google Mirror לדוגמה: כלי הזכוכית של Cat Facts מספק למשתמשים עובדות על חתולים, יש אפשרות לבצע את התהליך הזה:

1. המשתמש מבקר באפליקציית האינטרנט ונרשם באמצעות אימות באמצעות OAuth 2.0.
2. בכל שעה, בשעה, השירות שלך מספק עובדה חדשה בנושא חתולים לכל אחד מהמשתמשים שלך זכוכית.

עובדות על חתולים ייושמו באמצעות שיטת ההוספה של ציר הזמן:

1. המשתמשים נרשמים על ידי אימות באמצעות OAuth 2.0
2. Cat Facts מאחסן אינדקס של משתמשים ופרטי הכניסה שלהם
3. בכל שעה מפרסמת Cat Facts עובדה חדשה על חתולים. הפעולה הזו מתבצעת על ידי חזרה על כל המשתמשים המאוחסנים והוספת פריט בציר הזמן לציר הזמן שלהם.

להוספת חתול

כל שלב בהתפתחות הטכנולוגית של בני האדם מספק שיטות משופרות להפצת תמונות של חתולים. Project Glass אינו שונה.

מאחר שכל תמונה טובה יותר עם חתול, השירות הזה מאפשר למשתמשים להרכיב תמונה אקראית של חתול ותמונה שצילמו ב-Glass.

1. המשתמש מבקר באפליקציית האינטרנט ומתקין את האפליקציה 'הוספת חתול' על ידי אימות באמצעות OAuth 2.0.
2. השירות יוצר איש קשר חדש ב-Glass של המשתמש בשם 'Add a cat to ואז' (הוספת חתול).
3. כשהמשתמש מצלם תמונות, הוא משתף אותן באמצעות התכונה 'הוספת חתול'.
4. השירות שלכם מרכיב תמונה אקראית של חתול על התמונה המשותפת.
5. לבסוף, השירות שולח תמונה משופרת של חתולים ל-Glass של המשתמש שלכם.

מבחינה ארכיטקטונית, שירות זה יהיה תואם לתהליך ה-API הבא:

1. המשתמש שלך מספק הרשאות באמצעות OAuth 2.0. השירות שלכם שומר את פרטי הכניסה שלהם.
2. מיד אחרי שהריקוד של OAuth 2.0 מסתיים, השירות מוסיף איש קשר שנקרא "Add a Cat toThat".
3. בשלב הבא, השירות שלך נרשם לקבלת עדכונים בציר הזמן של המשתמש הזה על ידי הוספת מינוי לאוסף timeline. ההגדרה Add a Cat to Turn (הוספת חתול) הושלמה.
4. עם הזמן, המשתמשים מצלמים תמונות.
5. המשתמש שלך משתף תמונה עם 'הוספת חתול'. כך כרטיס ציר הזמן המשויך לתמונה הזו יהיה נגיש לשירות שלכם.
6. השירות שלך רשום לעדכונים על ציר הזמן, ולכן נשלחת התראה לשירות שלך. ההתראה הזו מקשרת לפריט בציר הזמן שמכיל את התמונה ששותפה.
7. השירות בודק את ההתראה ומשתמש ב-id המצורף כדי לאחזר את כרטיס ציר הזמן שמכיל את התמונה.
8. בשלב הבא, השירות בודק את הפריט בציר הזמן ומשתמש במזהה הקובץ המצורף כדי לאחזר את הבייטים של התמונה.
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. מאחר שהשירות שלך רשום לקבלת עדכוני מיקום, נשלחת התראה לשירות שלך. ההתראה הזו מקשרת לפריט latest באוסף location.
8. על סמך ההתראה, השירות מאחזר את latest location של המשתמש מהאוסף location.
9. בשלב הבא, השירות מחפש חנויות לחיות מחמד בקרבת המשתמש.
10. לבסוף, השירות משתמש בשיטה patch כדי לעדכן את גוף הפריט בציר הזמן שנוסף בשלב 5.