Khai báo quyền thích hợp

Dịch vụ sức khoẻ trên Wear OS sử dụng các quyền riêng biệt sau:

• READ_HEART_RATE để đọc thông tin về nhịp tim.
• ACTIVITY_RECOGNITION
• ACCESS_FINE_LOCATION
• BODY_SENSORS trên Wear OS 5.1 (API cấp 35) trở xuống
• BODY_SENSORS_BACKGROUND từ Wear OS 4 (API cấp 33) đến Wear OS 5.1 (API cấp 35)

Lưu ý: Đối với các ứng dụng nhắm đến Bản dùng thử Wear OS 6 dành cho nhà phát triển (API cấp 36) trở lên, mọi API trước đây yêu cầu BODY_SENSORS hoặc BODY_SENSORS_BACKGROUND đều yêu cầu quyền android.permissions.health tương ứng. Hãy xem phần các bước di chuyển để biết thêm thông tin.

Hãy tham khảo bảng sau đây để xác định những quyền cần thiết cho ứng dụng của bạn, dựa trên các loại dữ liệu thể chất mà bạn muốn trình bày cho người dùng. Hãy nhớ tuân thủ các nguyên tắc cơ bản để yêu cầu cấp quyền, bao gồm cả việc yêu cầu cấp quyền theo ngữ cảnh.

Nếu ứng dụng của bạn nhắm đến API cấp 36 trở lên và nếu ứng dụng sử dụng PassiveMonitoringClient để truy cập vào thông tin của cảm biến cơ thể ở chế độ nền, hãy yêu cầu quyền READ_HEALTH_DATA_IN_BACKGROUND. Nếu ứng dụng của bạn nhắm đến cấp độ API từ 33 đến 35, hãy yêu cầu cả quyền BODY_SENSORS và BODY_SENSORS_BACKGROUND.

Lưu ý: Nếu bạn chỉ định isGpsEnabled = true trong ExerciseConfig, Dịch vụ sức khoẻ cũng sử dụng GNSS để cải thiện độ chính xác của các chỉ số như quãng đường, tốc độ và tốc độ, nhưng yêu cầu người dùng cấp quyền ACCESS_FINE_LOCATION cho ứng dụng của bạn.

Loại dữ liệu	Quyền
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

Di chuyển để hỗ trợ API cấp 36

Nếu ứng dụng của bạn nhắm đến Wear OS 6 (API cấp 36) trở lên, hãy làm theo các bước sau để di chuyển ứng dụng của bạn nhằm hỗ trợ các phiên bản mới nhất của nền tảng Wear OS:

1. Trong tệp kê khai, hãy thêm maxSdkVersion cho quyền cũ cũng như quyền READ_HEART_RATE hiện đại:

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

2. Nếu ứng dụng của bạn yêu cầu quyền truy cập vào cảm biến cơ thể khi chạy ở chế độ nền, hãy thêm maxSdkVersion cho quyền cũ ở chế độ nền và thêm quyền READ_HEALTH_DATA_IN_BACKGROUND hiện đại:

   <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. Yêu cầu và xác nhận rằng quyền đo nhịp tim được cấp ở mọi nơi mà ứng dụng của bạn kiểm tra quyền BODY_SENSOR và BODY_SENSORS_BACKGROUND, lọc theo phiên bản Wear OS. Ví dụ:

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