API thông báo bộ nhớ đang ở giai đoạn thử nghiệm.

Tổng quan về API thông báo bộ nhớ

Stay organized with collections Save and categorize content based on your preferences.

API thông báo bộ nhớ là một API gốc thử nghiệm giúp các ứng dụng Android hoạt động trong giới hạn an toàn cho mức sử dụng bộ nhớ. Để làm được như vậy, API này ước tính lượng tài nguyên bộ nhớ đang sử dụng và thông báo cho ứng dụng khi vượt quá các ngưỡng nhất định. API cũng có thể thông báo mức sử dụng bộ nhớ ước tính theo tỷ lệ phần trăm trực tiếp cho ứng dụng.

Các ước tính của API giúp xác định khi nào ứng dụng cần điều chỉnh mức sử dụng bộ nhớ, hoặc đâu là những điểm cần cải thiện trong các phiên bản ứng dụng trong tương lai. Có thể điều chỉnh bất cứ yếu tố nào để thay đổi mức sử dụng bộ nhớ, chẳng hạn như giảm chi tiết và chất lượng của các thành phần hình ảnh và âm thanh.

Tài nguyên bộ nhớ được ước tính bao gồm bộ nhớ gốc do Malloc phân bổ và bộ nhớ đồ họa do API OpenGL ES và Vulkan Graphics phân bổ để làm cho API thông báo bộ nhớ phù hợp với trò chơi và các ứng dụng dùng nhiều đồ hoạ.

Các ước tính được đưa ra dựa trên những thông tin sau:

  • Các chỉ số về thiết bị được API thu thập
  • Dữ liệu máy học từ các thiết bị
  • Kiểm thử trên thiết bị

Ở cấp độ API, API thông báo bộ nhớ xác định một tập hợp các trạng thái tư vấn về bộ nhớ và thông báo cho ứng dụng bằng một bộ chức năng.

Bắt đầu

Phân phối

API thông báo bộ nhớ là một phần của Android Games Development Kit (AGDK) được phân phối thông qua các kênh sau:

Đối với Games (Trò chơi), bạn phải sử dụng bản phát hành API thông báo bộ nhớ theo đề xuất về môi trường tạo bản dựng của chúng. Đối với Android Studio, bạn nên sử dụng bản phát hành Jetpack. Đối với Android Game Development Extension (AGDE), bạn nên phát hành trên trang tải xuống AGDK.

Tính năng

Phần này mô tả về các tính năng của API thông báo bộ nhớ.

Trạng thái bộ nhớ

API báo cáo các trạng thái bộ nhớ sau đây cho ứng dụng:

  • MEMORYADVICE_STATE_OK
  • MEMORYADVICE_STATE_APPROACHING_LIMIT
  • MEMORYADVICE_STATE_CRITICAL

Để biết thêm chi tiết, vui lòng xem trang tham khảo memoryadvice_memorystate.

Báo cáo trạng thái bộ nhớ

API hỗ trợ báo cáo trạng thái bộ nhớ thông qua cơ chế thăm dò ý kiến hoặc cơ chế gọi lại:

  • Thăm dò ý kiến:
    Ứng dụng có thể gọi API bất cứ lúc nào để truy xuất trạng thái bộ nhớ.

  • Lệnh gọi lại:
    Ứng dụng có thể đăng ký một hàm gọi lại bằng API thông báo bộ nhớ. Ứng dụng sẽ chỉ định tần suất gọi cho cuộc gọi lại. API sử dụng tần suất để xác định thời điểm thực thi lệnh gọi lại khi điều kiện bộ nhớ ứng dụng sắp đạt đến giới hạn an toàn hoặc sắp hết. Lệnh gọi lại không được gọi nếu điều kiện của bộ nhớ là an toàn. Lệnh gọi lại được thực thi trong chuỗi của chính nó, không phải từ một chuỗi của ứng dụng.

Những điều cần cân nhắc về phí tổn và tần suất gọi

API thông báo bộ nhớ sử dụng thời gian tính toán để tạo trạng thái bộ nhớ. Chi phí sẽ khác nhau tùy theo thiết bị, nhưng thường trong khoảng từ 1 mili giây đến 3 mili giây cho mỗi cuộc gọi. Bạn nên xem xét chi phí này khi xác định tần suất thăm dò trạng thái bộ nhớ hoặc tần suất chỉ định cho lệnh gọi lại của trạng thái bộ nhớ.

Yêu cầu

Yêu cầu đối với thiết bị

  • Android 4.4 (API cấp 19) trở lên.

Yêu cầu đối với ứng dụng

  • API chỉ hỗ trợ các ứng dụng gốc (ứng dụng chủ yếu được viết bằng C/C++).

  • API chỉ hỗ trợ các ứng dụng 64 bit.

Yêu cầu đối với phiên bản NDK

Bản phát hành API thông báo bộ nhớ hỗ trợ hầu hết các phiên bản NDK, vui lòng tham khảo ghi chú phát hành để biết danh sách NDK được hỗ trợ.

Tài nguyên khác

Các sự cố và ý kiến phản hồi

API thông báo bộ nhớ đang ở giai đoạn thử nghiệm và chúng tôi hoan nghênh các ý kiến phản hồi. Nếu bạn có đề xuất hoặc tìm thấy vấn đề nào trong lúc sử dụng API, hãy tạo một vấn đề trong Công cụ theo dõi lỗi.