مخاطبین

مخاطبین به Glassware شما اجازه می‌دهند موارد جدول زمانی را که ایجاد نکرده‌اند دریافت کند. کاربران باید صراحتاً با ضربه زدن روی آیتم منوی اشتراک گذاری کارت، یک مورد خط زمانی را با مخاطب شما به اشتراک بگذارند.

چگونه کار می کنند

هنگامی که یک مخاطب اشتراک‌گذاری ایجاد می‌کنید، اشتراک‌گذاری کارت‌های جدول زمانی این جریان کلی را دنبال می‌کند:

1. یک مخاطب ایجاد کنید و انواع MIME را که مخاطب شما پشتیبانی می کند تعریف کنید.
2. مخاطب را در جدول زمانی کاربر خود وارد کنید.
3. کاربر یک آیتم جدول زمانی دریافت می کند که دارای یک آیتم منوی اشتراک گذاری است. ظروف شیشه ای باید صراحتاً به کاربران اجازه دهند تا اقلام خود را با این آیتم منو به اشتراک بگذارند.
4. کاربر روی آیتم جدول زمانی ضربه می زند، آیتم منوی اشتراک گذاری را انتخاب می کند و مخاطب شما را انتخاب می کند.
5. Mirror API یک کپی از کارت جدول زمانی مشترک ایجاد می کند، به مخاطب شما امکان دسترسی به کپی را می دهد و کپی را در جدول زمانی کاربر درج می کند. Glassware شما نمی تواند به آیتم جدول زمانی اصلی دسترسی پیدا کند.
6. اگر برای اشتراک‌گذاری اعلان‌ها مشترک شده‌اید ، محموله‌ای دریافت می‌کنید که حاوی اطلاعات شناسایی کارت خط زمان است. سپس می توانید مورد خط زمانی را با Timeline.get بازیابی کنید.
7. شما کارت جدول زمانی مشترک را تغییر می دهید و کارت جدول زمانی موجود را با Timeline.update به روز می کنید.

چه زمانی از آنها استفاده کنید

به‌طور پیش‌فرض، Glassware نمی‌تواند به موارد جدول زمانی که ایجاد نکرده دسترسی داشته باشد، بنابراین مخاطبین به Glassware به Glassware با رضایت کاربر اجازه اشتراک‌گذاری داده‌ها را می‌دهند.

دو راه اصلی وجود دارد که Glassware شما می تواند از مخاطبین استفاده کند:

• به کاربران اجازه دهید موارد خط زمانی شما را با سایر مخاطبین به اشتراک بگذارند : آیتم منوی داخلی SHARE به کارت جدول زمانی اضافه کنید. وقتی کاربران روی آیتم منوی اشتراک‌گذاری ضربه می‌زنند، Glass فهرستی از مخاطبین احتمالی برای اشتراک‌گذاری را نشان می‌دهد.

• به کاربران اجازه دهید موارد جدول زمانی را با Glassware شما به اشتراک بگذارند : مخاطبی ایجاد کنید که نمایانگر Glassware شما باشد. هنگامی که کاربران می خواهند کارت جدول زمانی را به اشتراک بگذارند، مخاطب شما به عنوان یک گزینه ظاهر می شود. همچنین می‌توانید فهرستی از انواع MIME قابل قبول را اعلام کنید تا مخاطب شما فقط برای کارت‌هایی که به آن‌ها علاقه دارید نشان داده شود. برای اطلاع از زمانی که کاربران کارت خط زمانی را با مخاطب شما به اشتراک می‌گذارند، می‌توانید مشترک اعلان‌های خط زمانی شوید.

ایجاد یک مخاطب

برای اینکه به کاربران اجازه دهید موارد خط زمانی را با Glassware خود به اشتراک بگذارند، یک مخاطب را با ارسال یک نمایش JSON از یک مخاطب در نقطه پایانی REST درج کنید.

همه مخاطبین باید یک id مشخص کنند که مخاطب را به Glassware دریافت کننده اعلان ها مشخص می کند. همچنین باید یک displayName و حداقل یک imageUrls مشخص کنید که Glass از آن برای نمایش اطلاعات تماس به کاربر استفاده می کند.

توجه: برای بهترین نتایج، از یک تصویر نماد PNG با ابعاد 640 در 360 پیکسل با پس‌زمینه شفاف برای imageUrls استفاده کنید.

HTTP خام

POST /mirror/v1/contacts HTTP/1.1
Authorization: Bearer {auth token}
Content-Type: application/json
Content-Length: {length}

{
  "id": "harold"
  "displayName": "Harold Penguin",
  "iconUrl": "https://developers.google.com/glass/images/harold.jpg"
  "priority": 7
}

اشتراک در اعلان‌های اشتراک‌گذاری

Mirror API به شما امکان می دهد در اعلان هایی که زمانی که کاربر اقدامات خاصی را روی یک آیتم Timeline انجام می دهد یا زمانی که مکان کاربر به روز شده است، ارسال می شود مشترک شوید. هنگامی که در یک اعلان مشترک می شوید، یک URL بازگشت به تماس ارائه می کنید که اعلان را پردازش می کند.

توجه: در مرحله تولید، URL بازگشت به تماس شما باید از SSL پشتیبانی کند. برای اهداف توسعه، ما یک سرور پراکسی اشتراک ارائه می کنیم که می تواند اعلان ها را به سرور توسعه غیر SSL شما ارسال کند.

