হোম APIs অ্যান্ড্রয়েড নমুনা অ্যাপ্লিকেশন

নমুনা অ্যাপটি Android এর জন্য Google Home API-এর মৌলিক ক্ষমতা প্রদর্শন করে।

পূর্বশর্ত

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

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

  • একটি Android ডিভাইস যা Android 10 বা তার পরে চলমান একটি Google অ্যাকাউন্টের সাথে সেট আপ করে যা আপনি বিকাশের জন্য ব্যবহার করতে চান। নিশ্চিত করুন যে Android Studio একটি আপ-টু-ডেট সংস্করণ ইনস্টল করা আছে এবং এই ডেভেলপমেন্ট অ্যাকাউন্টের সাথে সাইন ইন করা আছে।
  • একটি Wi-Fi নেটওয়ার্ক।
  • Matter ডিভাইসগুলি অ্যাক্সেস এবং নিয়ন্ত্রণ করতে, আপনার একটি Google হাবও প্রয়োজন যা হোম API সমর্থন করে । বিস্তারিত জানার জন্য Android-এ কানেক্টিভিটি দেখুন।
  • বাড়িতে অন্তত একটি সমর্থিত ডিভাইস। যদি এই ডিভাইসটি (বা অন্য কোনো আপনি পরীক্ষা করতে চান) থ্রেড ব্যবহার করে, হাবটি অবশ্যই একটি থ্রেড বর্ডার রাউটার হতে হবে। নিম্নলিখিত ডিভাইসের ধরন এবং বৈশিষ্ট্যগুলি Android নমুনা অ্যাপ দ্বারা সমর্থিত:

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

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

নমুনা অ্যাপের সোর্স কোড GitHub এ উপলব্ধ।

আপনি যেখানে প্রকল্পটি সংরক্ষণ করতে চান সেখানে নেভিগেট করুন, তারপরে এটি ক্লোন করুন:

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

