أذونات Android

تهدف أذونات Android إلى حماية خصوصية مستخدم Android. ويتم تنبيه المستخدم عندما تريد التطبيقات الوصول إلى أنواع بيانات للبيانات الحسّاسة، مثل جهات الاتصال أو الصور، وميزات النظام، مثل الموقع الجغرافي أو رصد الخطوات. يمنح المستخدمون هذه الأذونات عند تنزيل تطبيقك لأول مرة.

إذا كان تطبيقك يحتاج إلى الوصول إلى أيّ من أنواع البيانات هذه (وهي مجموعة فرعية من أنواع بيانات Google Fit)، اطلب إذن Android ذي الصلة قبل طلب أذونات OAuth. انظر أدناه.

الشكل 1.شاشة طلب الموافقة على أذونات Android.

---

أنواع البيانات التي تحتاج إلى أذونات Android

للوصول إلى أنواع بيانات النشاط البدني هذه، عليك طلب إذن Android ‏ACTIVITY_RECOGNITION:

• لتسجيل أنواع البيانات هذه:

  • com.google.step_count.delta
  • com.google.step_count.cumulative
  • com.google.step_count.cadence
  • com.google.activity.segment
  • com.google.calories.expended

• لقراءة أنواع البيانات هذه:

  • com.google.step_count.delta
  • com.google.step_count.cumulative
  • com.google.step_count.cadence
  • com.google.activity.segment
  • com.google.activity.exercise

للوصول إلى أنواع البيانات هذه، عليك طلب إذن Android ‏ACCESS_FINE_LOCATION:

• لقراءة أنواع البيانات هذه:
  • com.google.distance.delta
  • com.google.location.sample
  • com.google.location.bounding_box
  • com.google.speed

لتسجيل أنواع البيانات هذه، عليك طلب إذن Android ‏ BODY_SENSORS:BODY_SENSORS

• com.google.heart_rate.bpm

طلب أذونات Android

تعرَّف على طلب أذونات Android، و إذن التعرّف على النشاط البدني، و إذن تحديد الموقع الجغرافي الدقيق، وإذن أجهزة استشعار الجسم.

للوصول إلى أنواع البيانات أعلاه باستخدام Google Fit APIs، عليك تنفيذ منطق للتعامل مع طلب أذونات Android لكل من Android 10 والإصدارات السابقة من Android. تستخدِم هذه الأمثلة إذن ACTIVITY_RECOGNITION.

Android 10

لكي يتمكّن تطبيقك من استهداف مستوى واجهة برمجة التطبيقات 29 أو المستويات الأحدث، اطلب الإذن من المستخدم وسجِّله في ملف بيان التطبيق.

1. أضِف الإذن إلى ملف البيان.

   <uses-permission android:name="android.permission.ACTIVITY_RECOGNITION"/>
   

2. تحقَّق مما إذا تم منح الإذن:

   if (ContextCompat.checkSelfPermission(thisActivity, Manifest.permission.ACTIVITY_RECOGNITION)
             != PackageManager.PERMISSION_GRANTED) {
         // Permission is not granted
   }
   

3. إذا لم يتم منح الإذن بعد، اطلب الإذن:

   ActivityCompat.requestPermissions(thisActivity,
               arrayOf(Manifest.permission.ACTIVITY_RECOGNITION),
               MY_PERMISSIONS_REQUEST_ACTIVITY_RECOGNITION)
   

الإصدار 9 من Android والإصدارات الأقدم

لكي يتمكّن تطبيقك من استهداف المستوى 28 من واجهة برمجة التطبيقات أو المستويات الأقدم:

1. اطلب الإذن com.google.android.gms.permission.ACTIVITY_RECOGNITION.

2. أضِف الإذن إلى ملف البيان.

   <uses-permission android:name="android.gms.permission.ACTIVITY_RECOGNITION"/>
   

ملاحظة: إذا كان تطبيقك يستهدف المستوى 28 من واجهة برمجة التطبيقات أو المستويات الأقدم ولكنّه يعمل على Android 10، يتم تحويل com.google.android.gms.permission.ACTIVITY_RECOGNITION الإذن إلى إذن التشغيل الذي تم منحه مسبقًا والذي يمكن للمستخدم إبطاله. وفي حال إبطاله، سيتم حظر وصول تطبيقك إلى أنواع بيانات النشاط البدني هذه. يُرجى تحديث تطبيقك للتعامل مع هذه الحالة.