সাধারণ
প্রশ্ন: কোথায় এবং কোন ভাষায় আমাদের অ্যাকশন অন Google পরিপূর্ণতা পরিকাঠামো বাস্তবায়ন করা উচিত?
উত্তর: যতক্ষণ না এটি আধুনিক 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 অনুরোধে সাড়া দিচ্ছেন।
প্রশ্ন: একটি "মুলতুবি" প্রতিক্রিয়া ঠিক আছে?
উত্তর: আমরা দৃঢ়ভাবে একটি সাফল্য/ব্যর্থ প্রতিক্রিয়া পছন্দ করব, মুলতুবি থাকার বিপরীতে, যদি আপনার ডিভাইসগুলি রিয়েল টাইমে উপলব্ধ থাকে। অনুগ্রহ করে যোগাযোগ করুন যদি আপনি মনে করেন যে আপনার একটি 'মুলতুবি' প্রতিক্রিয়া প্রয়োজন -- আমরা স্বীকার করি যে কিছু স্বল্প-শক্তি, নন-রিয়েল-টাইম ডিভাইসগুলির একটি মুলতুবি প্রতিক্রিয়া এবং অ্যাসিঙ্ক্রোনাস এক্সিকিউশন মডেলের প্রয়োজন হতে পারে৷
পরীক্ষা এবং জমা
প্রশ্নঃ আমরা কি স্টেজিং এনভি সেট আপ করতে পারি?
উত্তর: হ্যাঁ, অনুগ্রহ করে একটি পৃথক প্রকল্প তৈরি করুন এবং সেই প্রকল্পের জন্য সেটআপের মাধ্যমে চালান। আপনার উন্নয়ন প্রক্রিয়া এবং অবকাঠামোতে ম্যাপ করার জন্য যতগুলি প্রকল্প প্রয়োজন ততগুলি তৈরি করতে আপনাকে স্বাগত জানাই৷
প্রশ্ন: কত ঘন ঘন আমার খসড়া প্রকল্প আপডেট করতে হবে?
উত্তর: একটি খসড়া প্রকল্প প্রতি 3 দিনে রিফ্রেশ করা প্রয়োজন। 3 দিন পরে, পরীক্ষার এজেন্ট মোবাইল-হোমকন্ট্রোল সেটিংস থেকে অদৃশ্য হয়ে যাবে। আপনি যদি এটি চালান, Actions on Google Console আপনার প্রকল্পের জন্য টেস্ট ড্রাফট বোতামে ক্লিক করুন।
প্রশ্ন: আমি কি একবারে একাধিক ডিভাইসে পরীক্ষা করতে পারি?
উত্তর: Actions on Google একবারে শুধুমাত্র একটি "ডিভাইস-এ চেষ্টা করুন" AP সমর্থন করে৷ আপনি যদি প্রথমে "ap1" এ TEST DRAFT ব্যবহার করেন এবং ডিভাইস সিঙ্ক করেন, তাহলে (ap1 আনলিঙ্ক না করে) সরাসরি TEST DRAFT "ap2" চালান, "ap1" মোবাইল-হোমকন্ট্রোল-সেটিংস থেকে অদৃশ্য হয়ে যাবে৷ এটি সংশোধন করতে, আবার "ap1" এ TEST DRAFT চালান এবং আপনি সেটিংসে "ap1" আনলিঙ্ক করতে পারেন৷
মনে রাখবেন যে এই একক অ্যাকশন প্যাকেজটি ব্যবহারকারীর জন্য আপনার সমস্ত Google Assistant ডিভাইসে উপলব্ধ হবে -- উদাহরণস্বরূপ, আপনি ভয়েস-অ্যাক্টিভেটেড স্পিকার এবং Android উভয় ক্ষেত্রেই আপনার নতুন হার্ডওয়্যার ইন্টিগ্রেশন পরীক্ষা করতে পারেন।
প্রশ্ন: নাম বা উচ্চারণের কারণে আমার অ্যাকশন প্রজেক্ট জমা বাতিল করা হয়েছে, আমাকে কী পরিবর্তন করতে হবে?
উত্তর: আমরা নামের উচ্চারণ পরীক্ষা করি যাতে উচ্চারণ নামটি ভবিষ্যতে অন্য কোনো অ্যাকশন দ্বারা নেওয়া না হয় এবং এটি প্রদর্শন নামের সাথে মেলে (ভবিষ্যতে নাম নিবন্ধনকে প্রভাবিত করে এমন অমিল প্রতিরোধ করতে)।
একই নাম ব্যবহার করা চালিয়ে যেতে, Assistant স্পিচ টিমের ডিসপ্লে নাম যোগ করতে অনুগ্রহ করে সহায়তার সাথে যোগাযোগ করুন ।
প্রশ্ন: Google Home অ্যাপের হোম কন্ট্রোল বিভাগে আমার অ্যাকশন দেখা যাচ্ছে না, কী হচ্ছে?
উত্তর: সমস্যাটি নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:
- আপনি Actions Console আপনার প্রকল্পের জন্য টেস্ট ড্রাফট বোতামে ক্লিক করেননি।
- আপনি একবারে টেস্ট-অন-ডিভাইস-এ শুধুমাত্র একটি একক অ্যাকশন রাখতে পারেন।
- Actions Console , আপনার অ্যাকশন প্রকল্পের জন্য সিমুলেটর ট্যাবে যান এবং সক্রিয়/নিষ্ক্রিয় টগলটিকে নিষ্ক্রিয় এবং তারপরে আবার সক্রিয় করতে টগল করুন।
- যদি এটি একটি অ্যাকশন হয় যা আপনার সাথে শেয়ার করা হয়েছে, অনুগ্রহ করে নিশ্চিত করুন যে শেয়ার করার সমস্ত নির্দেশাবলী অনুসরণ করা হয়েছে।
- ডিভাইস-অন-টেস্টের মেয়াদ তিন দিন পরে শেষ হয়ে যায়। Actions Console আপনার প্রজেক্টের জন্য টেস্ট ড্রাফট বোতামে ক্লিক করুন।
প্রশ্ন: যখন আমি সিমুলেটরে "টক টু <my agent name> " টাইপ করি তখন কেন এটি আমাকে একটি ত্রুটি দেয়?
উত্তর: স্মার্ট হোম অ্যাকশন আহ্বানের নাম ব্যবহার করে না। সিমুলেটরে পরীক্ষা করার জন্য, আপনাকে অবশ্যই Google Home app (GHA) ইনস্টল করা Android বা iOS ফোনে অ্যাকাউন্ট লিঙ্কিংয়ের মাধ্যমে চালাতে হবে। অ্যাকাউন্ট লিঙ্কিং চালানোর আগে আপনার অ্যাকাউন্টের সাথে যুক্ত ডিভাইস থাকতে হবে।
প্রশ্ন: আমি যখন সিমুলেটর ব্যবহার করার চেষ্টা করি তখন কেন আমি ত্রুটি পাচ্ছি?
উত্তর: আপনি স্থাপন করা smart home অ্যাকশন পরীক্ষা করতে সিমুলেটর ব্যবহার করতে পারবেন না। আপনি যদি একটি হোম অটোমেশন প্রকল্পের জন্য সিমুলেটর ব্যবহার করতে চান যা উৎপাদনে আছে, তাহলে আপনাকে পরীক্ষার উদ্দেশ্যে একটি নতুন প্রকল্প তৈরি করতে হবে।
রিপোর্ট রাজ্য
প্রশ্নঃ রিপোর্ট স্টেট বাস্তবায়নের পূর্বশর্ত আছে কি?
উত্তর: প্রকল্পের স্মার্ট হোম API ব্যবহার করতে হবে, OAuth2 সমর্থন করতে হবে এবং রিপোর্ট করতে হবে এমন বৈশিষ্ট্য থাকতে হবে।
প্রশ্ন: একটি ডিভাইসে আমাদের কত ঘন ঘন স্টেট রিপোর্ট করতে হবে?
উত্তর: গুগল ট্রানজিশন এবং টার্মিনাল স্টেটে আগ্রহী, তবে, যদি অল্প সময়ের মধ্যে অনেকগুলি অবস্থার পরিবর্তন হয় (উদাহরণস্বরূপ, একজন ব্যবহারকারী এক মিনিটে তিনবার ফ্রিজ খোলে এবং বন্ধ করে বা একটি ম্লান স্লাইড করে) তাহলে আমরা শুধুমাত্র চূড়ান্ত অবস্থা রিপোর্ট করা প্রয়োজন.
প্রশ্ন: রিপোর্ট স্টেট কল করার সময় কি সম্পূর্ণ ডিভাইসের অবস্থা পাঠানো দরকার?
উত্তর: আংশিক অবস্থার আপডেটগুলি সমর্থিত নয়, তাই Report State কলে সবসময় আপডেট করা হয়েছে এমন একটি নির্দিষ্ট বৈশিষ্ট্যের সমস্ত ডেটা অন্তর্ভুক্ত করা উচিত। যদি দুটি বৈশিষ্ট্য একটি অসঙ্গতি তৈরি করে, তবে তাদের একসাথে রিপোর্ট করা উচিত।
প্রশ্ন: Google কি আমার ডিভাইসের অবস্থা জানতে প্রশ্ন করতে পারে (অর্থাৎ, ডিভাইসটি পোল)?
উত্তর: এটি একটি ফলব্যাক প্রক্রিয়া যা আমরা সুপারিশ করি না। যদি আমাদের সেই ব্যবহারকারীদের জন্য ঘন ঘন একটি ডিভাইসের ভোটদানে ফিরে যেতে হয়, তাহলে অতিরিক্ত লোড কী হবে তা আমরা গ্যারান্টি দিতে পারি না। প্রয়োজন নতুন চাক্ষুষ পৃষ্ঠ থেকে আসে. অজানা লোড সমস্যা ছাড়াও, এটি একটি অবনমিত ব্যবহারকারীর অভিজ্ঞতা হবে। আমরা মনে করি যে Report State প্ল্যাটফর্মের জন্য গুরুত্বপূর্ণ।
প্রশ্ন: কোন বৈশিষ্ট্যগুলি এই মুহূর্তে রিপোর্ট স্টেটকে সমর্থন করে?
উত্তর: সমস্ত পাবলিক বৈশিষ্ট্য যা রাজ্যের সাথে যুক্ত আছে তা সমর্থিত। ডিভাইসের অনলাইন অবস্থার কোনো পরিবর্তনও রিপোর্ট করা উচিত।
মনে রাখবেন যে দৃশ্যের কোনো অবস্থা নেই। যাইহোক, এর ফলে ডিভাইস(গুলি) এর অবস্থার পরিবর্তন হতে পারে। যদি Google Home Graph এর কোনো ডিভাইসে পরিবর্তনের অবস্থা থাকে, তাহলে এটিকে আবার রিপোর্ট করতে হবে।
প্রশ্ন: রিপোর্ট রাজ্যের জন্য কি টাইমস্ট্যাম্প পাঠানোর প্রয়োজন হয়?
উত্তর: আমাদের টাইমস্ট্যাম্পের প্রয়োজন নেই; প্রেরিত সর্বশেষ অবস্থা পূর্ববর্তী কল ওভাররাইড করবে।
প্রশ্ন: যদি আমি ইতিমধ্যেই ক্যোয়ারী এবং/অথবা এক্সিকিউটে স্টেট পাঠাচ্ছি তাহলে কি আমাকে আলাদাভাবে স্টেট রিপোর্ট করতে হবে?
উত্তর: Home Graph শুধুমাত্র সেই স্টেট সঞ্চয় করে যা Report State মাধ্যমে পাঠানো হয়। যে অবস্থাটি EXECUTE এবং QUERY ইন্টেন্টের প্রতিক্রিয়া হিসাবে ফেরত দেওয়া হয় তা শুধুমাত্র ব্যবহারকারীর বক্তৃতা প্রতিক্রিয়াগুলির জন্য ব্যবহৃত হয় এবং সংরক্ষণ করা হয় না। ফলস্বরূপ, একটি EXECUTE বা QUERY অভিপ্রায়ের প্রতিক্রিয়া হিসাবে ডিভাইসের নতুন স্থিতিটি ফেরত দেওয়া হলেও Report State বলা উচিত৷
প্রশ্ন: প্রদত্ত সময়সীমার মধ্যে রিপোর্ট স্টেট সম্পূর্ণরূপে বাস্তবায়ন না করার ফলাফল কী?
উত্তর: এর ফলে ব্যবহারকারীর অভিজ্ঞতা খারাপ হবে, উদাহরণস্বরূপ GHA এবং ভিজ্যুয়াল সারফেসে। এর অর্থ হল অনেকগুলি QUERY ইন্টেন্ট রাজ্যের জন্য পোলে পাঠানো হবে এবং আমরা গ্যারান্টি দিতে পারি না যে এটি অংশীদার ক্লাউডে অতিরিক্ত লোডের সাথে কী মিলবে৷
প্রশ্ন: আমি কীভাবে আমাদের রিপোর্ট রাজ্য বাস্তবায়ন পরীক্ষা করতে পারি?
উত্তর: হোম গ্রাফ ভিউয়ার ব্যবহার করুন - একটি স্ব-পরিষেবা পরীক্ষার সরঞ্জাম যা আপনাকে Home Graph সঞ্চিত আপনার বর্তমান ডিভাইসের অবস্থা দেখায়।
প্রশ্ন: আমরা কি রিপোর্ট স্টেটের জন্য একটি এলোমেলো অনুরোধ আইডি ব্যবহার করতে পারি?
উত্তর: আমরা অংশীদারদের সুপারিশ করি যে তারা EXECUTE অনুরোধ থেকে প্রাপ্ত একই অনুরোধ আইডি ব্যবহার করবে যদি Report State EXECUTE অনুরোধ দ্বারা ট্রিগার হয়, অন্যথায় আপনি কেবল একটি এলোমেলো অনুরোধ আইডি ব্যবহার করতে পারেন।
প্রশ্ন: যদি একজন ব্যবহারকারীর একাধিক ডিভাইস থাকে এবং তাদের মধ্যে একটির অবস্থা পরিবর্তন হয়, তাহলে আমাদের কি সব ডিভাইসের সর্বশেষ অবস্থার প্রতিবেদন করতে হবে?
উত্তর: না। আপনাকে শুধুমাত্র সেই নির্দিষ্ট ডিভাইসের অবস্থা রিপোর্ট করতে হবে।
সেরা অনুশীলন
প্রশ্ন: কি ধরনের বিলম্ব গ্রহণযোগ্য?
উত্তর: 200ms এর কম আদর্শ, 2-5s এর মধ্যে ঠিক আছে। আপনার লেটেন্সি 5 সেকেন্ডের কাছাকাছি হলে, আমাদের সাথে যোগাযোগ করুন।
প্রশ্ন: আমার ভয়েস-অ্যাক্টিভেটেড স্পিকার যখন অফলাইনে থাকে তখন আমি কীভাবে সঠিকভাবে প্রতিক্রিয়া জানাতে পারি?
উত্তর: অফলাইন ডিভাইসের জন্য অফলাইন অবস্থা ফেরত দিন। আমরা এই ত্রুটির জন্য TTS হিসাবে 'এখন উপলব্ধ নেই' ফেরত দিই। আরও তথ্যের জন্য, ত্রুটি এবং ব্যতিক্রম দেখুন।