ज़रूरी अनुमतियों का एलान करना

Wear OS पर Health Services, इन अलग-अलग अनुमतियों का इस्तेमाल करती है:

• READ_HEART_RATE, धड़कन की दर की जानकारी देखने के लिए.
• ACTIVITY_RECOGNITION
• ACCESS_FINE_LOCATION
• Wear OS 5.1 (एपीआई लेवल 35) और इससे पहले के वर्शन पर BODY_SENSORS
• BODY_SENSORS_BACKGROUND Wear OS 4 (एपीआई लेवल 33) और Wear OS 5.1 (एपीआई लेवल 35) के बीच

ध्यान दें: Wear OS 6 Developer Preview (एपीआई लेवल 36) या उसके बाद के वर्शन को टारगेट करने वाले ऐप्लिकेशन के लिए, जिन एपीआई के लिए पहले BODY_SENSORS या BODY_SENSORS_BACKGROUND की ज़रूरत होती थी उनके लिए अब android.permissions.health अनुमति लेनी होगी. ज़्यादा जानकारी के लिए, डेटा को दूसरी जगह भेजने का तरीका सेक्शन देखें.

उपयोगकर्ताओं को किस तरह का फ़िटनेस डेटा दिखाना है, इसके आधार पर यह तय करने के लिए कि आपके ऐप्लिकेशन के लिए कौनसी अनुमतियां ज़रूरी हैं, नीचे दी गई टेबल देखें. अनुमतियों का अनुरोध करने के लिए, बुनियादी सिद्धांतों का पालन करना न भूलें. इनमें, संदर्भ के हिसाब से अनुमतियां मांगना भी शामिल है.

अगर आपका ऐप्लिकेशन, एपीआई लेवल 36 या उसके बाद के वर्शन को टारगेट करता है और बैकग्राउंड में बॉडी सेंसर की जानकारी ऐक्सेस करने के लिए PassiveMonitoringClient का इस्तेमाल करता है, तो READ_HEALTH_DATA_IN_BACKGROUND अनुमति का अनुरोध करें. अगर आपका ऐप्लिकेशन 33 से 35 के बीच के एपीआई लेवल को टारगेट करता है, तो BODY_SENSORS और BODY_SENSORS_BACKGROUND, दोनों अनुमतियों का अनुरोध करें.

ध्यान दें: अगर आपने ExerciseConfig में isGpsEnabled = true की वैल्यू दी है, तो Health Services, दूरी, रफ़्तार, और गति जैसी मेट्रिक की सटीक जानकारी देने के लिए GNSS का भी इस्तेमाल करता है. हालांकि, इसके लिए उपयोगकर्ता को आपके ऐप्लिकेशन को ACCESS_FINE_LOCATION की अनुमति देनी होगी.

डेटा टाइप	अनुमति
CALORIES CALORIES_DAILY DISTANCE_DAILY DECLINE_DISTANCE DISTANCE ELEVATION_GAIN ELEVATION_LOSS FLAT_GROUND_DISTANCE FLOORS FLOORS_DAILY GOLF_SHOT_COUNT INCLINE_DISTANCE PACE REP_COUNT RUNNING_STEPS SPEED STEPS STEPS_DAILY STEPS_PER_MINUTE SWIMMING_LAP_COUNT SWIMMING_STROKES CALORIES_TOTAL WALKING_STEPS UserActivityInfo UserActivityState	ACTIVITY_RECOGNITION
HEART_RATE_BPM	READ_HEART_RATE
ABSOLUTE_ELEVATION LOCATION	ACCESS_FINE_LOCATION

एपीआई लेवल 36 के साथ काम करने के लिए माइग्रेट करना

अगर आपका ऐप्लिकेशन Wear OS 6 (एपीआई लेवल 36) या उसके बाद के वर्शन को टारगेट करता है, तो अपने ऐप्लिकेशन को Wear OS प्लैटफ़ॉर्म के नए वर्शन के साथ काम करने के लिए माइग्रेट करने के लिए, यह तरीका अपनाएं:

1. अपनी मेनिफ़ेस्ट फ़ाइल में, लेगसी अनुमति के लिए maxSdkVersion और आधुनिक अनुमति के लिए READ_HEART_RATE जोड़ें:

   <uses-permission android:name="android.permission.BODY_SENSORS"
                    android:maxSdkVersion="35" />
   <uses-permission android:name="android.permission.health.READ_HEART_RATE" />
   

2. अगर आपके ऐप्लिकेशन को बैकग्राउंड में चलने के दौरान, बॉडी सेंसर का ऐक्सेस चाहिए, तो बैकग्राउंड में ऐक्सेस करने की लेगसी अनुमति के लिए maxSdkVersion जोड़ें. साथ ही, आधुनिक READ_HEALTH_DATA_IN_BACKGROUND अनुमति भी जोड़ें:

   <uses-permission android:name="android.permission.BODY_SENSORS_BACKGROUND"
                    android:maxSdkVersion="35" />
   <uses-permission android:name="android.permission.health.READ_HEALTH_DATA_IN_BACKGROUND" />
   

3. Wear OS वर्शन के हिसाब से फ़िल्टर करके, BODY_SENSOR और BODY_SENSORS_BACKGROUND की अनुमति की जांच करने के लिए, ऐप्लिकेशन में हर जगह दिल की दर की अनुमति देने का अनुरोध करें और पुष्टि करें. उदाहरण के लिए:

   if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.BAKLAVA) {
       this.add(HealthPermissions.READ_HEART_RATE)
   }