কীভাবে স্মার্ট হোম অ্যাকশন তৈরি করতে হয় তা শেখার নতুন গন্তব্য Google হোম ডেভেলপার সেন্টারে স্বাগতম। দ্রষ্টব্য: আপনি অ্যাকশন কনসোলে নির্মাণ কাজ চালিয়ে যাবেন।

Google Assistant-এর সাথে স্মার্ট হোম ডিভাইসগুলি কানেক্ট করুন

সেভ করা পৃষ্ঠা গুছিয়ে রাখতে 'সংগ্রহ' ব্যবহার করুন আপনার পছন্দ অনুযায়ী কন্টেন্ট সেভ করুন ও সঠিক বিভাগে রাখুন।

1. আপনি শুরু করার আগে

ইন্টারনেট অফ থিংস (IoT) বিকাশকারী হিসাবে, আপনি স্মার্ট হোম অ্যাকশন তৈরি করতে পারেন যা আপনার ব্যবহারকারীদের Google Home অ্যাপে টাচ কন্ট্রোল এবং অ্যাসিস্ট্যান্টের সাথে ভয়েস কমান্ডের মাধ্যমে তাদের ডিভাইসগুলি নিয়ন্ত্রণ করার ক্ষমতা দেয়।

79266e5f45e6ae20.gif

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

d009cef0f903d284.jpeg

পূর্বশর্ত

আপনি কি নির্মাণ করবেন

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

আপনি কি শিখবেন

  • কীভাবে একটি স্মার্ট হোম ক্লাউড পরিষেবা স্থাপন করবেন
  • অ্যাসিস্ট্যান্টের সাথে আপনার পরিষেবা কীভাবে সংযুক্ত করবেন
  • Google-এ ডিভাইসের অবস্থার পরিবর্তন কীভাবে প্রকাশ করবেন

আপনি কি প্রয়োজন হবে

2. শুরু করা

কার্যকলাপ নিয়ন্ত্রণ সক্ষম করুন

Google অ্যাসিস্ট্যান্ট ব্যবহার করার জন্য, আপনাকে অবশ্যই নির্দিষ্ট কার্যকলাপের ডেটা Google-এর সাথে শেয়ার করতে হবে। Google সহকারীর সঠিকভাবে কাজ করার জন্য এই ডেটা প্রয়োজন; যাইহোক, ডেটা শেয়ার করার প্রয়োজনীয়তা SDK-এর জন্য নির্দিষ্ট নয়। এই ডেটা ভাগ করতে, আপনার যদি আগে থেকে না থাকে তবে একটি Google অ্যাকাউন্ট তৈরি করুন৷ আপনি যেকোনো Google অ্যাকাউন্ট ব্যবহার করতে পারেন—এটি আপনার ডেভেলপার অ্যাকাউন্ট হতে হবে না।

আপনি সহকারীর সাথে যে Google অ্যাকাউন্টটি ব্যবহার করতে চান তার জন্য কার্যকলাপ নিয়ন্ত্রণ পৃষ্ঠাটি খুলুন।

নিম্নলিখিত টগল সুইচগুলি সক্ষম করা হয়েছে তা নিশ্চিত করুন:

  • ওয়েব ও অ্যাপ অ্যাক্টিভিটি - উপরন্তু, Google পরিষেবা ব্যবহার করে এমন সাইট, অ্যাপ এবং ডিভাইস থেকে Chrome ইতিহাস এবং কার্যকলাপ অন্তর্ভুক্ত করুন চেকবক্স নির্বাচন করতে ভুলবেন না।
  • যন্ত্রের তথ্য
  • ভয়েস এবং অডিও কার্যকলাপ

একটি অ্যাকশন প্রকল্প তৈরি করুন

  1. Google ডেভেলপার কনসোলে অ্যাকশনে যান।
  2. নতুন প্রকল্পে ক্লিক করুন, প্রকল্পের জন্য একটি নাম লিখুন এবং প্রকল্প তৈরি করুন ক্লিক করুন।

3d6b68ca79afd54c.png

স্মার্ট হোম অ্যাপটি নির্বাচন করুন

অ্যাকশন কনসোলের ওভারভিউ স্ক্রিনে , স্মার্ট হোম নির্বাচন করুন।

2fa4988f44f8914b.png

স্মার্ট হোম এক্সপেরিয়েন্স কার্ডটি বেছে নিন, স্টার্ট বিল্ডিং এ ক্লিক করুন এবং তারপরে আপনাকে আপনার প্রোজেক্ট কনসোলে নিয়ে যাওয়া হবে।

Firebase CLI ইনস্টল করুন

Firebase কমান্ড লাইন ইন্টারফেস (CLI) আপনাকে স্থানীয়ভাবে আপনার ওয়েব অ্যাপ পরিবেশন করতে এবং Firebase হোস্টিং-এ আপনার ওয়েব অ্যাপ স্থাপন করার অনুমতি দেবে।

CLI ইনস্টল করতে, টার্মিনাল থেকে নিম্নলিখিত npm কমান্ডটি চালান:

npm install -g firebase-tools

CLI সঠিকভাবে ইনস্টল করা হয়েছে তা যাচাই করতে, চালান:

firebase --version

চালিয়ে আপনার Google অ্যাকাউন্ট দিয়ে Firebase CLI অনুমোদন করুন:

firebase login

3. স্টার্টার অ্যাপ চালান

এখন আপনি আপনার ডেভেলপমেন্ট এনভায়রনমেন্ট সেট আপ করেছেন, আপনি সবকিছু সঠিকভাবে কনফিগার করা আছে কিনা তা যাচাই করতে স্টার্টার প্রজেক্ট স্থাপন করতে পারেন।

সোর্স কোড পান

আপনার ডেভেলপমেন্ট মেশিনে এই কোডল্যাবের নমুনা ডাউনলোড করতে নিম্নলিখিত লিঙ্কে ক্লিক করুন:

...অথবা আপনি কমান্ড লাইন থেকে GitHub সংগ্রহস্থল ক্লোন করতে পারেন:

git clone https://github.com/googlecodelabs/smarthome-washer.git

প্রকল্প সম্পর্কে

স্টার্টার প্রকল্পে নিম্নলিখিত সাবডিরেক্টরি রয়েছে:

  • public: স্মার্ট ওয়াশারের অবস্থা সহজেই নিয়ন্ত্রণ ও নিরীক্ষণ করার জন্য একটি ফ্রন্টএন্ড UI।
  • functions: একটি সম্পূর্ণরূপে বাস্তবায়িত ক্লাউড পরিষেবা যা ফায়ারবেস এবং ফায়ারবেস রিয়েলটাইম ডেটাবেসের জন্য ক্লাউড ফাংশনগুলির সাথে স্মার্ট ওয়াশার পরিচালনা করে৷

ফায়ারবেসের সাথে সংযোগ করুন

washer-start ডিরেক্টরিতে নেভিগেট করুন, তারপর আপনার অ্যাকশন প্রকল্পের সাথে Firebase CLI সেট আপ করুন:

cd washer-start
firebase use <project-id>

Firebase প্রকল্প কনফিগার করুন

একটি ফায়ারবেস প্রকল্প শুরু করুন।

firebase init

ডাটাবেস , ফাংশন এবং হোস্টিং CLI বৈশিষ্ট্য নির্বাচন করুন।

? Which Firebase CLI features do you want to set up for this folder? Press Space to select features, then
 Enter to confirm your choices. 
❯◉ Database: Configure Firebase Realtime Database and deploy rules
 ◯ Firestore: Deploy rules and create indexes for Firestore
 ◉ Functions: Configure and deploy Cloud Functions
 ◉ Hosting: Configure and deploy Firebase Hosting sites
 ◯ Storage: Deploy Cloud Storage security rules
 ◯ Emulators: Set up local emulators for Firebase features
 ◯ Remote Config: Get, deploy, and rollback configurations for Remote Config

এটি আপনার প্রকল্পের জন্য প্রয়োজনীয় API এবং বৈশিষ্ট্যগুলি শুরু করবে।

