Android Studio-র জন্য Google Home প্লাগ-ইন

Matter ; Home APIs

Google Home Plugin for Android Studio Google Home Platform ডেভেলপারদের জন্য ডিজাইন ও তৈরি করা হয়েছে। এই প্লাগ-ইন আপনাকে Google Assistant Simulator, ক্লাউড লগিং এবং অন্যান্য টুলে অ্যাক্সেস দেয়, যাতে আপনার স্মার্ট হোম ডেভেলপমেন্ট প্রসেস সহজ হয়।

নিরাপত্তা সংক্রান্ত বিজ্ঞপ্তি

Android Studio-কে সিক্রেট ও পাসওয়ার্ড সেভ করা থেকে আটকাতে, নিম্নলিখিত ধাপগুলি সম্পূর্ণ করুন:

1. ফাইল, তারপর সেটিংস... বিকল্পে ক্লিক করুন।
2. দেখার ধরন ও আচরণ বিকল্পে গিয়ে সিস্টেম সেটিংস বিকল্পটি বড় করুন, তারপর পাসওয়ার্ড বিকল্পে ক্লিক করুন।
3. সেভ করবেন না, রিস্টার্ট করার পরে পাসওয়ার্ড ভুলে যান বিকল্প বেছে নিন।

ফিচার

Assistant Simulator

আপনার স্মার্ট হোম ডিভাইস Google Home ইকোসিস্টেমের সাথে সঠিকভাবে কাজ করে কিনা তা পরীক্ষা করে দেখতে, আপনি Android Studio ছেড়ে না গিয়ে যেকোনও সময় Assistant Simulator-এর সাথে ইন্টার‍্যাক্ট করতে পারেন।

Assistant Simulator আপনাকে কোয়েরি টাইপ করে সহজেই ডিভাইস কন্ট্রোল করতে দেয়, যেমন, "লাইট জ্বালিয়ে দাও।" Android Studio-এর মধ্যে, Assistant Simulator আপনার কমান্ডের উপর ভিত্তি করে টেক্সট মেসেজের মাধ্যমে উত্তর দেয়, যেমন, "ঠিক আছে, আলো জ্বালানো হচ্ছে।"

Cloud Logging দেখা

Google Cloud Logging আপনার অ্যাকশনের ব্যবহার সম্পর্কে ইনসাইট দিতে, এটি ডিবাগিং সংক্রান্ত তথ্য ও গুরুত্বপূর্ণ মেট্রিক প্রদান করে। ডেভেলপমেন্ট সহজ করতে, Google Home Plugin সমস্যা সমাধান করার সময় আপনার কোডের ঠিক পাশে রিয়েল-টাইম Cloud Logging মেসেজ দেখায়।

আপনি রিয়েল-টাইম লগ দেখাতে বা তারিখের একটি রেঞ্জ বেছে নিতে পারবেন।

ব্যাচ করা উত্তর

Assistant Simulator একটি সিঙ্গেল বাক্যাংশের উত্তর নির্ধারিত নয়। যেমন, উত্তরে নিম্নলিখিত বাক্যাংশগুলির মধ্যে যেকোনও একটি থাকতে পারে:

• বুঝেছি, ২টি লাইট চালু করছি।
• অবশ্যই, ২টি লাইট চালু করছি।
• বুঝেছি, ২টি লাইট চালু করছি।
• ঠিক আছে, ২টি লাইট চালু করছি।

অটোমেটিক পরীক্ষা চালাতে এবং আপনার Google ইন্টিগ্রেশন কীভাবে এইসব বিভিন্ন উত্তরের সাথে কাজ করে তা যাচাই করতে, আপনি Assistant Simulator-এ উচ্চারণ স্ক্রিপ্ট চালিয়ে ব্যাচ উচ্চারণ পাঠাতে পারেন। স্ক্রিপ্ট সেভ করা হয়ে গেলে, আপনি উত্তর সংগ্রহ করতে এবং কোয়েরির বিরুদ্ধে একাধিক পরীক্ষা চালাতে পারবেন।

Home Graph ভিউয়ার

হোম গ্রাফ ভিউয়ার আপনাকে ডিভাইসের স্ট্যাটাস দেখতে এবং আপনার ব্রাউজারে Google Home টেস্ট স্যুট লঞ্চ করতে দেয়।

Android ডিবাগ ব্রিজ (adb) লগ ভিউয়ার

