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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

গুরুত্বপূর্ণ বিবেচনা

ডিভাইসের সীমা এবং পরিচালনা:

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

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

মিডিয়া আইটেমগুলির সাথে কাজ করা:

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

মিডিয়া আইটেমগুলি তালিকাভুক্ত এবং পুনরুদ্ধার করার গাইডটিতে অতিরিক্ত বিবরণ রয়েছে৷

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