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 健身 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 权限会转换为预先授予的运行时权限，用户可以 撤消该权限。如果撤消，您的应用将无法访问这些身体活动 数据类型。 请更新您的应用以处理这种情况。