एपीआई के इस्तेमाल से जुड़ी कहानियां

मिरर एपीआई बिल्डिंग ब्लॉक का एक सेट उपलब्ध कराता है, जिसका इस्तेमाल आप Glass के लिए सेवाएं बनाने में कर सकते हैं. क्योंकि Glass सेवाएं आपके द्वारा डेवलप किए गए अन्य सॉफ़्टवेयर से संभवतः अलग होती हैं, इसलिए हो सकता है कि यह स्पष्ट न हो कि Mirror API की सुविधाओं को एक साथ कैसे फ़िट किया जाए.

एपीआई के इस्तेमाल की कुछ कैटगरी में कई सेवाएं आती हैं. यहां कुछ कहानियां दी गई हैं, जिनमें बताया गया है कि Glass सेवाएं बनाने के लिए Mirror API की सुविधाओं को कैसे मिलाया जा सकता है.

बिल्ली से जुड़े तथ्य

Glass टाइमलाइन पर सामग्री डिलीवर करना, Google Mirror API का एक आसान लेकिन दमदार इस्तेमाल है. The Cat Facts का सैंपल ग्लासवेयर, उपयोगकर्ताओं को बिल्लियों के बारे में तथ्यों की जानकारी देता है और यह इस फ़्लो को फ़ॉलो कर सकते हैं:

1. आपका उपयोगकर्ता आपके वेब ऐप्लिकेशन पर जाता है और OAuth 2.0 से पुष्टि करके, सदस्यता लेता है.
2. आपकी सेवा, हर घंटे आपके हर उपयोगकर्ता को एक नया कैट फ़ैक्ट पब्लिश करती है कांच.

टाइमलाइन डालने के तरीके का इस्तेमाल करके, Cat Facts को लागू किया जाएगा:

1. उपयोगकर्ता OAuth 2.0 से पुष्टि करके सदस्यता लेते हैं
2. Cat Facts में, उपयोगकर्ताओं और उनके क्रेडेंशियल का इंडेक्स स्टोर है
3. हर घंटे, Cat Facts में एक नया Cat Fact पब्लिश होता है. ऐसा करने के लिए, यह सेव किए गए सभी उपयोगकर्ताओं के ज़रिए बार-बार कोशिश करता है और उनकी टाइमलाइन में टाइमलाइन आइटम शामिल करता है.

उसमें कोई बिल्ली जोड़ें

टेक्नोलॉजी के क्षेत्र में हर कदम पर, बिल्ली की तस्वीरों को शेयर करने के तरीके को और बेहतर बनाया जाता है. Project Glass भी अलग नहीं है.

हर फ़ोटो, बिल्ली के साथ बिलकुल सही होती है. इसलिए, इस सेवा की मदद से उपयोगकर्ता, किसी बिल्ली की रैंडम इमेज और Glass से ली गई एक फ़ोटो को बना सकते हैं.

1. आपका उपयोगकर्ता आपके वेब ऐप्लिकेशन पर जाता है और OAuth 2.0 से प्रमाणित करके, Add a Cat to That इंस्टॉल करता है.
2. आपकी सेवा आपके उपयोगकर्ता के Glass पर "Add a Cat to That" नाम से एक नया संपर्क बनाती है.
3. जैसे ही आपका उपयोगकर्ता फ़ोटो लेता है, वह उसे 'एक बिल्ली जोड़ें' सुविधा की मदद से शेयर करता है.
4. आपकी सेवा, शेयर की गई फ़ोटोग्राफ़ पर बिल्ली की किसी भी तरह की इमेज को मर्ज करती है.
5. आख़िर में, आपकी सेवा आपके उपयोगकर्ता के Glass पर बिल्ली की बेहतर बनाई गई फ़ोटो डिलीवर करती है.

आर्किटेक्चर के तौर पर, यह सेवा इस एपीआई फ़्लो को फ़ॉलो करेगी:

