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

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

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

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

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

  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.
  2. تنشئ خدمتك جهة اتصال جديدة على زجاج المستخدم تسمى "Add a Cat to That".
  3. عندما يلتقط المستخدم الصور، يشاركها باستخدام ميزة "إضافة قطة إلى ذلك".
  4. تقوم خدمتك بإضافة صورة عشوائية قطة إلى الصورة المُشارَكة.
  5. وأخيرًا، تقوم الخدمة بتسليم الصورة المحسّنة للقطط إلى زجاج المستخدم.

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

أضِف قطة إلى هذا المسار

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

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

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