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

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

পূর্বশর্ত

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

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

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

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

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

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

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

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

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

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

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

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

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

SDK সেট আপ করুন

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

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

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

নির্মাণ এবং চালান

  1. Android Studio খুলুন, তারপর google-home-api-sample-app-android প্রজেক্ট ফোল্ডারটি খুলুন যা আপনার স্থানীয় মেশিনে ক্লোন করা হয়েছিল।
  2. আপনার প্রথম সেটআপের সময়, Android Studio সমস্ত প্রকল্প নির্ভরতা ডাউনলোড করতে এবং গ্রেডল বিল্ড সম্পূর্ণ করতে 10 মিনিট পর্যন্ত সময় নিতে পারে।
    • আপনি যদি এই ধাপে একটি ত্রুটি পান, যেমন Gradle Sync Failed , আবার সিঙ্ক শুরু করতে আবার চেষ্টা করুন ক্লিক করুন।
  3. নমুনা অ্যাপের জন্য প্যাকেজের নাম পরিবর্তন করুন একটি নতুন যা আগে নিবন্ধিত হয়নি, যেমন আপনার প্রতিষ্ঠানের নামের উপর ভিত্তি করে:
    1. প্রকল্প খুলুন.
    2. উত্স শ্রেণিবিন্যাস প্রসারিত করুন।
    3. আপনি যে প্যাকেজটি পরিবর্তন করতে চান তার অংশ নির্বাচন করুন - অন্য কথায়, com.example ।
    4. প্যাকেজে ডান-ক্লিক করুন এবং রিফ্যাক্টর > পুনঃনামকরণ নির্বাচন করুন...
    5. সমস্ত ডিরেক্টরিতে ক্লিক করুন।
    6. নতুন নাম লিখুন এবং রিফ্যাক্টর ক্লিক করুন।
    7. build.gradle.kts ফাইলটি সম্পাদনা করুন, android namespace এবং applicationId নতুন প্যাকেজের নামে পরিবর্তন করুন।
    8. AndroidManifest.xml ফাইলটি সম্পাদনা করুন এবং প্যাকেজটিকে নতুন প্যাকেজের নামে পরিবর্তন করুন যেখানেই ফাইলটিতে এটি ঘটে।

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

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

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

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

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

  6. OAuth 2.0 এর জন্য নমুনা অ্যাপটি নিবন্ধন করুন এবং OAuth 2.0 সেট আপ করার নির্দেশাবলী অনুসরণ করে OAuth শংসাপত্র তৈরি করুন৷

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

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

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