Android 權限

Android 權限旨在保護 Android 使用者的隱私權。他們的提示 使用者要在應用程式存取機密資料類型 (例如聯絡人或相片) 時保護使用者。 系統功能，例如位置或步數偵測使用者授予這些權限 首次下載應用程式

如果您的應用程式需要存取上述任一類型資料 (屬於 Google Fit 資料類型的一部分)，請針對 必須先取得 Android 權限，再要求 OAuth 權限。 詳情請見下方說明。

Android 權限同意畫面範例
圖 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 權限 這些範例使用 ACTIVITY_RECOGNITION 權限。

Android 10

以便應用程式指定 API 級別 29 以上的目標 API 級別， 並在應用程式資訊清單檔案中註冊此權限。

  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"/>
，瞭解如何調查及移除這項存取權。