1. आपका उपयोगकर्ता, OAuth 2.0 से अनुमति देता है. आपकी सेवा देने वाली कंपनी के क्रेडेंशियल सेव रहते हैं.
2. OAuth 2.0 डांस पूरा होते ही, आपकी सेवा "Add a Cat to That" नाम से संपर्क जोड़ देती है.
3. इसके बाद, आपकी सेवा, timeline के कलेक्शन के लिए सदस्यता शामिल करके, इस उपयोगकर्ता की टाइमलाइन में मौजूद अपडेट के लिए सदस्य बन जाती है. Add a Cat to That अब पूरी तरह से सेट अप हो गया है.
4. समय के साथ, आपका उपयोगकर्ता फ़ोटो खींचता है.
5. आपका उपयोगकर्ता, 'एक बिल्ली जोड़ें' के साथ एक फ़ोटो शेयर करता है. इससे आपकी सेवा के लिए, इस फ़ोटो से जुड़ा टाइमलाइन कार्ड ऐक्सेस हो जाएगा.
6. आपकी सेवा के लिए टाइमलाइन अपडेट की सदस्यता ली गई है. इसलिए, आपकी सेवा को इसकी सूचना भेजी जाती है. यह सूचना, शेयर की गई फ़ोटो वाले टाइमलाइन आइटम से लिंक है.
7. आपकी सेवा, सूचना की जांच करती है. साथ ही, शामिल किए गए id का इस्तेमाल, उस टाइमलाइन कार्ड को फ़ेच करने के लिए करती है जिसमें फ़ोटो है.
8. इसके बाद, आपकी सेवा टाइमलाइन आइटम की जांच करती है और फ़ोटोग्राफ़ की बाइट फ़ेच करने के लिए अटैचमेंट आईडी का इस्तेमाल करती है.
9. सेवा देने वाली कंपनी, बिल्ली की एक इमेज चुनकर उसे शेयर की गई फ़ोटो में मर्ज कर देती है.
10. आखिर में, आपकी सेवा एक नया टाइमलाइन कार्ड बनाती है और उसे आपके उपयोगकर्ता के टाइमलाइन कार्ड में, बिल्ली की बेहतर फ़ोटो अटैच करके डाल देती है.

ध्यान दें: आपको बोनस के तौर पर, SHARE में मौजूद मेन्यू आइटम को टाइमलाइन कार्ड में जोड़ने का विकल्प मिलता है. इससे उन फ़ोटो को अन्य सेवाओं के साथ शेयर किया जा सकता है जो बिल्लियों के लिए बेहतर हैं या किसी फ़ोटो में कई बिल्लियों को जोड़ने के लिए, 'एक बिल्ली जोड़ें' सुविधा के साथ बार-बार शेयर की जा सकती हैं.

पालतू जानवरों के लिए दुकानें

बिल्लियों के बारे में जानकारी या उनके फ़ोटो से बेहतर सिर्फ़ एक चीज़ है और वह है असली, शारीरिक, और प्यारी बिल्लियां. Mirror API की मदद से आपको हमेशा यह पता होना चाहिए कि पालतू जानवरों के लिए नज़दीकी स्टोर कहां है.

इस फ़्लो के बाद इस्तेमाल किया जाता है:

1. आपका उपयोगकर्ता आपके वेब ऐप्लिकेशन पर जाता है और OAuth 2.0 से पुष्टि करके, सदस्यता लेता है.
2. आपकी सेवा, उपयोगकर्ता की जगह की जानकारी तय करती है.
3. आपकी सेवा उस जगह के आस-पास मौजूद पालतू जानवरों की दुकानें खोजती है.
4. आपकी सेवा घड़ी की बाईं ओर एक कार्ड जोड़ती है, जिसमें आस-पास के पालतू जानवरों की इन दुकानों की सूची होती है.
5. Glass, आपकी सेवा को आपके उपयोगकर्ता की जगह के बारे में सूचना देता है.
6. हर सूचना के लिए, आपकी सेवा पालतू जानवरों की दुकान की खोज को दोहराती है और पिन किए गए कार्ड को अपडेट करती है, ताकि पालतू जानवरों के लिए नज़दीकी स्टोर का नया सेट दिखाया जा सके.

इस सेवा को लागू करने के लिए, इस एपीआई फ़्लो का इस्तेमाल किया जाता है:

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 तरीके का इस्तेमाल करके पांचवें चरण में शामिल किए गए टाइमलाइन आइटम के मुख्य हिस्से को अपडेट करती है.