یک اعلان از Mirror API به عنوان یک درخواست POST به نقطه پایانی مشترک حاوی بدنه درخواست JSON ارسال می شود.

HTTP خام

{
  "collection": "timeline",
  "itemId": "3hidvm0xez6r8_dacdb3103b8b604_h8rpllg",
  "operation": "INSERT",
  "userToken": "harold_penguin",
  "verifyToken": "random_hash_to_verify_referer",
  "userActions": [
    {
      "type": "SHARE"
    }
  ]
}

ویژگی itemId ID آیتم جدول زمانی به اشتراک گذاشته شده است که می توانید با Timeline.get از آن برای دریافت آیتم جدول زمانی استفاده کنید. مثال زیر یک آیتم جدول زمانی معمولی را با پیوست عکس نشان می دهد:

{
  "id": "3hidvm0xez6r8_dacdb3103b8b604_h8rpllg",
  "attachments": [
      {
          "contentType": "image/jpeg",
          "id": "<ATTACHMENT_ID>"
      }
  ],
  "recipients": [
      {
          "kind": "glass#contact",
          "source": "api:<SERVICE_ID>",
          "id": "<CONTACT_ID>",
          "displayName": "<CONTACT_DISPLAY_NAME>",
          "imageUrls": [
              "<CONTACT_ICON_URL>"
          ]
      }
  ]
}

اگر خطایی رخ نداد، سرویس شما باید با کد وضعیت HTTP 200 OK به API پاسخ دهد. اگر سرویس شما با کد خطا پاسخ دهد، Mirror API ممکن است سعی کند اعلان را دوباره به سرویس شما ارسال کند.

توجه: زمان اتصال پس از 10 ثانیه قطع می شود. اگر به یک پروسه طولانی نیاز است، فورا پاسخ دهید و این فرآیند را در یک تاپیک دیگر انجام دهید.

دریافت رونویسی گفتار

کاربران می توانند گفتار رونویسی شده را از طریق منوی صوتی اصلی با مخاطب شما به اشتراک بگذارند. در حال حاضر دو فرمان صوتی وجود دارد که مخاطب شما می تواند از آنها استفاده کند:

• "یادداشت برداری"
• "پست یک به روز رسانی"

به عنوان مثال، یک کاربر می تواند در مورد تولد آینده Chipotle با این جمله به ما بگوید: "Ok Glass... ارسال به روز رسانی به... Cat Stream... تولد Chipotle فردا است!"

برای استفاده از دستورات صوتی:

1. خاصیت acceptCommands را با type مناسب مشخص کنید:

   {
     ...
   
     "displayName": "Cat Stream",
     "id": "CAT_STREAM",
     "acceptCommands": [
       {"type": "POST_AN_UPDATE"}
     ]
   }
   

2. در اعلان‌های جدول زمانی مشترک شوید تا از موجود بودن گفتار رونویسی شده مطلع شوید. وقتی این اتفاق می افتد Glassware شما یک اعلان دریافت می کند:

   {
     "collection": "timeline",
     "operation": "UPDATE",
     "userToken": "<USER_TOKEN>",
     "verifyToken": "<VERIFY_TOKEN>",
     "itemId": "<ITEM_ID>",
     "userActions": [
       {"type": "LAUNCH"}
     ]
   }
   

3. از itemId برای واکشی مورد خط زمانی استفاده کنید:

   {
     "id": "<ITEM_ID>",
     "text": "Chipotle's birthday is tomorrow",
     "recipients": [
       {"id": "CAT_STREAM"}
     ]
   }
   

   توجه: هنگامی که مورد اشتراک‌گذاری شده خط زمانی را دریافت می‌کنید، به‌جای ایجاد یک مورد جدید، اگر مورد را تغییر می‌دهید، کارت خط زمانی موجود را با Timeline.update به‌روزرسانی کنید.

4. اگر بیش از یک Glassware یک مخاطب را با یک فرمان صوتی ثبت کند، Glass یک منوی سطح دوم displayName هر مخاطب را نمایش می دهد. سپس کاربران می توانند مخاطب مورد نظر خود را بیان کنند. اگر displayName مخاطب شما حاوی نویسه‌های غیرقابل تلفظ است یا آوایی نیست، از ویژگی speakableName برای اعلام تلفظ مورد انتظار مخاطب اشتراک‌گذاری خود استفاده کنید.

زیرنویس برای عکس های به اشتراک گذاشته شده

کاربران این امکان را دارند که عکس‌ها را با Glassware شما با عنوانی به اشتراک بگذارند که با گفتار وارد می‌کنند. جریان عمومی کاربر به صورت زیر است:

1. کاربر روی آیتم جدول زمانی حاوی عکس ضربه می زند، آیتم منوی اشتراک گذاری را انتخاب می کند و مخاطب شما را انتخاب می کند.
2. کاربر در مدت زمان کوتاهی دوباره ضربه می زند تا یک توضیح به عکس اضافه کند.
3. کاربر یک عنوان صحبت می کند.
4. مورد جدول زمانی با Glassware شما به اشتراک گذاشته می شود که قبلاً در نحوه کار آنها توضیح داده شد. علاوه بر این، ویژگی text آیتم جدول زمانی با عنوان رونویسی شده کاربر تنظیم می شود.