在移動設備Camera應用開發中，預覽畫面穩定性直接影響用戶拍攝體驗。近期我們在RK3588芯片平臺+ Android 12系統環境下調試時，發現Camera2應用存在高概率預覽拉伸Bug——當用戶多次旋轉屏幕后，預覽圖像會出現明顯變形，而關閉系統自動旋轉功能后，該問題可有效規避。今天我們就結合該硬件與系統環境，詳細拆解Bug的現象、根源及臨時解決方案，為同平臺開發者提供參考。

一、Bug核心現象與復現路徑（RK3588+Android 12）

該Bug在RK3588芯片驅動的Android 12設備上表現尤為明顯，核心特征是旋轉屏幕后Camera預覽圖像拉伸，復現概率接近100%，具體操作步驟如下：

1.首次操作：打開Camera2應用→手動旋轉屏幕（任意角度，觸發設備重力感應）→完全退出Camera應用（確保進程未后臺駐留）；

2.二次操作：再次啟動Camera2應用→再次旋轉屏幕（與首次旋轉角度可相同，如均為270°）→高概率觸發預覽圖像拉伸（對比正常場景，預覽區域尺寸與比例異常）。

實際測試驗證：在同一RK3588+Android 12設備上，關閉系統“自動旋轉”功能后，重復上述操作，預覽拉伸現象完全消失——這表明Bug與RK3588平臺上Android 12系統傳遞的旋轉事件強相關，且該環境下重力感應事件對Camera應用的影響更顯著。

二、關鍵日志拆解：RK3588+Android 12下的預覽計算異常

為定位根源，我們提取了RK3588+Android 12環境下Bug觸發時的關鍵日志（旋轉角度270°，預覽拉伸場景），通過日志可清晰看到預覽區域（previewRect）計算存在明顯偏差，且與平臺系統的參數傳遞邏輯直接相關：

異常點分析（基于RK3588+Android 12特性）：

RK3588平臺對屏幕旋轉的事件傳遞機制與其他芯片略有差異——Android 12系統下，該平臺會更頻繁地向應用推送“旋轉狀態更新”，即使旋轉角度未實際變化（如重復旋轉至270°）。日志中雖顯示預覽區域寬高比（1344:1008=4:3）與設定的previewAspectRatio一致，但因：

旋轉角度（rotation=270°）與RK3588平臺的預覽方向（mDisplayOrientation=0°）未同步，導致CaptureLayoutHelper.java中getPositionConfiguration方法計算的“預覽渲染區域”與“實際屏幕顯示區域”錯位，最終在Android 12的UI渲染機制下呈現拉伸效果。

三、初步排查：旋轉事件處理的認知與驗證（RK3588+Android 12）

針對該Bug，我們最初假設：Camera應用無需接收RK3588傳感器傳遞的旋轉信息——因部分手機Camera應用旋轉時預覽正常，且旋轉不影響拍攝邏輯。為驗證該假設，我們在RK3588+Android 12環境下進行了測試：

1.測試操作：修改

Camera2srccomandroidcameraappOrientationManagerImpl.java，屏蔽“接收傳感器旋轉信息”的邏輯；

2.測試結果：即使屏蔽旋轉信息接收，Camera應用仍會響應RK3588平臺的屏幕旋轉事件，預覽拉伸Bug依舊存在；

3.關鍵發現：在同一設備上關閉系統“自動旋轉”功能后，Android 12系統不再向Camera應用推送旋轉事件，Bug復現率從100%降至0——這說明：Bug誘因并非“Camera主動接收傳感器信息”，而是“RK3588+Android 12下，系統自動旋轉開啟時多次傳遞旋轉事件，導致預覽布局計算參數混亂”。

四、臨時解決方案：關閉自動旋轉，快速規避問題（RK3588+Android 12）

目前在RK3588芯片+ Android 12系統的設備上，已驗證有效的臨時規避方案如下，適用于用戶臨時使用及同平臺測試驗證：

1.操作步驟：

打開Camera2應用前，通過系統設置（或下拉通知欄快捷開關）關閉“自動旋轉”功能；

2.適配原理：

關閉自動旋轉后，Android 12系統不再向Camera應用傳遞RK3588平臺的旋轉事件，CaptureLayoutHelper.java中的預覽計算參數（rotation、窗口寬高）保持穩定，避免因參數頻繁變化導致的適配錯誤；

3.實際效果：

在RK3588+Android 12設備上，重復原復現步驟，預覽畫面始終保持4:3比例，無任何拉伸現象。

五、后續優化方向：聚焦布局計算與旋轉事件同步（RK3588+Android 12）

臨時方案可解決當前痛點，但長期需結合RK3588平臺特性與Android 12系統機制，從代碼層面修復根本問題，核心優化方向有兩個：

1.修復CaptureLayoutHelper.java的預覽區域計算邏輯（適配RK3588+Android 12）

針對RK3588平臺的旋轉事件傳遞特性，在getPositionConfiguration方法中強化參數聯動：

?當RK3588平臺傳遞旋轉角度變化時，強制同步更新mDisplayOrientation（預覽方向），避免兩者數值不一致；

?適配Android 12的窗口管理機制，增加“RK3588橫屏/豎屏切換時的寬高適配”邏輯，確保預覽區域寬高比與previewAspectRatio嚴格匹配，不受平臺旋轉事件延遲影響。

2.優化OrientationManagerImpl.java的旋轉事件過濾（適配RK3588+Android 12）

RK3588+Android 12下系統會推送大量“重復旋轉事件”（如同一角度多次推送），需增加過濾邏輯：

?僅接收“有效旋轉事件”（如旋轉角度變化≥90°），避免頻繁觸發updatePositionConfiguration（預覽布局重算）；

?檢測到系統自動旋轉關閉時，主動屏蔽RK3588平臺的所有旋轉事件，防止參數混亂。

總結

本次在RK3588芯片+ Android 12系統上發現的Camera預覽拉伸Bug，本質是“平臺旋轉事件傳遞”與“預覽布局計算”的聯動異常——RK3588的高頻旋轉事件結合Android 12的渲染機制，導致關鍵參數（rotation、mDisplayOrientation）不同步，最終引發預覽拉伸。當前關閉系統自動旋轉可快速規避問題，后續需結合該平臺與系統特性，優化布局計算邏輯與旋轉事件過濾，從根本上保障用戶旋轉屏幕時的預覽穩定性。

若你在RK3588+Android 12或其他平臺調試Camera應用時遇到類似問題，歡迎分享場景細節！