স্বাস্থ্য প্ল্যাটফর্ম API

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

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

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

শুরু করুন

হেলথ প্ল্যাটফর্ম ব্যবহার করার সময় নিম্নলিখিত বিষয়গুলো মনে রাখবেন:

• ক্লায়েন্ট অ্যাপগুলোকে অবশ্যই ব্যবহারকারীর কাছ থেকে পঠন বা লিখন অ্যাক্সেসের জন্য সুনির্দিষ্ট অনুমতি নিতে হবে।
• ব্যবহারকারী পরবর্তীতে যেকোনো সময়ে অনুমতি অস্বীকার বা প্রত্যাহার করতে পারেন।
• হেলথ প্ল্যাটফর্ম এপিআই শুধুমাত্র নির্দিষ্ট কিছু স্যামসাং ডিভাইস সমর্থন করে।
• HealthDataClient হলো হেলথ প্ল্যাটফর্মের ক্লায়েন্ট এবং এই প্ল্যাটফর্মে প্রবেশের একটি প্রবেশপথ।

নিম্নলিখিত চিত্রটি ডেভেলপারদের অবশ্যই অনুসরণ করতে হবে এমন প্রয়োজনীয় ইন্টিগ্রেশন ধাপগুলি দেখায়:

রিলিজ ফাইল

হেলথ প্ল্যাটফর্ম ভি১ রিলিজে নিম্নলিখিত বিষয়গুলো অন্তর্ভুক্ত রয়েছে:

• ক্লায়েন্ট এসডিকে : হেলথ প্ল্যাটফর্ম এপিআই ব্যবহার করার জন্য আপনার অ্যাপ্লিকেশনে এই এসডিকে-টি অন্তর্ভুক্ত করুন। এসডিকে-টি একটি মেভেন রিপোজিটরি, যা আপনি সরাসরি আপনার অ্যাপ্লিকেশনের গ্রেডল বিল্ড ফাইলে অন্তর্ভুক্ত করতে পারেন।

স্বাস্থ্য প্ল্যাটফর্ম ইনস্টল করুন

নিম্নলিখিত ধাপগুলো অনুসরণ করে হেলথ প্ল্যাটফর্ম ইনস্টল করুন:

অ্যাপের রুট build.gradle ফাইলে, নিচের উদাহরণে দেখানো অনুযায়ী রিপোজিটরিটি যোগ করুন:

allprojects {
    . . .
    repositories {
        . . .
        google()
    }
}

নিম্নলিখিত উদাহরণে দেখানো অনুযায়ী, আপনার মডিউলের build.gradle ফাইলে হেলথ প্ল্যাটফর্ম SDK-এর উপর একটি ডিপেন্ডেন্সি যোগ করুন:

ডেটা

হেলথ প্ল্যাটফর্ম স্বাস্থ্য ও ফিটনেস সংক্রান্ত ডেটা সংরক্ষণ এবং কাঠামোবদ্ধ করে। এটি বিভিন্ন ধরনের ডেটা পরিমাপের পদ্ধতির মধ্যকার মৌলিক পার্থক্যগুলোও বিবেচনা করে। উদাহরণস্বরূপ, হৃদস্পন্দনের হার তাৎক্ষণিকভাবে পরিমাপ করা হয়, কিন্তু পদক্ষেপের সংখ্যা একটি নির্দিষ্ট সময় ধরে গণনা করা হয়।

হেলথ প্ল্যাটফর্মের প্রধান অবজেক্টগুলো এবং সেগুলোর মধ্যে পার্থক্যগুলো এখানে তুলে ধরা হলো:

• RawData : একটি পরিমাপ এবং তথ্যের রেকর্ড।
• DataType : স্বাস্থ্য ও ফিটনেস ডেটার সাধারণ প্রকার, যেমন হৃদস্পন্দন, শরীরের চর্বি বা শরীরের তাপমাত্রা, এবং তাদের ফরম্যাট, যেমন ফিল্ড, রিড-অনলি বা অপশনাল, নির্দিষ্ট করার একটি স্পেসিফায়ার।
• SampleData : একটি RawData অবজেক্ট যা একটি তাৎক্ষণিক পরিমাপ, যেমন হৃদস্পন্দন, রক্তচাপ বা দৌড়ের গতি।
• IntervalData : একটি RawData অবজেক্ট যা একটি নির্দিষ্ট সময় ধরে নেওয়া ক্রমবর্ধমান পরিমাপ, যেমন গৃহীত পদক্ষেপের সংখ্যা, অতিক্রান্ত দূরত্ব বা পোড়ানো ক্যালোরি।
• SeriesData : একটি RawData অবজেক্ট যা একটি নির্দিষ্ট সময় ধরে পরিমাপের একটি ক্রমকে ধারণ করে। SeriesData বিশেষত উচ্চ-ফ্রিকোয়েন্সির সেন্সর ডেটার জন্য উপযুক্ত, যেমন কোনো কার্যকলাপ চলাকালীন হৃদস্পন্দনের অবিচ্ছিন্ন নমুনা।

RawData এর তিনটি ক্লাসের প্রতিটি DataType এর একটি নির্দিষ্ট সাবক্লাসের সাথে সঙ্গতিপূর্ণ: SampleData , IntervalData এবং SeriesData যথাক্রমে SampleDataType , IntervalDataType এবং SeriesDataType সাথে সঙ্গতিপূর্ণ।

