Home API Android স্যাম্পেল অ্যাপ

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

পূর্বশর্ত

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

• Android Studio, ভার্সন 2024.2.1 ("Ladybug") বা তার পরবর্তী ভার্সন। মনে রাখবেন, এর আগের ভার্সনগুলি Home APIs SDK-এর সাথে সঠিকভাবে কাজ নাও করতে পারে।

  Android Studio ডাউনলোড করুন

• Android ডিবাগার (adb)।

  adb ইনস্টল করুন।

  SDK Manager-এর মাধ্যমে এটি করা যেতে পারে।

এবং Home API পরীক্ষা করতে, আপনার যা প্রয়োজন:

• Android 10 বা তার পরবর্তী ভার্সনে চলে এমন Android ডিভাইস যা আপনি ডেভেলপমেন্টের জন্য ব্যবহার করতে চান এমন Google অ্যাকাউন্টের সাথে সেট-আপ করা আছে। Android Studio-এর আপ-টু-ডেট ভার্সন ইনস্টল করা আছে কিনা এবং এই ডেভেলপমেন্ট অ্যাকাউন্ট দিয়ে সাইন-ইন করা আছে কিনা তা ভালভাবে দেখে নিন।
• একটি ওয়াই-ফাই নেটওয়ার্ক।
• Matter ডিভাইস অ্যাক্সেস ও কন্ট্রোল করতে, আপনার কাছে Home API-তে কাজ করে এমন Google হাব থাকতে হবে। বিস্তারিত জানতে Android-এ কানেক্টিভিটি দেখুন।

• হোমে অন্তত একটি কাজ করে এমন ডিভাইস। এই ডিভাইস (বা আপনি পরীক্ষা করতে চান এমন অন্য কোনও ডিভাইস) Thread ব্যবহার করলে, হাবটিকেও অবশ্যই Thread Border Router (TBR) হতে হবে। Android স্যাম্পেল অ্যাপে নিম্নলিখিত ধরনের ডিভাইস ও ট্রেট কাজ করে:

  • কালার টেম্পারেচার লাইট (চালু ও বন্ধ, উজ্জ্বলতা)
  • কন্ট্যাক্ট সেন্সর (বুলিয়ান স্টেট)
  • ডিম করা যায় এমন লাইট (চালু ও বন্ধ, উজ্জ্বলতা)
  • ডোর লক
  • এক্সটেন্ডেড কালার লাইট (চালু ও বন্ধ, উজ্জ্বলতা)
  • জেনেরিক সুইচ
  • Google Border Router
  • Google ক্যামেরা
  • Google Doorbell
  • বাড়িতে কেউ আছেন কিনা নেই তা শনাক্ত করার সেন্সর (বাড়িতে কেউ আছেন কিনা নেই তা শনাক্ত করা)
  • লাইট চালু/বন্ধ করা (চালু ও বন্ধ করা, উজ্জ্বলতা)
  • লাইট চালু/বন্ধ করার সুইচ
  • চালু/বন্ধ করার প্লাগ-ইন ইউনিট (চালু ও বন্ধ)
  • চালু/বন্ধ করার সেন্সর

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

স্যাম্পেল অ্যাপের সোর্স কোড GitHub-এ উপলভ্য।

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

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

SDK সেট-আপ করা

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

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

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

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

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

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

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

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

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

5. HomeModule.kt-এ OAuth স্কোপ কনফিগার করুন। ডিফল্ট হিসেবে, স্যাম্পেল অ্যাপের সোর্স কোড https://www.googleapis.com/auth/home.platform.v2 স্কোপ ব্যবহার করে। Sample App-এর অনেক ফিচার home.platform.v2 স্কোপ দ্বারা গেট করা থাকে এবং অ্যাক্সেস করার জন্য পার্টনারের অনুমোদনের প্রয়োজন হয়। স্ট্যান্ডার্ড https://www.googleapis.com/auth/home.platform.selected.devices স্কোপের সাথে স্যাম্পেল অ্যাপ চালাতে, HomeModule.kt খুলুন এবং HomeConfig-এ homePlatformScope পরিবর্তন করে HOME_PLATFORM_SCOPE_VERSION_1 করুন:

   val homeConfig = HomeConfig(
     coroutineContext = Dispatchers.IO,
     factoryRegistryProvider = {
       FactoryConstants.factoryRegistryAllTraitsAllTypes
     },
     homePlatformScope =
       HomeConfig.HomePlatformScope.HOME_PLATFORM_SCOPE_VERSION_1
   )
   

HomeClientProvider.kt-এ switchAccount()-এ homePlatformScope থেকে HOME_PLATFORM_SCOPE_VERSION_1-এ আপডেট করুন। অন্যথায়, অ্যাকাউন্ট পরিবর্তন করার জন্য প্রোফাইল আইকন বেছে নিলে, অ্যাপটি আবার HOME_PLATFORM_SCOPE_VERSION_2-এ ফিরে যায়।

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

স্বাক্ষর করার সার্টিফিকেট তৈরি করুন

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

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

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

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

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

2. Google Cloud Console সহায়তা সাইটে OAuth ক্লায়েন্ট / অ্যাপ্লিকেশনের ধরন / নেটিভ অ্যাপ্লিকেশন / Android ম্যানেজ করুন লিঙ্কে দেওয়া নির্দেশাবলী অনুসরণ করে আপনার ডিবাগ সার্টিফিকেটের SHA-1 ফিঙ্গারপ্রিন্ট পান।

OAuth সম্মতি সেট-আপ করুন

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

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

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

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

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

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

অ্যাপ রান করুন

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

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