Health Connect

  
Nhà phát triển có thể đọc hoặc ghi hồ sơ sức khoẻ và thể chất của người dùng.
Bản cập nhật mới nhất Bản phát hành ổn định Bản phát hành dùng thử Bản phát hành beta Bản phát hành alpha
Ngày 10 tháng 1 năm 2024 - - - 1.1.0-alpha07

Yêu cầu quyền đối với loại dữ liệu

Để giúp chúng tôi tăng cường mức độ bảo mật và quyền riêng tư của người dùng, nhà phát triển tích hợp với Health Connect phải yêu cầu quyền đọc và/hoặc ghi loại dữ liệu bằng cách hoàn thành biểu mẫu khai báo dưới đây dành cho nhà phát triển. Trong yêu cầu, hãy đưa ra (các) trường hợp sử dụng hợp lệ cho loại dữ liệu bạn cần dựa trên mục đích của ứng dụng. Để biết thêm thông tin, hãy truy cập vào phần Câu hỏi thường gặp liên quan đến yêu cầu của Chính sách Health Connect và Quyền truy cập Health Connect của Android.

Khai báo phần phụ thuộc

Để thêm một phần phụ thuộc trên Health, bạn phải thêm kho lưu trữ Google Maven vào dự án. Đọc nội dung Kho lưu trữ Maven của Google để biết thêm thông tin.

Thêm các phần phụ thuộc cho cấu phần phần mềm bạn cần trong tệp build.gradle cho ứng dụng hoặc mô-đun:

Groovy

dependencies {
    // Use to implement health connects
    implementation "androidx.health.connect:connect-client:1.1.0-alpha07"
}

Kotlin

dependencies {
    // Use to implement health connects
    implementation("androidx.health.connect:connect-client:1.1.0-alpha07")
}

Để biết thêm thông tin về các phần phụ thuộc, hãy xem bài viết Thêm phần phụ thuộc vào bản dựng.

Ý kiến phản hồi

Ý kiến phản hồi của bạn có thể giúp chúng tôi cải thiện Jetpack. Hãy cho chúng tôi biết nếu bạn phát hiện lỗi mới hoặc có ý tưởng cải thiện thư viện này. Vui lòng xem các lỗi hiện có trong thư viện này trước khi báo một lỗi mới. Bạn có thể thêm lượt bình chọn cho lỗi hiện có bằng cách nhấp vào nút dấu sao.

Báo lỗi mới

Xem tài liệu về Công cụ theo dõi lỗi để biết thêm thông tin.

Phiên bản 1.1

Phiên bản 1.1.0-alpha07

Ngày 10 tháng 1 năm 2024

Phát hành androidx.health.connect:connect-client:1.1.0-alpha07. Phiên bản 1.1.0-alpha07 bao gồm các thay đổi sau.

Các thay đổi về API

  • Trả về SDK_UNAVAILABLE khi #getSdkStatus được gọi từ ngữ cảnh người dùng hồ sơ. (I91df3)
  • Xoá SleepStageRecord. (/If6ada)

Sửa lỗi

  • Gửi RemoteException thay vì IllegalStateException khi có lỗi liên kết. (Id2233)

Phiên bản 1.1.0-alpha06

Ngày 18 tháng 10 năm 2023

Phát hành androidx.health.connect:connect-client:1.1.0-alpha06. Phiên bản 1.1.0-alpha06 bao gồm các thay đổi sau.

Các thay đổi về API

  • Đặt định nghĩa recordingMethod ở chế độ công khai. (I401fb)

Sửa lỗi

  • Thêm tài liệu vào tuyến đường tập thể dục để chỉ định rằng vị trí đó phải trước thời gian kết thúc phiên. (0e51e6)

Phiên bản 1.1.0-alpha05

Ngày 4 tháng 10 năm 2023

Phát hành androidx.health.connect:connect-client:1.1.0-alpha05. Phiên bản 1.1.0-alpha05 bao gồm các thay đổi sau.

Các thay đổi về API

  • Thêm ý định chuyển đến màn hình quản lý dữ liệu Health Connect. (Ibf591)
  • Xoá các phương thức không dùng nữa trong AggregationResult. (Idbda9)
  • Thêm API thuận tiện để tạo ReadRecordsRequest, cũng như xoá và đọc bản ghi với loại bản ghi được sửa đổi. (If58a5)