প্রতিটি RawData অবজেক্ট ইনসার্ট করার সময় হেলথ প্ল্যাটফর্ম দ্বারা এটিকে একটি অনন্য শনাক্তকারী (UID) প্রদান করা হয়। রিড, আপডেট বা ডিলিট অনুরোধে একটি নির্দিষ্ট RawData অবজেক্টকে নির্দেশ করার জন্য আপনি এই UID ব্যবহার করতে পারেন।

ডেটা টাইপ

হেলথ প্ল্যাটফর্মে বিভিন্ন ধরনের ডেটা টাইপ অন্তর্ভুক্ত রয়েছে, যা সাধারণত স্বাস্থ্য ও ফিটনেস অ্যাপগুলোতে ব্যবহৃত হয়। উপলব্ধ ডেটা টাইপগুলোর মাধ্যমে সংরক্ষিত তথ্য ব্যবহারকারীদের তাদের অতীতের স্বাস্থ্য, ফিটনেস এবং সুস্থতা সম্পর্কিত তথ্যের একটি সামগ্রিক চিত্র প্রদান করে, যা তাদের দৈনন্দিন কার্যকলাপ সম্পর্কে অন্তর্দৃষ্টি দেয়।

প্রতিটি ডেটা টাইপ তার ডেটা ফরম্যাট দ্বারা সংজ্ঞায়িত হয়, যার মধ্যে নিম্নলিখিত বিষয়গুলো অন্তর্ভুক্ত:

• ফিল্ড: ডেটা টাইপের সাথে সম্পর্কিত নির্দিষ্ট বা সাধারণ ফিল্ডসমূহ। উদাহরণস্বরূপ, ব্লাড অক্সিজেন স্যাচুরেশন (SpO2) ডেটা টাইপের টাইটেল, নোটস এবং পার্সেন্টেজ-এর মতো ফিল্ড রয়েছে।
• টাইপ: লং, ডাবল, স্ট্রিং, অথবা এনাম।
• অ্যাট্রিবিউট: পঠনযোগ্য, আবশ্যক, ঐচ্ছিক, অথবা যাচাইকরণ পরিসীমা।

ডেটা প্রকারের তালিকা

উপলব্ধ ডেটা টাইপগুলো বুঝে হেলথ প্ল্যাটফর্মের সর্বোত্তম ব্যবহার করুন। হেলথ প্ল্যাটফর্ম নিম্নলিখিত সারণিতে দেখানো ডেটা টাইপগুলো সমর্থন করে। ডেটা টাইপগুলো তাদের ফরম্যাট অনুযায়ী সাজানো হয়েছে: স্যাম্পল, ইন্টারভ্যাল বা সিরিজ।

SampleData প্রকার:

IntervalData প্রকার:

SeriesData প্রকার:

ডেভেলপার ফাংশন

নিম্নলিখিত অংশে হেলথ প্ল্যাটফর্মে উপলব্ধ স্ট্যান্ডার্ড ডেটা ফাংশনগুলো বর্ণনা করা হলো। প্ল্যাটফর্মটি র ডেটার জন্য স্ট্যান্ডার্ড ইনসার্ট, আপডেট এবং ডিলিট ফাংশন সরবরাহ করে।

একত্রিত ডেটা পড়ুন

এই প্ল্যাটফর্মটি ক্লায়েন্টদের নিম্নলিখিত ধরণের AggregatedData ) উপর একটি একত্রিতকরণ ফাংশন প্রয়োগ করার সুযোগ দেয়:

• StatisticalData : SampleData বা SeriesData -র কোনো সেটের গড়, সর্বনিম্ন বা সর্বোচ্চ মান, যেমন কোনো একটি কার্যকলাপের সময়কার সর্বনিম্ন ও সর্বোচ্চ হৃদস্পন্দন।
• CumulativeData : IntervalData মানগুলির যোগফল, যেমন একটি দৈনিক ব্যবধানের মধ্যে মোট পদক্ষেপের সংখ্যা।
• CountData : অন্তর্নিহিত RawData অবজেক্টের সংখ্যার গণনা, যেমন একটি নির্দিষ্ট সপ্তাহে অ্যাক্টিভিটি সেশনের সংখ্যা। স্যাম্পল, ইন্টারভাল এবং সিরিজ ডেটা টাইপের জন্য কাউন্ট ডেটা গণনা করা যেতে পারে।

হেলথ প্ল্যাটফর্ম এপিআই-এর সাথে সংযোগ করুন

HealthDataClient হলো হেলথ প্ল্যাটফর্ম এপিআই-এর প্রবেশপথ।

হেলথ প্ল্যাটফর্মে সংযোগ করার পদ্ধতি নিচে বর্ণনা করা হলো:

1. নতুন HealthDataClient ইনস্ট্যান্স তৈরি করতে HealthDataService.getClient ব্যবহার করুন।
2. এরপর ক্লায়েন্ট অ্যাপটিকে অবশ্যই requestPermissions (Set) মেথড ব্যবহার করে ব্যবহারকারীর কাছে অনুমতি চাইতে হবে।

HealthDataClient স্বয়ংক্রিয়ভাবে অন্তর্নিহিত স্টোরেজ লেয়ারের সাথে তার সংযোগ পরিচালনা করে এবং সমস্ত আন্তঃপ্রক্রিয়া যোগাযোগ (IPC) ও বহির্গামী অনুরোধ এবং আগত প্রতিক্রিয়ার সিরিয়ালাইজেশন সামলায়।