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

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

পূর্বশর্ত

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

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

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

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

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

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

স্যাম্পল অ্যাপের সোর্স কোডটি GitHub-এ পাওয়া যাচ্ছে।

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

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

SDK সেট আপ করুন

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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