এই নির্দেশিকাটি Health Connect সংস্করণ 1.1.0-alpha12 এর সাথে সামঞ্জস্যপূর্ণ।
ব্যায়াম রুট ব্যবহারকারীদের সংশ্লিষ্ট ব্যায়াম ক্রিয়াকলাপের জন্য একটি GPS রুট ট্র্যাক করতে এবং অন্যান্য অ্যাপের সাথে তাদের ওয়ার্কআউটের মানচিত্র শেয়ার করতে দেয়।
এই নির্দেশিকাটি কীভাবে ব্যবহারকারীর কাছ থেকে অনুমতির অনুরোধ করতে হয় সে সম্পর্কে তথ্য প্রদান করে এবং ব্যায়াম সেশনের অংশ হিসাবে অ্যাপগুলি কীভাবে রুট ডেটা লেখার অনুমতি পায় তার রূপরেখা দেয়।
ব্যায়াম রুটের জন্য পড়া এবং লেখার কার্যকারিতা অন্তর্ভুক্ত:
- অ্যাপ্লিকেশানগুলি ব্যায়াম রুটের জন্য একটি নতুন লেখার অনুমতি তৈরি করে৷
- ক্ষেত্র হিসাবে একটি রুট সহ একটি অনুশীলন সেশন লিখে সন্নিবেশ ঘটে।
- পড়া:
- সেশনের মালিকের জন্য, সেশন রিড ব্যবহার করে ডেটা অ্যাক্সেস করা হয়।
- একটি থার্ড-পার্টি অ্যাপ থেকে, একটি ডায়ালগের মাধ্যমে যা ব্যবহারকারীকে একটি রুট একবার পড়ার অনুমতি দেয়।
ব্যবহারকারীর লেখার অনুমতি না থাকলে এবং রুট সেট না থাকলে, রুট আপডেট হয় না।
যদি আপনার অ্যাপের একটি রুট লেখার অনুমতি থাকে এবং রুট ছাড়াই একটি সেশন অবজেক্টে পাস করে একটি সেশন আপডেট করার চেষ্টা করে, বিদ্যমান রুটটি মুছে ফেলা হয়।
স্বাস্থ্য সংযোগের উপলব্ধতা পরীক্ষা করুন
Health Connect ব্যবহার করার চেষ্টা করার আগে, আপনার অ্যাপটিকে যাচাই করা উচিত যে ব্যবহারকারীর ডিভাইসে Health Connect উপলব্ধ রয়েছে। Health Connect সব ডিভাইসে আগে থেকে ইনস্টল নাও থাকতে পারে বা অক্ষম করা যেতে পারে। আপনি HealthConnectClient.getSdkStatus()
পদ্ধতি ব্যবহার করে উপলব্ধতা পরীক্ষা করতে পারেন।
হেলথ কানেক্টের প্রাপ্যতা কিভাবে চেক করবেন
fun checkHealthConnectAvailability(context: Context) { val providerPackageName = "com.google.android.apps.healthdata" // Or get from HealthConnectClient.DEFAULT_PROVIDER_PACKAGE_NAME val availabilityStatus = HealthConnectClient.getSdkStatus(context, providerPackageName) if (availabilityStatus == HealthConnectClient.SDK_UNAVAILABLE) { // Health Connect is not available. Guide the user to install/enable it. // For example, show a dialog. return // early return as there is no viable integration } if (availabilityStatus == HealthConnectClient.SDK_UNAVAILABLE_PROVIDER_UPDATE_REQUIRED) { // Health Connect is available but requires an update. // Optionally redirect to package installer to find a provider, for example: val uriString = "market://details?id=$providerPackageName&url=healthconnect%3A%2F%2Fonboarding" context.startActivity( Intent(Intent.ACTION_VIEW).apply { setPackage("com.android.vending") data = Uri.parse(uriString) putExtra("overlay", true) putExtra("callerId", context.packageName) } ) return } // Health Connect is available, obtain a HealthConnectClient instance val healthConnectClient = HealthConnectClient.getOrCreate(context) // Issue operations with healthConnectClient }
getSdkStatus()
দ্বারা প্রত্যাবর্তিত স্থিতির উপর নির্ভর করে, আপনি প্রয়োজনে Google Play Store থেকে Health Connect ইনস্টল বা আপডেট করার জন্য ব্যবহারকারীকে গাইড করতে পারেন।
বৈশিষ্ট্য প্রাপ্যতা
একজন ব্যবহারকারীর ডিভাইস স্বাস্থ্য সংযোগে পরিকল্পিত অনুশীলন সমর্থন করে কিনা তা নির্ধারণ করতে, ক্লায়েন্টেFEATURE_PLANNED_EXERCISE
এর উপলব্ধতা পরীক্ষা করুন:if (healthConnectClient
.features
.getFeatureStatus(
HealthConnectFeatures.FEATURE_PLANNED_EXERCISE
) == HealthConnectFeatures.FEATURE_STATUS_AVAILABLE) {
// Feature is available
} else {
// Feature isn't available
}
প্রয়োজনীয় অনুমতি
ব্যায়াম রুটে অ্যাক্সেস নিম্নলিখিত অনুমতি দ্বারা সুরক্ষিত:
-
android.permission.health.READ_EXERCISE_ROUTES
-
android.permission.health.WRITE_EXERCISE_ROUTE
READ_EXERCISE_ROUTES
হল বহুবচন, যখন WRITE_EXERCISE_ROUTE
হল একবচন৷ আপনার অ্যাপে ব্যায়াম রুট ক্ষমতা যোগ করতে, ExerciseSession
ডেটা টাইপের জন্য লেখার অনুমতির অনুরোধ করে শুরু করুন।
ব্যায়ামের রুট লিখতে সক্ষম হওয়ার জন্য আপনাকে যে অনুমতিটি ঘোষণা করতে হবে তা এখানে:
<application>
<uses-permission
android:name="android.permission.health.WRITE_EXERCISE_ROUTE" />
...
</application>
ব্যায়ামের রুট পড়তে, আপনাকে নিম্নলিখিত অনুমতিগুলির জন্য অনুরোধ করতে হবে:
<application>
<uses-permission
android:name="android.permission.health.READ_EXERCISE_ROUTES" />
...
</application>
আপনাকে একটি ব্যায়ামের অনুমতিও ঘোষণা করতে হবে, কারণ প্রতিটি রুট একটি ব্যায়াম সেশনের সাথে যুক্ত (এক সেশন = একটি ওয়ার্কআউট)।
অনুমতির জন্য অনুরোধ করতে, যখন আপনি প্রথমবার আপনার অ্যাপকে Health Connect-এর সাথে সংযুক্ত করবেন তখন PermissionController.createRequestPermissionResultContract()
পদ্ধতি ব্যবহার করুন। আপনি অনুরোধ করতে চাইতে পারেন যে কয়েকটি অনুমতি হল:
- রুট ডেটা সহ স্বাস্থ্য এবং ফিটনেস ডেটা পড়ুন:
HealthPermission.getReadPermission(ExerciseSessionRecord::class)
- রুট ডেটা সহ স্বাস্থ্য এবং ফিটনেস ডেটা লিখুন:
HealthPermission.getWritePermission(ExerciseSessionRecord::class)
- ব্যায়াম রুট ডেটা লিখুন:
HealthPermission.PERMISSION_WRITE_EXERCISE_ROUTE
ব্যবহারকারীর কাছ থেকে অনুমতি অনুরোধ
একটি ক্লায়েন্ট উদাহরণ তৈরি করার পরে, আপনার অ্যাপটিকে ব্যবহারকারীর কাছ থেকে অনুমতির অনুরোধ করতে হবে। ব্যবহারকারীদের যেকোন সময় অনুমতি প্রদান বা অস্বীকার করার অনুমতি দিতে হবে।
এটি করতে, প্রয়োজনীয় ডেটা প্রকারের জন্য অনুমতিগুলির একটি সেট তৈরি করুন৷ নিশ্চিত করুন যে সেটের অনুমতিগুলি প্রথমে আপনার Android ম্যানিফেস্টে ঘোষণা করা হয়েছে।
// Create a set of permissions for required data types
val PERMISSIONS =
setOf(
HealthPermission.getReadPermission(ExerciseSessionRecord::class),
HealthPermission.getWritePermission(ExerciseSessionRecord::class)
)
আপনার অ্যাপে ইতিমধ্যেই প্রয়োজনীয় অনুমতি দেওয়া আছে কিনা তা দেখতে getGrantedPermissions
ব্যবহার করুন। যদি না হয়, সেই অনুমতিগুলির অনুরোধ করতে createRequestPermissionResultContract
ব্যবহার করুন। এটি স্বাস্থ্য সংযোগের অনুমতি স্ক্রীন প্রদর্শন করে।
// Create the permissions launcher
val requestPermissionActivityContract = PermissionController.createRequestPermissionResultContract()
val requestPermissions = registerForActivityResult(requestPermissionActivityContract) { granted ->
if (granted.containsAll(PERMISSIONS)) {
// Permissions successfully granted
} else {
// Lack of required permissions
}
}
suspend fun checkPermissionsAndRun(healthConnectClient: HealthConnectClient) {
val granted = healthConnectClient.permissionController.getGrantedPermissions()
if (granted.containsAll(PERMISSIONS)) {
// Permissions already granted; proceed with inserting or reading data
} else {
requestPermissions.launch(PERMISSIONS)
}
}
যেহেতু ব্যবহারকারীরা যেকোন সময় অনুমতি মঞ্জুর বা প্রত্যাহার করতে পারে, আপনার অ্যাপটিকে পর্যায়ক্রমে মঞ্জুর করা অনুমতিগুলি পরীক্ষা করতে হবে এবং অনুমতি হারিয়ে গেলে পরিস্থিতিগুলি পরিচালনা করতে হবে।
একটি ব্যায়াম সেশন রেকর্ড অন্তর্ভুক্ত তথ্য
প্রতিটি ব্যায়াম সেশনের রেকর্ডে নিম্নলিখিত তথ্য থাকে:
- ব্যায়ামের ধরন , উদাহরণস্বরূপ, বাইক চালানো।
- ব্যায়ামের পথ , যাতে অক্ষাংশ, দ্রাঘিমাংশ এবং উচ্চতার মতো তথ্য থাকে।
সমর্থিত সমষ্টি
ExerciseSessionRecord
জন্য নিম্নলিখিত সমষ্টিগত মানগুলি উপলব্ধ:
উদাহরণ ব্যবহার
নিম্নলিখিত কোড স্নিপেটগুলি দেখায় কিভাবে একটি ব্যায়াম রুট পড়তে এবং লিখতে হয়।
ব্যায়াম রুট পড়ুন
আপনার অ্যাপটি ব্যাকগ্রাউন্ডে চলাকালীন অন্যান্য অ্যাপ দ্বারা তৈরি ব্যায়াম রুট ডেটা পড়তে পারে না।
যখন আপনার অ্যাপটি ব্যাকগ্রাউন্ডে চলে এবং অন্য অ্যাপের দ্বারা তৈরি একটি ব্যায়াম রুট পড়ার চেষ্টা করে, তখন Health Connect একটি ExerciseRouteResult.ConsentRequired
রেসপন্স ফেরত দেয়, এমনকি যদি আপনার অ্যাপে সবসময় ব্যায়াম রুটের ডেটা অ্যাক্সেস করার অনুমতি থাকে।
এই কারণে, আমরা দৃঢ়ভাবে সুপারিশ করছি যে আপনি আপনার অ্যাপের সাথে ইচ্ছাকৃত ব্যবহারকারীর ইন্টারঅ্যাকশনের ভিত্তিতে রুটের অনুরোধ করুন, যখন ব্যবহারকারী আপনার অ্যাপের UI এর সাথে সক্রিয়ভাবে জড়িত থাকে।
ব্যাকগ্রাউন্ড রিড সম্পর্কে আরও জানতে, পটভূমি পঠিত উদাহরণ দেখুন।
নিম্নলিখিত কোড স্নিপেট দেখায় কিভাবে Health Connect-এ একটি সেশন পড়তে হয় এবং সেই সেশন থেকে একটি রুটের অনুরোধ করতে হয়:
suspend fun readExerciseSessionAndRoute() {
val endTime = Instant.now()
val startTime = endTime.minus(Duration.ofHours(1))
val grantedPermissions =
healthConnectClient.permissionController.getGrantedPermissions()
if (!grantedPermissions.contains(
HealthPermission.getReadPermission(ExerciseSessionRecord::class))) {
// The user doesn't allow the app to read exercise session data.
return
}
val readResponse =
healthConnectClient.readRecords(
ReadRecordsRequest(
ExerciseSessionRecord::class,
TimeRangeFilter.between(startTime, endTime)
)
)
val exerciseRecord = readResponse.records.first()
val recordId = exerciseRecord.metadata.id
// See https://developer.android.com/training/basics/intents/result#launch
// for appropriately handling ActivityResultContract.
val requestExerciseRouteLauncher = fragment.registerForActivityResul
(ExerciseRouteRequestContract()) { exerciseRoute: ExerciseRoute? ->
if (exerciseRoute != null) {
displayExerciseRoute(exerciseRoute)
} else {
// Consent was denied
}
}
val exerciseSessionRecord =
healthConnectClient.readRecord(ExerciseSessionRecord::class, recordId).record
when (val exerciseRouteResult = exerciseSessionRecord.exerciseRouteResult) {
is ExerciseRouteResult.Data ->
displayExerciseRoute(exerciseRouteResult.exerciseRoute)
is ExerciseRouteResult.ConsentRequired ->
requestExerciseRouteLauncher.launch(recordId)
is ExerciseRouteResult.NoData -> Unit // No exercise route to show
else -> Unit
}
}
fun displayExerciseRoute(route: ExerciseRoute?) {
val locations = route.route.orEmpty()
for (location in locations) {
// Handle location.
}
}
একটি ব্যায়াম রুট লিখুন
নিম্নলিখিত কোডটি প্রদর্শন করে যে কীভাবে একটি সেশন রেকর্ড করতে হয় যাতে একটি ব্যায়াম রুট রয়েছে:
suspend fun InsertExerciseRoute(healthConnectClient: HealthConnectClient) {
val grantedPermissions =
healthConnectClient.permissionController.getGrantedPermissions()
if (!grantedPermissions.contains(
getWritePermission(ExerciseSessionRecord::class))) {
// The user doesn't allow the app to write exercise session data.
return
}
val sessionStartTime = Instant.now()
val sessionDuration = Duration.ofMinutes(20)
val sessionEndTime = sessionStartTime.plus(sessionDuration)
val exerciseRoute =
if (grantedPermissions.contains(PERMISSION_WRITE_EXERCISE_ROUTE)) ExerciseRoute(
listOf(
ExerciseRoute.Location(
// Location times must be on or after the session start time
time = sessionStartTime,
latitude = 6.5483,
longitude = 0.5488,
horizontalAccuracy = Length.meters(2.0),
verticalAccuracy = Length.meters(2.0),
altitude = Length.meters(9.0),
), ExerciseRoute.Location(
// Location times must be before the session end time
time = sessionEndTime.minusSeconds(1),
latitude = 6.4578,
longitude = 0.6577,
horizontalAccuracy = Length.meters(2.0),
verticalAccuracy = Length.meters(2.0),
altitude = Length.meters(9.2),
)
)
)
else
// The user doesn't allow the app to write exercise route data.
null
val exerciseSessionRecord = ExerciseSessionRecord(
startTime = sessionStartTime,
startZoneOffset = ZoneOffset.UTC,
endTime = sessionEndTime,
endZoneOffset = ZoneOffset.UTC,
exerciseType = ExerciseSessionRecord.EXERCISE_TYPE_BIKING,
title = "Morning Bike Ride",
exerciseRoute = exerciseRoute,
metadata = Metadata.manualEntry(
device = Device(type = Device.TYPE_PHONE)
),
)
val response = healthConnectClient.insertRecords(listOf(exerciseSessionRecord))
}
ব্যায়াম সেশন
ব্যায়াম সেশনে দৌড় থেকে শুরু করে ব্যাডমিন্টন পর্যন্ত যেকোনো কিছু অন্তর্ভুক্ত থাকতে পারে।
ব্যায়াম সেশন লিখুন
এইভাবে একটি সন্নিবেশের অনুরোধ তৈরি করতে হয় যাতে একটি সেশন অন্তর্ভুক্ত থাকে:
suspend fun writeExerciseSession(healthConnectClient: HealthConnectClient) {
healthConnectClient.insertRecords(
listOf(
ExerciseSessionRecord(
startTime = START_TIME,
startZoneOffset = START_ZONE_OFFSET,
endTime = END_TIME,
endZoneOffset = END_ZONE_OFFSET,
exerciseType = ExerciseSessionRecord.ExerciseType.RUNNING,
title = "My Run"
),
// ... other records
)
)
}
একটি ব্যায়াম অধিবেশন পড়ুন
একটি ব্যায়াম সেশন কিভাবে পড়তে হয় তার একটি উদাহরণ এখানে দেওয়া হল:
suspend fun readExerciseSessions(
healthConnectClient: HealthConnectClient,
startTime: Instant,
endTime: Instant
) {
val response =
healthConnectClient.readRecords(
ReadRecordsRequest(
ExerciseSessionRecord::class,
timeRangeFilter = TimeRangeFilter.between(startTime, endTime)
)
)
for (exerciseRecord in response.records) {
// Process each exercise record
// Optionally pull in with other data sources of the same time range.
val distanceRecord =
healthConnectClient
.readRecords(
ReadRecordsRequest(
DistanceRecord::class,
timeRangeFilter =
TimeRangeFilter.between(
exerciseRecord.startTime,
exerciseRecord.endTime
)
)
)
.records
}
}
উপ-টাইপ ডেটা লিখুন
সেশনে ঐচ্ছিক সাবটাইপ ডেটাও থাকতে পারে, যা অতিরিক্ত তথ্য দিয়ে সেশনকে সমৃদ্ধ করে।
উদাহরণ স্বরূপ, ব্যায়াম সেশনে ExerciseSegment
, ExerciseLap
এবং ExerciseRoute
ক্লাস অন্তর্ভুক্ত থাকতে পারে:
val segments = listOf(
ExerciseSegment(
startTime = Instant.parse("2022-01-02T10:10:10Z"),
endTime = Instant.parse("2022-01-02T10:10:13Z"),
segmentType = ActivitySegmentType.BENCH_PRESS,
repetitions = 373
)
)
val laps = listOf(
ExerciseLap(
startTime = Instant.parse("2022-01-02T10:10:10Z"),
endTime = Instant.parse("2022-01-02T10:10:13Z"),
length = 0.meters
)
)
ExerciseSessionRecord(
exerciseType = ExerciseSessionRecord.EXERCISE_TYPE_CALISTHENICS,
startTime = Instant.parse("2022-01-02T10:10:10Z"),
endTime = Instant.parse("2022-01-02T10:10:13Z"),
startZoneOffset = ZoneOffset.UTC,
endZoneOffset = ZoneOffset.UTC,
segments = segments,
laps = laps,
route = route
)
একটি অনুশীলন সেশন মুছুন
একটি ব্যায়াম অধিবেশন মুছে ফেলার দুটি উপায় আছে:
- সময় পরিসীমা দ্বারা.
- ইউআইডি দ্বারা।
সময়সীমা অনুসারে আপনি কীভাবে সাব-টাইপ ডেটা মুছবেন তা এখানে:
suspend fun deleteExerciseSessionByTimeRange(
healthConnectClient: HealthConnectClient,
exerciseRecord: ExerciseSessionRecord,
) {
val timeRangeFilter = TimeRangeFilter.between(exerciseRecord.startTime, exerciseRecord.endTime)
healthConnectClient.deleteRecords(ExerciseSessionRecord::class, timeRangeFilter)
// delete the associated distance record
healthConnectClient.deleteRecords(DistanceRecord::class, timeRangeFilter)
}
আপনি UID দ্বারা সাব-টাইপ ডেটাও মুছতে পারেন। এটি করলে শুধুমাত্র ব্যায়াম সেশন মুছে যায়, সংশ্লিষ্ট ডেটা নয়:
suspend fun deleteExerciseSessionByUid(
healthConnectClient: HealthConnectClient,
exerciseRecord: ExerciseSessionRecord,
) {
healthConnectClient.deleteRecords(
ExerciseSessionRecord::class,
recordIdsList = listOf(exerciseRecord.metadata.id),
clientRecordIdsList = emptyList()
)
}