মেটাডেটা সংক্রান্ত প্রয়োজনীয়তা

এই গাইড 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 ডিভাইসের ধরন হল পরিমাপ করার মিটার।
ব্যবহারকারীর ডিভাইস Health Connect-এ এক্সটেন্ডেড ডিভাইসের ধরন সাপোর্ট করে কিনা তা নির্ধারণ করতে, ক্লায়েন্টে 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 নির্দেশিকা আপডেট করা হয়েছে। কিছু উদাহরণের জন্য, ডেটা লিখুন পৃষ্ঠা দেখুন।

মেটাডেটার নতুন পদ্ধতি

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

  • activelyRecorded

    • fun activelyRecorded(device: Device): Metadata.
    • fun activelyRecorded(clientRecordId: String, clientRecordVersion: Long = 0, device: Device): Metadata
    • fun activelyRecordedWithId(id: String, device: Device): Metadata
  • autoRecorded

    • fun autoRecorded(device: Device): Metadata
    • fun autoRecorded(clientRecordId: String, clientRecordVersion: Long = 0, device: Device): Metadata
    • fun autoRecordedWithId(id: String, device: Device): Metadata
  • manualEntry

    • fun manualEntry(device: Device? = null): Metadata
    • fun manualEntry(clientRecordId: String, clientRecordVersion: Long = 0, device: Device? = null): Metadata
    • fun manualEntryWithId(id: String, device: Device? = null): Metadata
  • unknownRecordingMethod

    • fun unknownRecordingMethod(device: Device? = null): Metadata
    • fun unknownRecordingMethod(clientRecordId: String, clientRecordVersion: Long = 0, device: Device? = null): Metadata
    • fun 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.1.0-alpha12-এ আপগ্রেড করুন।

  2. লাইব্রেরি তৈরি করার সময়, যেখানে নতুন মেটাডেটা প্রয়োজন সেখানে কম্পাইলেশন সংক্রান্ত সমস্যা দেখা দেবে। এইসব সমস্যার সমাধান করতে এবং মাইগ্রেশন সম্পূর্ণ করতে, আপনি নিম্নলিখিত পরিবর্তনগুলি করেছেন কিনা তা যাচাই করুন:

    • Record তৈরি করার সময় রেকর্ডিং পদ্ধতি উল্লেখ করা বাধ্যতামূলক। এটি Metadata-এ দেওয়া ফ্যাক্টরি পদ্ধতির মধ্যে কোনও একটি ব্যবহার করে করা হয়, যেমন Metadata.manualEntry() বা Metadata.activelyRecorded(device = Device(...))।
    • কোনও ডিভাইসের মাধ্যমে রেকর্ড করা ডেটার ক্ষেত্রে, ডিভাইসের ধরন উল্লেখ করা বাধ্যতামূলক, যেমন Device.TYPE_WATCH বা Device.TYPE_PHONE।
  3. আপনার অ্যাপ যদি এক্সটেন্ডেড ডিভাইসের ধরন লেখে, তাহলে ডিভাইসে অপ্রত্যাশিত TYPE_UNKNOWN এড়াতে FEATURE_EXTENTED_DEVICE_TYPES-এর পিছনে গেট করুন যেখানে ফিচারটি উপলভ্য নেই।