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

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

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

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

শুরু করুন

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

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

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

ইন্টিগ্রেশন-পদক্ষেপ

ফাইল রিলিজ

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

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

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

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

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

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

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

dependencies {
   …
  implementation 'com.google.android.libraries.healthdata:health-data-api:1.0.0-alpha01'
}

ডেটা

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

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

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

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

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

ডেটা প্রকার

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

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

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

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

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

SampleData প্রকার:

DataType.BasalMetabolicRateDataType BASAL_METABOLIC_RATE প্রয়োজন
DataType.BloodGlucoseDataType BLOOD_GLUCOSE প্রয়োজনীয় এবং ঐচ্ছিক
DataType.BloodPressureDataType BLOOD_PRESSURE প্রয়োজনীয় এবং ঐচ্ছিক
DataType.BodyFatDataType BODY_FAT প্রয়োজন
DataType.BodyTemperatureDataType BODY_TEMPERATURE প্রয়োজনীয় এবং ঐচ্ছিক
DataType.BoneMassDataType BONE_MASS প্রয়োজন
DataType.CervicalMucusDataType CERVICAL_MUCUS ঐচ্ছিক
DataType.CervicalPositionDataType CERVICAL_POSITION ঐচ্ছিক
DataType.CyclingPedalingCadenceDataType CYCLING_PEDALING_CADENCE প্রয়োজন
DataType.DateOfBirthDataType DATE_OF_BIRTH শুধুমাত্র পড়া
DataType.GenderDataType GENDER শুধুমাত্র পড়া
DataType.HeartRateDataType HEART_RATE প্রয়োজন
DataType.HeightDataType HEIGHT প্রয়োজন
DataType.HipCircumferenceDataType HIP_CIRCUMFERENCE প্রয়োজন
DataType.HrvDifferentialIndexDataType HRV_DIFFERENTIAL_INDEX প্রয়োজন
DataType.HrvRmssdDataType HRV_RMSSD প্রয়োজন
DataType.HrvSDataType HRV_S প্রয়োজন
DataType.HrvSd2DataType HRV_SD2 প্রয়োজন
DataType.HrvSdannDataType HRV_SDANN প্রয়োজন
DataType.HrvSdnnDataType HRV_SDNN প্রয়োজন
DataType.HrvSdnnIndexDataType HRV_SDNN_INDEX প্রয়োজন
DataType.HrvSdnnIndexDataType HRV_SDNN_INDEX প্রয়োজন
DataType.HrvSdsdDataType HRV_SDSD প্রয়োজন
DataType.HrvTinnDataType HRV_TINN প্রয়োজন
DataType.LeanBodyMassDataType LEAN_BODY_MASS প্রয়োজন
DataType.LocationDataType LOCATION প্রয়োজন
DataType.MenstruationDataType MENSTRUATION ঐচ্ছিক
DataType.OvulationTestDataType OVULATION_TEST প্রয়োজন
DataType.OxygenSaturationDataType OXYGEN_SATURATION প্রয়োজন
DataType.PaceDataType PACE প্রয়োজন
DataType.PowerDataType POWER প্রয়োজন
DataType.RespiratoryRateDataType RESPIRATORY_RATE প্রয়োজন
DataType.RestingHeartRateDataType RESTING_HEART_RATE প্রয়োজন
DataType.SexualActivityDataType SEXUAL_ACTIVITY প্রয়োজন
DataType.SpeedDataType SPEED প্রয়োজন
DataType.StepsCadenceDataType STEPS_CADENCE প্রয়োজন
DataType.Vo2MaxDataType VO2_MAX প্রয়োজনীয় এবং ঐচ্ছিক
DataType.WaistCircumferenceDataType WAIST_CIRCUMFERENCE প্রয়োজন
DataType.WeightDataType WEIGHT প্রয়োজন

IntervalData প্রকার:

DataType.ActiveEnergyDataType ACTIVE_ENERGY_BURNED প্রয়োজন
DataType.ActiveTimeDataType ACTIVE_TIME শুধুমাত্র পড়া
DataType.ActivityEventDataType ACTIVITY_EVENT প্রয়োজন
DataType.ActivityLapDataType ACTIVITY_LAP ঐচ্ছিক
DataType.ActivitySessionDataType ACTIVITY_SESSION প্রয়োজন
DataType.BasalEnergyDataType BASAL_ENERGY_BURNED শুধুমাত্র পড়া
DataType.DistanceDataType DISTANCE প্রয়োজন
DataType.ElevationGainedDataType ELEVATION_GAINED প্রয়োজন
DataType.FloorsClimbedDataType FLOORS_CLIMBED প্রয়োজন
DataType.HydrationDataType HYDRATION প্রয়োজন
DataType.NutritionDataType NUTRITION ঐচ্ছিক
DataType.RepetitionsDataType REPETITIONS প্রয়োজন
DataType.SleepSessionDataType SLEEP_SESSION ঐচ্ছিক
DataType.SleepStageDataType SLEEP_STAGE প্রয়োজন
DataType.StepsDataType STEPS প্রয়োজন
DataType.SwimmingStrokesDataType SWIMMING_STROKES প্রয়োজনীয় এবং ঐচ্ছিক
DataType.TotalEnergyDataType TOTAL_ENERGY_BURNED শুধুমাত্র পড়া

SeriesData প্রকার:

DataType.CyclingPedalingCadenceSeriesDataType CYCLING_PEDALING_CADENCE প্রয়োজন
DataType.HeartRateSeriesDataType HEART_RATE প্রয়োজন
DataType.LocationSeriesDataType LOCATION প্রয়োজন
DataType.PaceSeriesDataType PACE প্রয়োজন
DataType.PowerSeriesDataType POWER প্রয়োজন
DataType.SpeedSeriesDataType SPEED প্রয়োজন
DataType.StepsCadenceSeriesDataType STEPS_CADENCE প্রয়োজন

বিকাশকারী ফাংশন

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

Aggregated Data পড়ুন

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

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

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

HealthDataClient হল হেলথ প্ল্যাটফর্ম API-এর এন্ট্রি পয়েন্ট।

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

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

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

{% শব্দার্থে %} {% endverbatim %} {% শব্দার্থে %} {% endverbatim %}