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

Sample App-এ 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 ডিভাইস অ্যাক্সেস ও কন্ট্রোল করতে, আপনার Google হাবও প্রয়োজন যা Home API-তে কাজ করে। বিস্তারিত জানতে Android-এ কানেক্টিভিটি দেখুন।

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

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

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

Sample App-এর সোর্স কোড 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. প্রথমবার সেট-আপ করার সময়, Android Studio-এর সমস্ত প্রোজেক্টের ডিপেন্ডেন্সি ডাউনলোড করতে এবং Gradle বিল্ড সম্পূর্ণ করতে ১০ মিনিট পর্যন্ত সময় লাগতে পারে।

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

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

    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 স্কোপের সাথে Sample অ্যাপ চালাতে, 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 সিঙ্ক্রোনাইজেশন সম্পূর্ণ হলে, অ্যাপ বিল্ড ও রান করাতে রান করুন বোতামে ক্লিক করুন। আপনার ফোনে অ্যাপটি সঠিকভাবে রান করলে, আপনি Sample অ্যাপের মূল পৃষ্ঠা দেখতে পাবেন।

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

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

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

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

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

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

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

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

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

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

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