পরিচিতি

আপনার কন্ট্যাক্টরা আপনার গ্লাসওয়্যারকে এমন টাইমলাইন আইটেম গ্রহণ করার অনুমতি দেয় যা সে নিজে তৈরি করেনি। ব্যবহারকারীদের অবশ্যই একটি কার্ডের শেয়ার মেনু আইটেমে ট্যাপ করে আপনার কন্ট্যাক্টের সাথে স্পষ্টভাবে একটি টাইমলাইন আইটেম শেয়ার করতে হবে।

তারা কীভাবে কাজ করে

একবার আপনি একটি শেয়ারিং কন্টাক্ট তৈরি করলে, শেয়ারিং টাইমলাইন কার্ডগুলো এই সাধারণ প্রবাহ অনুসরণ করে:

  1. একটি কন্টাক্ট তৈরি করুন এবং আপনার কন্টাক্ট যে MIME টাইপগুলো সাপোর্ট করে তা নির্ধারণ করুন।
  2. আপনার ব্যবহারকারীর টাইমলাইনে পরিচিতিটি যুক্ত করুন।
  3. ব্যবহারকারী একটি টাইমলাইন আইটেম পান, যেটিতে একটি শেয়ার মেনু আইটেম থাকে। গ্লাসওয়্যারকে অবশ্যই এই মেনু আইটেমটির মাধ্যমে ব্যবহারকারীদের তাদের আইটেম শেয়ার করার জন্য সুস্পষ্টভাবে অনুমতি দিতে হবে।
  4. ব্যবহারকারী টাইমলাইন আইটেমটিতে ট্যাপ করেন, শেয়ার মেনু আইটেমটি নির্বাচন করেন এবং আপনার পরিচিতিটি বেছে নেন।
  5. মিরর এপিআই শেয়ার করা টাইমলাইন কার্ডের একটি অনুলিপি তৈরি করে, আপনার পরিচিত ব্যক্তিকে সেই অনুলিপিতে অ্যাক্সেস দেয় এবং অনুলিপিটি ব্যবহারকারীর টাইমলাইনে যুক্ত করে দেয়। আপনার গ্লাসওয়্যার মূল টাইমলাইন আইটেমটি অ্যাক্সেস করতে পারে না।
  6. আপনি যদি শেয়ার নোটিফিকেশনের জন্য সাবস্ক্রাইব করে থাকেন , তাহলে আপনি টাইমলাইন কার্ডের শনাক্তকারী তথ্য সম্বলিত একটি পেলোড পাবেন। এরপর আপনি Timeline.get ব্যবহার করে টাইমলাইন আইটেমটি পুনরুদ্ধার করতে পারবেন।
  7. আপনি Timeline.update ব্যবহার করে শেয়ার করা টাইমলাইন কার্ডটি পরিবর্তন করতে এবং বিদ্যমান টাইমলাইন কার্ডটি আপডেট করতে পারেন।

কখন সেগুলি ব্যবহার করবেন

ডিফল্টরূপে, Glassware তার তৈরি না করা টাইমলাইন আইটেমগুলো অ্যাক্সেস করতে পারে না, তাই কন্ট্যাক্টরা ব্যবহারকারীর সম্মতি সাপেক্ষে Glassware-কে ডেটা শেয়ার করার অনুমতি দেয়।

আপনার গ্লাসওয়্যার দুটি প্রধান উপায়ে কন্টাক্ট লেন্স ব্যবহার করতে পারে:

  • ব্যবহারকারীদের আপনার টাইমলাইন আইটেমগুলো অন্যান্য কন্ট্যাক্টদের সাথে শেয়ার করার অনুমতি দিন : একটি টাইমলাইন কার্ডে SHARE বিল্ট-ইন মেনু আইটেমটি যোগ করুন। ব্যবহারকারীরা যখন শেয়ার মেনু আইটেমটিতে ট্যাপ করবেন, তখন Glass শেয়ার করার জন্য সম্ভাব্য কন্ট্যাক্টদের একটি তালিকা প্রদর্শন করবে।

  • ব্যবহারকারীদের আপনার গ্লাসওয়্যারের সাথে টাইমলাইন আইটেম শেয়ার করার অনুমতি দিন : একটি কন্ট্যাক্ট তৈরি করুন যা আপনার গ্লাসওয়্যারের প্রতিনিধিত্ব করবে। যখন ব্যবহারকারীরা একটি টাইমলাইন কার্ড শেয়ার করতে চাইবে, তখন আপনার কন্ট্যাক্টটি একটি বিকল্প হিসেবে প্রদর্শিত হবে। আপনি গ্রহণযোগ্য MIME টাইপের একটি তালিকাও ঘোষণা করতে পারেন, যাতে আপনার কন্ট্যাক্টটি শুধুমাত্র আপনার পছন্দের কার্ডগুলোর জন্যই প্রদর্শিত হয়। ব্যবহারকারীরা যখন আপনার কন্ট্যাক্টের সাথে কোনো টাইমলাইন কার্ড শেয়ার করবে, তখন তার নোটিফিকেশন পেতে আপনি টাইমলাইন নোটিফিকেশনে সাবস্ক্রাইব করতে পারেন।

যোগাযোগ তৈরি করা

ব্যবহারকারীদের আপনার Glassware-এর সাথে টাইমলাইন আইটেম শেয়ার করার সুযোগ দিতে, insert REST এন্ডপয়েন্টে একটি কন্ট্যাক্টের JSON রিপ্রেজেন্টেশন POST করে কন্ট্যাক্টটি ইনসার্ট করুন।

