হোম এপিআই অ্যান্ড্রয়েড নমুনা অ্যাপ

স্যাম্পল অ্যাপটি অ্যান্ড্রয়েডের জন্য গুগল হোম এপিআই-এর মৌলিক সক্ষমতাগুলো তুলে ধরে।

পূর্বশর্ত

অ্যাপটি তৈরি, ইনস্টল এবং পরীক্ষা করার জন্য আপনাকে কয়েকটি পূর্বশর্ত পূরণ করতে হবে:

এবং হোম এপিআইগুলো পরীক্ষা করার জন্য আপনার প্রয়োজন হবে:

  • ডেভেলপমেন্টের জন্য ব্যবহৃত গুগল অ্যাকাউন্ট দিয়ে সেট আপ করা অ্যান্ড্রয়েড ১০ বা তার পরবর্তী সংস্করণের একটি অ্যান্ড্রয়েড ডিভাইস প্রয়োজন। নিশ্চিত করুন যে Android Studio -র একটি হালনাগাদ সংস্করণ ইনস্টল করা আছে এবং এই ডেভেলপমেন্ট অ্যাকাউন্ট দিয়ে সাইন ইন করা আছে।
  • একটি ওয়াই-ফাই নেটওয়ার্ক।
  • Matter ডিভাইসগুলো অ্যাক্সেস ও নিয়ন্ত্রণ করতে, আপনার এমন একটি গুগল হাবও প্রয়োজন যা হোম এপিআই (Home APIs) সমর্থন করে । বিস্তারিত জানতে অ্যান্ড্রয়েডে কানেক্টিভিটি (Connectivity on Android) দেখুন।

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

    • রঙের তাপমাত্রা আলো (চালু এবং বন্ধ, উজ্জ্বলতা)
    • কন্টাক্ট সেন্সর (বুলিয়ান অবস্থা)
    • ম্লানযোগ্য আলো (চালু এবং বন্ধ, উজ্জ্বলতা)
    • বর্ধিত রঙিন আলো (চালু ও বন্ধ, উজ্জ্বলতা)
    • জেনেরিক সুইচ
    • গুগল ক্যামেরা
    • অকুপেন্সি সেন্সর (অকুপেন্সি সেন্সিং)
    • আলো জ্বালানো/বন্ধ করা (চালু ও বন্ধ, উজ্জ্বলতা)
    • অন/অফ লাইট সুইচ
    • অন/অফ প্লাগ-ইন ইউনিট (চালু এবং বন্ধ)
    • অন/অফ সেন্সর

সোর্স কোড ডাউনলোড করুন

স্যাম্পল অ্যাপটির সোর্স কোড গিটহাবে পাওয়া যাবে।

প্রজেক্টটি যেখানে সেভ করতে চান সেখানে যান, তারপর এটি ক্লোন করুন:

git clone https://github.com/google-home/google-home-api-sample-app-android.git

এসডিকে সেট আপ করুন

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

Home APIs Android SDK ডাউনলোড করার জন্য, আপনাকে প্রথমে Google Home Developers-এ সাইন ইন করতে হবে।

