Health Connect স্বাস্থ্য এবং ফিটনেস ডেটা সঞ্চয় করে এবং গঠন করে। এটি কীভাবে বিভিন্ন ডেটা প্রকার পরিমাপ করা হয় তার জন্যও হিসাব করে। এই ডেটা প্রকারের মধ্যে রয়েছে অবিলম্বে নেওয়া হার্ট রেট পরিমাপ, সময়ের সাথে সাথে নেওয়া ধাপ গণনা এবং সেশনে নেওয়া ঘুমের ডেটা।
হেলথ কানেক্ট কী ধরনের ডেটা এবং অনুমতি দেয় তা প্রথমে বোঝা গুরুত্বপূর্ণ যাতে আপনি আপনার অ্যাপের প্রয়োজনীয়তাগুলি পরিকল্পনা করতে পারেন৷ এর সাথে, আপনি আপনার প্রয়োজনীয়তাগুলি চূড়ান্ত করার আগে আপনাকে আপনার ডেটা প্রকারগুলি পর্যালোচনা করতে হবে।
ডেটা টাইপ বিভাগ
Health Connect ডেটা প্রকারগুলিকে সমর্থন করে যা বেশিরভাগ স্বাস্থ্য এবং ফিটনেস অ্যাপ জুড়ে যতটা সম্ভব বৈচিত্র্য সরবরাহ করতে ব্যবহৃত হয়। Health Connect-এর লক্ষ্য স্বাস্থ্য এবং ফিটনেস ডেটার একটি বিস্তৃত দৃশ্য এবং স্টোরেজ অফার করা। এই ডেটা প্রকারগুলি নিম্নলিখিত বিভাগে পড়ে:
- ক্রিয়াকলাপ: এটি ব্যবহারকারীর যে কোনও কার্যকলাপকে ক্যাপচার করে। এটি স্বাস্থ্য এবং ফিটনেস ক্রিয়াকলাপ যেমন দৌড়ানো, সাঁতার কাটা এবং ঘুম অন্তর্ভুক্ত করতে পারে।
- শারীরিক পরিমাপ: এটি শরীরের সাথে সম্পর্কিত সাধারণ ডেটা ক্যাপচার করে, যেমন ব্যবহারকারীর ওজন এবং তাদের বেসাল বিপাকীয় হার।
- সাইকেল ট্র্যাকিং: এটি মাসিক চক্র এবং সম্পর্কিত ডেটা পয়েন্ট ক্যাপচার করে, যেমন ডিম্বস্ফোটন পরীক্ষার বাইনারি ফলাফল।
- পুষ্টি: এটি হাইড্রেশন এবং পুষ্টি ডেটা প্রকার ক্যাপচার করে। আগেরটি প্রতিনিধিত্ব করে যে একজন ব্যবহারকারী একটি একক পানীয়তে কতটা জল খান। পরেরটিতে ক্যালোরি, চিনি এবং ম্যাগনেসিয়ামের মতো ঐচ্ছিক ক্ষেত্রগুলি অন্তর্ভুক্ত রয়েছে।
- ঘুম: এটি ব্যবহারকারীর দৈর্ঘ্য এবং ঘুমের ধরন সম্পর্কিত ব্যবধান ডেটা ক্যাপচার করে।
- গুরুত্বপূর্ণ: এটি ব্যবহারকারীর সাধারণ স্বাস্থ্য সম্পর্কে প্রয়োজনীয় তথ্য ক্যাপচার করে। এতে শরীরের তাপমাত্রা, রক্তের গ্লুকোজ, রক্তচাপ এবং রক্তের অক্সিজেন স্যাচুরেশনের মতো তথ্য অন্তর্ভুক্ত থাকে।
ডেটা টাইপ ফরম্যাট
হেলথ কানেক্টে ডেটার ধরনগুলি এমন বস্তুগুলিতে সংরক্ষণ করা হয় যেগুলি Record সাবক্লাস।
প্রতিটি ডেটা টাইপের জন্য, সংশ্লিষ্ট ক্ষেত্র রয়েছে যা হয় জেনেরিক যেমন time এবং zoneOffset বা নির্দিষ্ট যেমন title , count এবং percentage । কিছু ক্ষেত্র সাধারণ প্রকার ব্যবহার করে—যেমন দীর্ঘ, দ্বিগুণ, বা স্ট্রিং—যখন অন্যরা জটিল প্রকারগুলি ব্যবহার করে যেমন গণনা এবং ক্লাসের মতো Instant এবং ZoneOffset । এই ক্ষেত্রগুলির বৈশিষ্ট্যগুলি প্রয়োজনীয় বা ঐচ্ছিক হতে পারে। কিছু বৈশিষ্ট্য শুধুমাত্র পঠনযোগ্য, এবং কিছু বৈশিষ্ট্য মানগুলির একটি নির্দিষ্ট পরিসরে আটকানো হয়।
উপলব্ধ ডেটা প্রকারের সম্পূর্ণ তালিকা এবং তাদের ক্ষেত্রগুলির জন্য, জেটপ্যাকের ক্লাসগুলি পড়ুন।
অতিরিক্ত ডেটা বৈশিষ্ট্য
Health Connect API-এর ডেটাতে নিম্নলিখিত তালিকায় বর্ণিত মেটাডেটা বৈশিষ্ট্যগুলিও অন্তর্ভুক্ত রয়েছে:
- হেলথ কানেক্ট আইডি: ডেটার প্রতিটি পয়েন্ট তৈরি করার পর একটি ইউনিক আইডেন্টিফায়ার (UID) দিয়ে বরাদ্দ করা হয়। এটি স্ট্যান্ডার্ড রিড এবং রাইট অপারেশনের জন্য দরকারী। আরও বিস্তারিত জানার জন্য স্বাস্থ্য সংযোগ আইডি দেখুন।
- সর্বশেষ সংশোধিত সময়: এটি টাইমস্ট্যাম্পটিকে চিহ্নিত করে যখন একটি রেকর্ডে একটি আপডেট আছে। এটি রেকর্ডের প্রথম সৃষ্টিতে বা প্রতিটি আপডেটে স্বয়ংক্রিয়ভাবে তৈরি হয়।
- ডেটার উৎস: Health Connect অ্যাপের তথ্য সঞ্চয় করে যেখান থেকে ডেটা এসেছে। এটিতে সেই উৎপত্তির প্যাকেজের নাম রয়েছে, যা সৃষ্টির পরে স্বয়ংক্রিয়ভাবে যোগ করা হয়।
- ডিভাইস: Health Connect সেই ডিভাইসের তথ্য সঞ্চয় করে যেখান থেকে ডেটা এসেছে। এটিতে সেই ডিভাইসের প্রস্তুতকারক এবং মডেল রয়েছে, যা আপনি ম্যানুয়ালি মান সরবরাহ করেন।
- ক্লায়েন্ট আইডি: হেলথ কানেক্ট ক্লায়েন্ট আইডি সরবরাহ করে যাতে ক্লায়েন্ট অ্যাপগুলি তাদের নিজস্ব আইডি ব্যবহার করে ডেটা উল্লেখ করতে পারে, যা দ্বন্দ্ব সমাধানে সহায়তা করে এবং সিঙ্ক করা সহজ করে। এটি ম্যানুয়ালি রেকর্ডে সরবরাহ করা হয়।
- ক্লায়েন্ট রেকর্ড সংস্করণ: ক্লায়েন্ট আইডির সাথে, স্বাস্থ্য সংযোগ ডেটা সিঙ্কিংয়ের সময় পরিবর্তনগুলি ট্র্যাক করতে সহায়তা করার জন্য সংস্করণ সরবরাহ করে। এটি ম্যানুয়ালি রেকর্ডে সরবরাহ করা হয়।
- রেকর্ডিং পদ্ধতি: স্বাস্থ্য সংযোগ আপনাকে বুঝতে দেয় কিভাবে ডেটা রেকর্ড করা হয়। এই পদ্ধতিগুলির মধ্যে রয়েছে নিষ্ক্রিয়ভাবে (স্বয়ংক্রিয়ভাবে) ডেটা রেকর্ড করা অ্যাপগুলি এবং ব্যবহারকারীরা সক্রিয়ভাবে বা ম্যানুয়ালি ডেটা রেকর্ড করে৷
স্বাস্থ্য সংযোগ আইডি
Health Connect নতুন সন্নিবেশিত ডেটা অবজেক্টগুলিতে অনন্য শনাক্তকারী (UID) বরাদ্দ করে, যা ডেটা অবজেক্টগুলি সনাক্ত করে এবং অন্যদের থেকে আলাদা করে। হেলথ কানেক্ট আইডিগুলি রিকুয়েস্ট পড়তে বা লেখার ক্ষেত্রে উপযোগী। স্বাস্থ্য সংযোগ আইডিগুলি ক্লায়েন্ট আইডিগুলির সাথে অভিন্ন নয়৷ একটি ক্লায়েন্ট অ্যাপ ক্লায়েন্ট আইডি বরাদ্দ করে, যখন হেলথ কানেক্ট একচেটিয়াভাবে হেলথ কানেক্ট আইডি বরাদ্দ করে।
Health Connect আইডিগুলির সাথে কাজ করার সময় নিম্নলিখিত নোটগুলি মনে রাখবেন :
- সেশনের একটি একক হেলথ কানেক্ট আইডি থাকে, কিন্তু সেশনের মধ্যে থাকা ডেটার নিজস্ব হেলথ কানেক্ট আইডি থাকে।
- হেলথ কানেক্ট আইডি টাইমস্ট্যাম্পের সাথে আবদ্ধ বা সম্পর্কিত নয়।
- কিছু ব্যবহারের ক্ষেত্রে কার্যপ্রবাহের সময় একটি নির্দিষ্ট হেলথ কানেক্ট আইডি সংরক্ষণের প্রয়োজন হতে পারে। উদাহরণস্বরূপ, একটি নির্দিষ্ট আইডি পুনরুদ্ধার করতে এবং ব্যবহারকারীকে দেখানো ডেটা এন্ট্রির প্রয়োজন যা তারা এইমাত্র লগ করেছে৷
স্বাস্থ্য সংযোগ সময়
Health Connect-এ লেখা সমস্ত ডেটা অবশ্যই জোন অফসেট তথ্য উল্লেখ করতে হবে। জোন অফসেট নির্দিষ্ট করা অ্যাপগুলিকে সিভিল সময়ে প্রতিনিধিত্ব করতে ডেটা পড়তে সক্ষম করে। সিভিল টাইম হল সেই সময় যা স্থানীয় এবং ব্যবহারকারীর জন্য প্রাসঙ্গিক, কিন্তু অগত্যা সমন্বিত ইউনিভার্সাল টাইমে (UTC) নয়।
বিরল পরিস্থিতিতে, জোন অফসেট উপলব্ধ নাও হতে পারে। যখন এটি Android 14 (API লেভেল 34) এ ঘটে, তখন Health Connect ডিভাইসের সিস্টেম ডিফল্ট টাইম জোনের উপর ভিত্তি করে জোন অফসেট সেট করে। অ্যান্ড্রয়েড 13 এবং নিম্ন সংস্করণে (API স্তর 33 এবং নিম্নতর), কোনো জোন অফসেট তথ্য উল্লেখ না করেই Health Connect-এ লেখা সম্ভব, যা যখনই সম্ভব এড়িয়ে চলতে হবে।
সময় এবং অঞ্চল সেটিং
ডেটা লেখার সময় জোন অফসেট তথ্য নির্দিষ্ট করা স্বাস্থ্য সংযোগে ডেটা পড়ার সময় সময় অঞ্চলের তথ্য প্রদান করে। যাইহোক, এটি কিছু নির্দিষ্ট পরিস্থিতিতে তা করতে ব্যর্থ হতে পারে, যেমন যখন জোন অফসেট প্রদান করা হয় না। আপনার অ্যাপটিকে উভয় ধরণের ডেটার সাথে মোকাবিলা করার জন্য প্রস্তুত থাকতে হবে, এমনভাবে যা আপনার নির্দিষ্ট পরিস্থিতিতে বোঝা যায়।
অনুমতি
কোনো অনুমতির অনুরোধ করার আগে, আপনার অ্যাপটিকে অবশ্যই প্রথমে ম্যানিফেস্টে সেগুলি ঘোষণা করতে হবে৷ ডেটা প্রকারের সম্পূর্ণ ম্যাপিং এবং তাদের অনুমতিগুলির জন্য নিম্নলিখিত টেবিলগুলি দেখুন৷
1.0.0-alpha10 এবং উচ্চতর জন্য
| রেকর্ড ক্লাস টাইপ | অনুমতি ঘোষণা পড়ুন এবং লিখুন |
|---|---|
| সক্রিয় ক্যালোরি পোড়া | android.permission.health.READ_ACTIVE_CALORIES_BURNED android.permission.health.WRITE_ACTIVE_CALORIES_BURNED |
| বেসাল বডি টেম্পারেচার | android.permission.health.READ_BASAL_BODY_TEMPERATURE android.permission.health.WRITE_BASAL_BODY_TEMPERATURE |
| মূলগত বিপাকীয় হার | android.permission.health.READ_BASAL_METABOLIC_RATE android.permission.health.WRITE_BASAL_METABOLIC_RATE |
| রক্তে গ্লুকোজ | android.permission.health.READ_BLOOD_GLUCOSE android.permission.health.WRITE_BLOOD_GLUCOSE |
| রক্তচাপ | android.permission.health.READ_BLOOD_PRESSURE android.permission.health.WRITE_BLOOD_PRESSURE |
| শরীরের চর্বি | android.permission.health.READ_BODY_FAT android.permission.health.WRITE_BODY_FAT |
| শরীরের তাপমাত্রা | android.permission.health.READ_BODY_TEMPERATURE android.permission.health.WRITE_BODY_TEMPERATURE |
| বডিওয়াটারমাস | android.permission.health.READ_BODY_WATER_MASS android.permission.health.WRITE_BODY_WATER_MASS |
| বোনমাস | android.permission.health.READ_BONE_MASS android.permission.health.WRITE_BONE_MASS |
| সার্ভিকাল শ্লেষ্মা | android.permission.health.READ_CERVICAL_MUCUS android.permission.health.WRITE_CERVICAL_MUCUS |
| সাইক্লিং পেডালিং ক্যাডেন্স | android.permission.health.READ_EXERCISE android.permission.health.WRITE_EXERCISE |
| দূরত্ব | android.permission.health.READ_DISTANCE android.permission.health.WRITE_DISTANCE |
| উচ্চতা লাভ করেছে | android.permission.health.READ_ELEVATION_GAINED android.permission.health.WRITE_ELEVATION_GAINED |
| ব্যায়াম অধিবেশন | android.permission.health.READ_EXERCISE android.permission.health.WRITE_EXERCISE |
| ফ্লোরসক্লাইম্বড | android.permission.health.READ_FLOORS_CLIMBED android.permission.health.WRITE_FLOORS_CLIMBED |
| হৃদ কম্পন | android.permission.health.READ_HEART_RATE android.permission.health.WRITE_HEART_RATE |
| হার্ট রেট ভ্যারিয়েবিলিটিআরএমএসডি | android.permission.health.READ_HEART_RATE_VARIABILITY android.permission.health.WRITE_HEART_RATE_VARIABILITY |
| উচ্চতা | android.permission.health.READ_HEIGHT android.permission.health.WRITE_HEIGHT |
| হাইড্রেশন | android.permission.health.READ_HYDRATION android.permission.health.WRITE_HYDRATION |
| অন্তঃসত্ত্বা রক্তপাত | android.permission.health.READ_INTERMENSTRUAL_BLEEDING android.permission.health.WRITE_INTERMENSTRUAL_BLEEDING |
| চর্বিহীন শরীরের ভর | android.permission.health.READ_LEAN_BODY_MASS android.permission.health.WRITE_LEAN_BODY_MASS |
| ঋতুস্রাব প্রবাহ | android.permission.health.READ_MENSTRUATION android.permission.health.WRITE_MENSTRUATION |
| মাসিকের সময়কাল | android.permission.health.READ_MENSTRUATION android.permission.health.WRITE_MENSTRUATION |
| পুষ্টি | android.permission.health.READ_NUTRITION android.permission.health.WRITE_NUTRITION |
| ডিম্বস্ফোটন পরীক্ষা | android.permission.health.READ_OVULATION_TEST android.permission.health.WRITE_OVULATION_TEST |
| অক্সিজেন সম্পৃক্তি | android.permission.health.READ_OXYGEN_SATURATION android.permission.health.WRITE_OXYGEN_SATURATION |
| শক্তি | android.permission.health.READ_POWER android.permission.health.WRITE_POWER |
| শ্বাসপ্রশ্বাসের হার | android.permission.health.READ_RESPIRATORY_RATE android.permission.health.WRITE_RESPIRATORY_RATE |
| বিশ্রামের হৃদস্পন্দন | android.permission.health.READ_RESTING_HEART_RATE android.permission.health.WRITE_RESTING_HEART_RATE |
| যৌন কার্যকলাপ | android.permission.health.READ_SEXUAL_ACTIVITY android.permission.health.WRITE_SEXUAL_ACTIVITY |
| স্লিপসেশন | android.permission.health.READ_SLEEP android.permission.health.WRITE_SLEEP |
| গতি | android.permission.health.READ_SPEED android.permission.health.WRITE_SPEED |
| স্টেপস ক্যাডেন্স | android.permission.health.READ_STEPS android.permission.health.WRITE_STEPS |
| ধাপ | android.permission.health.READ_STEPS android.permission.health.WRITE_STEPS |
| মোট ক্যালোরি পোড়া | android.permission.health.READ_TOTAL_CALORIES_BURNED android.permission.health.WRITE_TOTAL_CALORIES_BURNED |
| Vo2Max | android.permission.health.READ_VO2_MAX android.permission.health.WRITE_VO2_MAX |
| ওজন | android.permission.health.READ_WEIGHT android.permission.health.WRITE_WEIGHT |
| হুইলচেয়ার পুশ করে | android.permission.health.READ_WHEELCHAIR_PUSHES android.permission.health.WRITE_WHEELCHAIR_PUSHES |
1.0.0-alpha09 এবং তার নিচের জন্য
| রেকর্ড ক্লাস টাইপ | অনুমতি ঘোষণা পড়ুন এবং লিখুন |
|---|---|
| সক্রিয় ক্যালোরি পোড়া | androidx.health.permission.ActiveCalories Burned.READ androidx.health.permission.ActiveCalories Burned.WRITE |
| বেসাল বডি টেম্পারেচার | androidx.health.permission.BasalBodyTemperature.READ androidx.health.permission.BasalBodyTemperature.WRITE |
| মূলগত বিপাকীয় হার | androidx.health.permission.BasalMetabolicRate.READ androidx.health.permission.BasalMetabolicRate.WRITE |
| রক্তে গ্লুকোজ | androidx.health.permission.BloodGlucose.READ androidx.health.permission.BloodGlucose.WRITE |
| রক্তচাপ | androidx.health.permission.Bloodpressure.READ androidx.health.permission.Bloodpressure.WRITE |
| শরীরের চর্বি | androidx.health.permission.BodyFat.READ androidx.health.permission.BodyFat.WRITE |
| শরীরের তাপমাত্রা | androidx.health.permission.BodyTemperature.READ androidx.health.permission.BodyTemperature.WRITE |
| বডিওয়াটারমাস | androidx.health.permission.BodyWaterMass.READ androidx.health.permission.BodyWaterMass.WRITE |
| বোনমাস | androidx.health.permission.BoneMass.READ androidx.health.permission.BoneMass.WRITE |
| সার্ভিকাল শ্লেষ্মা | androidx.health.permission.CervicalMucus.READ androidx.health.permission.CervicalMucus.WRITE |
| সাইক্লিং পেডালিং ক্যাডেন্স | androidx.health.permission.CyclingPedalingCadence.READ androidx.health.permission.CyclingPedalingCadence.WRITE |
| দূরত্ব | androidx.health.permission.Distance.READ androidx.health.permission.Distance.WRITE |
| উচ্চতা লাভ করেছে | androidx.health.permission.ElevationGained.READ androidx.health.permission.ElevationGained.WRITE |
| ব্যায়াম অধিবেশন | androidx.health.permission.ExerciseSession.READ androidx.health.permission.ExerciseSession.WRITE |
| ফ্লোরসক্লাইম্বড | androidx.health.permission.FloorsClimbed.READ androidx.health.permission.FloorsClimbed.WRITE |
| হৃদ কম্পন | androidx.health.permission.HeartRate.READ androidx.health.permission.HeartRate.WRITE |
| হার্ট রেট ভ্যারিয়েবিলিটিআরএমএসডি | androidx.health.permission.HeartRateVariabilityRmssd.READ androidx.health.permission.HeartRateVariabilityRmssd.WRITE |
| উচ্চতা | androidx.health.permission.Height.READ androidx.health.permission.Height.WRITE |
| হাইড্রেশন | androidx.health.permission.Hydration.READ androidx.health.permission.Hydration.WRITE |
| অন্তঃসত্ত্বা রক্তপাত | androidx.health.permission.IntermenstrualBleeding.READ androidx.health.permission.IntermenstrualBleeding.WRITE |
| চর্বিহীন শরীরের ভর | androidx.health.permission.LeanBodyMass.READ androidx.health.permission.LeanBodyMass.WRITE |
| ঋতুস্রাব প্রবাহ | androidx.health.permission.MenstruationFlow.READ androidx.health.permission.MenstruationFlow.WRITE |
| পুষ্টি | androidx.health.permission.Nutrition.READ androidx.health.permission.Nutrition.WRITE |
| ডিম্বস্ফোটন পরীক্ষা | androidx.health.permission.OvulationTest.READ androidx.health.permission.OvulationTest.WRITE |
| অক্সিজেন সম্পৃক্তি | androidx.health.permission.OxygenSaturation.READ androidx.health.permission.OxygenSaturation.WRITE |
| শক্তি | androidx.health.permission.Power.READ androidx.health.permission.Power.WRITE |
| শ্বাসপ্রশ্বাসের হার | androidx.health.permission.respiratory Rate.READ androidx.health.permission.respiratory Rate.WRITE |
| বিশ্রামের হৃদস্পন্দন | androidx.health.permission.RestingHeartRate.READ androidx.health.permission.RestingHeartRate.WRITE |
| যৌন কার্যকলাপ | androidx.health.permission.SexualActivity.READ androidx.health.permission.SexualActivity.WRITE |
| স্লিপসেশন | androidx.health.permission.SleepSession.READ androidx.health.permission.SleepSession.WRITE |
| গতি | androidx.health.permission.Speed.READ androidx.health.permission.Speed.WRITE |
| স্টেপস ক্যাডেন্স | androidx.health.permission.StepsCadence.READ androidx.health.permission.StepsCadence.WRITE |
| ধাপ | androidx.health.permission.steps.READ androidx.health.permission.steps.WRITE |
| মোট ক্যালোরি পোড়া | androidx.health.permission.TotalCalories Burned.READ androidx.health.permission.TotalCalories Burned.WRITE |
| Vo2Max | androidx.health.permission.Vo2Max.READ androidx.health.permission.Vo2Max.WRITE |
| ওজন | androidx.health.permission.Weight.READ androidx.health.permission.Weight.WRITE |
| হুইলচেয়ার পুশ করে | androidx.health.permission.WheelchairPushes.READ androidx.health.permission.WheelchairPushes.WRITE |
আপনার ডেটা প্রকার এবং অনুমতি পর্যালোচনা করুন
এখন যেহেতু আপনার ডেটার ধরন এবং অনুমতিগুলি পরিকল্পিত রয়েছে, আপনি বিকাশের সময় সেগুলি বাস্তবায়ন করতে পারেন৷
প্লে স্টোরে আপলোড করার আগে আপনার অ্যাপটি পর্যালোচনা করার সময়, আপনার অ্যাপের প্রয়োজনীয় ডেটা প্রকার এবং অনুমতিগুলির তালিকা দুবার চেক করুন। এটি আপনাকে আপনার অ্যাপের ডেটা ব্যবহার সঠিকভাবে ঘোষণা করতে দেয়৷
আপনি প্লে স্টোরে আপনার অ্যাপ প্রকাশ করার পরে, আপনাকে একটি ত্রুটি বার্তার সাথে অনুরোধ করা হতে পারে যেখানে আপনার অ্যাপ স্বাস্থ্য সংযোগ ডেটা প্রকারগুলি অ্যাক্সেস করতে পারে না কারণ তাদের বিশেষ অনুমোদনের প্রয়োজন হয়৷ সেই ক্ষেত্রে, আপনাকে ডেভেলপার ঘোষণাপত্রের মাধ্যমে ডেটা টাইপ অ্যাক্সেসের জন্য অনুরোধ করতে হবে। এই প্রক্রিয়া সম্পর্কে আরও জানতে, স্বাস্থ্য সংযোগ ডেটা প্রকারগুলিতে অ্যাক্সেসের অনুরোধ দেখুন।