داستان های استفاده از API

Mirror API مجموعه‌ای از بلوک‌های ساختمانی را ارائه می‌کند که می‌توانید از آنها برای ساخت سرویس‌های Glass استفاده کنید. از آنجایی که سرویس‌های Glass احتمالاً با سایر نرم‌افزارهایی که شما توسعه داده‌اید متفاوت هستند، ممکن است نحوه تطبیق ویژگی‌های Mirror API با هم مشخص نباشد.

بسیاری از خدمات در چند دسته از استفاده از API قرار می گیرند. در اینجا چند داستان وجود دارد که نحوه ترکیب ویژگی های Mirror API برای ایجاد سرویس های Glass را نشان می دهد.

حقایق گربه

ارائه محتوا به جدول زمانی Glass یک استفاده ساده و در عین حال قدرتمند از Google Mirror API است. Glassware نمونه Cat Facts حقایقی را در مورد گربه ها به کاربران ارائه می دهد و به طور بالقوه می تواند این جریان را دنبال کند:

1. کاربر شما از برنامه وب شما بازدید می کند و با احراز هویت با OAuth 2.0 مشترک می شود.
2. هر ساعت، هر ساعت، سرویس شما یک Cat Fact جدید را به شیشه هر یک از کاربران شما ارائه می دهد.

Cat Facts با استفاده از روش درج جدول زمانی پیاده سازی می شود:

1. کاربران با احراز هویت با OAuth 2.0 مشترک می شوند
2. Cat Facts فهرستی از کاربران و اعتبار آنها را ذخیره می کند
3. هر ساعت، Cat Facts یک واقعیت جدید گربه را منتشر می کند. این کار را با تکرار در میان همه کاربران ذخیره شده و درج یک آیتم جدول زمانی در جدول زمانی آنها انجام می دهد.

یک گربه را به آن اضافه کنید

هر مرحله در پیشرفت فن آوری انسان روش های بهبود یافته ای را برای توزیع عکس های گربه ارائه می دهد. Project Glass هم تفاوتی ندارد.

از آنجایی که هر عکسی با گربه بهتر است، این سرویس به کاربران اجازه می دهد تا یک تصویر تصادفی گربه و عکسی را که با شیشه گرفته اند ترکیب کنند.

1. کاربر شما از برنامه وب شما بازدید می کند و Add a Cat to That را با احراز هویت با OAuth 2.0 نصب می کند.
2. سرویس شما یک مخاطب جدید روی شیشه کاربر شما ایجاد می کند به نام "Add a Cat to That".
3. همانطور که کاربر شما عکس می گیرد، آنها را با Add a Cat to That به اشتراک می گذارد.
4. خدمات شما یک تصویر تصادفی از یک گربه را در عکس مشترک ترکیب می کند.
5. در نهایت، سرویس شما عکس ارتقا یافته گربه را به شیشه کاربر شما تحویل می دهد.

از نظر معماری، این سرویس از این جریان API پیروی می کند:

1. کاربر شما با OAuth 2.0 مجوز می دهد. سرویس شما اعتبار آنها را ذخیره می کند.
2. درست پس از اتمام رقص OAuth 2.0، سرویس شما مخاطبی به نام "Add a Cat to That" را وارد می کند.
3. سپس، سرویس شما با قرار دادن اشتراکی برای مجموعه timeline ، مشترک به‌روزرسانی‌های جدول زمانی این کاربر می‌شود. افزودن یک گربه به آن اکنون کاملاً تنظیم شده است.
4. با گذشت زمان، کاربر شما عکس می گیرد.
5. کاربر شما عکسی را با Add a Cat to That به اشتراک می گذارد. این باعث می شود تا کارت جدول زمانی مرتبط با این عکس در دسترس خدمات شما قرار گیرد.
6. از آنجایی که سرویس شما مشترک به‌روزرسانی‌های جدول زمانی است، یک اعلان به سرویس شما ارسال می‌شود. این اعلان به آیتم جدول زمانی حاوی عکس به اشتراک گذاشته شده پیوند دارد.
7. سرویس شما اعلان را بررسی می کند و از id ارائه شده برای واکشی کارت جدول زمانی حاوی عکس استفاده می کند.
8. سپس، سرویس شما آیتم جدول زمانی را بررسی می کند و از شناسه پیوست برای واکشی بایت های عکس استفاده می کند.
9. سرویس شما یک تصویر تصادفی از یک گربه را انتخاب می کند و آن را در عکس مشترک ترکیب می کند.
10. در نهایت، سرویس شما یک کارت جدول زمانی جدید می‌سازد و آن را با عکس ضمیمه شده با گربه در کارت جدول زمانی کاربر قرار می‌دهد.

توجه: به عنوان یک جایزه احمقانه اضافه شده، می‌توانید آیتم منوی SHARE داخلی را به کارت جدول زمانی اضافه کنید. این اجازه می دهد تا عکس های بهبود یافته گربه را با سرویس های دیگر به اشتراک بگذارید یا به طور مکرر با Add a Cat to That به اشتراک بگذارید تا چندین گربه به یک عکس اضافه شود.

فروشگاه های حیوانات خانگی در نزدیکی

تنها یک چیز بهتر از حقایق در مورد گربه ها یا تصاویر گربه ها وجود دارد، و آن گربه های واقعی، فیزیکی و پشمالو است. 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 استفاده می کند.