এখনই সাইন ইন করুন!

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

  1. Android Studio খুলুন, তারপর আপনার লোকাল মেশিনে ক্লোন করা google-home-api-sample-app-android প্রোজেক্ট ফোল্ডারটি খুলুন।

  2. প্রথমবার সেটআপ করার সময়, Android Studio প্রোজেক্টের সমস্ত ডিপেন্ডেন্সি ডাউনলোড করতে এবং গ্রেডল বিল্ড সম্পন্ন করতে ১০ মিনিট পর্যন্ত সময় লাগতে পারে।

  3. একটি ইউএসবি কেবলের মাধ্যমে আপনার কম্পিউটারকে একটি বাস্তব অ্যান্ড্রয়েড ফোনের সাথে সংযুক্ত করুন এবং ডেভেলপার অপশনে এডিবি (ADB) সক্রিয় করুন। নিশ্চিত করুন যে Android Studio এডিবি-র মাধ্যমে অ্যান্ড্রয়েড ফোনটির সাথে সংযোগ করতে পারে।

  4. স্যাম্পল অ্যাপটির প্যাকেজ নামটি পরিবর্তন করে এমন একটি নতুন নাম দিন যা আগে নিবন্ধিত হয়নি, যেমন আপনার প্রতিষ্ঠানের নামের উপর ভিত্তি করে রাখা কোনো নাম:

    1. প্রকল্পটি খুলুন।
    2. উৎস স্তরক্রম প্রসারিত করুন।
    3. প্যাকেজের যে অংশটি আপনি পরিবর্তন করতে চান তা নির্বাচন করুন - অন্য কথায়, com.example ।
    4. প্যাকেজটির উপর রাইট-ক্লিক করুন এবং Refactor > Rename... নির্বাচন করুন। রিফ্যাক্টর > রিনেম মেনু
    5. নতুন নামটি প্রবেশ করান এবং রিফ্যাক্টর-এ ক্লিক করুন।
    6. build.gradle.kts ফাইলটি সম্পাদনা করে android namespace এবং applicationId পরিবর্তন করে নতুন প্যাকেজ নামটি দিন।

  5. প্রয়োজনীয় সমস্ত লাইব্রেরি ডাউনলোড হয়ে গেলে এবং গ্রেডল সিঙ্ক্রোনাইজেশন সম্পন্ন হলে, অ্যাপটি বিল্ড ও রান করার জন্য রান বাটনে ক্লিক করুন। আপনার ফোনে অ্যাপটি সফলভাবে চালু হলে, আপনি স্যাম্পল অ্যাপের মূল পৃষ্ঠাটি দেখতে পাবেন।

একটি স্বাক্ষর শংসাপত্র তৈরি করুন

আপনি যখন Android Studio কোনো অ্যাপ রান বা ডিবাগ করেন, তখন এটি স্বয়ংক্রিয়ভাবে ডেভেলপমেন্ট ও ডিবাগিংয়ের জন্য একটি ডিবাগ সার্টিফিকেট তৈরি করে। বিস্তারিত ব্যাখ্যার জন্য “অ্যান্ড্রয়েড স্টুডিও: আপনার ডিবাগ বিল্ড সাইন করুন” দেখুন।

  1. Android Studio অ্যাপটি রান করে একটি ডিবাগ অ্যাপ সাইনিং সার্টিফিকেট তৈরি করুন। আপনি যখন Android Studio কোনো অ্যাপ রান বা ডিবাগ করেন, তখন Android Studio স্বয়ংক্রিয়ভাবে ডেভেলপমেন্ট এবং ডিবাগিংয়ের জন্য একটি অ্যাপ সাইনিং সার্টিফিকেট তৈরি করে। একটি সম্পূর্ণ ব্যাখ্যার জন্য "অ্যান্ড্রয়েড স্টুডিও: আপনার ডিবাগ বিল্ড সাইন করুন" দেখুন।

    আপনার মোবাইল ডিভাইসটি আপনার লোকাল মেশিনের সাথে সংযুক্ত করুন। Android Studio মডেল নম্বর অনুসারে আপনার সংযুক্ত ডিভাইসগুলোর তালিকা দেখাবে। তালিকা থেকে আপনার ডিভাইসটি নির্বাচন করুন, তারপর 'Run project'-এ ক্লিক করুন। এটি আপনার মোবাইল ডিভাইসে স্যাম্পল অ্যাপটি বিল্ড এবং ইনস্টল করবে।

    আরও বিস্তারিত নির্দেশাবলীর জন্য, অ্যান্ড্রয়েড ডেভেলপার সাইটে ‘Run apps on a hardware device’ দেখুন।

    এখন চলমান অ্যাপটি বন্ধ করুন।

  2. Google Cloud Console Help সাইটে Manage OAuth Clients / Application Types / Native applications / Android অংশে বিস্তারিত নির্দেশাবলী অনুসরণ করে আপনার ডিবাগ সার্টিফিকেটের SHA-1 ফিঙ্গারপ্রিন্ট সংগ্রহ করুন।

  1. গুগল ক্লাউড কনসোলে, প্রজেক্ট সিলেক্টর ড্যাশবোর্ডে যান এবং যে প্রজেক্টটি আপনি OAuth ক্রেডেনশিয়াল তৈরি করতে ব্যবহার করতে চান, সেটি নির্বাচন করুন।
  2. API এবং পরিষেবা পৃষ্ঠায় যান এবং নেভিগেশন মেনুতে থাকা ক্রেডেনশিয়ালস- এ ক্লিক করুন।

  3. আপনি যদি এই গুগল ক্লাউড প্রজেক্টের জন্য আপনার কনসেন্ট স্ক্রিনটি এখনও কনফিগার না করে থাকেন, তাহলে ‘কনসেন্ট স্ক্রিন কনফিগার করুন’ বাটনটি দেখা যাবে। সেক্ষেত্রে, নিচের পদ্ধতি অনুসরণ করে আপনার কনসেন্ট স্ক্রিনটি কনফিগার করুন। অন্যথায়, পরবর্তী বিভাগে চলে যান।

    1. ‘কনফিগার কনসেন্ট স্ক্রিন’- এ ক্লিক করুন। OAuth কনসেন্ট স্ক্রিন পেজটি প্রদর্শিত হবে।
    2. আপনার ব্যবহারের ধরনের ওপর নির্ভর করে Internal বা External নির্বাচন করুন, এবং তারপর Create-এ ক্লিক করুন। OAuth সম্মতি স্ক্রিন প্যানেটি প্রদর্শিত হবে।
    3. অ্যাপের তথ্য পাতায় পর্দায় দেওয়া নির্দেশনা অনুযায়ী তথ্য প্রবেশ করান এবং তারপর 'সংরক্ষণ করুন ও চালিয়ে যান' -এ ক্লিক করুন। স্কোপস পেইনটি প্রদর্শিত হবে।
    4. আপনাকে কোনো স্কোপ যোগ করতে হবে না, তাই সেভ অ্যান্ড কন্টিনিউ-তে ক্লিক করুন। টেস্ট ইউজার্স পেইনটি প্রদর্শিত হবে।
    5. Audience-এ ক্লিক করুন এবং + ADD USERS বোতামে ক্লিক করুন।
    6. আপনার টেস্ট ইউজারের ইমেল ঠিকানাটি প্রবেশ করান এবং সেভ (SAVE ) বাটনে ক্লিক করুন।
    7. সংরক্ষণ করুন এবং চালিয়ে যান- এ ক্লিক করুন। সারাংশ প্যানেলটি প্রদর্শিত হবে।
    8. আপনার OAuth সম্মতি স্ক্রিনের তথ্য পর্যালোচনা করুন, এবং তারপর 'ড্যাশবোর্ডে ফিরে যান' (Back to dashboard) এ ক্লিক করুন।

