অ্যাম্বিয়েন্ট এপিআই দিয়ে শুরু করুন

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

অ্যাম্বিয়েন্ট এপিআই ফ্লো

অ্যাম্বিয়েন্ট এপিআই কীভাবে একটি ডিভাইস সংযোগ করতে এবং তারপর মিডিয়া আইটেমগুলি পুনরুদ্ধার এবং প্রদর্শন করতে কাজ করে তার একটি বিশদ বিবরণ এখানে দেওয়া হল:

  1. বিদ্যমান ডিভাইসটি পরীক্ষা করুন (প্রস্তাবিত): একটি নতুন ডিভাইস তৈরি করার আগে, বর্তমান ব্যবহারকারীর জন্য কোনও ডিভাইস ইতিমধ্যেই বিদ্যমান কিনা তা পরীক্ষা করে নেওয়ার পরামর্শ দেওয়া হচ্ছে। আপনার অ্যাপ্লিকেশনটি আপনার অভ্যন্তরীণ ব্যবহারকারী এবং আপনার অ্যাপের মাধ্যমে তৈরি করা যেকোনো ডিভাইসের জন্য Google-প্রদত্ত deviceId মধ্যে একটি ম্যাপিং বজায় রাখবে। যদি ব্যবহারকারীর জন্য কোনও deviceId পাওয়া যায়, তাহলে আপনি তাদের অনুমোদন টোকেন রিফ্রেশ করতে পারেন (যদি প্রয়োজন হয়)।

  2. OAuth 2.0 অনুমোদন শুরু করুন (এবং ঐচ্ছিকভাবে ডিভাইস তৈরি করুন): একটি অনুমোদন কোড অনুরোধ করে টিভি এবং সীমিত ইনপুট ডিভাইস প্রবাহের জন্য OAuth 2.0 শুরু করুন।

  3. একটি নতুন ডিভাইস তৈরি করুন: আপনার অ্যাপটি CreateDevice কল করে এবং একটি বৈধ v4 UUID প্রদান করে একজন ব্যবহারকারীর Google Photos অ্যাকাউন্টে একটি ডিভাইস তৈরি করে।

    সফলভাবে ডিভাইস তৈরির পর, API একটি AmbientDevice অবজেক্ট ফেরত দেবে যার মধ্যে একটি Google-নির্ধারিত deviceId থাকবে। আপনার অ্যাপ্লিকেশনের জন্য এই deviceId সংরক্ষণ করা এবং এটি আপনার ব্যবহারকারীদের সাথে সংযুক্ত করা অত্যন্ত গুরুত্বপূর্ণ।

  4. settingsUri প্রদর্শন করুন: একটি AmbientDevice অবজেক্টে একটি settingsUri থাকে। ব্যবহারকারীর কাছে এই URI উপস্থাপন করুন, সাধারণত একটি QR কোড হিসেবে, যা ব্যবহারকারী তার মোবাইল ডিভাইস ব্যবহার করে স্ক্যান করতে পারেন। এই URI ব্যবহারকারীকে Google Photos অ্যাপে নির্দেশ করে যেখানে তারা তাদের অ্যাম্বিয়েন্ট ডিভাইসে যে মিডিয়া সোর্সগুলি (যেমন, অ্যালবাম) প্রদর্শন করতে চান তা কনফিগার করতে পারে।

  5. mediaSourcesSet এর জন্য পোল: আপনার অ্যাপ্লিকেশনটি পর্যায়ক্রমে GetDevice পদ্ধতিতে কল করবে, যা deviceId প্রদান করবে, যাতে অ্যাম্বিয়েন্ট ডিভাইসের অবস্থা পরীক্ষা করা যায়। AmbientDevice প্রতিক্রিয়াতে mediaSourcesSet ক্ষেত্রটি পর্যবেক্ষণ করুন। এটি প্রাথমিকভাবে মিথ্যা হবে।

    ব্যবহারকারী একবার গুগল ফটো অ্যাপে মিডিয়া সোর্সগুলি সফলভাবে নির্বাচন করলে, এই ক্ষেত্রটি সত্যে পরিবর্তিত হবে।

    AmbientDevice রেসপন্সে একটি pollingConfig থাকে যার একটি pollInterval থাকে যা আপনার পোলিং ফ্রিকোয়েন্সির জন্য একটি নির্দেশিকা হিসেবে ব্যবহার করা উচিত।

  6. মিডিয়া আইটেমগুলি পুনরুদ্ধার করুন: যখন mediaSourcesSet সত্য প্রদান করে, তখন আপনার অ্যাপ্লিকেশন ব্যবহারকারীর দ্বারা নির্বাচিত মিডিয়া আইটেমগুলি আনা শুরু করতে পারে।

    deviceId প্রদান করে ListMediaItems পদ্ধতিতে কল করুন। API ListMediaItemsResponse ফিরিয়ে আনবে যেখানে AmbientMediaItem অবজেক্টের তালিকা থাকবে। প্রতিটি AmbientMediaItem id , createTime এবং অতিরিক্ত মেটাডেটা সহ একটি MediaFile অবজেক্টের মতো বিশদ বিবরণ থাকবে। MediaFile একটি baseUrl থাকে যা আপনি একটি মিডিয়া আইটেমের প্রকৃত বাইট আনতে ব্যবহার করতে পারেন। অতিরিক্ত baseUrl প্যারামিটার সম্পর্কে বিস্তারিত জানতে মিডিয়া আইটেম তালিকাভুক্ত এবং পুনরুদ্ধার করার নির্দেশিকাটি পর্যালোচনা করুন।

  7. মিডিয়া আইটেম প্রদর্শন করুন: অ্যাম্বিয়েন্ট ডিভাইসে মিডিয়া কন্টেন্ট ডাউনলোড এবং প্রদর্শন করতে MediaFile থেকে baseUrl ব্যবহার করুন।

