Android 权限

Android 权限旨在保护 Android 用户的隐私。当应用想要访问敏感数据类型（如联系人或照片）以及系统功能（如位置信息或步数检测）时，系统会提示用户。用户在首次下载您的应用时授予这些权限。

如果您的应用需要访问任何这些类型的数据（Google 健身的一部分数据类型），请先请求相关的 Android 权限，然后再请求 OAuth 权限。请参阅下文。

图 1. Android 权限同意屏幕。

---

需要 Android 权限的数据类型

若要访问这些类型的身体活动数据，您需要请求 ACTIVITY_RECOGNITION Android 权限：

• 如需记录这些数据类型，请执行以下操作：

  • 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

若要访问这些数据类型，您需要请求 ACCESS_FINE_LOCATION Android 权限：

• 如需读取这些类型的数据，请执行以下操作：
  • com.google.distance.delta
  • com.google.location.sample
  • com.google.location.bounding_box
  • com.google.speed

若要记录这些数据类型，您需要请求 BODY_SENSORS Android 权限：

• com.google.heart_rate.bpm

请求 Android 权限

了解如何请求 Android 权限、身体活动识别权限、精确位置信息权限和身体传感器权限。

如需使用 Google Fit API 访问上述数据类型，您需要实现为 Android 10 及之前版本的 Android 请求 Android 权限的逻辑。这些示例使用了 ACTIVITY_RECOGNITION 权限。

Android 10

因此，您的应用能够以 API 级别 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)
   

Android 9 及更低版本

因此，您的应用能够以 API 级别 28 或更低级别为目标平台：

1. 请求 com.google.android.gms.permission.ACTIVITY_RECOGNITION 权限。

2. 向清单文件添加权限。

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

注意 ：如果您的应用以 API 级别 28 或更低级别为目标平台，但在 Android 10 上运行，系统会将 com.google.android.gms.permission.ACTIVITY_RECOGNITION 权限转换为预先授予的运行时权限，该权限可由用户撤消。撤消后，您的应用将无法访问这些身体活动数据类型。请更新您的应用以应对这种情况。