قصص استخدام واجهة برمجة التطبيقات

توفر واجهة برمجة تطبيقات Mirror مجموعة من الوحدات الأساسية التي يمكنك استخدامها لإنشاء خدمات لـ Glass. ونظرًا لاختلاف خدمات Glass عن البرامج الأخرى التي طورتها، قد لا يكون من الواضح كيفية ملاءمة ميزات واجهة برمجة تطبيقات Mirror.

تندرج العديد من الخدمات ضمن بضع فئات من استخدام واجهة برمجة التطبيقات. في ما يلي بعض القصص التي توضح كيفية الجمع بين ميزات Mirror API لإنشاء خدمات Glass.

حقائق عن القطط

يُعد عرض المحتوى في المخطط الزمني لـ Glass استخدامًا بسيطًا وفعالاً في الوقت نفسه لواجهة برمجة تطبيقات Google Mirror. يقدم نموذج Cat Facts لـ Glassware حقائق عن القطط إلى المستخدمين ومن المحتمل أن يتبع هذا التدفق:

1. يزور المستخدم تطبيق الويب ويشترك في الخدمة من خلال المصادقة باستخدام OAuth 2.0.
2. في كل ساعة، على مدار الساعة، تقدّم الخدمة معلومة جديدة عن القطط إلى كل زجاج من المستخدمين.

سيتم تنفيذ Cat Facts باستخدام أسلوب إدراج المخطط الزمني:

1. اشتراك المستخدمين من خلال إجراء مصادقة باستخدام OAuth 2.0
2. يخزّن تطبيق Fact Cats فهرس المستخدمين وبيانات اعتمادهم
3. تنشر Cat Facts معلومة جديدة عن القطط، كل ساعة. ويتم ذلك من خلال تكرار جميع المستخدمين المخزّنين وإدراج عنصر المخطط الزمني في المخططات الزمنية.

إضافة قطة إلى ذلك

توفر كل خطوة في التقدم التقني للإنسان أساليب محسّنة لتوزيع صور القطط. لا يختلف تطبيق Glass Glass

وبما أن كل صورة فوتوغرافية أفضل باستخدام قطة، فإن هذه الخدمة تتيح للمستخدمين إمكانية تركيب صورة قطة عشوائية وصورة التقطوها باستخدام Glass.

1. يزور المستخدم تطبيق الويب ويثبّت إضافة Cat to That من خلال إجراء مصادقة باستخدام OAuth 2.0.
2. تنشئ خدمتك جهة اتصال جديدة على جهاز Glass باسم المستخدم "إضافة قطة إلى هذا".
3. عندما يلتقط المستخدم الصور، يشاركها مع "إضافة قطة إلى هذا".
4. تعرض خدمتك صورة عشوائية لقطة في الصورة المشتركة.
5. وأخيرًا، توصل خدمتك الصورة المحسّنة للقطط إلى Glass للمستخدم.

ومن الناحية المعمارية، ستتبع هذه الخدمة مسار واجهة برمجة التطبيقات التالي:

1. يتم تفويض المستخدم من خلال OAuth 2.0. تخزّن الخدمة بيانات اعتمادها.
2. بعد اكتمال رقصة OAuth 2.0 مباشرةً، تدرج الخدمة جهة اتصال تسمى "إضافة قطة إلى هذا".
3. بعد ذلك، تشترك خدمتك في التحديثات على المخطط الزمني لهذا المستخدم من خلال إدراج اشتراك لمجموعة timeline. يمكنك الآن إضافة "قطة" إلى "ذلك".
4. وبمرور الوقت، يلتقط المستخدم صورًا فوتوغرافية.
5. يشارك المستخدم صورة مع إضافة قطة إلى هذا. يؤدي هذا الإجراء إلى إتاحة الوصول إلى بطاقة المخطط الزمني المرتبطة بهذه الصورة عبر خدمتك.
6. نظرًا لأن الخدمة اشتركت في تحديثات المخطط الزمني، يتم إرسال إشعار إلى خدمتك. يرتبط هذا الإشعار بعنصر المخطط الزمني الذي يحتوي على الصورة المشتركة.
7. تفحص الخدمة الإشعار وتستخدم id المضمّن لجلب بطاقة المخطط الزمني التي تحتوي على الصورة.
8. بعد ذلك، تفحص الخدمة عنصر المخطط الزمني وتستخدم رقم تعريف المرفق لجلب بايت من الصورة.
9. تختار الخدمة صورة عشوائية لقطة، ثم تهيئها في الصورة المشتركة.
10. أخيرًا، تنشئ خدمتك بطاقة مخطط زمني جديدة وتدرجها في بطاقة المخطط الزمني للمستخدم مع إرفاق الصورة المحسّنة للقطط.

ملاحظة: كمكافأة مضحكة، يمكنك إضافة عنصر القائمة المضمّن في SHARE إلى بطاقة المخطط الزمني. يسمح هذا الإجراء بمشاركة الصور المحسَّنة للقطط مع الخدمات الأخرى أو مشاركتها بشكل متكرر مع "إضافة قطة إلى ذلك" لإضافة قطط متعددة إلى الصورة.

متاجر حيوانات أليفة قريبة

هناك شيء واحد أفضل من الحقائق حول القطط أو صور القطط، وهذه هي القطط الفعلية الجسدية ذات الفراء. وتسهّل واجهة برمجة التطبيقات Mirror ذلك عن طريق التأكد دائمًا من معرفة مكان أقرب متجر حيوانات أليفة.

يتبع الاستخدام هذه العملية:

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. نظرًا لأن الخدمة اشتركت في تحديثات الموقع، يتم إرسال إشعار إلى الخدمة. يرتبط هذا الإشعار بالعنصر latest في المجموعة location.
8. استنادًا إلى الإشعار، تجلب الخدمة latest location للمستخدم من مجموعة location.
9. بعد ذلك، تبحث الخدمة عن متاجر الحيوانات الأليفة بالقرب من المستخدم.
10. وأخيرًا، تستخدم الخدمة طريقة patch لتعديل نص عنصر المخطط الزمني الذي تم إدراجه في الخطوة 5.