এই গাইড Health Connect-এর 1.2.0-alpha05 বা তার পরবর্তী যেকোনও ভার্সনের সাথে মানানসই।
Health Connect-এ মেটাডেটায় পরিবর্তন করা হয়েছে। যেসব ডেভেলপার 1.1.0-alpha12 বা তার পরবর্তী ভার্সনে আপগ্রেড করেছেন তাদের জন্য এই পরিবর্তন করা হয়েছে।
লাইব্রেরি সংক্রান্ত তথ্য
Google Maven Android gradle প্লাগ-ইন আর্টিফ্যাক্ট আইডি
Health Connect লাইব্রেরি শনাক্ত করে, যেটিতে আপনাকে আপগ্রেড করতে হবে।
আপনার মডিউল-লেভেল build.gradle ফাইলে এই Health Connect SDK ডিপেন্ডেন্সি যোগ করুন:
dependencies {
implementation "androidx.health.connect:connect-client:1.1.0-alpha12"
}
মেটাডেটায় পরিবর্তন
Health Connect Jetpack SDK-তে দুটি মেটাডেটা পরিবর্তন করা হয়েছে
ভার্সন 1.1.0-alpha12 থেকে, যাতে ইকোসিস্টেমে অতিরিক্ত উপযোগী মেটাডেটা
আছে কিনা তা যাচাই করতে সাহায্য করা যায়। আপনার Record কনস্ট্রাক্টরে metadata অন্তর্ভুক্ত না থাকলে, আপনি হয়ত কনস্ট্রাক্টর ইন্টার্নাল সমস্যা দেখতে পাবেন।
রেকর্ডিংয়ের পদ্ধতি নির্দিষ্ট করুন
Record() ধরনের অবজেক্ট ইনস্ট্যান্টিয়েট করা হলে
আপনাকে মেটাডেটার বিবরণ উল্লেখ করতে হবে।
Health Connect-এ ডেটা লেখার সময়, আপনাকে অবশ্যই চারটি রেকর্ডিং পদ্ধতির মধ্যে একটি নির্দিষ্ট করতে হবে, যার জন্য সংশ্লিষ্ট ফ্যাক্টরি পদ্ধতিগুলির মধ্যে একটি ব্যবহার করে Metadata ইনস্ট্যান্টিয়েট করতে হবে:
| রেকর্ডিংয়ের পদ্ধতি | বর্ণনা |
|---|---|
RECORDING_METHOD_UNKNOWN |
রেকর্ডিং পদ্ধতি যাচাই করা যায়নি। |
RECORDING_METHOD_MANUAL_ENTRY |
ব্যবহারকারী ডেটা লিখেছেন। |
RECORDING_METHOD_AUTOMATICALLY_RECORDED |
কোনও ডিভাইস বা সেন্সর ডেটা রেকর্ড করেছে। |
RECORDING_METHOD_ACTIVELY_RECORDED |
ব্যবহারকারী কোনও ডিভাইসে রেকর্ডিং সেশন শুরু বা শেষ করেছেন। |
যেমন:
StepsRecord( startTime = Instant.ofEpochMilli(1234L), startZoneOffset = null, endTime = Instant.ofEpochMilli(1236L), endZoneOffset = null, metadata = Metadata.activelyRecorded(device = Device(type = Device.TYPE_WATCH)), count = 10 )
ডিভাইসের ধরন
অটোমেটিক ও অ্যাক্টিভভাবে রেকর্ড করা সব ডেটার জন্য
আপনাকে ডিভাইসের ধরন উল্লেখ করতে হবে। আরও জানতে, Jetpack ডকুমেন্টেশনে Device ক্লাস দেখুন। বর্তমান ডিভাইসের
ধরনের মধ্যে রয়েছে:
| ডিভাইসের ধরন | বর্ণনা |
|---|---|
TYPE_UNKNOWN |
ডিভাইসের ধরন অজানা। |
TYPE_WATCH |
ডিভাইসের ধরন হল স্মার্টওয়াচ। |
TYPE_PHONE |
ডিভাইসের ধরন হল ফোন। |
TYPE_SCALE |
ডিভাইসের ধরন হল স্কেল। |
TYPE_RING |
ডিভাইসের ধরন হল রিং। |
TYPE_HEAD_MOUNTED |
ডিভাইসের ধরন হল হেড-মাউন্টেড ডিভাইস। |
TYPE_FITNESS_BAND |
ডিভাইসের ধরন হল ফিটনেস ব্যান্ড। |
TYPE_CHEST_STRAP |
ডিভাইসের ধরন হল চেস্ট স্ট্র্যাপ। |
TYPE_SMART_DISPLAY |
ডিভাইসের ধরন হল স্মার্ট ডিসপ্লে। |
কিছু Device.type ভ্যালু শুধুমাত্র Health Connect-এর পরবর্তী ভার্সনে উপলভ্য। এক্সটেন্ডেড ডিভাইসের ধরন সংক্রান্ত ফিচার উপলভ্য না থাকলে, এই ধরনের ডিভাইসকে
Device.TYPE_UNKNOWN হিসেবে বিবেচনা করা হয়।
| এক্সটেন্ডেড ডিভাইসের ধরন | বর্ণনা |
|---|---|
TYPE_CONSUMER_MEDICAL_DEVICE |
ডিভাইসের ধরন হল মেডিকেল ডিভাইস। |
TYPE_GLASSES |
ডিভাইসের ধরন হল এক জোড়া স্মার্ট গ্লাস বা আইওয়্যার। |
TYPE_HEARABLE |
ডিভাইসের ধরন হল শোনার ডিভাইস। |
TYPE_FITNESS_MACHINE |
ডিভাইসের ধরন হল স্থির মেশিন। |
TYPE_FITNESS_EQUIPMENT |
ডিভাইসের ধরন হল ফিটনেস সরঞ্জাম। |
TYPE_PORTABLE_COMPUTER |
ডিভাইসের ধরন হল পোর্টেবল কম্পিউটার। |
TYPE_METER |
ডিভাইসের ধরন হল পরিমাপ করার মিটার। |
FEATURE_EXTENDED_DEVICE_TYPES-এর উপলভ্যতা চেক করুন:
if (healthConnectClient
.features
.getFeatureStatus(
HealthConnectFeatures.FEATURE_EXTENDED_DEVICE_TYPES
) == HealthConnectFeatures.FEATURE_STATUS_AVAILABLE) {
// Feature is available
} else {
// Feature isn't available
}
যেমন:
val WATCH_DEVICE = Device( manufacturer = "Google", model = "Pixel Watch", type = Device.TYPE_WATCH ) // Phone val PHONE_DEVICE = Device( manufacturer = "Google", model = "Pixel 8", type = Device.TYPE_PHONE ) // Ring val RING_DEVICE = Device( manufacturer = "Oura", model = "Ring Gen3", type = Device.TYPE_RING ) // Scale val SCALE_DEVICE = Device( manufacturer = "Withings", model = "Body Comp", type = Device.TYPE_SCALE )
অনন্য ডিভাইস শনাক্তকারী (UDI)
Android 17 (API লেভেল 37.1) বা U এক্সটেনশন 23 বা তার পরবর্তী ভার্সনে Health Connect-এর জন্য, Device ক্লাসে অনন্য ডিভাইস শনাক্তকারীর (UDI) জন্য সহায়তা অন্তর্ভুক্ত রয়েছে। আপনার লিখিত রেকর্ডের সাথে মেডিকেল ডিভাইসের রেজিস্টার করা UDI মডেলের বিবরণ
যুক্ত করলে, ডাউনস্ট্রিম অ্যাপ্লিকেশন (যেমন টেলি-হেলথ প্ল্যাটফর্ম বা ক্লিনিক্যাল পোর্টাল)
ক্লিনিক্যাল-গ্রেড রিডিং শনাক্ত করতে এবং সাধারণ কনজিউমার-ওয়্যারেবল ডেটা থেকে
সেগুলিকে আলাদা করতে পারে।
অনুমতি ঘোষণা করা
Health Connect-এ UDI বিবরণ লিখতে, আপনাকে অবশ্যই আপনার অ্যাপের AndroidManifest.xml ফাইলে
WRITE_DEVICE_UDI অনুমতি ঘোষণা করতে হবে:
<uses-permission android:name="android.permission.health.WRITE_DEVICE_UDI" />
মনে রাখবেন যে WRITE_DEVICE_UDI হল একটি সাধারণ অনুমতি। আপনার ম্যানিফেস্টে এটি ঘোষণা করতে হবে, তবে রানটাইমে ব্যবহারকারীর কাছ থেকে এটি অনুরোধ করার প্রয়োজন নেই। ইনস্টল করার সময় আপনার অ্যাপকে এটি
অটোমেটিক দেওয়া হয়।
শুধুমাত্র ডিভাইস শনাক্তকারী (DI) অংশটি লিখুন
একটি সম্পূর্ণ UDI-এর দুটি অংশ থাকে:
- ডিভাইস শনাক্তকারী (UDI-DI): কোনও ইস্যুকারী এজেন্সির (যেমন, GS1) মাধ্যমে নির্দিষ্ট ডিভাইস মডেলকে অ্যাসাইন করা বিশ্বব্যাপী স্বীকৃত শনাক্তকারী।
- প্রোডাকশন আইডেন্টিফায়ার (UDI-PI): ইউনিট-নির্দিষ্ট অ্যাট্রিবিউট, যেমন ক্রমিক সংখ্যা, ব্যাচ নম্বর, উৎপাদনের তারিখ বা মেয়াদ শেষ হওয়ার তারিখ।
ব্যবহারকারীর গোপনীয়তা সুরক্ষিত রাখতে, Health Connect-এ কোডের শুধুমাত্র UDI-DI অংশটি পূরণ করুন। কোনও প্রোডাক্ট শনাক্তকারী অ্যাট্রিবিউট (যেমন সিরিয়াল নম্বর বা ব্যাচ নম্বর) অন্তর্ভুক্ত করবেন না।
কোডের উদাহরণ
মনে রাখবেন: Device ইনস্ট্যান্স তৈরি করার সময় আপনি UDI সেট করতে পারবেন।
Jetpack SDK
val device = Device( type = Device.TYPE_CONSUMER_MEDICAL_DEVICE, manufacturer = "Omron", model = "HEM-7121", udi = "04015674011832" // Device Identifier (UDI-DI) portion only )
Platform API
val device = Device.Builder() .setType(Device.DEVICE_TYPE_CONSUMER_MEDICAL_DEVICE) .setManufacturer("Omron") .setModel("HEM-7121") .setUdi("04015674011832") // Device Identifier (UDI-DI) portion only .build()
WRITE_DEVICE_UDI অনুমতি ঘোষণা না করে UDI সহ ডেটা লিখলে, লেখার সময় Health Connect SecurityException দেখায়।
ডিভাইস ক্লিয়ারেন্স যাচাই করতে UDI ব্যবহার করুন
Health Connect একটি ট্রান্সপোর্ট লেয়ার হিসেবে কাজ করে এবং UDI-এর সত্যতা বা রেজিস্ট্রেশন স্ট্যাটাস যাচাই করে না।
ডেটা রিডারের ক্ষেত্রে, UDI-এর উপস্থিতি থেকে বোঝা যায় যে ডেটা কোনও রেজিস্টার করা মেডিকেল ডিভাইস থেকে এসেছে। রিডিং অ্যাপের উচিত FDA-এর গ্লোবাল ইউনিক ডিভাইস আইডেন্টিফিকেশন ডেটাবেস (GUDID) বা EU-এর EUDAMED-এর মতো রেগুলেটরি ডেটাবেস কোয়েরি করা যাতে ডিভাইসের শ্রেণীবিভাগ, রেগুলেটরি ছাড়পত্রের স্ট্যাটাস (যেমন, ক্লাস I, II বা III) বা নির্দিষ্ট উদ্দেশ্যমূলক ব্যবহার যাচাই করা যায়।
স্নিপেট আপডেট করা হয়েছে
নতুন মেটাডেটা সংক্রান্ত প্রয়োজনীয়তা মেনে চলার জন্য যেখানেই নতুন স্নিপেট প্রয়োজন, সেখানেই Health Connect নির্দেশিকা আপডেট করা হয়েছে। কিছু উদাহরণের জন্য, ডেটা লিখুন পৃষ্ঠা দেখুন।
মেটাডেটার নতুন পদ্ধতি
মেটাডেটা আর সরাসরি ইনস্ট্যান্টিয়েট করা যাবে না, তাই মেটাডেটার নতুন ইনস্ট্যান্স পেতে ফ্যাক্টরি পদ্ধতির মধ্যে একটি ব্যবহার করুন। ফ্যাক্টরি পদ্ধতি যাচাই করে যে ডেটা রেকর্ড করার জন্য কোনও ডিভাইস বা সেন্সর ব্যবহার করার সময় ডিভাইসের তথ্য প্রদান করা হয়েছে কিনা। ম্যানুয়ালি লেখা ডেটার ক্ষেত্রে, ডিভাইসের তথ্য প্রদান করা ঐচ্ছিক। প্রতিটি ফাংশনের তিনটি সিগনেচার ভেরিয়েন্ট আছে:
activelyRecordedfun activelyRecorded(device: Device): Metadata.fun activelyRecorded(clientRecordId: String, clientRecordVersion: Long = 0, device: Device): Metadatafun activelyRecordedWithId(id: String, device: Device): Metadata
autoRecordedfun autoRecorded(device: Device): Metadatafun autoRecorded(clientRecordId: String, clientRecordVersion: Long = 0, device: Device): Metadatafun autoRecordedWithId(id: String, device: Device): Metadata
manualEntryfun manualEntry(device: Device? = null): Metadatafun manualEntry(clientRecordId: String, clientRecordVersion: Long = 0, device: Device? = null): Metadatafun manualEntryWithId(id: String, device: Device? = null): Metadata
unknownRecordingMethodfun unknownRecordingMethod(device: Device? = null): Metadatafun unknownRecordingMethod(clientRecordId: String, clientRecordVersion: Long = 0, device: Device? = null): Metadatafun unknownRecordingMethodWithId(id: String, device: Device? = null): Metadata
আরও তথ্যের জন্য, Android ওপেন সোর্স প্রজেক্ট দেখুন।
টেস্টিং ডেটা
প্রত্যাশিত মেটাডেটা ভ্যালু মক করতে
Testing Library এবং
MetadataTestHelper ব্যবহার করুন:
private val TEST_METADATA =
Metadata.unknownRecordingMethod(
clientRecordId = "clientId",
clientRecordVersion = 1L,
device = Device(type = Device.TYPE_UNKNOWN),
).populatedWithTestValues(id = "test")
এটি Health Connect প্রয়োগের আচরণকে সিমুলেট করে, যা রেকর্ড যোগ করার সময় অটোমেটিক এইসব ভ্যালু পপুলেট করে।
টেস্টিং লাইব্রেরির জন্য, আপনাকে এই Health Connect SDK ডিপেন্ডেন্সি আপনার মডিউল-লেভেল build.gradle ফাইলে যোগ করতে হবে:
dependencies {
testImplementation "androidx.health.connect:connect-testing:1.0.0-alpha02"
}
লাইব্রেরি আপগ্রেড করুন
আপনাকে যেসব প্রধান ধাপগুলি অনুসরণ করতে হবে সেগুলি হল:
আপনার লাইব্রেরি 1.1.0-alpha12-এ আপগ্রেড করুন।
লাইব্রেরি তৈরি করার সময়, যেখানে নতুন মেটাডেটা প্রয়োজন সেখানে কম্পাইলেশন সংক্রান্ত সমস্যা দেখা দেবে। এইসব সমস্যার সমাধান করতে এবং মাইগ্রেশন সম্পূর্ণ করতে, আপনি নিম্নলিখিত পরিবর্তনগুলি করেছেন কিনা তা যাচাই করুন:
Recordতৈরি করার সময় রেকর্ডিং পদ্ধতি উল্লেখ করা বাধ্যতামূলক। এটিMetadata-এ দেওয়া ফ্যাক্টরি পদ্ধতির মধ্যে কোনও একটি ব্যবহার করে করা হয়, যেমনMetadata.manualEntry()বাMetadata.activelyRecorded(device = Device(...))।- কোনও ডিভাইসের মাধ্যমে রেকর্ড করা ডেটার ক্ষেত্রে, ডিভাইসের ধরন উল্লেখ করা বাধ্যতামূলক,
যেমন
Device.TYPE_WATCHবাDevice.TYPE_PHONE।
আপনার অ্যাপ যদি এক্সটেন্ডেড ডিভাইসের ধরন লেখে, তাহলে ডিভাইসে অপ্রত্যাশিত
TYPE_UNKNOWNএড়াতেFEATURE_EXTENTED_DEVICE_TYPES-এর পিছনে গেট করুন যেখানে ফিচারটি উপলভ্য নেই।