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

一、Bug核心現(xiàn)象與復(fù)現(xiàn)路徑（RK3588+Android 12）

該Bug在RK3588芯片驅(qū)動的Android 12設(shè)備上表現(xiàn)尤為明顯，核心特征是旋轉(zhuǎn)屏幕后Camera預(yù)覽圖像拉伸，復(fù)現(xiàn)概率接近100%，具體操作步驟如下：

1.首次操作：打開Camera2應(yīng)用→手動旋轉(zhuǎn)屏幕（任意角度，觸發(fā)設(shè)備重力感應(yīng)）→完全退出Camera應(yīng)用（確保進(jìn)程未后臺駐留）；

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

實際測試驗證：在同一RK3588+Android 12設(shè)備上，關(guān)閉系統(tǒng)“自動旋轉(zhuǎn)”功能后，重復(fù)上述操作，預(yù)覽拉伸現(xiàn)象完全消失——這表明Bug與RK3588平臺上Android 12系統(tǒng)傳遞的旋轉(zhuǎn)事件強(qiáng)相關(guān)，且該環(huán)境下重力感應(yīng)事件對Camera應(yīng)用的影響更顯著。

二、關(guān)鍵日志拆解：RK3588+Android 12下的預(yù)覽計算異常

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

異常點(diǎn)分析（基于RK3588+Android 12特性）：

RK3588平臺對屏幕旋轉(zhuǎn)的事件傳遞機(jī)制與其他芯片略有差異——Android 12系統(tǒng)下，該平臺會更頻繁地向應(yīng)用推送“旋轉(zhuǎn)狀態(tài)更新”，即使旋轉(zhuǎn)角度未實際變化（如重復(fù)旋轉(zhuǎn)至270°）。日志中雖顯示預(yù)覽區(qū)域?qū)捀弑龋?/span>1344:1008=4:3）與設(shè)定的previewAspectRatio一致，但因：

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

三、初步排查：旋轉(zhuǎn)事件處理的認(rèn)知與驗證（RK3588+Android 12）

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

1.測試操作：修改

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

2.測試結(jié)果：即使屏蔽旋轉(zhuǎn)信息接收，Camera應(yīng)用仍會響應(yīng)RK3588平臺的屏幕旋轉(zhuǎn)事件，預(yù)覽拉伸Bug依舊存在；

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

四、臨時解決方案：關(guān)閉自動旋轉(zhuǎn)，快速規(guī)避問題（RK3588+Android 12）

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

1.操作步驟：

打開Camera2應(yīng)用前，通過系統(tǒng)設(shè)置（或下拉通知欄快捷開關(guān)）關(guān)閉“自動旋轉(zhuǎn)”功能；

2.適配原理：

關(guān)閉自動旋轉(zhuǎn)后，Android 12系統(tǒng)不再向Camera應(yīng)用傳遞RK3588平臺的旋轉(zhuǎn)事件，CaptureLayoutHelper.java中的預(yù)覽計算參數(shù)（rotation、窗口寬高）保持穩(wěn)定，避免因參數(shù)頻繁變化導(dǎo)致的適配錯誤；

3.實際效果：

在RK3588+Android 12設(shè)備上，重復(fù)原復(fù)現(xiàn)步驟，預(yù)覽畫面始終保持4:3比例，無任何拉伸現(xiàn)象。

五、后續(xù)優(yōu)化方向：聚焦布局計算與旋轉(zhuǎn)事件同步（RK3588+Android 12）

臨時方案可解決當(dāng)前痛點(diǎn)，但長期需結(jié)合RK3588平臺特性與Android 12系統(tǒng)機(jī)制，從代碼層面修復(fù)根本問題，核心優(yōu)化方向有兩個：

1.修復(fù)CaptureLayoutHelper.java的預(yù)覽區(qū)域計算邏輯（適配RK3588+Android 12）

針對RK3588平臺的旋轉(zhuǎn)事件傳遞特性，在getPositionConfiguration方法中強(qiáng)化參數(shù)聯(lián)動：

?當(dāng)RK3588平臺傳遞旋轉(zhuǎn)角度變化時，強(qiáng)制同步更新mDisplayOrientation（預(yù)覽方向），避免兩者數(shù)值不一致；

?適配Android 12的窗口管理機(jī)制，增加“RK3588橫屏/豎屏切換時的寬高適配”邏輯，確保預(yù)覽區(qū)域?qū)捀弑扰cpreviewAspectRatio嚴(yán)格匹配，不受平臺旋轉(zhuǎn)事件延遲影響。

2.優(yōu)化OrientationManagerImpl.java的旋轉(zhuǎn)事件過濾（適配RK3588+Android 12）

RK3588+Android 12下系統(tǒng)會推送大量“重復(fù)旋轉(zhuǎn)事件”（如同一角度多次推送），需增加過濾邏輯：

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

?檢測到系統(tǒng)自動旋轉(zhuǎn)關(guān)閉時，主動屏蔽RK3588平臺的所有旋轉(zhuǎn)事件，防止參數(shù)混亂。

總結(jié)

本次在RK3588芯片+ Android 12系統(tǒng)上發(fā)現(xiàn)的Camera預(yù)覽拉伸Bug，本質(zhì)是“平臺旋轉(zhuǎn)事件傳遞”與“預(yù)覽布局計算”的聯(lián)動異常——RK3588的高頻旋轉(zhuǎn)事件結(jié)合Android 12的渲染機(jī)制，導(dǎo)致關(guān)鍵參數(shù)（rotation、mDisplayOrientation）不同步，最終引發(fā)預(yù)覽拉伸。當(dāng)前關(guān)閉系統(tǒng)自動旋轉(zhuǎn)可快速規(guī)避問題，后續(xù)需結(jié)合該平臺與系統(tǒng)特性，優(yōu)化布局計算邏輯與旋轉(zhuǎn)事件過濾，從根本上保障用戶旋轉(zhuǎn)屏幕時的預(yù)覽穩(wěn)定性。

若你在RK3588+Android 12或其他平臺調(diào)試Camera應(yīng)用時遇到類似問題，歡迎分享場景細(xì)節(jié)！