সাধারণ
প্রশ্ন: কোথায় এবং কোন ভাষায় আমাদের ক্লাউড-টু-ক্লাউড পরিপূর্ণতা পরিকাঠামো বাস্তবায়ন করা উচিত?
উত্তর: যতক্ষণ না এটি আধুনিক SSL (TLS) এবং OAuth 2.0 সমর্থন করে, আপনি যে কোনও প্ল্যাটফর্মে এবং আপনার চয়ন করা যে কোনও ভাষায় আপনার পরিকাঠামো বাস্তবায়ন করতে স্বাগত জানাই৷ আমরা সুপারিশ করি যে আপনি আপনার বাকি অবকাঠামোর যতটা সম্ভব কাছাকাছি স্থাপন করুন, নির্ভরযোগ্যতা উন্নত করতে এবং প্রকৃত ব্যবহারকারীর ডিভাইসগুলিতে কার্যকর করার জন্য বিলম্ব কমাতে।
প্রশ্ন: ডিভাইস আইডি অনন্য হতে হবে?
উত্তর: আইডি অনন্য হতে হবে। আপনার পরিষেবা জুড়ে যদি আপনার অনন্য আইডি না থাকে, তবে সেগুলি অবশ্যই প্রতি-ব্যবহারকারী স্তরে অনন্য হতে হবে। একাধিক হোম সহ একজন ব্যবহারকারীকে কল্পনা করুন, যেখানে উভয় বাড়িরই একই ব্যবহারকারীর সাথে একীকরণ রয়েছে। এক বাড়িতে আলো জ্বালাতে বললে অন্য বাড়িতে একই আইডি দিয়ে আলো জ্বালানো উচিত নয়।
প্রশ্ন: ডিভাইসের নাম কি অনন্য হওয়া দরকার?
উত্তর: নামগুলি অনন্য হতে হবে না, যদিও সময়ের সাথে সাথে আমরা ব্যবহারকারীদের আরও ভাল অভিজ্ঞতার জন্য সেটআপ করার পরে খারাপ নামকরণের উন্নতি করতে উত্সাহিত করতে পারি।
এখানে একটি দ্রুত নামকরণের নির্দেশিকা রয়েছে:
- নামগুলি এমন জিনিস হওয়া উচিত যা লোকেরা আসলে বলতে পারে।
- আমরা স্ট্রিংগুলির উপসেটগুলি চিনতে পারি, তাই যদি আপনার কাছে 'acme কালার লাইট' থাকে তবে আমরা 'acme লাইট'-এর উত্তরও দেব।
- আমরা পণ্যের জন্য একটি বর্ণনামূলক নাম এবং এক বা একাধিক ব্যবহারকারী-সংজ্ঞায়িত নাম উভয়কেই উৎসাহিত করি।
- ব্যবহারকারীদের লাইটের ঘরের নাম দেওয়ার দরকার নেই, কারণ আমাদের কাছে এটির জন্য ঘর রয়েছে; প্রতিটি কক্ষের জন্য তাদের অনন্য নাম থাকা উচিত, কিন্তু সর্বদা সবকিছুকে নির্দেশ করার জন্য বহুবচন ব্যবহার করতে পারে (উদাহরণস্বরূপ, অফিস স্কোন্সের দুটি বাল্ব হল 'উত্তর আলো' এবং 'পূর্ব আলো', তবে কেবল 'লাইট' হিসাবে নির্দেশ করা যেতে পারে)।
প্রশ্ন: ডিভাইসের অবস্থা কত ঘন ঘন আপডেট করা হয়?
উত্তর: QUERY বা EXECUTE-এর উপর ক্ষণস্থায়ী অবস্থা পুনরুদ্ধার করা হয়, যেগুলি ব্যবহারকারীর সূচিত ক্রিয়া। ব্যবহারকারী যদি জিজ্ঞেস করেন 'আলো জ্বলছে?', বা আলো উজ্জ্বল করতে চায়, তাহলে বর্তমান অবস্থা বের করার জন্য আমাদের একটি প্রশ্ন করতে হবে।
প্রশ্ন: একটি ডিভাইসের বর্তমান অবস্থার সাথে সরাসরি হোম গ্রাফ আপডেট করা কি সম্ভব?
উত্তর: হ্যাঁ, Report State API কল ব্যবহার করুন।
অ্যাকাউন্ট লিঙ্কিং এবং OAuth
প্রশ্নঃ আমাদের কি অ্যাকাউন্ট লিঙ্কিং করতে হবে?
উত্তর: হ্যাঁ, প্রদানকারীর ক্লাউড পরিষেবাগুলির সাথে ব্যবহারকারীর ডিভাইসগুলিকে সংযুক্ত করার জন্য অ্যাকাউন্ট লিঙ্ক করা প্রয়োজন৷
প্রশ্ন: OAuth-এর জন্য, আমরা প্রতি 15.213 ঘন্টায় অ্যাক্সেস টোকেনগুলির মেয়াদ শেষ করি, এটা কি ঠিক আছে?
উত্তর: হ্যাঁ, তবে অনুগ্রহ করে একটি মোটামুটি সংক্ষিপ্ত মেয়াদ শেষ হওয়ার সাথে পরীক্ষা করুন, বলুন 10-20 মিনিট। আমাদের OAuth ক্লায়েন্টের প্রয়োজন অনুসারে টোকেনগুলিকে রিফ্রেশ করা উচিত এবং একটি সংক্ষিপ্ত মেয়াদ শেষ হওয়ার সাথে পরীক্ষা করা প্রমাণ করবে যে এটি কাজ করছে৷
অভিপ্রায়
প্রশ্নঃ SYNC কখন হয়?
উত্তর: OAuth সমাপ্তির পরপরই SYNC হয়, এবং একটি অনুরোধ সিঙ্ক কল করার পরে।
প্রশ্ন: কেন SYNC কাজ করছে না?
উত্তর: এটি ব্যর্থ হতে পারে এমন কয়েকটি সাধারণ কারণ রয়েছে।
আপনি ভুল ধরনের ডিভাইস পাঠাচ্ছেন।
- উদাহরণস্বরূপ, আমরা
action.devices.types.LIGHTআশা করি, কিন্তু আপনিaction.devices.types.Lightপাঠান।
- উদাহরণস্বরূপ, আমরা
আপনি অসমর্থিত ডিভাইসের ধরন পাঠাচ্ছেন।
- উদাহরণস্বরূপ, আপনি
action.devices.types.FLASHLIGHTপাঠান - এটি এমন একটি জিনিস নয় যা আমরা সমর্থন করি।
- উদাহরণস্বরূপ, আপনি
আপনি অবৈধ/অসমর্থিত ক্ষেত্র পাঠাচ্ছেন।
- উদাহরণস্বরূপ, আপনার একটি ক্ষেত্র রয়েছে যা আমাদের স্পেসিফিকেশনে নেই।
আপনার SYNC প্রতিক্রিয়ার সাথে অন্য কিছু ফর্ম্যাটিং সমস্যা রয়েছে৷
- আপনার বন্ধনী পরীক্ষা করুন!
আপনি একটি অ্যাকাউন্ট লিঙ্ক সমস্যা আঘাত করছেন.
- অনুগ্রহ করে যাচাই করুন যে আপনি SYNC অনুরোধের প্রমাণীকরণ শিরোনামে একটি বৈধ অ্যাক্সেস টোকেন পাচ্ছেন৷
SYNC অনুরোধে সাড়া দিতে আপনি খুব বেশি সময় নিচ্ছেন।
- অনুগ্রহ করে যাচাই করুন যে আপনি 5 সেকেন্ডের মধ্যে SYNC অনুরোধে সাড়া দিচ্ছেন।
প্রশ্ন: একটি "মুলতুবি" প্রতিক্রিয়া ঠিক আছে?
উত্তর: আমরা দৃঢ়ভাবে একটি সাফল্য/ব্যর্থ প্রতিক্রিয়া পছন্দ করব, মুলতুবি থাকার বিপরীতে, যদি আপনার ডিভাইসগুলি রিয়েল টাইমে উপলব্ধ থাকে। অনুগ্রহ করে যোগাযোগ করুন যদি আপনি মনে করেন যে আপনার একটি 'মুলতুবি' প্রতিক্রিয়া প্রয়োজন -- আমরা স্বীকার করি যে কিছু স্বল্প-শক্তি, নন-রিয়েল-টাইম ডিভাইসগুলির একটি মুলতুবি প্রতিক্রিয়া এবং অ্যাসিঙ্ক্রোনাস এক্সিকিউশন মডেলের প্রয়োজন হতে পারে৷
পরীক্ষা এবং জমা
প্রশ্ন: আমরা একটি উন্নয়ন মেঘ পরিবেশ সেট আপ করতে পারি?
উত্তর: হ্যাঁ, আপনি একটি আনলঞ্চ করা ক্লাউড পরিবেশ এবং কনফিগারেশন পরীক্ষা করতে পারেন।
প্রশ্ন: Google Home অ্যাপের হোম কন্ট্রোল বিভাগে আমার অ্যাকশন দেখা যাচ্ছে না। কি হচ্ছে?
উত্তর: নিশ্চিত করুন যে আপনি এই প্রকল্পের একজন বিকাশকারী৷
রিপোর্ট রাজ্য
প্রশ্নঃ রিপোর্ট স্টেট বাস্তবায়নের পূর্বশর্ত আছে কি?
উত্তর: প্রকল্পের স্মার্ট হোম API ব্যবহার করতে হবে, OAuth2 সমর্থন করতে হবে এবং রিপোর্ট করতে হবে এমন বৈশিষ্ট্য থাকতে হবে।
প্রশ্ন: একটি ডিভাইসে আমাদের কত ঘন ঘন স্টেট রিপোর্ট করতে হবে?
উত্তর: Google রূপান্তর এবং টার্মিনাল অবস্থায় আগ্রহী। যাইহোক, যদি স্বল্প সময়ের মধ্যে অনেকগুলি অবস্থার পরিবর্তন হয় (উদাহরণস্বরূপ, একজন ব্যবহারকারী এক মিনিটে তিনবার ফ্রিজ খোলে এবং বন্ধ করে বা একটি ম্লান স্লাইড করে) তবে আমাদের শুধুমাত্র চূড়ান্ত অবস্থার রিপোর্ট করা প্রয়োজন।
প্রশ্ন: রিপোর্ট স্টেট কল করার সময় কি সম্পূর্ণ ডিভাইসের অবস্থা পাঠানো দরকার?
উত্তর: আংশিক অবস্থার আপডেটগুলি সমর্থিত নয়, তাই Report State কলে সবসময় আপডেট করা হয়েছে এমন একটি নির্দিষ্ট বৈশিষ্ট্যের সমস্ত ডেটা অন্তর্ভুক্ত করা উচিত। যদি দুটি বৈশিষ্ট্য একটি অসঙ্গতি তৈরি করে, তবে তাদের একসাথে রিপোর্ট করা উচিত।
প্রশ্ন: Google কি আমার ডিভাইসের অবস্থা জানতে প্রশ্ন করতে পারে (অর্থাৎ, ডিভাইসটি পোল)?
উত্তর: এটি একটি ফলব্যাক প্রক্রিয়া যা আমরা সুপারিশ করি না। যদি আমাদের সেই ব্যবহারকারীদের জন্য ঘন ঘন একটি ডিভাইসের ভোটদানে ফিরে যেতে হয়, তাহলে অতিরিক্ত লোড কী হবে তা আমরা গ্যারান্টি দিতে পারি না। প্রয়োজন নতুন চাক্ষুষ পৃষ্ঠ থেকে আসে. অজানা লোড সমস্যা ছাড়াও, এটি একটি অবনমিত ব্যবহারকারীর অভিজ্ঞতা হবে। আমরা মনে করি যে Report State প্ল্যাটফর্মের জন্য গুরুত্বপূর্ণ।
প্রশ্ন: কোন বৈশিষ্ট্যগুলি এই মুহূর্তে রিপোর্ট স্টেটকে সমর্থন করে?
উত্তর: সমস্ত পাবলিক বৈশিষ্ট্য যা রাজ্যের সাথে যুক্ত আছে তা সমর্থিত। ডিভাইসের অনলাইন অবস্থার কোনো পরিবর্তনও রিপোর্ট করা উচিত।
মনে রাখবেন যে দৃশ্যের কোনো অবস্থা নেই। যাইহোক, এর ফলে ডিভাইস(গুলি) এর অবস্থার পরিবর্তন হতে পারে। যদি Google Home Graph এর কোনো ডিভাইসে পরিবর্তনের অবস্থা থাকে, তাহলে এটিকে আবার রিপোর্ট করতে হবে।
প্রশ্ন: রিপোর্ট রাজ্যের জন্য কি টাইমস্ট্যাম্প পাঠানোর প্রয়োজন হয়?
উত্তর: আমাদের টাইমস্ট্যাম্পের প্রয়োজন নেই; প্রেরিত সর্বশেষ অবস্থা পূর্ববর্তী কল ওভাররাইড করবে।
প্রশ্ন: যদি আমি ইতিমধ্যেই ক্যোয়ারী এবং/অথবা এক্সিকিউটে স্টেট পাঠাচ্ছি তাহলে কি আমাকে আলাদাভাবে স্টেট রিপোর্ট করতে হবে?
উত্তর: Home Graph শুধুমাত্র সেই স্টেট সঞ্চয় করে যা Report State মাধ্যমে পাঠানো হয়। যে অবস্থাটি EXECUTE এবং QUERY ইন্টেন্টের প্রতিক্রিয়া হিসাবে ফেরত দেওয়া হয় তা শুধুমাত্র ব্যবহারকারীর বক্তৃতা প্রতিক্রিয়াগুলির জন্য ব্যবহৃত হয় এবং সংরক্ষণ করা হয় না। ফলস্বরূপ, একটি EXECUTE বা QUERY অভিপ্রায়ের প্রতিক্রিয়া হিসাবে ডিভাইসের নতুন স্থিতিটি ফেরত দেওয়া হলেও Report State বলা উচিত৷
প্রশ্ন: প্রদত্ত সময়সীমার মধ্যে রিপোর্ট স্টেট সম্পূর্ণরূপে বাস্তবায়ন না করার ফলাফল কী?
উত্তর: এর ফলে ব্যবহারকারীর অভিজ্ঞতা খারাপ হবে, যেমন Google Home app (GHA) এবং ভিজ্যুয়াল সারফেসে। এর অর্থ হল অনেকগুলি QUERY ইন্টেন্ট রাজ্যের জন্য পোলে পাঠানো হবে এবং আমরা গ্যারান্টি দিতে পারি না যে এটি অংশীদার ক্লাউডে অতিরিক্ত লোডের সাথে কী মিলবে৷
প্রশ্ন: আমি কীভাবে আমাদের রিপোর্ট রাজ্য বাস্তবায়ন পরীক্ষা করতে পারি?
উত্তর: হোম গ্রাফ ভিউয়ার ব্যবহার করুন - একটি স্ব-পরিষেবা পরীক্ষার সরঞ্জাম যা আপনাকে Home Graph সঞ্চিত আপনার বর্তমান ডিভাইসের অবস্থা দেখায়।
প্রশ্ন: আমরা কি রিপোর্ট স্টেটের জন্য একটি এলোমেলো অনুরোধ আইডি ব্যবহার করতে পারি?
উত্তর: আমরা অংশীদারদের সুপারিশ করি যে তারা EXECUTE অনুরোধ থেকে প্রাপ্ত একই অনুরোধ আইডি ব্যবহার করবে যদি Report State EXECUTE অনুরোধ দ্বারা ট্রিগার হয়, অন্যথায় আপনি কেবল একটি এলোমেলো অনুরোধ আইডি ব্যবহার করতে পারেন।
প্রশ্ন: যদি একজন ব্যবহারকারীর একাধিক ডিভাইস থাকে এবং তাদের মধ্যে একটির অবস্থা পরিবর্তন হয়, তাহলে আমাদের কি সব ডিভাইসের সর্বশেষ অবস্থার প্রতিবেদন করতে হবে?
উত্তর: না। আপনাকে শুধুমাত্র সেই নির্দিষ্ট ডিভাইসের অবস্থা রিপোর্ট করতে হবে।
সর্বোত্তম অনুশীলন
প্রশ্ন: কি ধরনের বিলম্ব গ্রহণযোগ্য?
উত্তর: 200ms এর কম আদর্শ, 2-5s এর মধ্যে ঠিক আছে। আপনার লেটেন্সি 5 সেকেন্ডের কাছাকাছি হলে, আমাদের সাথে যোগাযোগ করুন।
প্রশ্ন: আমার ভয়েস-অ্যাক্টিভেটেড স্পিকার যখন অফলাইনে থাকে তখন আমি কীভাবে সঠিকভাবে প্রতিক্রিয়া জানাতে পারি?
উত্তর: অফলাইন ডিভাইসের জন্য অফলাইন অবস্থা ফেরত দিন। আমরা এই ত্রুটির জন্য TTS হিসাবে 'এখন উপলব্ধ নেই' ফেরত দিই। আরও তথ্যের জন্য, ত্রুটি এবং ব্যতিক্রম দেখুন।