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

Memory Advice API (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 này 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.

Thông tin ước tính mà API này cung cấp giúp xác định thời điểm ứng dụng cần điều chỉnh mức sử dụng bộ nhớ hoặc những điểm cần cải thiện trong các phiên bản ứng dụng trong tương lai. Bạn 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, âm thanh.

Tài nguyên bộ nhớ ước tính bao gồm bộ nhớ heap gốc do Malloc phân bổ và bộ nhớ đồ hoạ do API OpenGL ES và Vulkan Graphics API (API đồ hoạ Vulkan) phân bổ, nhờ đó, Memory Advice API (API Thông báo bộ nhớ) trở nên 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, Memory Advice API (API Thông báo bộ nhớ) xác định một tập hợp các trạng thái thông báo về bộ nhớ và truyền đến ứng dụng thông qua một nhóm hàm.

Bắt đầu Làm quen với trò chơi Unity

Phân phối

Memory Advice API (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:

Bản phát hành tệp nhị phân trong Thư viện Android Games Jetpack.
Bản phát hành tệp nhị phân trên Trang tải xuống AGDK.
Mã nguồn trên AOSP.

Đối với trò chơi, bạn phải sử dụng bản phát hành Memory Advice API (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 Memory Advice API (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 callback bằng Memory Advice API (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

Memory Advice API (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 này chỉ hỗ trợ các ứng dụng 64 bit.
API này chỉ hỗ trợ các thiết bị thực; không hỗ trợ trình mô phỏng.

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

Memory Advice API (API Thông báo bộ nhớ) đang ở giai đoạn thử nghiệm beta 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 phát hiện sự cố nào trong lúc sử dụng API này, hãy tạo một sự cố trong IssueTracker.