গুরুত্বপূর্ণ বিবেচ্য বিষয়গুলি

ডিভাইসের সীমা এবং ব্যবস্থাপনা:

  • ডিভাইসের সীমা: আপনার অ্যাপ্লিকেশনের প্রতি ব্যবহারকারীর জন্য ১০০টি ডিভাইসের সীমা সম্পর্কে সচেতন থাকুন।
  • ডিভাইসের কার্যকলাপ এবং টোকেন: আপনাকে ডিভাইসের জীবনচক্র এবং ব্যবহারকারীর অনুমোদন টোকেন পরিচালনা করতে হবে। ডিভাইসগুলি কতক্ষণ সক্রিয় থাকে এবং কোনও ডিভাইস নিষ্ক্রিয় হয়ে গেলে বা টোকেনের মেয়াদ শেষ হয়ে গেলে আপনি টোকেন রিফ্রেশ বা পুনরায় অনুমোদন কীভাবে পরিচালনা করবেন তা বিবেচনা করুন।

ডিভাইস তৈরি এবং পরিচালনা করার নির্দেশিকাটিতে অতিরিক্ত বিবরণ রয়েছে।

মিডিয়া আইটেম নিয়ে কাজ করা:

  • মিডিয়া আইটেম ব্যবহার: baseUrl ব্যবহার করে মিডিয়া আইটেম কন্টেন্ট কীভাবে সঠিকভাবে আনতে হয় এবং পরিচালনা করতে হয় তা বুঝুন, যার মধ্যে প্রয়োজনীয় প্রমাণীকরণ বা প্যারামিটারও অন্তর্ভুক্ত রয়েছে।
  • ত্রুটি পরিচালনা: API কলগুলির জন্য শক্তিশালী ত্রুটি পরিচালনা বাস্তবায়ন করুন, যার মধ্যে রয়েছে ডিভাইসের জন্য NOT_FOUND , মিডিয়া সোর্স সেট না থাকলে FAILED_PRECONDITION এবং ডিভাইসের সীমা অতিক্রম করলে RESOURCE_EXHAUSTED মতো পরিস্থিতি।

মিডিয়া আইটেম তালিকাভুক্ত এবং পুনরুদ্ধারের নির্দেশিকাটিতে অতিরিক্ত বিবরণ রয়েছে, যার মধ্যে রয়েছে বিষয়বস্তু নীতি এবং ফিল্টারিং সম্পর্কিত তথ্য।

পরবর্তী পদক্ষেপ