Kể từ Android 13, HAL của Hardware Composer (HWC) được xác định trong AIDL và các phiên bản HIDL từ android.hardware.graphics.composer@2.1 đến android.hardware.graphics.composer@2.4 đã ngừng hoạt động.
Trang này mô tả sự khác biệt giữa AIDL và HIDL HAL cho HWC, cũng như việc triển khai và kiểm thử AIDL HAL.
Do những lợi ích mà AIDL mang lại, các nhà cung cấp nên triển khai HAL trình kết hợp AIDL bắt đầu từ Android 13 thay vì phiên bản HIDL. Hãy xem phần Triển khai để biết thêm thông tin.
Sự khác biệt giữa AIDL và HIDL HAL
HAL trình kết hợp AIDL mới có tên là android.hardware.graphics.composer3, được xác định trong IComposer.aidl.
API này cho thấy một API tương tự như HIDL HAL android.hardware.graphics.composer@2.4 với những thay đổi sau:
Xoá Hàng đợi tin nhắn nhanh (FMQ) để chuyển sang các lệnh có thể phân chia.
HAL AIDL xác định giao diện lệnh dựa trên các loại có thể phân chia được nhập mạnh thay vì các lệnh được chuyển đổi tuần tự qua FMQ trong HIDL. Điều này cung cấp một giao diện ổn định cho các lệnh và định nghĩa dễ đọc hơn về cách diễn giải tải trọng lệnh.
Phương thức
executeCommandsđược xác định trongIComposerClient.aidllàCommandResultPayload[] executeCommands(in DisplayCommand[] commands);trong đó mỗi lệnh là một loại có thể phân chia được gõ mạnh được xác định trong
DisplayCommand.aidl. Các phản hồi lệnh là các đối tượng có thể phân chia được nhập mạnh mẽ được xác định trongCommandResultPayload.aidl.Xoá
IComposerClient.getClientTargetSupportvì không có ứng dụng nào đang hoạt động cho phương thức này.Biểu thị màu sắc dưới dạng số thực thay vì byte để điều chỉnh tốt hơn với ngăn xếp đồ hoạ trên trong Android như được xác định trong
ASurfaceTransaction_setColor.Thêm các trường mới để kiểm soát nội dung HDR.
Trong AIDL HAL, các ngăn xếp lớp SDR/HDR hỗn hợp hỗ trợ làm mờ liền mạch các lớp SDR khi một lớp HDR đồng thời xuất hiện trên màn hình.
Trường
brightnesstrongLayerCommandcho phép SurfaceFlinger chỉ định độ sáng cho mỗi lớp, để HWC làm mờ nội dung của lớp trong không gian ánh sáng tuyến tính, thay vì không gian gamma.Trường
brightnesstrongClientTargetPropertyWithBrightnesscho phép HWC chỉ định không gian độ sáng cho thành phần ứng dụng và hướng dẫnRenderEnginecó làm mờ các lớp SDR trong thành phần ứng dụng hay không.Trường
dimmingStagecho phép HWC định cấu hình thời điểmRenderEnginelàm mờ nội dung. Điều này phù hợp vớiColorModesdo nhà cung cấp xác định, có thể muốn làm mờ trong không gian gamma, để cho phép các chế độ tăng cường độ tương phản do nhà cung cấp xác định trong quy trình xử lý màu của họ.Thêm một loại thành phần mới
DISPLAY_DECORATIONtrongComposition.aidlđể trang trí màn hình.Một số thiết bị có phần cứng chuyên dụng để tối ưu hoá việc vẽ mặt nạ alpha giúp làm mịn các góc bo tròn và vết cắt trên màn hình. Các thiết bị có phần cứng như vậy phải triển khai
IComposerClient.getDisplayDecorationSupportđể trả về cấu trúcDisplayDecorationSupportnhư được xác định trongDisplayDecorationSupport.aidlmới. Cấu trúc này mô tả các enumPixelFormatvàAlphaInterpretationmà thiết bị yêu cầu. Khi triển khai, Giao diện người dùng hệ thống sẽ đánh dấu lớp mặt nạ alpha làDISPLAY_DECORATION, một loại thành phần mới tận dụng phần cứng chuyên dụng.Thêm trường
expectedPresentTimemới vàoDisplayCommand.aidl.Trường
expectedPresentTimecho phép SurfaceFlinger đặt thời gian hiển thị dự kiến thành thời điểm nội dung hiện tại phải xuất hiện trên màn hình. Với tính năng này, SurfaceFlinger sẽ gửi lệnh trình bày đến quá trình triển khai trước thời hạn, cho phép quá trình này xử lý theo quy trình nhiều công việc kết hợp hơn.Thêm các API mới để kiểm soát cấu hình màn hình khởi động.
Bằng cách sử dụng
BOOT_DISPLAY_CONFIG, các nhà cung cấp có thể chỉ định rằng cấu hình màn hình khởi động được hỗ trợ. Các phương thứcsetBootDisplayConfig,clearBootDisplayConfigvàgetPreferredBootDisplayConfigsử dụngBOOT_DISPLAY_CONFIGnhư sau:Bằng cách sử dụng
setBootDisplayConfig, khung này sẽ thông báo cho nhà cung cấp về cấu hình hiển thị thời gian khởi động. Nhà cung cấp phải lưu vào bộ nhớ đệm trong cấu hình màn hình khởi động và khởi động trong cấu hình này khi khởi động lại lần tiếp theo. Nếu thiết bị không thể khởi động ở cấu hình này, nhà cung cấp phải tìm một cấu hình phù hợp với độ phân giải và tốc độ làm mới của cấu hình này. Nếu không có cấu hình nào như vậy, nhà cung cấp nên sử dụng cấu hình hiển thị mà họ ưu tiên.Khi sử dụng
clearBootDisplayConfig, khung này sẽ thông báo cho các nhà cung cấp để xoá cấu hình màn hình khởi động và khởi động ở cấu hình màn hình mà họ muốn trong lần khởi động lại tiếp theo.Khi dùng
getPreferredBootDisplayConfig, khung sẽ truy vấn chế độ khởi động ưu tiên của nhà cung cấp.
Khi không hỗ trợ cấu hình màn hình khởi động, các phương thức này sẽ trả về giá trị
UNSUPPORTED.Thêm các API mới để kiểm soát bộ hẹn giờ ở trạng thái chờ của màn hình.
Bằng cách sử dụng
DISPLAY_IDLE_TIMER, nhà cung cấp có thể chỉ định rằng nhà cung cấp sẽ triển khai bộ hẹn giờ không hoạt động cho màn hình này. Khi ở trạng thái rảnh, tính năng này sẽ thay đổi tốc độ làm mới thành một chế độ cài đặt thấp hơn để tiết kiệm pin. Nền tảng này sử dụngsetIdleTimerEnabledđể kiểm soát thời gian chờ của bộ hẹn giờ và trong một số trường hợp, để tắt bộ hẹn giờ nhằm ngăn các hoạt động chuyển đổi tốc độ làm mới không mong muốn khi thiết bị ở trạng thái rảnh.Việc sử dụng lệnh gọi lại
IComposerCallback.onVsyncIdlecho biết với nền tảng rằng màn hình đang ở trạng thái rảnh và nhịp điệuvsyncđã thay đổi. Nền tảng này sẽ phản hồi lệnh gọi lại này bằng cách đặt lại mô hìnhvsync. Thao tác này buộcvsyncđồng bộ hoá lại trên khung hình tiếp theo và tìm hiểu nhịpvsyncmới.
Triển khai
Nhà cung cấp không bắt buộc phải triển khai AIDL HAL cho Android 13. Tuy nhiên, các nhà phát triển nên triển khai HAL trình kết hợp AIDL thay vì phiên bản HIDL để sử dụng các chức năng và API mới.
Một triển khai tham chiếu cho AIDL HWC HAL được triển khai trong trình mô phỏng Android.
Thử nghiệm
Để kiểm tra việc triển khai, hãy chạy VtsHalGraphicsComposer3_TargetTest.