adb লগ ভিউয়ার হল লগ ফাইল দেখার ও বিশ্লেষণ করার একটি টুল, যেমন Matter ডিভাইস লগ ফাইল, Google Home লগ ও Android লগ।

ইনস্টল করুন

Google Home Plugin-এ Android Studio ইনস্টল করতে, এইসব ধাপ অনুসরণ করুন:

1. Android Studio ডাউনলোড বা আপডেট করুন। Android Studio ডাউনলোড করুন
2. ফাইল > সেটিংস (Android Studio > MacOS-এ পছন্দ) বিকল্পে যান।
3. প্লাগ-ইন বিভাগে, মার্কেটপ্লেস বিকল্পে যান এবং google home সার্চ করুন।
4. টুল ইনস্টল করে Android Studio রিস্টার্ট করুন।

এছাড়াও, আপনি সরাসরি JetBrains মার্কেটপ্লেস থেকে প্লাগ-ইন ডাউনলোড করতে পারবেন।

সেট-আপ করুন

আপনি প্লাগ-ইন ইনস্টল করার পরে, Assistant Simulator ব্যবহার করতে এবং Cloud Logging দেখতে আপনাকে নিম্নলিখিত ধাপগুলি সম্পূর্ণ করতে হবে:

• Google-এর মাধ্যমে সাইন-ইন করুন
• ক্লাউড প্রোজেক্ট বেছে নিন

Google-এর মাধ্যমে সাইন-ইন করুন

আপনি Google Home প্যানেল থেকে নিজের ডেভেলপার অ্যাকাউন্টে সাইন-ইন করতে পারবেন, এর ফলে Android Studio আপনার হয়ে Google পরিষেবার সাথে যোগাযোগ করার অনুমতি পায়।

1. Android Studio উইন্ডোর বাঁদিকে থাকা উল্লম্ব ট্যাব কলামে Google Home ট্যাবে ক্লিক করুন।

2. এর মাধ্যমে সাইন-ইন করতে, আপনার ব্রাউজার লঞ্চ করতে Google বিকল্পে ক্লিক করুন।

   

3. আপনার স্মার্ট হোম ডিভাইসের সাথে লিঙ্ক করা অ্যাকাউন্টটি বেছে নিন।

4. Google-এর মাধ্যমে সাইন-ইন করুন অনুমোদন পৃষ্ঠায়, অনুমতি দিন বিকল্পে ক্লিক করুন।

5. ব্রাউজার উইন্ডো বন্ধ করে Android Studio-এ ফিরে যান।

আপনি এখন লগ-ইন করে থাকবেন এবং সাইন-আউট করার বিকল্প দেখতে পাবেন।

ক্লাউড প্রোজেক্ট বেছে নিন

সাইন-ইন করার পরে, ড্রপডাউন থেকে একটি প্রোজেক্ট বেছে নিন। আপনার প্রোজেক্ট তালিকা ফিল্টার করতে, একটি ফিল্টার এক্সপ্রেশন টাইপ করুন, যেমন matter, তারপর Enter প্রেস করুন।

প্রোজেক্ট ড্রপডাউন আপনার ফিল্টার অনুযায়ী প্রথম ১০০টি প্রোজেক্ট লোড করে। আপনি Android Studio থেকে বেরিয়ে গেলেও আপনার বেছে নেওয়া বিকল্প সেভ করা থাকে।

প্রোজেক্ট ফিল্টার সংক্রান্ত সাহায্যের জন্য, Google Cloud রেফারেন্সে কোয়েরি প্যারামিটার দেখুন।

Assistant Simulator ব্যবহার করা

Android Studio-এ Assistant Simulator খুলতে, Google Home Plugin প্যানেল থেকে উচ্চারণ প্যানেল বিকল্পে ক্লিক করুন।

Assistant Simulator-এ কোয়েরি পাঠানোর বিভিন্ন উপায় আছে। এরপরে, আমরা প্রতিটি বিকল্পের ব্যাপারে আলোচনা করব।

কোয়েরি টাইপ করা ও উত্তর সংগ্রহ করা

Assistant Simulator-এর সাথে ইন্টার‍্যাক্ট করতে, আপনার কোয়েরি টাইপ করে Enter কী প্রেস করুন।

আপনার কোয়েরির শেষে cached আবার পাঠান আইকনে ক্লিক করে কোয়েরি আবার পাঠাতে পারবেন।