অনুরোধ করা হলে, রিয়েলটাইম ডেটাবেস আরম্ভ করুন। আপনি ডাটাবেস উদাহরণের জন্য ডিফল্ট অবস্থান ব্যবহার করতে পারেন।

? It seems like you haven't initialized Realtime Database in your project yet. Do you want to set it up? 
Yes

? Please choose the location for your default Realtime Database instance: us-central1

যেহেতু আপনি স্টার্টার প্রজেক্ট কোড ব্যবহার করছেন, নিরাপত্তা নিয়মের জন্য ডিফল্ট ফাইলটি বেছে নিন এবং নিশ্চিত করুন যে আপনি বিদ্যমান ডাটাবেস নিয়ম ফাইলটি ওভাররাইট করবেন না।

? What file should be used for Realtime Database Security Rules? Database.rules.json

? File database.rules.json already exists. Do you want to overwrite it with the Realtime Database Security Rules for <project-ID>-default-rtdb from the Firebase Console? 
No

একইভাবে, আপনার ফাংশনগুলি কনফিগার করার সময়, আপনার ডিফল্ট ফাইলগুলি ব্যবহার করা উচিত এবং নিশ্চিত করুন যে আপনি প্রকল্পের নমুনায় বিদ্যমান index.js এবং package.json ফাইলগুলিকে ওভাররাইট করবেন না।

? What language would you like to use to write Cloud Functions? 
JavaScript

? File functions/package.json already exists. Overwrite? 
No

? File functions/index.js already exists. Overwrite? 
No

? Do you want to install dependencies with npm now? 
Yes

অবশেষে, প্রোজেক্ট কোডে public ডিরেক্টরি ব্যবহার করতে আপনার হোস্টিং সেটআপ কনফিগার করুন এবং বিদ্যমান index.html ফাইলটি ব্যবহার করুন।

? What do you want to use as your public directory? 
public

? Configure as a single-page app (rewrite all urls to /index.html)? 
Yes

? File public/index.html already exists. Overwrite?
 No

ফায়ারবেসে স্থাপন করুন

functions ফোল্ডারে নেভিগেট করুন এবং npm.

cd functions
npm install

এখন আপনি নির্ভরতাগুলি ইনস্টল করেছেন এবং আপনার প্রকল্পটি কনফিগার করেছেন, আপনি প্রথমবারের জন্য অ্যাপটি চালানোর জন্য প্রস্তুত৷

firebase deploy

এটি হল কনসোল আউটপুট যা আপনাকে দেখতে হবে:

...

✔ Deploy complete!

Project Console: https://console.firebase.google.com/project/<project-id>/overview
Hosting URL: https://<project-id>.web.app

এই কমান্ডটি Firebase-এর জন্য বিভিন্ন ক্লাউড ফাংশন সহ একটি ওয়েব অ্যাপ স্থাপন করে।