সমস্ত কন্ট্যাক্টের একটি id অবশ্যই উল্লেখ করতে হবে, যা নোটিফিকেশন গ্রহণকারী Glassware-এর কাছে কন্ট্যাক্টটিকে শনাক্ত করে। আপনাকে অবশ্যই একটি displayName এবং অন্তত একটি imageUrls উল্লেখ করতে হবে, যা Glass ব্যবহারকারীকে কন্ট্যাক্টের তথ্য দেখানোর জন্য ব্যবহার করে।

কাঁচা 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
}

শেয়ারিং বিজ্ঞপ্তিগুলিতে সাবস্ক্রাইব করা

মিরর এপিআই আপনাকে সেইসব নোটিফিকেশনে সাবস্ক্রাইব করার সুযোগ দেয়, যা ব্যবহারকারী কোনো টাইমলাইন আইটেমে নির্দিষ্ট কোনো কাজ করলে বা তার অবস্থান আপডেট হলে পাঠানো হয়। কোনো নোটিফিকেশনে সাবস্ক্রাইব করার সময়, আপনাকে একটি কলব্যাক ইউআরএল প্রদান করতে হয়, যা নোটিফিকেশনটি প্রসেস করে।

মিরর এপিআই থেকে একটি নোটিফিকেশন একটি JSON রিকোয়েস্ট বডি সহ একটি POST রিকোয়েস্ট হিসেবে সাবস্ক্রাইব করা এন্ডপয়েন্টে পাঠানো হয়।

কাঁচা 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>"
          ]
      }
  ]
}

যদি কোনো ত্রুটি না ঘটে, তবে আপনার সার্ভিসকে অবশ্যই API-কে একটি 200 OK HTTP স্ট্যাটাস কোড দিয়ে সাড়া দিতে হবে। যদি আপনার সার্ভিস কোনো ত্রুটি কোড দিয়ে সাড়া দেয়, তাহলে মিরর API আপনার সার্ভিসে নোটিফিকেশনটি পুনরায় পাঠানোর চেষ্টা করতে পারে।

বক্তৃতার প্রতিলিপি গ্রহণ

ব্যবহারকারীরা মূল ভয়েস মেনুর মাধ্যমে আপনার পরিচিত ব্যক্তির সাথে লিখিত বক্তব্য শেয়ার করতে পারেন। বর্তমানে দুটি ভয়েস কমান্ড রয়েছে যা আপনার পরিচিত ব্যক্তি ব্যবহার করতে পারেন:

  • "নোট নিন"
  • "একটি আপডেট পোস্ট করুন"

উদাহরণস্বরূপ, একজন ব্যবহারকারী এই বাক্যটির মাধ্যমে আমাদের চিপোটলের আসন্ন জন্মদিন সম্পর্কে জানাতে পারেন: "ওকে গ্লাস... ক্যাট স্ট্রিমে একটি আপডেট পোস্ট করো... আগামীকাল চিপোটলের জন্মদিন!"

ভয়েস কমান্ড ব্যবহার করতে:

  1. উপযুক্ত type দিয়ে acceptCommands প্রপার্টিটি নির্দিষ্ট করুন:

    {
  ...

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

  2. অনুলিখিত বক্তৃতা উপলব্ধ হলে বিজ্ঞপ্তি পেতে টাইমলাইন নোটিফিকেশনে সাবস্ক্রাইব করুন। এটি ঘটলে আপনার গ্লাসওয়্যার একটি বিজ্ঞপ্তি পায়:

    {
  "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"}
  ]
}

  4. যদি একাধিক Glassware একই ভয়েস কমান্ড দিয়ে একটি কন্ট্যাক্ট রেজিস্টার করে, তাহলে Glass একটি দ্বিতীয়-স্তরের মেনু প্রদর্শন করে যেখানে প্রতিটি কন্ট্যাক্টের displayName দেখানো হয়। এরপর ব্যবহারকারীরা তাদের পছন্দের কন্ট্যাক্টটি বলতে পারেন। যদি আপনার কন্ট্যাক্টের displayName উচ্চারণ-অযোগ্য অক্ষর থাকে বা এটি ধ্বনিগত না হয়, তাহলে আপনার শেয়ার করা কন্ট্যাক্টটির প্রত্যাশিত উচ্চারণ ঘোষণা করতে speakableName প্রপার্টিটি ব্যবহার করুন।

শেয়ার করা ছবির ক্যাপশন

ব্যবহারকারীরা আপনার গ্লাসওয়্যারে ছবি শেয়ার করতে পারেন এবং এর সাথে একটি ক্যাপশনও যোগ করতে পারেন, যা তারা কথার মাধ্যমে ইনপুট করেন। সাধারণ ব্যবহার প্রক্রিয়াটি হলো:

  1. ব্যবহারকারী টাইমলাইনের কোনো ছবিযুক্ত আইটেমে ট্যাপ করেন, শেয়ার মেনু আইটেমটি নির্বাচন করেন এবং আপনার কন্ট্যাক্টটি বেছে নেন।
  2. ছবিটিতে ক্যাপশন যোগ করার জন্য ব্যবহারকারী অল্প সময়ের মধ্যে আবার ট্যাপ করেন।
  3. ব্যবহারকারী একটি ক্যাপশন বলেন।
  4. পূর্বে 'এগুলো কীভাবে কাজ করে' অংশে যেমন বর্ণনা করা হয়েছে, সেই অনুযায়ী টাইমলাইন আইটেমটি আপনার গ্লাসওয়্যারের সাথে শেয়ার করা হয়। এছাড়াও, টাইমলাইন আইটেমটির text প্রপার্টিতে ব্যবহারকারীর অনুলিখিত ক্যাপশনটি সেট করা থাকে।