Khoá chế độ thức một phần là một cơ chế trong API PowerManager
cho phép các nhà phát triển tiếp tục chạy CPU sau khi màn hình của thiết bị tắt (cho dù do hệ thống hết thời gian chờ hay người dùng nhấn nút nguồn). Ứng dụng của bạn có được khoá chế độ thức một phần bằng cách gọi acquire()
bằng cờ PARTIAL_WAKE_LOCK
hoặc bằng cách sử dụng các API khác có được khoá chế độ thức.
Việc sử dụng quá nhiều khoá chế độ thức một phần sẽ làm tiêu hao pin của thiết bị vì tính năng này khiến thiết bị không thể chuyển sang trạng thái tiết kiệm pin. Bạn chỉ nên sử dụng khoá chế độ thức một phần khi cần thiết và mở khoá ngay khi không còn cần dùng nữa.
Nếu ứng dụng của bạn sử dụng quá nhiều lượt khoá chế độ thức một phần, bạn có thể tham khảo hướng dẫn trên trang này để chẩn đoán và khắc phục sự cố.
Ý kiến phản hồi của bạn có vai trò quan trọng trong việc cải thiện tài liệu của chúng tôi. Vui lòng gửi ý kiến phản hồi cho chúng tôi qua đường liên kết sau:
Phát hiện vấn đề
Android vitals có thể giúp bạn biết được thời điểm ứng dụng sử dụng khoá chế độ thức một phần quá nhiều.
Android vitals
Android vitals có thể giúp cải thiện hiệu suất của ứng dụng bằng cách cảnh báo cho bạn qua Play Console khi ứng dụng của bạn sử dụng khoá chế độ thức một phần quá nhiều.
Android vitals báo cáo việc sử dụng khoá chế độ thức một phần là quá mức khi tất cả các khoá chế độ thức một phần cộng lại chạy trong 2 giờ trở lên trong khoảng thời gian 24 giờ. Android vitals chỉ theo dõi thời lượng khoá đánh thức nếu khoá đánh thức được giữ khi ứng dụng ở chế độ nền hoặc đang chạy một dịch vụ trên nền trước. Hiện tại, Android vitals miễn trừ các khoá đánh thức do audio, location và JobScheduler API do người dùng khởi tạo tạo ra khỏi quy trình tính toán khoá đánh thức.
Trang tổng quan Android vitals về lỗi khoá chế độ thức một phần cung cấp thông tin chi tiết về tên khoá chế độ thức không được miễn trừ liên kết với ứng dụng của bạn, cho biết số phiên và thời lượng bị ảnh hưởng.
Nếu tình trạng khoá đánh thức một phần quá mức xảy ra trong hơn 5% số phiên của ứng dụng trên tất cả các thiết bị trong khoảng thời gian 28 ngày, thì điều này có thể ảnh hưởng đến khả năng hiển thị của ứng dụng trên Play sau khi chỉ số này không còn ở giai đoạn thử nghiệm.
Khi tính năng khoá chế độ thức một phần trên ứng dụng lỗi quá nhiều lần, việc tiếp theo bạn cần làm là nhanh chóng giải quyết vấn đề.
Khắc phục vấn đề
Vì khoá chế độ thức có thể làm hao pin thiết bị, nên bạn không nên sử dụng khoá chế độ thức nếu có giải pháp thay thế. Tài liệu Chọn API phù hợp để giữ cho thiết bị luôn hoạt động có thể giúp bạn tìm ra giải pháp tốt nhất cho ứng dụng của mình.
Nếu bạn cần sử dụng tính năng khoá đánh thức, hãy làm theo các phương pháp hay nhất về tính năng khoá đánh thức để đảm bảo tính năng khoá đánh thức không ảnh hưởng đến hiệu suất của thiết bị. Cụ thể, hãy đảm bảo mọi thiết bị bạn nhận được đều được giải phóng và giải phóng khoá nhanh nhất có thể.
Ứng dụng của bạn cũng có thể đang sử dụng khoá đánh thức ngay cả khi bạn không thu thập khoá đánh thức một cách rõ ràng. Nếu bạn thấy các khoá đánh thức được gán cho ứng dụng mà bạn không nhận ra, thì xác định các khoá đánh thức do các API khác tạo có thể giúp bạn xác định những API có thể đã tạo các khoá đó.
Sau khi khắc phục vấn đề về mã, bạn có thể xác minh các bản sửa lỗi bằng cách sử dụng công cụ gỡ lỗi khoá chế độ thức cục bộ.
Xem thêm
- Lỗi xảy ra với tính năng khoá chế độ thức một phần
- Chọn API phù hợp để giữ cho thiết bị ở trạng thái bật
- Tài liệu về khoá chế độ thức
Đề xuất cho bạn
- Lưu ý: văn bản có đường liên kết sẽ hiện khi JavaScript tắt
- Khung hình bị treo
- Chạy phép đo điểm chuẩn trong tính năng Tích hợp liên tục
- Tạo và đo lường Hồ sơ cơ sở mà không cần Macrobenchmark