এক বা একাধিক কোয়েরি জমা দেওয়ার পরে, আপনার কোয়েরি আবার রান করাতে এবং আপনার উত্তর চেক করতে, cached আবার চালান বিকল্পে ক্লিক করুন। উচ্চারণ প্যানেল আপনার কোয়েরি ও উত্তর স্টোর করা ক্যাশে ট্র্যাক করে। আবার চালান বিকল্পটি শুধুমাত্র এই ইন্টার্নাল ক্যাশে নতুন উত্তর যোগ করে এবং আপনি যতবারই বোতামে ক্লিক করুন না কেন, আপনার কোয়েরি ডুপ্লিকেট করবে না।

উচ্চারণ প্যানেলে আপনার লেখা কোয়েরি ও উত্তর সেভ করতে save সেভ করুন বিকল্পে ক্লিক করুন। আপনার ইন্টার‍্যাকশনকে নিম্নলিখিত ফর্ম্যাটে JSON-এ কনভার্ট করা হয়:

• ask: আপনার কোয়েরি।
• answers: সম্ভাব্য Assistant Simulator উত্তরের একটি অ্যারে।

আপনি Android Studio-এ এই JSON ফাইল এডিট করতে পারবেন।

{
  "collected": false,
  "lines": [
    {
      "ask": "turn lights on",
      "answers": [
        "OK, turning 2 lights on.",
        "Sure, turning on 2 lights."
      ]
    }
  ]
}

ব্যাচ উত্তর সংগ্রহ করা

Google Home Plugin প্যানেল থেকে, উচ্চারণ ফাইল বিকল্পে ক্লিক করে নতুন ট্যাবে আপনার সেভ করা JSON ফাইল খুলুন। পাথ বেছে নিন বিকল্পের জন্য, আপনি কোনও ফাইল বা ফোল্ডার বেছে নিতে পারবেন। আপনি কোনও ফোল্ডার বেছে নিলে, সংগ্রহ করুন ও পরীক্ষা করুন বিকল্প সেই ফোল্ডারের সবকটি উচ্চারণ .json ফাইলের উপর কাজ করবে।

আপনি একই ফাইল বা আলাদা ফাইলের জন্য একাধিক ট্যাব খুলতে পারবেন, যেমন lights, lights(1) ও plug।

স্ট্যাটাস বার আপনার শেষ পরীক্ষার ফলাফল (প্রযোজ্য হলে), ফাইল সংগ্রহ করা হয়েছে কিনা তা বোঝাতে হলুদ বা সবুজ বিন্দু এবং উচ্চারণ .json ফাইলের পাথ দেখায়। আপনি tocসংগ্রহ করুন বিকল্পে ক্লিক করার পরে, Assistant Simulator আপনার কোয়েরি রান করে। নতুন উত্তর সংগ্রহ করা হলে আপনাকে বিজ্ঞপ্তি পাঠানো হবে এবং আপনার কোয়েরি প্রসেস করার সময় স্ট্যাটাস বার একটি কাউন্টার দেখাবে।

সংগ্রহ করা সম্পূর্ণ হলে, আপনার .json পাথের আগে একটি সবুজ চেকমার্ক সহ স্ট্যাটাস বার আপডেট হয় এবং আপনার উচ্চারণ ফাইলগুলি সম্ভাব্য উত্তর দিয়ে পূরণ করা হয়।

{
  "collected": true,
  "lines": [
    {
      "ask": "turn lights on",
      "answers": [
        "OK, turning 2 lights on.",
        "Sure, turning on 2 lights.",
        "Sure, turning 2 lights on.",
        "Got it, turning 2 lights on.",
        "Alright, turning on 2 lights.",
        "OK, turning on 2 lights.",
        "Got it, turning on 2 lights.",
        "Alright, turning 2 lights on."
      ]
    }
  ]
}

আপনি যদি ডেটা সংগ্রহ করার প্রসেসটি নির্ধারিত সময়ের আগে বন্ধ করে দেন, তাহলে আপনার .json পাথকে সংগ্রহ করা হয়েছে হিসেবে চিহ্নিত করা হবে না।

টেস্ট ব্যাচ উচ্চারণ

উত্তর সংগ্রহ করা হয়ে গেলে, আপনার কোয়েরি আবার চালানোর জন্য switch_left পরীক্ষা করুন বিকল্পে ক্লিক করুন এবং আপনার উত্তর ও লগ চেক করুন। আপনি ব্যাচ উচ্চারণ পরীক্ষা করার সময়, Assistant Simulator আপনার JSON ফাইলে সেভ করা উত্তরগুলি প্রত্যাশা করে। আপনার টেস্টে যদি এমন কোনও উত্তর আসে যা সংগ্রহ করা হয়নি, তাহলে আপনি নিম্নলিখিত উত্তরের মতো একটি বিজ্ঞপ্তি পাবেন:

error Expected one of: "Got it, turning on 2 lights."

এই পরিস্থিতি থেকে বোঝা যায় যে পরীক্ষাটি সফল হয়নি। অন্যথায়, Assistant Simulator আপনার প্রতিটি কোয়েরি চালাবে এবং উত্তর দেবে। পরীক্ষা সফল হলে, স্ট্যাটাস বারে একটি check টিকচিহ্ন দেখা যাবে।

Cloud Logging দেখা

Cloud Logs টুল উইন্ডোতে কোনও প্রোজেক্ট ট্যাব খুলতে, Google Home Plugin প্যানেল থেকে Cloud Logs বিকল্পে ক্লিক করুন। আপনার প্রতিটি প্রোজেক্টের জন্য আলাদা আলাদা ক্লাউড লগ ট্যাব খুলতে পারবেন।

কোয়েরি করা শব্দ

আপনার বেছে নেওয়া প্রোজেক্টের জন্য, আপনি কোয়েরি ফিল্ড ব্যবহার করে লগ ফিল্টার করতে পারবেন। যেমন, light কীওয়ার্ডের জন্য লগ ফিল্টার করতে:

লগিং কোয়েরি ল্যাঙ্গুয়েজ ব্যবহার করতে QL ব্যবহার করুন বিকল্প বেছে নিন।

আপনাকে শুরু করতে সাহায্য করার জন্য এখানে QL কোয়েরির কয়েকটি উদাহরণ দেওয়া হল:

severity = (DEBUG OR INFO OR NOTICE OR WARNING OR ERROR OR CRITICAL OR ALERT OR EMERGENCY) AND resource.type="assistant_action_project" AND timestamp > "2022-04-07T00:40:18Z"

jsonPayload.executionLog.executionResults.actionResults.action.trait = "TRAIT_ON_OFF"

jsonPayload.executionLog.executionResults.actionResults.action.actionType = "ONOFF_ON"

তারিখ ও সময় সংক্রান্ত কোয়েরি

তারিখ অনুযায়ী লগ কোয়েরি করাও ঐচ্ছিক এবং পরে ও আগে বিকল্পে ক্লিক করে এটি চালু করা যেতে পারে। প্রদত্ত টেক্সট ফিল্ডে আপনার তারিখ ও সময়ের ফর্ম্যাট লিখতে পারেন, যেমন 5/11/22, 12:37 PM অথবা তারিখ বেছে নিতে তারিখ বাছাইকারী calendar_month ব্যবহার করতে পারেন, তারপর টেক্সট ফিল্ডে সময় লিখুন।

• 5/1/22-এর পরের কোনও তারিখ বেছে নিতে, পরে বিকল্প বেছে নিয়ে তারিখের আইকনে ক্লিক করুন calendar_month।
• 5/1/22-এর আগের কোনও তারিখ বেছে নিতে, আগে বিকল্প বেছে নিন এবং তারিখের আইকনে calendar_month ক্লিক করুন।
• 5/1/22 ও 6/30/22-এর মধ্যে কোনও তারিখ বেছে নিতে, আগে ও পরে বিকল্প বেছে নিন এবং তারিখ আইকন থেকে আপনার তারিখ বেছে নিন calendar_month।

লাইভ প্রজেক্ট লগ পেতে রিয়েল টাইম বিকল্প বেছে নিন। রিয়েল-টাইম ফিড বন্ধ করতে বন্ধ করুন বিকল্পে ক্লিক করুন।

গুরুতরতার লেভেল

এছাড়াও, আপনি ড্রপডাউন থেকে ন্যূনতম গুরুতর বেছে নিতে পারেন।

কোয়েরির ফলাফল

আপনার কোয়েরি প্যারামিটার জমা দিতে cached ফেচ করুন বিকল্পে ক্লিক করুন।

লগ লোড হয়ে গেলে, যেকোনও রেকর্ড chevron_right-এ ক্লিক করে সম্পূর্ণ JSON পেলোড বড় করে দেখুন। সম্পূর্ণ মেসেজ দেখতে আবার chevron_left ক্লিক করুন।

ঐচ্ছিকভাবে, আপনার লগ ফলাফল আরও নির্দিষ্ট করতে, ফিল্টার বক্সে কোনও কীওয়ার্ড টাইপ করতে পারেন। আপনার ফিল্টার সরিয়ে দিতে এবং আসল ফলাফলে ফিরে যেতে x আইকনে ক্লিক করুন।