সম্পূর্ণ বিবরণের জন্য গুগল ক্লাউড কনসোল হেল্প সাইটে আপনার OAuth সম্মতি স্ক্রিন সেট আপ করা দেখুন। চালিয়ে যাওয়ার আগে অন্তত একজন পরীক্ষামূলক ব্যবহারকারী যোগ করতে ভুলবেন না।

OAuth ক্রেডেনশিয়াল সেট আপ করুন

  1. OAuth 2.0 সেট আপ করার নির্দেশাবলী অনুসরণ করে স্যাম্পল অ্যাপটিকে OAuth 2.0-এর জন্য রেজিস্টার করুন এবং OAuth ক্রেডেনশিয়াল তৈরি করুন।
    1. অ্যাপ্লিকেশনটির ধরন উল্লেখ করুন, যা নেটিভ/অ্যান্ড্রয়েড অ্যাপ ।
    2. Google Cloud Console Help সাইটে Setting up OAuth 2.0 / Native applications / Android-এর নির্দেশাবলী অনুসরণ করে OAuth ক্লায়েন্টে SHA-1 ফিঙ্গারপ্রিন্ট যোগ করুন। ডেভেলপমেন্ট প্রক্রিয়া জুড়ে আপনাকে ডিফল্ট Android Studio কী থেকে SHA-1 কী তৈরি করতে হবে।

অ্যাপটি চালান

  1. আপনার মোবাইল ডিভাইসটি লোকাল মেশিনের সাথে সংযুক্ত করে, স্যাম্পল অ্যাপটি আপনার মোবাইল ডিভাইসে চালানোর জন্য আবার 'Run project'- এ ক্লিক করুন।

একবার ইনস্টল হয়ে গেলে, অ্যাপটি আপনার মোবাইল ডিভাইসে Home API Sample App নামে পাওয়া যাবে।