পরিচিতি

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

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

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

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

কখন এগুলো ব্যবহার করবেন

ডিফল্টরূপে, গ্লাসওয়্যার টাইমলাইন আইটেমগুলি অ্যাক্সেস করতে পারে না যা এটি তৈরি করেনি, তাই পরিচিতিগুলি ব্যবহারকারীর সম্মতিতে গ্লাসওয়্যার থেকে গ্লাসওয়্যার ডেটা ভাগ করে নেওয়ার অনুমতি দেয়।

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

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

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

একটি পরিচিতি তৈরি করা হচ্ছে

ব্যবহারকারীদের আপনার গ্লাসওয়্যারের সাথে টাইমলাইন আইটেমগুলি ভাগ করার অনুমতি দিতে, REST এন্ডপয়েন্ট সন্নিবেশে একটি পরিচিতির JSON উপস্থাপনা পোস্ট করে একটি পরিচিতি সন্নিবেশ করান৷

সমস্ত পরিচিতি অবশ্যই একটি id নির্দিষ্ট করবে, যা বিজ্ঞপ্তিগুলি গ্রহণকারী গ্লাসওয়্যারের পরিচিতিকে সনাক্ত করে৷ আপনাকে অবশ্যই একটি 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
}

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

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

মিরর এপিআই থেকে একটি বিজ্ঞপ্তি একটি 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>"
          ]
      }
  ]
}

কোনো ত্রুটি না ঘটলে আপনার পরিষেবাকে অবশ্যই 200 OK HTTP স্ট্যাটাস কোড সহ API-এ সাড়া দিতে হবে। যদি আপনার পরিষেবা একটি ত্রুটি কোডের সাথে প্রতিক্রিয়া জানায়, মিরর 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. যদি একাধিক গ্লাসওয়্যার একই ভয়েস কমান্ডের সাথে একটি পরিচিতি নিবন্ধন করে, তবে গ্লাস একটি দ্বিতীয়-স্তরের মেনু প্রদর্শন করে যা প্রতিটি পরিচিতির displayName দেখায়। ব্যবহারকারীরা তারপর তাদের পছন্দের পরিচিতি বলতে পারেন। আপনার পরিচিতির displayName যদি উচ্চারণযোগ্য অক্ষর না থাকে বা উচ্চারণযোগ্য না হয়, তাহলে আপনার শেয়ারিং পরিচিতির প্রত্যাশিত উচ্চারণ ঘোষণা করতে speakableName বৈশিষ্ট্যটি ব্যবহার করুন।

শেয়ার করা ফটোর জন্য ক্যাপশন

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

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