Sửa lỗi

  • Khắc phục lỗi trong Android 14 khiến các trường dinh dưỡng rỗng được trả về là Double.MIN_VALUE. (1aa1d1)
  • Sửa lỗi trong Android 14, trong đó việc tổng hợp theo khoảng thời gian Hằng tháng/Hằng năm đã gửi một ngoại lệ trong phản hồi do các bộ chứa có cùng thời gian bắt đầu/kết thúc. (281313)

Phiên bản 1.1.0-alpha04

Ngày 6 tháng 9 năm 2023

Phát hành androidx.health.connect:connect-client:1.1.0-alpha04. Phiên bản 1.1.0-alpha04 bao gồm các thay đổi sau.

Các thay đổi về API

Sửa lỗi

Phiên bản 1.1.0-alpha03

Ngày 26 tháng 7 năm 2023

Phát hành androidx.health.connect:connect-client:1.1.0-alpha03. Phiên bản 1.1.0-alpha03 bao gồm các thay đổi sau.

Tính năng mới

  • API để đọc và ghi tuyến đường Bài tập thể dục:
    • Đã thêm ExerciseRouteResult vào ExerciseSessionRecord
    • Đã thêm ExerciseRouteRequestContract

Các thay đổi về API

  • Thêm ExerciseRouteResult và các lớp con: Data, NoData và ConsentRequiredStates.
  • Thêm ExerciseRoute dưới dạng một lớp độc lập, lớp này lưu giữ dữ liệu vị trí cho tuyến đường. (Người dùng)
  • Thêm PERMISSION_WRITE_EXERCISE_ROUTE. (I92fc4)
  • Đã thêm ExerciseRouteRequestContract và HealthPermissionsRequestContract đã thêm. (Ief0e5)

Sửa lỗi

  • Sửa lỗi tạo Năng lượng tính theo kilojun (Ie8791)

Phiên bản 1.1.0-alpha02

Ngày 21 tháng 6 năm 2023

Phát hành androidx.health.connect:connect-client:1.1.0-alpha02. Phiên bản 1.1.0-alpha02 bao gồm các thay đổi sau.

Sửa lỗi

  • Khắc phục sự cố rò rỉ HealthDataSdkService (Ia3ba5)
  • Luôn chuyển hướng đến Ứng dụng HealthConnect phù hợp khi yêu cầu quyền trên Android U.(I6415a)

Phiên bản 1.1.0-alpha01

Ngày 7 tháng 6 năm 2023

Phát hành androidx.health.connect:connect-client:1.1.0-alpha01. Phiên bản này được phát triển trong một nhánh nội bộ.

Tính năng mới

  • Hỗ trợ phiên bản khung Android 14 của Health Connect. SDK này là điều kiện tiên quyết để chạy Android 14. Nếu không có, các ứng dụng sẽ không thể tích hợp với Health Connect trên Android 14.
  • Thêm phương thức ghi để ghi siêu dữ liệu.

Các thay đổi về API

  • Các thay đổi về API phiên:
    • Thêm nhiều giai đoạn ngủ vào SleepSessionRecord và xoá SleepStageRecord.
    • Thêm ExerciseLap và ExerciseSegment vào ExerciseSessionRecord.
  • Giới hạn tốc độ định kỳ và hằng ngày (bao gồm cả giới hạn bộ nhớ) cho các thao tác đọc, thay đổi, chèn và xoá.
  • Thêm tính năng xác thực cho tất cả các trường NutritionRecord.
  • Thêm tính năng xác thực cho HeartRateVariabilityRmssdRecord.
  • Xoá 2 API không dùng nữa: HealthConnectClient#isProviderAvailable và HealthConnectClient#isApiSupported.

Sửa lỗi

  • Cố định đẳng thức đơn vị cho tất cả các loại đơn vị, đẳng thức không còn phụ thuộc vào loại dùng để khởi tạo đơn vị. Ví dụ: Khối lượng.gam(1000) bây giờ bằng Khối lượng.kilogam(1).

Phiên bản 1.0

Phiên bản 1.0.0-alpha11

Ngày 22 tháng 2 năm 2023

Phát hành androidx.health.connect:connect-client:1.0.0-alpha11. Phiên bản 1.0.0-alpha11 bao gồm các thay đổi sau.

