本原创文章帖发布在华为开发者联盟社区，欢迎开发者前往访问评论交流，更多与该内容相关讨论，请点击原帖查看：

折叠屏相机适配指南：相机动态场景解决方案-华为开发者话题 | 华为开发者联盟

对于折叠屏应用开发而言，相机功能的无缝流转是保障用户体验的关键。本文将重点讲解折叠屏相机如何跟随设备形态完成场景适配，逐层剖析问题根源，并分享相机状态适配、平滑接续的落地实践指南。

本篇文章旨在帮助开发者高效解决相机适配过程中的常见问题，建议在应用适配时重点关注以下方面：

• 相机状态平滑流转及多形态适配： 针对折叠屏不同折叠状态下的摄像头调用与切换场景，确保应用在单折、双折、完全展开等物理姿态切换时，相机的显示与交互能够平滑过渡，妥善处理摄像头调用、画面连续性以及设备多形态变化带来的拍摄体验。

为便于快速定位和解决问题，本文提炼了折叠屏适相机配中最常见的场景问题，并提供了对应的解决方案：

相机动态场景问题与解决

场景一、折在折叠态、展开态切换时，相机预览出现直接卡死或无法加载画面

展开态自拍切换为折叠态自拍无法显现画面/折叠态自拍切换为展开态自拍时摄像头自动切换为展开态外拍且画面卡死

可能原因

• 设备由展开态变成折叠态，展开态选择并打开的相机设备在折叠后，变为了“不可用”状态 。

• 仅按“前置"或"后置”固定逻辑选择相机，未基于展开态、折叠态切换前后的设备物理形态重新获取并判断可用的相机列表 。

• 展开态、折叠态切换状态后，未重新建立和触发相机预览流 。

最小适配建议

• 监听折叠状态变化

通过注册 display.on('foldStatusChange') 监听设备开合状态，在折叠状态改变时及时响应。查看参考文档：@ohos.display ( 屏幕属性 )

• 动态重选相机设备

不要硬编码固定使用某一个相机 ID。应在折叠状态切换、窗口尺寸变化后，调用 createCameraInput() 重新判断当前形态下可用的相机设备。

建议优先排查的页面

• 相机主页面-拍照/拍摄预览

【查看参考文档】：

• 适配不同折叠状态的摄像头变更 (ArkTS)

场景二、预览画面压缩、拉伸

预览画面压缩、拉伸 预览画面的显示内容被压缩或拉伸。

可能原因

• 相机预览对象绑定XComponent组件时，未正确设置Surface区域宽高的值，导致宽高比与预览流旋转后的宽高比不一致。

最小适配建议

• 对齐画面比例：动态设置XComponent组件对应Surface区域的宽高比，确保重新计算并使其与预览流旋转后的宽高比保持一致。

建议优先排查的页面

• 相机主页面-拍摄预览区（XComponent绑定的相关UI页面）

【查看参考文档】:

• 设置多设备上相机预览画面比例

场景三、拍完照片显示角度异常

拍完照片显示角度异常:拍摄完成后，照片的实际内容与预期方向不符，可能发生90°、180°或270°的旋转，导致用户需要手动调整才能正常查看。

可能原因

• 拍照时旋转了设备形态或方向，且应用侧未获取当前物理方向并设置正确的拍照角度。

最小适配建议

• 动态设置拍照角度：在设备方向发生变化时监听传感器或窗口方向，并在触发拍照请求时，调用相关接口设置正确的拍照旋转角度。

建议优先排查的页面

• 相机主页面-拍照动作触发/出图结果处理页

【查看参考文档】:

• 适配相机旋转角度 (ArkTS ）

远程真机调测

开发者可以通过远程真机或真机，查看 Pura X 、Mate X 、Mate XT 等折叠屏设备上的实际显示效果。

远程真机调试：https://developer.huawei.com/consumer/cn/service/josp/agc/index.html#/redirectToService?menuId=92495191845 96051206&type=project

模拟器使用指引：文档中心

最小走查清单（建议必查）

1. 相机主页面-拍摄预览区：预览画面无卡顿，黑屏，画面正常显示无拉伸缩放等

2. 相机拍照结果：拍照动作触发/出图结果处理页角度正常

附：官方文档资源

• 多设备功能开发：文档中心

• 多设备开发最佳实践：HarmonyOS 多设备开发最佳实践-华为开发者联盟

• 多窗口适配：https://developer.huawei.com/consumer/c n/doc/best-practices/bpta-multi-device-window-mode

• 相机硬件差异：https://developer.huawei.com/consumer/cn/doc/best-practices/bpta-mult i-device-camera#section882216138497

希望本指南能助您高效完成折叠屏手机相机适配，欢迎分享交流您的适配实践、遇到的问题及解决思路，期待与您共同为用户带来更流畅、一致的使用体验！