হোম গ্রাফ দেখা ও টেস্ট চালানো

আপনার ডিভাইস তালিকাভুক্ত করতে, Google Home Plugin প্যানেল থেকে Home Graph বিকল্প বেছে নিন।

বেছে নেওয়া প্রোজেক্টের সাথে যুক্ত আপনার ডিভাইসের ডিভাইসের নাম, ডিভাইস আইডি ও ডিভাইসের ধরন দেখতে cached রিফ্রেশ করুন বিকল্পে ক্লিক করুন। আলাদা আলাদা প্রোজেক্টের জন্য আপনি একাধিক Google Home Graph প্যানেল খুলে রাখতে পারেন।

আপনার ডিভাইস লোড হয়ে গেলে, যেকোনও রেকর্ড chevron_right-এ ক্লিক করে সম্পূর্ণ JSON পেলোড দেখুন।

এছাড়াও, আপনার ডিভাইসের জন্য JSON পে-লোড দেখাতে ও লুকাতে বড় করুন ও ছোট করুন বিকল্প ব্যবহার করতে পারবেন।

নির্দিষ্ট ডিভাইসের জন্য টেস্ট স্যুট লঞ্চ করতে, টেস্ট করুন বিকল্পে ক্লিক করুন। এটি আপনার ব্রাউজারে টেস্ট স্যুট লঞ্চ করে, যেখানে আপনার বেছে নেওয়া ডিভাইসটি পরীক্ষা করার জন্য রেডি থাকে। শুরু করুন বিকল্পে ক্লিক করুন এবং পরীক্ষার ফলাফলের জন্য অপেক্ষা করুন।

পরীক্ষা সম্পূর্ণ হয়ে গেলে আপনি পরীক্ষার বিবরণ চেক করতে এবং লগ দেখতে পারবেন।

Android ডিবাগ ব্রিজ (adb) লগ ভিউয়ার

Adb Log টুল উইন্ডোতে কোনও প্রোজেক্ট ট্যাব খুলতে, Google Home প্লাগ-ইন টুলবারে (বাঁদিকে) Adb Log কমান্ডে ক্লিক করুন । আপনার প্রতিটি লগ ফাইলের জন্য আলাদা আলাদা Adb Log ট্যাব খুলতে পারবেন। ট্যাব মুছে দিতে, clear আইকনে ক্লিক করুন।

দেখার জন্য নির্দিষ্ট লগিং কম্পোনেন্ট বেছে নিতে বেছে নিন ফিল্ড ব্যবহার করুন এবং ম্যাচ করা লগ তীব্রতা সহ এন্ট্রি শুধুমাত্র দেখাতে তীব্রতা ড্রপ-ডাউন ব্যবহার করুন।

আপনার বেছে নেওয়া adb লগ থেকে, ঐচ্ছিক কেস-সংবেদনশীল বা রেজেক্স মডিফায়ার সহ ফিল্টার ফিল্ড ব্যবহার করে লগ এন্ট্রি ফিল্টার করতে পারবেন।

এছাড়াও, আপনি:

• খুঁজুন ফিল্ড এবং পরবর্তীটি খুঁজুন (arrow_downward আইকন) ও আগেরটি খুঁজুন (arrow_upward আইকন) কমান্ড ব্যবহার করে নির্দিষ্ট এন্ট্রি খুঁজুন।
• ঐচ্ছিক কেস-সংবেদনশীল বা রেজেক্স মডিফায়ার ব্যবহার করুন।
• লগে নির্দিষ্ট লাইনে (নম্বর অনুযায়ী) যেতে লাইনে যান বিকল্প ব্যবহার করুন।

লাইন নম্বর যোগ করা লগ লাইন দেখতে নম্বর করা বিকল্প বেছে নিন। লগ এন্ট্রি দেখতে Raw বিকল্প বেছে নিন।

রিসোর্স ও মতামত

ডেভেলপার টুল ও রিসোর্সের তালিকা দেখতে রিসোর্স বিকল্পে ক্লিক করুন।

Google Home Plugin-এর মাধ্যমে ডেভেলপমেন্ট অভিজ্ঞতা কীভাবে উন্নত করা যায় সেই বিষয়ে আপনার মতামত বা ফিডব্যাক জমা দিতে, ফিডব্যাক বিকল্পে ক্লিক করুন।