SDK সেট আপ করুন

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

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

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

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

  1. Android Studio খুলুন, তারপর google-home-api-sample-app-android প্রজেক্ট ফোল্ডারটি খুলুন যা আপনার স্থানীয় মেশিনে ক্লোন করা হয়েছিল।
  2. আপনার প্রথম সেটআপের সময়, Android Studio সমস্ত প্রকল্প নির্ভরতা ডাউনলোড করতে এবং গ্রেডল বিল্ড সম্পূর্ণ করতে 10 মিনিট পর্যন্ত সময় নিতে পারে।

  3. একটি USB কেবলের মাধ্যমে আপনার কম্পিউটারকে একটি ফিজিক্যাল অ্যান্ড্রয়েড ফোনে সংযুক্ত করুন এবং বিকাশকারী বিকল্পগুলিতে ADB সক্ষম করুন৷ নিশ্চিত করুন যে Android Studio ADB এর মাধ্যমে Android ফোনের সাথে সংযোগ করতে পারে।

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

    1. প্রকল্প খুলুন.
    2. উত্স শ্রেণিবিন্যাস প্রসারিত করুন।
    3. আপনি যে প্যাকেজটি পরিবর্তন করতে চান তার অংশ নির্বাচন করুন - অন্য কথায়, com.example
    4. প্যাকেজটিতে ডান-ক্লিক করুন এবং রিফ্যাক্টর > পুনঃনামকরণ নির্বাচন করুন... রিফ্যাক্টর > রিনেম মেনু
    5. নতুন নাম লিখুন এবং রিফ্যাক্টর ক্লিক করুন।
    6. build.gradle.kts ফাইলটি সম্পাদনা করুন, android namespace এবং applicationId নতুন প্যাকেজের নামে পরিবর্তন করুন।
  5. সমস্ত প্রয়োজনীয় লাইব্রেরি ডাউনলোড হয়ে গেলে এবং গ্র্যাডল সিঙ্ক্রোনাইজেশন সম্পূর্ণ হওয়ার পরে, অ্যাপটি তৈরি এবং চালানোর জন্য রান বোতামে ক্লিক করুন। যখন অ্যাপটি আপনার ফোনে সফলভাবে চলছে, আপনি নমুনা অ্যাপের মূল পৃষ্ঠাটি দেখতে পাবেন।

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

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

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

    আপনার স্থানীয় মেশিনে আপনার মোবাইল ডিভাইস সংযোগ করুন. Android Studio মডেল নম্বর দ্বারা আপনার সংযুক্ত ডিভাইস তালিকাভুক্ত করবে। তালিকা থেকে আপনার ডিভাইস নির্বাচন করুন, তারপর প্রকল্প চালান ক্লিক করুন। এটি আপনার মোবাইল ডিভাইসে নমুনা অ্যাপ তৈরি করে এবং ইনস্টল করে।

    আরও বিশদ নির্দেশাবলীর জন্য, Android বিকাশকারী সাইটে একটি হার্ডওয়্যার ডিভাইসে অ্যাপ্লিকেশন চালান দেখুন৷

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

  2. Google ক্লাউড কনসোল হেল্প সাইটে OAuth ক্লায়েন্ট / অ্যাপ্লিকেশন প্রকার / নেটিভ অ্যাপ্লিকেশন / অ্যান্ড্রয়েড পরিচালনায় বিশদ নির্দেশাবলী অনুসরণ করে আপনার ডিবাগ শংসাপত্রের SHA-1 ফিঙ্গারপ্রিন্ট পান৷

  1. Google ক্লাউড কনসোলে, প্রকল্প নির্বাচক ড্যাশবোর্ডে যান এবং OAuth শংসাপত্র তৈরি করতে আপনি যে প্রকল্পটি ব্যবহার করতে চান সেটি নির্বাচন করুন৷
  2. APIs এবং পরিষেবা পৃষ্ঠাতে যান এবং নেভিগেশন মেনুতে শংসাপত্রে ক্লিক করুন।
  3. আপনি যদি এখনও এই Google ক্লাউড প্রকল্পের জন্য আপনার সম্মতি স্ক্রীন কনফিগার না করে থাকেন, তাহলে কনফিগার সম্মতি স্ক্রীন বোতামটি প্রদর্শিত হবে। সেই ক্ষেত্রে, নিম্নলিখিত পদ্ধতি ব্যবহার করে আপনার সম্মতি স্ক্রিন কনফিগার করুন। অন্যথায়, পরবর্তী বিভাগে যান।

    1. সম্মতি স্ক্রীন কনফিগার করুন ক্লিক করুন। OAuth সম্মতি স্ক্রীন পৃষ্ঠা দেখায়।
    2. আপনার ব্যবহারের ক্ষেত্রে নির্ভর করে, অভ্যন্তরীণ বা বাহ্যিক নির্বাচন করুন এবং তারপরে তৈরি করুন ক্লিক করুন। OAuth সম্মতি স্ক্রিন প্যানে প্রদর্শিত হয়।
    3. অন-স্ক্রীন নির্দেশাবলী অনুসারে অ্যাপ তথ্য পৃষ্ঠায় তথ্য লিখুন এবং তারপর সংরক্ষণ করুন এবং চালিয়ে যান ক্লিক করুন। স্কোপস ফলক প্রদর্শন করে।
    4. আপনাকে কোনো স্কোপ যোগ করতে হবে না, তাই সংরক্ষণ করুন এবং চালিয়ে যান এ ক্লিক করুন। পরীক্ষা ব্যবহারকারী ফলক প্রদর্শন করে।
    5. Audience-এ ক্লিক করুন এবং + ADD USERS বোতামে ক্লিক করুন।
    6. আপনার পরীক্ষার ব্যবহারকারীর ইমেল ঠিকানা লিখুন এবং সংরক্ষণ বোতামে ক্লিক করুন।
    7. সংরক্ষণ করুন এবং চালিয়ে যান ক্লিক করুন। সারাংশ ফলক প্রদর্শন করে।
    8. আপনার OAuth সম্মতি স্ক্রীন তথ্য পর্যালোচনা করুন, এবং তারপর ড্যাশবোর্ডে ফিরে যান ক্লিক করুন।

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

OAuth শংসাপত্র সেট আপ করুন৷

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

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

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

একবার ইনস্টল হয়ে গেলে, অ্যাপটি আপনার মোবাইল ডিভাইসে হোম API নমুনা অ্যাপ হিসাবে উপলব্ধ।