এই নির্দেশিকাটি ব্যাখ্যা করে কিভাবে Android এ Google Fit-এর মাধ্যমে বিকাশ শুরু করতে হয়।
সেটআপ
আপনি আপনার অ্যাপ তৈরি করা শুরু করার আগে, নিম্নলিখিত বিভাগগুলিতে পদক্ষেপগুলি সম্পূর্ণ করুন৷
একটি Google অ্যাকাউন্ট পান
Google Fit API ব্যবহার করতে, আপনার একটি Google অ্যাকাউন্ট প্রয়োজন৷ আপনি একটি নতুন অ্যাকাউন্ট তৈরি করতে পারেন বা একটি বিদ্যমান অ্যাকাউন্ট ব্যবহার করতে পারেন।
Google Play পরিষেবা পান৷
আপনার ডেভেলপমেন্ট হোস্টে Google Play পরিষেবার জন্য সর্বশেষ ক্লায়েন্ট লাইব্রেরি পান:
- অ্যান্ড্রয়েড এসডিকে ম্যানেজার খুলুন।
- SDK টুলের অধীনে, Google Play পরিষেবাগুলি খুঁজুন।
- যদি এই প্যাকেজগুলির জন্য স্থিতি ইনস্টল করা না থাকে, তাহলে উভয়ই নির্বাচন করুন এবং প্যাকেজ ইনস্টল করুন ক্লিক করুন।
একটি OAuth 2.0 ক্লায়েন্ট আইডি পান
ফিটনেস API সক্ষম করতে, একটি OAuth 2.0 ক্লায়েন্ট আইডি পান ৷
আপনার প্রকল্প তৈরি করুন এবং কনফিগার করুন
আমরা ফিটনেস এপিআই সহ একটি অ্যাপ তৈরি করতে Android স্টুডিও উন্নয়ন পরিবেশ ব্যবহার করার পরামর্শ দিই। কিভাবে একটি নতুন প্রজেক্ট তৈরি করতে হয় এবং অ্যান্ড্রয়েড স্টুডিওতে কনফিগার করতে হয় তার বিস্তারিত জানার জন্য, একটি প্রজেক্ট তৈরি করুন দেখুন।
Google Play পরিষেবার ক্লায়েন্ট লাইব্রেরি যোগ করুন
অ্যান্ড্রয়েড স্টুডিওতে, আপনার মডিউলের জন্য build.gradle
ফাইলটি খুলুন এবং নির্ভরতা হিসাবে Google Play পরিষেবা ক্লায়েন্ট লাইব্রেরি যোগ করুন:
plugin { id("com.android.application") } ... dependencies { implementation("com.google.android.gms:play-services-fitness:21.2.0") implementation("com.google.android.gms:play-services-auth:21.2.0") }
apply plugin: 'com.android.application' ... dependencies { implementation 'com.google.android.gms:play-services-fitness:21.2.0' implementation 'com.google.android.gms:play-services-auth:21.2.0' }
এটি নিশ্চিত করে যে Gradle আপনার অ্যাপ তৈরি করার সময় স্বয়ংক্রিয়ভাবে ফিটনেস SDK ডাউনলোড করে।
আপনার অ্যাপ তৈরি করুন এবং পরীক্ষা করুন
আপনি সেটআপ পদক্ষেপগুলি শেষ করার পরে, আপনি আপনার অ্যাপ তৈরি করা শুরু করতে পারেন৷ শুরু করতে, আপনার অ্যাপ যে ধরনের ডেটা সঞ্চয় করতে এবং পড়তে পারে সে সম্পর্কে জানুন৷ Google Fit-এ ডেটা নিয়ে কাজ করার বিষয়ে আরও জানুন।
প্রয়োজনীয় অ্যান্ড্রয়েড অনুমতি পান
কিছু ধরণের ডেটা পড়তে এবং লিখতে, আপনার অ্যাপটিকে Android অনুমতির অনুরোধ করতে হবে।
OAuth অনুমতি পান
আপনার অ্যাপ্লিকেশানের অ্যাক্সেস করার অনুমতি রয়েছে এমন ডেটা প্রকারগুলি অনুমোদনের সুযোগগুলির সাথে সম্পর্কিত৷ এই অনুমতিগুলি চাওয়ার জন্য, আপনাকে FitnessOptions
দৃষ্টান্তে আপনার অ্যাপের কোন ধরনের ডেটা অ্যাক্সেস করতে হবে তা যোগ করতে হবে। যখন আপনার অ্যাপ Google Fit ডেটা প্রকারের যেকোনো একটি ব্যবহার করতে বলে, তখন Android SDK স্বয়ংক্রিয়ভাবে পরীক্ষা করে যে তারা কোন স্কোপের অন্তর্ভুক্ত এবং ব্যবহারকারীকে সেই স্কোপের অনুমোদনের জন্য জিজ্ঞাসা করে।
একটি API ক্লায়েন্ট তৈরি করুন
একটি API ক্লায়েন্ট তৈরি করুন এবং ডেটা লিখতে বা পড়ার জন্য আপনার অ্যাপের অ্যাক্সেসের প্রয়োজন এমন ডেটা প্রকারগুলি যোগ করুন। নিম্নলিখিত শেষ পয়েন্ট উপলব্ধ:
-
SensorsClient
: স্থানীয় ডিভাইস এবং সহচর ডিভাইসে হার্ডওয়্যার সেন্সর থেকে স্বাস্থ্য এবং সুস্থতার ডেটার বিভিন্ন উত্স অ্যাক্সেস করুন। -
RecordingClient
: কম শক্তির জন্য, সর্বদা-সেন্সর ডেটার পটভূমি সংগ্রহ। -
HistoryClient
: Google Fit-এ ঐতিহাসিক ডেটা সন্নিবেশ করান, মুছুন এবং পড়ুন। -
SessionsClient
: ব্যবহারকারীর কার্যকলাপের সেশন তৈরি এবং পরিচালনা করুন। -
GoalsClient
: Google Fit-এ ব্যবহারকারীদের দ্বারা তৈরি হার্ট পয়েন্ট এবং পদক্ষেপের লক্ষ্যগুলি পড়ুন। -
ConfigClient
: Google Fit প্ল্যাটফর্মে কাস্টম ডেটা প্রকার এবং সেটিংস অ্যাক্সেস করুন৷
কিভাবে একটি Fitness API ক্লায়েন্ট তৈরি করতে হয় তার একটি উদাহরণ দেখুন।
ফলে ব্যবহারকারীর অনুমোদন প্রবাহ
নিম্নলিখিত অনুমোদনের প্রবাহ দেখায় যা ব্যবহারকারীরা যখন তাদের অনুমতি চাওয়া হয় তখন তাদের অভিজ্ঞতা হয়:
- অ্যান্ড্রয়েড পারমিশন : ব্যবহারকারীরা দেখেন আপনার অ্যাপ ডাউনলোড করার আগে কী কী অ্যান্ড্রয়েড অনুমতির অনুরোধ করেছে। আপনার অ্যাপ ডাউনলোড হওয়ার পরে, এটি প্রয়োজনীয় যেকোন রানটাইম অনুমতির জন্য অনুরোধ করে এবং ব্যবহারকারীরা এই অনুমতিগুলি মঞ্জুর বা অস্বীকার করে৷
- চেক করুন এবং সংযোগ করুন : আপনার অ্যাপটি অন্যান্য ডেটা প্রকারে অ্যাক্সেসের অনুরোধ করার আগে অনুমতি দেওয়া হয়েছিল কিনা তা পরীক্ষা করে।
- OAuth স্কোপের অনুরোধ : Google ব্যবহারকারীকে আপনার অ্যাপটিকে যে ডেটা টাইপগুলি অ্যাক্সেস করতে চায় তার জন্য প্রয়োজনীয় OAuth স্কোপ দেওয়ার জন্য অনুরোধ করে৷
- অ্যাক্সেস প্রযোজ্য : ব্যবহারকারীর অনুমতি দেওয়ার পরে, আপনার অ্যাপ ব্যবহারকারীর অনুমতি দেওয়া স্কোপের অন্তর্গত ডেটা প্রকারগুলি অ্যাক্সেস করতে পারে।
যাচাইয়ের জন্য আবেদন করুন
আপনি আপনার অ্যাপ তৈরি এবং পরীক্ষা করার পরে, আপনাকে সংবেদনশীল এবং সীমাবদ্ধ সুযোগের জন্য প্রয়োজনীয় বিভিন্ন স্তরের ন্যায্যতা সহ যাচাইয়ের জন্য আবেদন করতে হবে।