ওয়েব অ্যাপটি দেখতে আপনার ব্রাউজারে হোস্টিং URL খুলুন ( https://<project-id>.web.app )। আপনি নিম্নলিখিত ইন্টারফেস দেখতে পাবেন:

5845443e94705557.png

এই ওয়েব UI ডিভাইসের অবস্থা দেখতে বা পরিবর্তন করার জন্য একটি তৃতীয় পক্ষের প্ল্যাটফর্মের প্রতিনিধিত্ব করে। ডিভাইসের তথ্য দিয়ে আপনার ডাটাবেস তৈরি করা শুরু করতে, আপডেট ক্লিক করুন। আপনি পৃষ্ঠায় কোনো পরিবর্তন দেখতে পাবেন না, তবে আপনার ওয়াশারের বর্তমান অবস্থা ডাটাবেসে সংরক্ষণ করা হবে।

অ্যাকশন কনসোল ব্যবহার করে Google অ্যাসিস্ট্যান্টের সাথে আপনি যে ক্লাউড পরিষেবাটি স্থাপন করেছেন সেটি সংযোগ করার এখন সময়।

আপনার অ্যাকশন কনসোল প্রকল্প কনফিগার করুন

ওভারভিউ > আপনার অ্যাকশন তৈরি করুন এর অধীনে, অ্যাকশন যোগ করুন নির্বাচন করুন। আপনার ক্লাউড ফাংশনের URL লিখুন যা স্মার্ট হোমের উদ্দেশ্য পূরণ করে এবং সংরক্ষণ করুন ক্লিক করুন।

https://us-central1-<project-id>.cloudfunctions.net/smarthome

9d7b223427f587ca.png

বিকাশ > আমন্ত্রণ ট্যাবে, আপনার কর্মের জন্য একটি প্রদর্শন নাম যোগ করুন এবং সংরক্ষণ করুন ক্লিক করুন। এই নামটি Google Home অ্যাপে দেখা যাবে।

774d0c40c351c7da.png

a8c4673eb11d76ee.png

অ্যাকাউন্ট লিঙ্কিং সক্ষম করতে, বাম নেভিগেশনে বিকাশ > অ্যাকাউন্ট লিঙ্কিং বিকল্পটি নির্বাচন করুন। এই অ্যাকাউন্ট লিঙ্কিং সেটিংস ব্যবহার করুন:

ক্লায়েন্ট আইডি

ABC123

ক্লায়েন্ট গোপন

DEF456

অনুমোদন URL

https://us-central1-
.cloudfunctions.net/fakeauth

টোকেন URL

https://us-central1-
.cloudfunctions.net/faketoken

9730d20b90bcc038.png

আপনার অ্যাকাউন্ট লিঙ্কিং কনফিগারেশন সংরক্ষণ করতে সংরক্ষণ করুন ক্লিক করুন, তারপর আপনার প্রকল্পে পরীক্ষা সক্ষম করতে পরীক্ষা ক্লিক করুন৷

ee0547f05b5efd98.png

আপনাকে সিমুলেটরে পুনঃনির্দেশিত করা হবে। আপনি যদি " Test now enabled " দেখতে না পান তবে টেস্টিং সক্ষম হয়েছে কিনা যাচাই করতে রিসেট টেস্ট ক্লিক করুন৷

d0495810dbadf059.png

এখন আপনি অ্যাসিস্ট্যান্টের সাথে ডিভাইসের অবস্থা কানেক্ট করার জন্য প্রয়োজনীয় ওয়েবহুক প্রয়োগ করা শুরু করতে পারেন।

4. একটি ধাবক তৈরি করুন

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

  • একটি SYNC অভিপ্রায় তখন ঘটে যখন সহকারী জানতে চায় ব্যবহারকারী কোন ডিভাইস কানেক্ট করেছে। ব্যবহারকারী একটি অ্যাকাউন্ট লিঙ্ক করলে এটি আপনার পরিষেবাতে পাঠানো হয়। আপনার সমস্ত ব্যবহারকারীর ডিভাইস এবং তাদের ক্ষমতাগুলির একটি JSON পেলোডের সাথে প্রতিক্রিয়া জানানো উচিত।
  • যখন সহকারী একটি ডিভাইসের বর্তমান অবস্থা বা স্থিতি জানতে চায় তখন একটি QUERY উদ্দেশ্য ঘটে। আপনাকে অনুরোধ করা প্রতিটি ডিভাইসের অবস্থার সাথে একটি JSON পেলোডের সাথে প্রতিক্রিয়া জানাতে হবে।
  • যখন সহকারী ব্যবহারকারীর পক্ষ থেকে একটি ডিভাইস নিয়ন্ত্রণ করতে চায় তখন একটি EXECUTE উদ্দেশ্য ঘটে। আপনাকে অনুরোধ করা প্রতিটি ডিভাইসের এক্সিকিউশন স্ট্যাটাস সহ একটি JSON পেলোড দিয়ে প্রতিক্রিয়া জানাতে হবে।
  • ব্যবহারকারী যখন অ্যাসিস্ট্যান্ট থেকে তাদের অ্যাকাউন্টটি আনলিঙ্ক করে তখন একটি DISCONNECT উদ্দেশ্য ঘটে। আপনার এই ব্যবহারকারীর ডিভাইসের জন্য সহকারীকে ইভেন্ট পাঠানো বন্ধ করা উচিত।

আপনি নিম্নলিখিত বিভাগে এই উদ্দেশ্যগুলি পরিচালনা করার জন্য পূর্বে মোতায়েন করা ফাংশনগুলি আপডেট করবেন৷

SYNC প্রতিক্রিয়া আপডেট করুন

functions/index.js খুলুন, যাতে সহকারীর অনুরোধের উত্তর দেওয়ার জন্য কোড থাকে।

আপনাকে ডিভাইসের মেটাডেটা এবং ক্ষমতা ফিরিয়ে দিয়ে একটি SYNC উদ্দেশ্য পরিচালনা করতে হবে। ডিভাইসের তথ্য এবং কাপড় ধোয়ার জন্য প্রস্তাবিত বৈশিষ্ট্য অন্তর্ভুক্ত করতে onSync অ্যারেতে JSON আপডেট করুন।

index.js

app.onSync((body) => {
  return {
    requestId: body.requestId,
    payload: {
      agentUserId: USER_ID,
      devices: [{
        id: 'washer',
        type: 'action.devices.types.WASHER',
        traits: [
          'action.devices.traits.OnOff',
          'action.devices.traits.StartStop',
          'action.devices.traits.RunCycle',
        ],
        name: {
          defaultNames: ['My Washer'],
          name: 'Washer',
          nicknames: ['Washer'],
        },
        deviceInfo: {
          manufacturer: 'Acme Co',
          model: 'acme-washer',
          hwVersion: '1.0',
          swVersion: '1.0.1',
        },
        willReportState: true,
        attributes: {
          pausable: true,
        },
      }],
    },
  };
});

ফায়ারবেসে স্থাপন করুন

Firebase CLI ব্যবহার করে আপডেট করা ক্লাউড পরিপূর্ণতা স্থাপন করুন:

firebase deploy --only functions

আপনার স্মার্ট হোম অ্যাকশন পরীক্ষা করার জন্য, আপনাকে একটি Google অ্যাকাউন্টের সাথে আপনার প্রোজেক্ট লিঙ্ক করতে হবে। এটি Google অ্যাসিস্ট্যান্ট সারফেস এবং একই অ্যাকাউন্টে সাইন-ইন করা Google Home অ্যাপের মাধ্যমে পরীক্ষা করতে সক্ষম করে।

  1. আপনার ফোনে, Google Assistant সেটিংস খুলুন। মনে রাখবেন যে আপনি কনসোলের মতো একই অ্যাকাউন্টে লগ ইন করতে হবে।
  2. গুগল অ্যাসিস্ট্যান্ট > সেটিংস > হোম কন্ট্রোল (অ্যাসিস্ট্যান্টের অধীনে) নেভিগেট করুন।
  3. নীচে ডান কোণায় প্লাস (+) আইকন নির্বাচন করুন
  4. আপনার [টেস্ট] উপসর্গ এবং আপনার সেট করা ডিসপ্লে নাম সহ আপনার পরীক্ষা অ্যাপটি দেখতে হবে।
  5. সেই আইটেমটি নির্বাচন করুন। Google অ্যাসিস্ট্যান্ট তারপরে আপনার পরিষেবার সাথে প্রমাণীকরণ করবে এবং একটি SYNC অনুরোধ পাঠাবে, আপনার পরিষেবাকে ব্যবহারকারীর জন্য ডিভাইসগুলির একটি তালিকা প্রদান করতে বলবে।

Google Home অ্যাপটি খুলুন এবং যাচাই করুন যে আপনি আপনার ওয়াশার ডিভাইস দেখতে পাচ্ছেন।

ae252220753726f6.png

5. কমান্ড এবং প্রশ্নগুলি পরিচালনা করুন

এখন যেহেতু আপনার ক্লাউড পরিষেবা সঠিকভাবে ওয়াশার ডিভাইসটি Google-এ রিপোর্ট করে, আপনাকে ডিভাইসের অবস্থার অনুরোধ করার এবং কমান্ড পাঠানোর ক্ষমতা যোগ করতে হবে।

QUERY অভিপ্রায় পরিচালনা করুন৷

একটি QUERY উদ্দেশ্য ডিভাইসগুলির একটি সেট অন্তর্ভুক্ত করে৷ প্রতিটি ডিভাইসের জন্য, আপনাকে তার বর্তমান অবস্থার সাথে প্রতিক্রিয়া জানাতে হবে।

functions/index.js এ, উদ্দেশ্য অনুরোধে থাকা টার্গেট ডিভাইসগুলির তালিকা প্রক্রিয়া করতে QUERY হ্যান্ডলারটি সম্পাদনা করুন৷

index.js

app.onQuery(async (body) => {
  const {requestId} = body;
  const payload = {
    devices: {},
  };
  const queryPromises = [];
  const intent = body.inputs[0];
  for (const device of intent.payload.devices) {
    const deviceId = device.id;
    queryPromises.push(queryDevice(deviceId)
        .then((data) => {
        // Add response to device payload
          payload.devices[deviceId] = data;
        }
        ));
  }
  // Wait for all promises to resolve
  await Promise.all(queryPromises);
  return {
    requestId: requestId,
    payload: payload,
  };
});

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

index.js

const queryFirebase = async (deviceId) => {
  const snapshot = await firebaseRef.child(deviceId).once('value');
  const snapshotVal = snapshot.val();
  return {
    on: snapshotVal.OnOff.on,
    isPaused: snapshotVal.StartStop.isPaused,
    isRunning: snapshotVal.StartStop.isRunning,
  };
};

const queryDevice = async (deviceId) => {
  const data = await queryFirebase(deviceId);
  return {
    on: data.on,
    isPaused: data.isPaused,
    isRunning: data.isRunning,
    currentRunCycle: [{
      currentCycle: 'rinse',
      nextCycle: 'spin',
      lang: 'en',
    }],
    currentTotalRemainingTime: 1212,
    currentCycleRemainingTime: 301,
  };
};

হ্যান্ডেল EXECUTE অভিপ্রায়

EXECUTE ইন্টেন্ট ডিভাইসের অবস্থা আপডেট করার জন্য কমান্ড পরিচালনা করে। প্রতিক্রিয়া প্রতিটি কমান্ডের স্ট্যাটাস প্রদান করে—উদাহরণস্বরূপ, SUCCESS , ERROR , বা PENDING —এবং নতুন ডিভাইসের অবস্থা।

functions/index.js এ, প্রতিটি কমান্ডের জন্য আপডেটের প্রয়োজন এমন বৈশিষ্ট্যের তালিকা এবং লক্ষ্য ডিভাইসের সেট প্রক্রিয়া করতে EXECUTE হ্যান্ডলারটি সম্পাদনা করুন:

index.js

app.onExecute(async (body) => {
  const {requestId} = body;
  // Execution results are grouped by status
  const result = {
    ids: [],
    status: 'SUCCESS',
    states: {
      online: true,
    },
  };

  const executePromises = [];
  const intent = body.inputs[0];
  for (const command of intent.payload.commands) {
    for (const device of command.devices) {
      for (const execution of command.execution) {
        executePromises.push(
            updateDevice(execution, device.id)
                .then((data) => {
                  result.ids.push(device.id);
                  Object.assign(result.states, data);
                })
                .catch(() => functions.logger.error('EXECUTE', device.id)));
      }
    }
  }

  await Promise.all(executePromises);
  return {
    requestId: requestId,
    payload: {
      commands: [result],
    },
  };
});

প্রতিটি কমান্ড এবং টার্গেট ডিভাইসের জন্য, রিয়েলটাইম ডেটাবেসের মানগুলি আপডেট করুন যা অনুরোধ করা বৈশিষ্ট্যের সাথে সঙ্গতিপূর্ণ। উপযুক্ত Firebase রেফারেন্স আপডেট করতে updateDevice ফাংশনটি পরিবর্তন করুন এবং আপডেট করা ডিভাইসের অবস্থা ফিরিয়ে দিন।

index.js

const updateDevice = async (execution, deviceId) => {
  const {params, command} = execution;
  let state; let ref;
  switch (command) {
    case 'action.devices.commands.OnOff':
      state = {on: params.on};
      ref = firebaseRef.child(deviceId).child('OnOff');
      break;
    case 'action.devices.commands.StartStop':
      state = {isRunning: params.start};
      ref = firebaseRef.child(deviceId).child('StartStop');
      break;
    case 'action.devices.commands.PauseUnpause':
      state = {isPaused: params.pause};
      ref = firebaseRef.child(deviceId).child('StartStop');
      break;
  }

  return ref.update(state)
      .then(() => state);
};

6. আপনার ক্রিয়া পরীক্ষা করুন

আপনি তিনটি উদ্দেশ্য বাস্তবায়ন করার পরে, আপনি পরীক্ষা করতে পারেন যে আপনার অ্যাকশন ওয়াশারকে নিয়ন্ত্রণ করে।

ফায়ারবেসে স্থাপন করুন

Firebase CLI ব্যবহার করে আপডেট করা ক্লাউড পরিপূর্ণতা স্থাপন করুন:

firebase deploy --only functions

ওয়াশার পরীক্ষা করুন

এখন আপনি যখন আপনার ফোনের মাধ্যমে নিচের ভয়েস কমান্ডের যেকোনো একটি চেষ্টা করেন তখন আপনি মান পরিবর্তন দেখতে পাবেন:

"ওহে গুগল, আমার ওয়াশার চালু করুন।"

"ওহে গুগল, আমার ওয়াশার থামান।"

"ওহে গুগল, আমার ওয়াশার বন্ধ করুন।"

আপনি প্রশ্ন জিজ্ঞাসা করে আপনার ওয়াশারের বর্তমান অবস্থা দেখতে পারেন।

"ওহে গুগল, আমার ওয়াশার কি চালু আছে?"

"ওহে গুগল, আমার ওয়াশার কি চলছে?"

"ওহে গুগল, আমার ওয়াশার কোন সাইকেল চালু আছে?"

এছাড়াও আপনি নেভিগেশন মেনুতে বিকাশ > ফাংশন > লগ -এ ক্লিক করে আপনার Firebase কনসোল লগগুলিতে এই প্রশ্নগুলি এবং কমান্ডগুলি দেখতে পারেন।

ce02fb66fe2037dc.png

7. Google-এ আপডেট রিপোর্ট করুন

আপনি আপনার ক্লাউড পরিষেবাকে স্মার্ট হোম ইন্টেন্টের সাথে সম্পূর্ণরূপে একত্রিত করেছেন, ব্যবহারকারীদের তাদের ডিভাইসের বর্তমান অবস্থা নিয়ন্ত্রণ এবং অনুসন্ধান করতে সক্ষম করে। যাইহোক, আপনার পরিষেবার জন্য অ্যাসিস্ট্যান্টকে ইভেন্টের তথ্য যেমন ডিভাইসের উপস্থিতি বা অবস্থার পরিবর্তনের মতো সক্রিয়ভাবে পাঠানোর উপায় বাস্তবায়নে এখনও নেই।

অনুরোধ সিঙ্কের সাথে, ব্যবহারকারীরা যখন ডিভাইসগুলি যোগ করে বা সরিয়ে দেয়, বা যখন তাদের ডিভাইসের ক্ষমতা পরিবর্তিত হয় তখন আপনি একটি নতুন সিঙ্ক অনুরোধ ট্রিগার করতে পারেন৷ রিপোর্ট স্টেট এর সাথে, ব্যবহারকারীরা শারীরিকভাবে একটি ডিভাইসের অবস্থা পরিবর্তন করলে আপনার ক্লাউড পরিষেবা সক্রিয়ভাবে একটি ডিভাইসের অবস্থা হোম গ্রাফে পাঠাতে পারে—উদাহরণস্বরূপ, একটি লাইট সুইচ চালু করা—অথবা অন্য পরিষেবা ব্যবহার করে অবস্থা পরিবর্তন করে৷

এই বিভাগে, আপনি ফ্রন্টএন্ড ওয়েব অ্যাপ থেকে এই পদ্ধতিগুলি কল করার জন্য কোড যোগ করবেন।

HomeGraph API সক্ষম করুন

HomeGraph API ব্যবহারকারীর হোম গ্রাফের মধ্যে ডিভাইস এবং তাদের অবস্থার স্টোরেজ এবং অনুসন্ধান সক্ষম করে। এই API ব্যবহার করতে, আপনাকে প্রথমে Google ক্লাউড কনসোল খুলতে হবে এবং HomeGraph API সক্ষম করতে হবে

Google ক্লাউড কনসোলে, আপনার অ্যাকশন <project-id>. তারপর, HomeGraph API-এর জন্য API লাইব্রেরি স্ক্রিনে, Enable এ ক্লিক করুন।

ee198858a6eac112.png

রিপোর্ট স্টেট সক্ষম করুন

রিয়েলটাইম ডাটাবেসে লেখা স্টার্টার প্রকল্পে reportstate ফাংশন ট্রিগার করে। ডেটাবেসে লেখা ডেটা ক্যাপচার করতে এবং রিপোর্ট স্টেটের মাধ্যমে হোম গ্রাফে পোস্ট করতে functions/index.js reportstate ফাংশন আপডেট করুন।

index.js

exports.reportstate = functions.database.ref('{deviceId}').onWrite(
    async (change, context) => {
      functions.logger.info('Firebase write event triggered Report State');
      const snapshot = change.after.val();

      const requestBody = {
        requestId: 'ff36a3cc', /* Any unique ID */
        agentUserId: USER_ID,
        payload: {
          devices: {
            states: {
              /* Report the current state of our washer */
              [context.params.deviceId]: {
                on: snapshot.OnOff.on,
                isPaused: snapshot.StartStop.isPaused,
                isRunning: snapshot.StartStop.isRunning,
              },
            },
          },
        },
      };

      const res = await homegraph.devices.reportStateAndNotification({
        requestBody,
      });
      functions.logger.info('Report state response:', res.status, res.data);
    });

অনুরোধ সিঙ্ক সক্ষম করুন

ফ্রন্টএন্ড ওয়েব UI-তে আইকন রিফ্রেশ করা স্টার্টার প্রজেক্টে requestsync ফাংশনকে ট্রিগার করে। HomeGraph API কল করার জন্য functions/index.jsrequestsync ফাংশন প্রয়োগ করুন।

index.js

exports.requestsync = functions.https.onRequest(async (request, response) => {
  response.set('Access-Control-Allow-Origin', '*');
  functions.logger.info(`Request SYNC for user ${USER_ID}`);
  try {
    const res = await homegraph.devices.requestSync({
      requestBody: {
        agentUserId: USER_ID,
      },
    });
    functions.logger.info('Request sync response:', res.status, res.data);
    response.json(res.data);
  } catch (err) {
    functions.logger.error(err);
    response.status(500).send(`Error requesting sync: ${err}`);
  }
});

ফায়ারবেসে স্থাপন করুন

Firebase CLI ব্যবহার করে আপডেট করা কোড স্থাপন করুন:

firebase deploy --only functions

আপনার বাস্তবায়ন পরীক্ষা করুন

রিফ্রেশ ক্লিক করুন ae8d3b25777a5e30.png ওয়েব UI-তে বোতাম এবং যাচাই করুন যে আপনি Firebase কনসোল লগে একটি সিঙ্ক অনুরোধ দেখতে পাচ্ছেন।

5241d663238a8d04.png

এর পরে, ফ্রন্টএন্ড ওয়েব UI-তে ওয়াশার ডিভাইসের বৈশিষ্ট্যগুলি সামঞ্জস্য করুন এবং আপডেট ক্লিক করুন। আপনি আপনার Firebase কনসোল লগগুলিতে Google-এ রিপোর্ট করা অবস্থার পরিবর্তন দেখতে পাচ্ছেন তা যাচাই করুন।

8. অভিনন্দন

674c4f4392e98c1.png

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

আরও জানুন

এখানে কিছু ধারণা রয়েছে যা আপনি আরও গভীরে যেতে বাস্তবায়ন করতে পারেন:

আপনি ব্যবহারকারীদের কাছে আপনার অ্যাকশন প্রকাশ করার সার্টিফিকেশন প্রক্রিয়া সহ পর্যালোচনার জন্য অ্যাকশন পরীক্ষা এবং জমা দেওয়ার বিষয়ে আরও জানতে পারেন।

,

1. আপনি শুরু করার আগে

ইন্টারনেট অফ থিংস (IoT) বিকাশকারী হিসাবে, আপনি স্মার্ট হোম অ্যাকশন তৈরি করতে পারেন যা আপনার ব্যবহারকারীদের Google Home অ্যাপে টাচ কন্ট্রোল এবং অ্যাসিস্ট্যান্টের সাথে ভয়েস কমান্ডের মাধ্যমে তাদের ডিভাইসগুলি নিয়ন্ত্রণ করার ক্ষমতা দেয়।

79266e5f45e6ae20.gif

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

d009cef0f903d284.jpeg

পূর্বশর্ত

আপনি কি নির্মাণ করবেন

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

আপনি কি শিখবেন

  • কীভাবে একটি স্মার্ট হোম ক্লাউড পরিষেবা স্থাপন করবেন
  • অ্যাসিস্ট্যান্টের সাথে আপনার পরিষেবা কীভাবে সংযুক্ত করবেন
  • Google-এ ডিভাইসের অবস্থার পরিবর্তন কীভাবে প্রকাশ করবেন

আপনি কি প্রয়োজন হবে

2. শুরু করা

কার্যকলাপ নিয়ন্ত্রণ সক্ষম করুন

Google অ্যাসিস্ট্যান্ট ব্যবহার করার জন্য, আপনাকে অবশ্যই নির্দিষ্ট কার্যকলাপের ডেটা Google-এর সাথে শেয়ার করতে হবে। Google সহকারীর সঠিকভাবে কাজ করার জন্য এই ডেটা প্রয়োজন; যাইহোক, ডেটা শেয়ার করার প্রয়োজনীয়তা SDK-এর জন্য নির্দিষ্ট নয়। এই ডেটা ভাগ করতে, আপনার যদি আগে থেকে না থাকে তবে একটি Google অ্যাকাউন্ট তৈরি করুন৷ আপনি যেকোনো Google অ্যাকাউন্ট ব্যবহার করতে পারেন—এটি আপনার ডেভেলপার অ্যাকাউন্ট হতে হবে না।

আপনি সহকারীর সাথে যে Google অ্যাকাউন্টটি ব্যবহার করতে চান তার জন্য কার্যকলাপ নিয়ন্ত্রণ পৃষ্ঠাটি খুলুন।

নিম্নলিখিত টগল সুইচগুলি সক্ষম করা হয়েছে তা নিশ্চিত করুন:

  • ওয়েব ও অ্যাপ অ্যাক্টিভিটি - উপরন্তু, Google পরিষেবা ব্যবহার করে এমন সাইট, অ্যাপ এবং ডিভাইস থেকে Chrome ইতিহাস এবং কার্যকলাপ অন্তর্ভুক্ত করুন চেকবক্স নির্বাচন করতে ভুলবেন না।
  • যন্ত্রের তথ্য
  • ভয়েস এবং অডিও কার্যকলাপ

একটি অ্যাকশন প্রকল্প তৈরি করুন

  1. Google ডেভেলপার কনসোলে অ্যাকশনে যান।
  2. নতুন প্রকল্পে ক্লিক করুন, প্রকল্পের জন্য একটি নাম লিখুন এবং প্রকল্প তৈরি করুন ক্লিক করুন।

3d6b68ca79afd54c.png

স্মার্ট হোম অ্যাপটি নির্বাচন করুন

অ্যাকশন কনসোলের ওভারভিউ স্ক্রিনে , স্মার্ট হোম নির্বাচন করুন।

2fa4988f44f8914b.png

স্মার্ট হোম এক্সপেরিয়েন্স কার্ডটি বেছে নিন, স্টার্ট বিল্ডিং এ ক্লিক করুন এবং তারপরে আপনাকে আপনার প্রোজেক্ট কনসোলে নিয়ে যাওয়া হবে।

Firebase CLI ইনস্টল করুন

Firebase কমান্ড লাইন ইন্টারফেস (CLI) আপনাকে স্থানীয়ভাবে আপনার ওয়েব অ্যাপ পরিবেশন করতে এবং Firebase হোস্টিং-এ আপনার ওয়েব অ্যাপ স্থাপন করার অনুমতি দেবে।

CLI ইনস্টল করতে, টার্মিনাল থেকে নিম্নলিখিত npm কমান্ডটি চালান:

npm install -g firebase-tools

CLI সঠিকভাবে ইনস্টল করা হয়েছে তা যাচাই করতে, চালান:

firebase --version

চালিয়ে আপনার Google অ্যাকাউন্ট দিয়ে Firebase CLI অনুমোদন করুন:

firebase login

3. স্টার্টার অ্যাপ চালান

এখন আপনি আপনার ডেভেলপমেন্ট এনভায়রনমেন্ট সেট আপ করেছেন, আপনি সবকিছু সঠিকভাবে কনফিগার করা আছে কিনা তা যাচাই করতে স্টার্টার প্রজেক্ট স্থাপন করতে পারেন।

সোর্স কোড পান

আপনার ডেভেলপমেন্ট মেশিনে এই কোডল্যাবের নমুনা ডাউনলোড করতে নিম্নলিখিত লিঙ্কে ক্লিক করুন:

...অথবা আপনি কমান্ড লাইন থেকে GitHub সংগ্রহস্থল ক্লোন করতে পারেন:

git clone https://github.com/googlecodelabs/smarthome-washer.git

প্রকল্প সম্পর্কে

স্টার্টার প্রকল্পে নিম্নলিখিত সাবডিরেক্টরি রয়েছে:

  • public: স্মার্ট ওয়াশারের অবস্থা সহজেই নিয়ন্ত্রণ ও নিরীক্ষণ করার জন্য একটি ফ্রন্টএন্ড UI।
  • functions: একটি সম্পূর্ণরূপে বাস্তবায়িত ক্লাউড পরিষেবা যা ফায়ারবেস এবং ফায়ারবেস রিয়েলটাইম ডেটাবেসের জন্য ক্লাউড ফাংশনগুলির সাথে স্মার্ট ওয়াশার পরিচালনা করে৷

ফায়ারবেসের সাথে সংযোগ করুন

washer-start ডিরেক্টরিতে নেভিগেট করুন, তারপর আপনার অ্যাকশন প্রকল্পের সাথে Firebase CLI সেট আপ করুন:

cd washer-start
firebase use <project-id>

Firebase প্রকল্প কনফিগার করুন

একটি ফায়ারবেস প্রকল্প শুরু করুন।

firebase init

ডাটাবেস , ফাংশন এবং হোস্টিং CLI বৈশিষ্ট্য নির্বাচন করুন।

? Which Firebase CLI features do you want to set up for this folder? Press Space to select features, then
 Enter to confirm your choices. 
❯◉ Database: Configure Firebase Realtime Database and deploy rules
 ◯ Firestore: Deploy rules and create indexes for Firestore
 ◉ Functions: Configure and deploy Cloud Functions
 ◉ Hosting: Configure and deploy Firebase Hosting sites
 ◯ Storage: Deploy Cloud Storage security rules
 ◯ Emulators: Set up local emulators for Firebase features
 ◯ Remote Config: Get, deploy, and rollback configurations for Remote Config

এটি আপনার প্রকল্পের জন্য প্রয়োজনীয় API এবং বৈশিষ্ট্যগুলি শুরু করবে।

অনুরোধ করা হলে, রিয়েলটাইম ডেটাবেস আরম্ভ করুন। আপনি ডাটাবেস উদাহরণের জন্য ডিফল্ট অবস্থান ব্যবহার করতে পারেন।

? It seems like you haven't initialized Realtime Database in your project yet. Do you want to set it up? 
Yes

? Please choose the location for your default Realtime Database instance: us-central1

যেহেতু আপনি স্টার্টার প্রজেক্ট কোড ব্যবহার করছেন, নিরাপত্তা নিয়মের জন্য ডিফল্ট ফাইলটি বেছে নিন এবং নিশ্চিত করুন যে আপনি বিদ্যমান ডাটাবেস নিয়ম ফাইলটি ওভাররাইট করবেন না।

? What file should be used for Realtime Database Security Rules? Database.rules.json

? File database.rules.json already exists. Do you want to overwrite it with the Realtime Database Security Rules for <project-ID>-default-rtdb from the Firebase Console? 
No

একইভাবে, আপনার ফাংশনগুলি কনফিগার করার সময়, আপনার ডিফল্ট ফাইলগুলি ব্যবহার করা উচিত এবং নিশ্চিত করুন যে আপনি প্রকল্পের নমুনায় বিদ্যমান index.js এবং package.json ফাইলগুলিকে ওভাররাইট করবেন না।

? What language would you like to use to write Cloud Functions? 
JavaScript

? File functions/package.json already exists. Overwrite? 
No

? File functions/index.js already exists. Overwrite? 
No

? Do you want to install dependencies with npm now? 
Yes

অবশেষে, প্রোজেক্ট কোডে public ডিরেক্টরি ব্যবহার করতে আপনার হোস্টিং সেটআপ কনফিগার করুন এবং বিদ্যমান index.html ফাইলটি ব্যবহার করুন।

? What do you want to use as your public directory? 
public

? Configure as a single-page app (rewrite all urls to /index.html)? 
Yes

? File public/index.html already exists. Overwrite?
 No

ফায়ারবেসে স্থাপন করুন

functions ফোল্ডারে নেভিগেট করুন এবং npm.

cd functions
npm install

এখন আপনি নির্ভরতাগুলি ইনস্টল করেছেন এবং আপনার প্রকল্পটি কনফিগার করেছেন, আপনি প্রথমবারের জন্য অ্যাপটি চালানোর জন্য প্রস্তুত৷

firebase deploy

এটি হল কনসোল আউটপুট যা আপনাকে দেখতে হবে:

...

✔ Deploy complete!

Project Console: https://console.firebase.google.com/project/<project-id>/overview
Hosting URL: https://<project-id>.web.app

এই কমান্ডটি Firebase-এর জন্য বিভিন্ন ক্লাউড ফাংশন সহ একটি ওয়েব অ্যাপ স্থাপন করে।

ওয়েব অ্যাপটি দেখতে আপনার ব্রাউজারে হোস্টিং URL খুলুন ( https://<project-id>.web.app )। আপনি নিম্নলিখিত ইন্টারফেস দেখতে পাবেন:

5845443e94705557.png

এই ওয়েব UI ডিভাইসের অবস্থা দেখতে বা পরিবর্তন করার জন্য একটি তৃতীয় পক্ষের প্ল্যাটফর্মের প্রতিনিধিত্ব করে। ডিভাইসের তথ্য দিয়ে আপনার ডাটাবেস তৈরি করা শুরু করতে, আপডেট ক্লিক করুন। আপনি পৃষ্ঠায় কোনো পরিবর্তন দেখতে পাবেন না, তবে আপনার ওয়াশারের বর্তমান অবস্থা ডাটাবেসে সংরক্ষণ করা হবে।

অ্যাকশন কনসোল ব্যবহার করে Google অ্যাসিস্ট্যান্টের সাথে আপনি যে ক্লাউড পরিষেবাটি স্থাপন করেছেন সেটি সংযোগ করার এখন সময়।

আপনার অ্যাকশন কনসোল প্রকল্প কনফিগার করুন

ওভারভিউ > আপনার অ্যাকশন তৈরি করুন এর অধীনে, অ্যাকশন যোগ করুন নির্বাচন করুন। আপনার ক্লাউড ফাংশনের URL লিখুন যা স্মার্ট হোমের উদ্দেশ্য পূরণ করে এবং সংরক্ষণ করুন ক্লিক করুন।

https://us-central1-<project-id>.cloudfunctions.net/smarthome

9d7b223427f587ca.png

বিকাশ > আমন্ত্রণ ট্যাবে, আপনার কর্মের জন্য একটি প্রদর্শন নাম যোগ করুন এবং সংরক্ষণ করুন ক্লিক করুন। এই নামটি Google Home অ্যাপে দেখা যাবে।

774d0c40c351c7da.png

a8c4673eb11d76ee.png

অ্যাকাউন্ট লিঙ্কিং সক্ষম করতে, বাম নেভিগেশনে বিকাশ > অ্যাকাউন্ট লিঙ্কিং বিকল্পটি নির্বাচন করুন। এই অ্যাকাউন্ট লিঙ্কিং সেটিংস ব্যবহার করুন:

ক্লায়েন্ট আইডি

ABC123

ক্লায়েন্ট গোপন

DEF456

অনুমোদন URL

https://us-central1-
.cloudfunctions.net/fakeauth

টোকেন URL

https://us-central1-
.cloudfunctions.net/faketoken

9730d20b90bcc038.png

আপনার অ্যাকাউন্ট লিঙ্কিং কনফিগারেশন সংরক্ষণ করতে সংরক্ষণ করুন ক্লিক করুন, তারপর আপনার প্রকল্পে পরীক্ষা সক্ষম করতে পরীক্ষা ক্লিক করুন৷

ee0547f05b5efd98.png

আপনাকে সিমুলেটরে পুনঃনির্দেশিত করা হবে। আপনি যদি " Test now enabled " দেখতে না পান তবে টেস্টিং সক্ষম হয়েছে কিনা যাচাই করতে রিসেট টেস্ট ক্লিক করুন৷

d0495810dbadf059.png

এখন আপনি অ্যাসিস্ট্যান্টের সাথে ডিভাইসের অবস্থা কানেক্ট করার জন্য প্রয়োজনীয় ওয়েবহুক প্রয়োগ করা শুরু করতে পারেন।

4. একটি ধাবক তৈরি করুন

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

  • একটি SYNC অভিপ্রায় তখন ঘটে যখন সহকারী জানতে চায় ব্যবহারকারী কোন ডিভাইস কানেক্ট করেছে। ব্যবহারকারী একটি অ্যাকাউন্ট লিঙ্ক করলে এটি আপনার পরিষেবাতে পাঠানো হয়। আপনার সমস্ত ব্যবহারকারীর ডিভাইস এবং তাদের ক্ষমতাগুলির একটি JSON পেলোডের সাথে প্রতিক্রিয়া জানানো উচিত।
  • যখন সহকারী একটি ডিভাইসের বর্তমান অবস্থা বা স্থিতি জানতে চায় তখন একটি QUERY উদ্দেশ্য ঘটে। আপনাকে অনুরোধ করা প্রতিটি ডিভাইসের অবস্থার সাথে একটি JSON পেলোডের সাথে প্রতিক্রিয়া জানাতে হবে।
  • যখন সহকারী ব্যবহারকারীর পক্ষ থেকে একটি ডিভাইস নিয়ন্ত্রণ করতে চায় তখন একটি EXECUTE উদ্দেশ্য ঘটে। আপনাকে অনুরোধ করা প্রতিটি ডিভাইসের এক্সিকিউশন স্ট্যাটাস সহ একটি JSON পেলোড দিয়ে প্রতিক্রিয়া জানাতে হবে।
  • ব্যবহারকারী যখন অ্যাসিস্ট্যান্ট থেকে তাদের অ্যাকাউন্টটি আনলিঙ্ক করে তখন একটি DISCONNECT উদ্দেশ্য ঘটে। আপনার এই ব্যবহারকারীর ডিভাইসের জন্য সহকারীকে ইভেন্ট পাঠানো বন্ধ করা উচিত।

আপনি নিম্নলিখিত বিভাগে এই উদ্দেশ্যগুলি পরিচালনা করার জন্য পূর্বে মোতায়েন করা ফাংশনগুলি আপডেট করবেন৷

SYNC প্রতিক্রিয়া আপডেট করুন

functions/index.js খুলুন, যাতে সহকারীর অনুরোধের উত্তর দেওয়ার জন্য কোড থাকে।

আপনাকে ডিভাইসের মেটাডেটা এবং ক্ষমতা ফিরিয়ে দিয়ে একটি SYNC উদ্দেশ্য পরিচালনা করতে হবে। ডিভাইসের তথ্য এবং কাপড় ধোয়ার জন্য প্রস্তাবিত বৈশিষ্ট্য অন্তর্ভুক্ত করতে onSync অ্যারেতে JSON আপডেট করুন।

index.js

app.onSync((body) => {
  return {
    requestId: body.requestId,
    payload: {
      agentUserId: USER_ID,
      devices: [{
        id: 'washer',
        type: 'action.devices.types.WASHER',
        traits: [
          'action.devices.traits.OnOff',
          'action.devices.traits.StartStop',
          'action.devices.traits.RunCycle',
        ],
        name: {
          defaultNames: ['My Washer'],
          name: 'Washer',
          nicknames: ['Washer'],
        },
        deviceInfo: {
          manufacturer: 'Acme Co',
          model: 'acme-washer',
          hwVersion: '1.0',
          swVersion: '1.0.1',
        },
        willReportState: true,
        attributes: {
          pausable: true,
        },
      }],
    },
  };
});

ফায়ারবেসে স্থাপন করুন

Firebase CLI ব্যবহার করে আপডেট করা ক্লাউড পরিপূর্ণতা স্থাপন করুন:

firebase deploy --only functions

আপনার স্মার্ট হোম অ্যাকশন পরীক্ষা করার জন্য, আপনাকে একটি Google অ্যাকাউন্টের সাথে আপনার প্রোজেক্ট লিঙ্ক করতে হবে। এটি Google অ্যাসিস্ট্যান্ট সারফেস এবং একই অ্যাকাউন্টে সাইন-ইন করা Google Home অ্যাপের মাধ্যমে পরীক্ষা করতে সক্ষম করে।

  1. আপনার ফোনে, Google Assistant সেটিংস খুলুন। মনে রাখবেন যে আপনি কনসোলের মতো একই অ্যাকাউন্টে লগ ইন করতে হবে।
  2. গুগল অ্যাসিস্ট্যান্ট > সেটিংস > হোম কন্ট্রোল (অ্যাসিস্ট্যান্টের অধীনে) নেভিগেট করুন।
  3. নীচে ডান কোণায় প্লাস (+) আইকন নির্বাচন করুন
  4. আপনার [টেস্ট] উপসর্গ এবং আপনার সেট করা ডিসপ্লে নাম সহ আপনার পরীক্ষা অ্যাপটি দেখতে হবে।
  5. সেই আইটেমটি নির্বাচন করুন। Google অ্যাসিস্ট্যান্ট তারপরে আপনার পরিষেবার সাথে প্রমাণীকরণ করবে এবং একটি SYNC অনুরোধ পাঠাবে, আপনার পরিষেবাকে ব্যবহারকারীর জন্য ডিভাইসগুলির একটি তালিকা প্রদান করতে বলবে।

Google Home অ্যাপটি খুলুন এবং যাচাই করুন যে আপনি আপনার ওয়াশার ডিভাইস দেখতে পাচ্ছেন।

ae252220753726f6.png

5. কমান্ড এবং প্রশ্নগুলি পরিচালনা করুন

এখন যেহেতু আপনার ক্লাউড পরিষেবা সঠিকভাবে ওয়াশার ডিভাইসটি Google-এ রিপোর্ট করে, আপনাকে ডিভাইসের অবস্থার অনুরোধ করার এবং কমান্ড পাঠানোর ক্ষমতা যোগ করতে হবে।

QUERY অভিপ্রায় পরিচালনা করুন৷

একটি QUERY উদ্দেশ্য ডিভাইসগুলির একটি সেট অন্তর্ভুক্ত করে৷ প্রতিটি ডিভাইসের জন্য, আপনাকে তার বর্তমান অবস্থার সাথে প্রতিক্রিয়া জানাতে হবে।

functions/index.js এ, উদ্দেশ্য অনুরোধে থাকা টার্গেট ডিভাইসগুলির তালিকা প্রক্রিয়া করতে QUERY হ্যান্ডলারটি সম্পাদনা করুন৷

index.js

app.onQuery(async (body) => {
  const {requestId} = body;
  const payload = {
    devices: {},
  };
  const queryPromises = [];
  const intent = body.inputs[0];
  for (const device of intent.payload.devices) {
    const deviceId = device.id;
    queryPromises.push(queryDevice(deviceId)
        .then((data) => {
        // Add response to device payload
          payload.devices[deviceId] = data;
        }
        ));
  }
  // Wait for all promises to resolve
  await Promise.all(queryPromises);
  return {
    requestId: requestId,
    payload: payload,
  };
});

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

index.js

const queryFirebase = async (deviceId) => {
  const snapshot = await firebaseRef.child(deviceId).once('value');
  const snapshotVal = snapshot.val();
  return {
    on: snapshotVal.OnOff.on,
    isPaused: snapshotVal.StartStop.isPaused,
    isRunning: snapshotVal.StartStop.isRunning,
  };
};

const queryDevice = async (deviceId) => {
  const data = await queryFirebase(deviceId);
  return {
    on: data.on,
    isPaused: data.isPaused,
    isRunning: data.isRunning,
    currentRunCycle: [{
      currentCycle: 'rinse',
      nextCycle: 'spin',
      lang: 'en',
    }],
    currentTotalRemainingTime: 1212,
    currentCycleRemainingTime: 301,
  };
};

হ্যান্ডেল EXECUTE অভিপ্রায়

EXECUTE ইন্টেন্ট ডিভাইসের অবস্থা আপডেট করার জন্য কমান্ড পরিচালনা করে। প্রতিক্রিয়া প্রতিটি কমান্ডের স্ট্যাটাস প্রদান করে—উদাহরণস্বরূপ, SUCCESS , ERROR , বা PENDING —এবং নতুন ডিভাইসের অবস্থা।

functions/index.js এ, প্রতিটি কমান্ডের জন্য আপডেটের প্রয়োজন এমন বৈশিষ্ট্যের তালিকা এবং লক্ষ্য ডিভাইসের সেট প্রক্রিয়া করতে EXECUTE হ্যান্ডলারটি সম্পাদনা করুন:

index.js

app.onExecute(async (body) => {
  const {requestId} = body;
  // Execution results are grouped by status
  const result = {
    ids: [],
    status: 'SUCCESS',
    states: {
      online: true,
    },
  };

  const executePromises = [];
  const intent = body.inputs[0];
  for (const command of intent.payload.commands) {
    for (const device of command.devices) {
      for (const execution of command.execution) {
        executePromises.push(
            updateDevice(execution, device.id)
                .then((data) => {
                  result.ids.push(device.id);
                  Object.assign(result.states, data);
                })
                .catch(() => functions.logger.error('EXECUTE', device.id)));
      }
    }
  }

  await Promise.all(executePromises);
  return {
    requestId: requestId,
    payload: {
      commands: [result],
    },
  };
});

প্রতিটি কমান্ড এবং টার্গেট ডিভাইসের জন্য, রিয়েলটাইম ডেটাবেসের মানগুলি আপডেট করুন যা অনুরোধ করা বৈশিষ্ট্যের সাথে সঙ্গতিপূর্ণ। উপযুক্ত Firebase রেফারেন্স আপডেট করতে updateDevice ফাংশনটি পরিবর্তন করুন এবং আপডেট করা ডিভাইসের অবস্থা ফিরিয়ে দিন।

index.js

const updateDevice = async (execution, deviceId) => {
  const {params, command} = execution;
  let state; let ref;
  switch (command) {
    case 'action.devices.commands.OnOff':
      state = {on: params.on};
      ref = firebaseRef.child(deviceId).child('OnOff');
      break;
    case 'action.devices.commands.StartStop':
      state = {isRunning: params.start};
      ref = firebaseRef.child(deviceId).child('StartStop');
      break;
    case 'action.devices.commands.PauseUnpause':
      state = {isPaused: params.pause};
      ref = firebaseRef.child(deviceId).child('StartStop');
      break;
  }

  return ref.update(state)
      .then(() => state);
};

6. আপনার ক্রিয়া পরীক্ষা করুন

আপনি তিনটি উদ্দেশ্য বাস্তবায়ন করার পরে, আপনি পরীক্ষা করতে পারেন যে আপনার অ্যাকশন ওয়াশারকে নিয়ন্ত্রণ করে।

ফায়ারবেসে স্থাপন করুন

Firebase CLI ব্যবহার করে আপডেট করা ক্লাউড পরিপূর্ণতা স্থাপন করুন:

firebase deploy --only functions

ওয়াশার পরীক্ষা করুন

এখন আপনি যখন আপনার ফোনের মাধ্যমে নিচের ভয়েস কমান্ডের যেকোনো একটি চেষ্টা করেন তখন আপনি মান পরিবর্তন দেখতে পাবেন:

"ওহে গুগল, আমার ওয়াশার চালু করুন।"

"ওহে গুগল, আমার ওয়াশার থামান।"

"ওহে গুগল, আমার ওয়াশার বন্ধ করুন।"

আপনি প্রশ্ন জিজ্ঞাসা করে আপনার ওয়াশারের বর্তমান অবস্থা দেখতে পারেন।

"ওহে গুগল, আমার ওয়াশার কি চালু আছে?"

"ওহে গুগল, আমার ওয়াশার কি চলছে?"

"ওহে গুগল, আমার ওয়াশার কোন সাইকেল চালু আছে?"

এছাড়াও আপনি নেভিগেশন মেনুতে বিকাশ > ফাংশন > লগ -এ ক্লিক করে আপনার Firebase কনসোল লগগুলিতে এই প্রশ্নগুলি এবং কমান্ডগুলি দেখতে পারেন।

ce02fb66fe2037dc.png

7. Google-এ আপডেট রিপোর্ট করুন

আপনি আপনার ক্লাউড পরিষেবাকে স্মার্ট হোম ইন্টেন্টের সাথে সম্পূর্ণরূপে একত্রিত করেছেন, ব্যবহারকারীদের তাদের ডিভাইসের বর্তমান অবস্থা নিয়ন্ত্রণ এবং অনুসন্ধান করতে সক্ষম করে। যাইহোক, আপনার পরিষেবার জন্য অ্যাসিস্ট্যান্টকে ইভেন্টের তথ্য যেমন ডিভাইসের উপস্থিতি বা অবস্থার পরিবর্তনের মতো সক্রিয়ভাবে পাঠানোর উপায় বাস্তবায়নে এখনও নেই।

অনুরোধ সিঙ্কের সাথে, ব্যবহারকারীরা যখন ডিভাইসগুলি যোগ করে বা সরিয়ে দেয়, বা যখন তাদের ডিভাইসের ক্ষমতা পরিবর্তিত হয় তখন আপনি একটি নতুন সিঙ্ক অনুরোধ ট্রিগার করতে পারেন৷ রিপোর্ট স্টেট এর সাথে, ব্যবহারকারীরা শারীরিকভাবে একটি ডিভাইসের অবস্থা পরিবর্তন করলে আপনার ক্লাউড পরিষেবা সক্রিয়ভাবে একটি ডিভাইসের অবস্থা হোম গ্রাফে পাঠাতে পারে—উদাহরণস্বরূপ, একটি লাইট সুইচ চালু করা—অথবা অন্য পরিষেবা ব্যবহার করে অবস্থা পরিবর্তন করে৷

এই বিভাগে, আপনি ফ্রন্টএন্ড ওয়েব অ্যাপ থেকে এই পদ্ধতিগুলি কল করার জন্য কোড যোগ করবেন।

HomeGraph API সক্ষম করুন

HomeGraph API ব্যবহারকারীর হোম গ্রাফের মধ্যে ডিভাইস এবং তাদের অবস্থার স্টোরেজ এবং অনুসন্ধান সক্ষম করে। এই API ব্যবহার করতে, আপনাকে প্রথমে Google ক্লাউড কনসোল খুলতে হবে এবং HomeGraph API সক্ষম করতে হবে

Google ক্লাউড কনসোলে, আপনার অ্যাকশন <project-id>. তারপর, HomeGraph API-এর জন্য API লাইব্রেরি স্ক্রিনে, Enable এ ক্লিক করুন।

ee198858a6eac112.png

রিপোর্ট স্টেট সক্ষম করুন

রিয়েলটাইম ডাটাবেসে লেখা স্টার্টার প্রকল্পে reportstate ফাংশন ট্রিগার করে। ডেটাবেসে লেখা ডেটা ক্যাপচার করতে এবং রিপোর্ট স্টেটের মাধ্যমে হোম গ্রাফে পোস্ট করতে functions/index.js reportstate ফাংশন আপডেট করুন।

index.js

exports.reportstate = functions.database.ref('{deviceId}').onWrite(
    async (change, context) => {
      functions.logger.info('Firebase write event triggered Report State');
      const snapshot = change.after.val();

      const requestBody = {
        requestId: 'ff36a3cc', /* Any unique ID */
        agentUserId: USER_ID,
        payload: {
          devices: {
            states: {
              /* Report the current state of our washer */
              [context.params.deviceId]: {
                on: snapshot.OnOff.on,
                isPaused: snapshot.StartStop.isPaused,
                isRunning: snapshot.StartStop.isRunning,
              },
            },
          },
        },
      };

      const res = await homegraph.devices.reportStateAndNotification({
        requestBody,
      });
      functions.logger.info('Report state response:', res.status, res.data);
    });

অনুরোধ সিঙ্ক সক্ষম করুন

ফ্রন্টএন্ড ওয়েব UI-তে আইকন রিফ্রেশ করা স্টার্টার প্রজেক্টে requestsync ফাংশনকে ট্রিগার করে। HomeGraph API কল করার জন্য functions/index.jsrequestsync ফাংশন প্রয়োগ করুন।

index.js

exports.requestsync = functions.https.onRequest(async (request, response) => {
  response.set('Access-Control-Allow-Origin', '*');
  functions.logger.info(`Request SYNC for user ${USER_ID}`);
  try {
    const res = await homegraph.devices.requestSync({
      requestBody: {
        agentUserId: USER_ID,
      },
    });
    functions.logger.info('Request sync response:', res.status, res.data);
    response.json(res.data);
  } catch (err) {
    functions.logger.error(err);
    response.status(500).send(`Error requesting sync: ${err}`);
  }
});

ফায়ারবেসে স্থাপন করুন

Firebase CLI ব্যবহার করে আপডেট করা কোড স্থাপন করুন:

firebase deploy --only functions

আপনার বাস্তবায়ন পরীক্ষা করুন

রিফ্রেশ ক্লিক করুন ae8d3b25777a5e30.png ওয়েব UI-তে বোতাম এবং যাচাই করুন যে আপনি Firebase কনসোল লগে একটি সিঙ্ক অনুরোধ দেখতে পাচ্ছেন।

5241d663238a8d04.png

এর পরে, ফ্রন্টএন্ড ওয়েব UI-তে ওয়াশার ডিভাইসের বৈশিষ্ট্যগুলি সামঞ্জস্য করুন এবং আপডেট ক্লিক করুন। আপনি আপনার Firebase কনসোল লগগুলিতে Google-এ রিপোর্ট করা অবস্থার পরিবর্তন দেখতে পাচ্ছেন তা যাচাই করুন।

8. অভিনন্দন

674c4f4392e98c1.png

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

আরও জানুন

এখানে কিছু ধারণা রয়েছে যা আপনি আরও গভীরে যেতে বাস্তবায়ন করতে পারেন:

You can also learn more about testing and submitting an Action for review, including the certification process to publish your Action to users.