Các thay đổi về API

  • Thêm ý định dùng để mở Health Connect. (Ic8055)
  • Xoá một số loại bài tập thể dục. Hãy sử dụng EXERCISE_TYPE_STRENGTH_TRAINING, EXERCISE_TYPE_HIGH_INTENSITY_INTERVAL_TRAINING hoặc EXERCISE_TYPE_CALISTHENICS thay cho các loại đã xoá. (I7291c)
  • Thêm API sdkStatus() mới kết hợp 2 API isSdkSupported() và isProviderAvailable() hiện không còn được dùng nữa. (Iac89d)
  • Thay đổi các API dùng providerPackageName để chấp nhận một chuỗi thay vì danh sách. (I67e0f)

Phiên bản 1.0.0-alpha10

Ngày 25 tháng 1 năm 2023

Phát hành androidx.health.connect:connect-client:1.0.0-alpha10. Phiên bản 1.0.0-alpha10 bao gồm các thay đổi sau.

Các thay đổi về API

  • ExerciseEventRecord, ExerciseLapRecord, ExerciseRepititionRecord và SwimmingStrokesRecord không còn được hỗ trợ dưới dạng RecordTypes. Chúng không thể được ghi hoặc đọc từ HealthConnect nữa. Hãy xoá mọi tham chiếu đến các loại dữ liệu này khỏi quá trình tích hợp HealthConnect. (If7ca2)
  • Các thay đổi trong các API quyền để chấp nhận quyền ở định dạng mới dựa trên chuỗi. Sự thay đổi này cũng yêu cầu thay đổi khai báo quyền sang định dạng quyền Android tiêu chuẩn. (Ib0a2f)

Phiên bản 1.0.0-alpha09

Ngày 11 tháng 1 năm 2023

Phát hành androidx.health.connect:connect-client:1.0.0-alpha09. Phiên bản 1.0.0-alpha09 bao gồm các thay đổi sau.

Tính năng mới

  • Thêm 2 loại dữ liệu mới về sức khoẻ nữ giới cho Health Connect: IntermenstrualBleedingRecord và MenstruationPeriodRecord. MenstruationFlow.ENUMs có các thuộc tính là Ít, Trung bình, Nhiều và Không xác định.

Các thay đổi về API

  • Thêm IntermenstrualBleedingRecord (Idc470)
  • Thêm loại bản ghi MenstruationPeriodRecord (Iea545)

Phiên bản 1.0.0-alpha08

Ngày 7 tháng 12 năm 2022

Phát hành androidx.health.connect:connect-client:1.0.0-alpha08. Phiên bản 1.0.0-alpha08 bao gồm các thay đổi sau.

Các thay đổi về API

  • Thêm BodyWaterMass, HeartRateVariabilityRmssdRecord ở dạng Loại bản ghi mới được hỗ trợ. (Ifd58f)
  • Xoá HipCircumferenceRecord, WaistCircumferenceRecord ở dạng RecordTypes được hỗ trợ. (I62fb9)
  • Thay đổi MenstruationFlowRecord.flow từ stringdef thành intdefs. (I0369f)
  • Thay đổi các trường Ghi giống enum với Strings thành Integers để cải thiện hiệu suất. (I3b295)
  • Thay đổi kiểu của các trường giống enum là ExerciseSession, ExerciseRepetitions, SleepStage từ chuỗi thành số nguyên. (Id32a9)
  • Đổi tên ExerciseSessionRecord.ACTIVE_TIME_TOTAL->EXERCISE_DURATION_TOTAL. (I5d7bd)
  • Thêm "Unusual" (Bất thường) vào enum CervicalMucus. Đổi tên "Clear" (Xoá sạch) thành "Eggwhite" để tăng tính rõ ràng. Thay đổi CervicalMucus#appearance và #sensation từ StringDefs thành IntDefs. (I3ac51)
  • StringDef của enum DeviceTypes giờ được chuyển vào IntDefs trong phần Thiết bị. (I3abf3)
  • Thêm HealthConnectClient.isApiSupported(), có tác dụng trả về giá trị false trên các phiên bản SDK không có cách triển khai tương thích. Đổi tên HealthConnectClient.isAvailable->isProviderAvailable. (I3674e)

Sửa lỗi

  • Không cho phép các giá trị HeartRate beatsPerMinute nhỏ hơn 1 (I6052f)
  • Thêm chú thích @JvmDefaultWithCompatibility (I8f206)

