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

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

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

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

শুরু করুন

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

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

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

ফাইল প্রকাশ করুন

হেলথ প্ল্যাটফর্ম V1 রিলিজে নিম্নলিখিতগুলি রয়েছে:

• ক্লায়েন্ট SDK : Health Platform API ব্যবহার করার জন্য আপনার অ্যাপ্লিকেশনে এই SDKটি অন্তর্ভুক্ত করুন। SDK হল একটি Maven সংগ্রহস্থল যা আপনি সরাসরি আপনার অ্যাপ্লিকেশন Gradle বিল্ড ফাইলগুলিতে অন্তর্ভুক্ত করতে পারেন।

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

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

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

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

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

উপাত্ত

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

হেলথ প্ল্যাটফর্মের কেন্দ্রীয় বিষয়গুলি এবং সেগুলি কীভাবে আলাদা তা এখানে দেখুন:

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

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

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

ডেটা টাইপ

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

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

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

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

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

SampleData ধরণ:

IntervalData প্রকার:

SeriesData টাইপ:

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

হেলথ প্ল্যাটফর্মের মধ্যে উপলব্ধ স্ট্যান্ডার্ড ডেটা ফাংশনগুলির সেটটি নীচে বর্ণনা করা হয়েছে। প্ল্যাটফর্মটি কাঁচা ডেটার জন্য স্ট্যান্ডার্ড ইনসার্ট, আপডেট এবং ডিলিট ফাংশন সরবরাহ করে।

সমষ্টিগত ডেটা পড়ুন

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

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

Health Platform API-এর সাথে সংযোগ করুন

HealthDataClient হল Health Platform API-এর প্রবেশপথ।

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

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

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