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

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

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

बिल्लियों के तथ्य

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

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

बिल्लियों के तथ्यों को टाइमलाइन शामिल करने की विधि का इस्तेमाल करके लागू किया जाएगा:

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

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

तकनीक की दिशा में हर कदम आगे बढ़ने पर बिल्लियों की फ़ोटो को बांटने के बेहतर तरीके मिलेंगे. प्रोजेक्ट ग्लास अलग नहीं है.

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

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

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

1. आपके उपयोगकर्ता को OAuth 2.0 का इस्तेमाल करके अनुमति दें. आपकी सेवा अपने क्रेडेंशियल स्टोर करती है.
2. OAuth 2.0 डांस पूरा होने के तुरंत बाद, आपकी सेवा में "एक बिल्ली को जोड़ें" नाम का संपर्क जोड़ दिया जाता है.
3. इसके बाद, आपकी सेवा, timeline कलेक्शन के लिए सदस्यता डालकर, इस उपयोगकर्ता की टाइमलाइन में अपडेट की सदस्यता लेती है. इसमें एक बिल्ली जोड़ें, इसका सेट अप पूरा हो गया है.
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. सूचना के आधार पर, आपकी सेवा आपके उपयोगकर्ता के latest location को location संग्रह से फ़ेच करती है.
9. इसके बाद, आपकी सेवा आपके उपयोगकर्ता के आस-पास मौजूद पालतू जानवरों की दुकानों की खोज करती है.
10. आखिर में, आपकी सेवा में, patch तरीके का इस्तेमाल करके, पांचवें चरण में शामिल टाइमलाइन आइटम के मुख्य हिस्से को अपडेट किया जाता है.