Phiên bản 1.0.0-alpha07

Ngày 24 tháng 10 năm 2022

Phát hành androidx.health.connect:connect-client:1.0.0-alpha07. Phiên bản 1.0.0-alpha07 bao gồm các thay đổi sau.

Các thay đổi về API

  • Các đối số ghi không có giá trị mặc định được đặt trước các đối số có giá trị mặc định. Để đảm bảo tính nhất quán, các đối số Instant và ZoneOffset luôn được đặt ngay từ đầu. (Id618c)
  • Đổi tên HealthConnectClient.getOrCreate#packageNames thành providerPackageNames. (Id81e4)

Sửa lỗi

  • Thêm xác thực giá trị trường Record (Ghi). Các giá trị cực kỳ sai sẽ gửi IllegalArgumentExceptions khi giá trị được cung cấp nằm ngoài giới hạn hợp lý. (Ie171d)
  • Xác thực thời gian bắt đầu ghi trước thời gian kết thúc khi phù hợp. (I02460)

Phiên bản 1.0.0-alpha06

Ngày 5 tháng 10 năm 2022

Phát hành androidx.health.connect:connect-client:1.0.0-alpha06. Phiên bản 1.0.0-alpha06 bao gồm các thay đổi sau.

Sửa lỗi

  • Cải thiện vòng đời của kết nối của dịch vụ. (If2bd5)
  • Khắc phục lỗi NPE khi ngoại lệ tăng lên trong kết nối dịch vụ. (I13546)

Phiên bản 1.0.0-alpha05

Ngày 21 tháng 9 năm 2022

Phát hành androidx.health.connect:connect-client:1.0.0-alpha05. Phiên bản 1.0.0-alpha05 bao gồm các thay đổi sau.

Các thay đổi về API

  • Đổi tên Metadata.uid -> Metadata.id và sử dụng thuật ngữ recordId một cách nhất quán trong các API CRUD có liên quan. (I3d1d2)
  • Đặt PermissionController.createRequestPermissionActivityContract làm phương thức tĩnh thay vì phương thức thực thể. Đổi tên thành PermissionController.createRequestPermissionResultContract. (Icd2fe)
  • Thêm loại đơn vị BloodGlucose cho BloodGlucoseRecord (I97678)
  • Đổi tên MenstruationRecord -> MenstruationFlowRecord. (I3b88e)

Sửa lỗi

  • Khắc phục hành vi ngoài mong muốn không lan truyền số liệu thống kê ở nền trước theo quy trình của ứng dụng khách. (Ifb44c)

Phiên bản 1.0.0-alpha04

Ngày 24 tháng 8 năm 2022 phát hành androidx.health.connect:connect-client:1.0.0-alpha04. Phiên bản 1.0.0-alpha04 bao gồm các thay đổi sau.

Di chuyển sang `androidx.health.connect

Kể từ phiên bản 1.0.0-alpha04, androidx.health:health-connect-client đã được chuyển sang androidx.health.connect:connect-client. Để xem các phiên bản Health Connect trước, vui lòng truy cập trang androidx.health.

Để di chuyển, thay vì nhập phần phụ thuộc từ androidx.health:health-connect-client:1.0.0-alpha03, bạn chỉ cần chuyển thành androidx.health.connect:connect-client:1.0.0-alpha04.

Tính năng mới

  • Cung cấp nhật ký gỡ lỗi (không bắt buộc) có sẵn cho lệnh gọi API (đường liên kết)

Các thay đổi về API

  • Đổi tên Metadata.clientId thành clientRecordId, Metadata.clientVersion thành clientRecordVersion. (đường liên kết)
  • Cải tiến để Metadata.uid thân thiện hơn với trình đọc và không còn giá trị rỗng. (đường liên kết)
  • Thêm pound vào đơn vị Khối lượng (đường liên kết)
  • Đổi tên DeletionChange.deleteUid thành uid (đường liên kết)
  • Đổi tên Permission thành HealthPermission. Điều này giúp tránh tình trạng không rõ ràng về các quyền của Khung Android. (đường liên kết)

Sửa lỗi

  • Sửa lỗi hồi quy ở đơn vị calo không chính xác của Năng lượng (đường liên kết)
  • Sửa lỗi hồi quy ở quá trình tổng hợp cho một số loại bản ghi (đường liên kết)