经常有做车载应用开发和系统集成的同行来问我同一个问题Android 15里摄像头朝向到底在哪里定义为什么手机那套Camera API到车机框架里就不好使了这个问题确实容易踩坑因为Android 15系统里同时存在着两套摄像头体系一套是普通的娱乐框架也就是我们熟悉的Android Camera Stack另一套是车机框架AAOS里的Car Camera和EVS两套框架对朝向的语义完全不一样。这篇文章就把这两套体系一次说清楚包括LENS_FACING和SENSOR_ORIENTATION的作用、车机框架里摄像头的物理安装位置如何被描述和上报、以及你在实际调试中怎么判断一颗摄像头到底是朝车头还是车尾、图像要不要旋转。适合正在做Android 15车机系统定制、车载应用开发、外接UVC摄像头适配的工程师参考。1. 先分清两个Android娱乐框架和车机框架不是一套Camera栈Android 15在手机上的Camera架构和在车机里的Camera架构虽然底层都用了Camera HAL、CameraProvider这些基础组件但从定义到使用路径完全是两条线。如果你用手机开发的经验去车机上直接找CameraCharacteristics和CameraManager能拿到一些数据但往往不是车机真正在用的那套东西。1.1 娱乐框架指的是哪一段代码所谓娱乐框架其实就是Android标准框架里所有和多媒体、Camera相关的部分。它从应用层的android.hardware.camera2包开始到CameraService、CameraProvider HAL再到底层的Camera HAL走的是一条非常成熟的链路。在这条链路上摄像头朝向由CameraCharacteristics.LENS_FACING和CameraCharacteristics.SENSOR_ORIENTATION两个关键元数据决定。Android 15对这套框架没有做颠覆性改动而是延续了之前多个版本的架构。你要在娱乐框架里知道一个摄像头朝哪最基本的方法就是调用CameraCharacteristics.get(LENS_FACING)拿到FRONT、BACK或EXTERNAL这是逻辑语义上的朝向再调用SENSOR_ORIENTATION拿到传感器芯片相对设备屏幕的自然方向的旋转角度。很多做App的开发者只关心LENS_FACING其实这是一个常见的误区。LENS_FACING只告诉你这颗摄像头是在设备正面还是背面或者是不是外部接入的但它不告诉你图像是否需要旋转。真正决定预览画面要不要转90度、180度的是SENSOR_ORIENTATION。1.2 车机框架为什么不能用同一套逻辑车机框架就不一样了。Android Automotive OSAAOS在Android 10之后逐步发展出了自己的一套摄像头访问机制。车机上的摄像头通常不是手机那种前置后置的镜头而是倒车镜头、全景环视镜头、DMS驾驶员监控镜头、行车记录仪镜头它们的朝向本质上是安装在车辆的哪个物理位置、镜头光轴指向什么方向。这里有一个很关键的差异手机上的摄像头是固定在设备里的摄像头和屏幕的相对位置基本不变所以可以用LENS_FACING和SENSOR_ORIENTATION组合描述车机上的摄像头分布在车身四周屏幕中控屏和摄像头之间的位置关系是动态的、物理上分离的所以用前置或后置这种概念根本描述不了这是一颗朝左后方的环视镜头。因此车机框架引入了EVSExterior View System外部视野系统和CarCamera相关服务。EVS里的一个摄像头不是用朝向来分类的而是通过它在车身拓扑中的位置、用途如REAR_VIEW、SURROUND_VIEW来定义。这个定义不是放在CameraCharacteristics里而是放在HAL配置、车辆配置和VHAL属性里。1.3 Android 15在这两块里分别有什么新变化Android 15在娱乐框架侧的改动主要是低光拍照、前置镜头弱光支持、以及对外部显示设备的摄像头支持优化等朝向定义本身没有变化。在车机框架侧Android 15继续强化了EVS 2.0、摄像头使用策略等方向尤其是多个摄像头同时访问时的资源仲裁。现在很多车机主板会同时接入好几个摄像头比如一个内置DMS镜头、一个外接倒车镜头、两个外接环视镜头它们在系统里会以不同的ID存在有的挂在Android Camera HAL下有的挂在EVS HAL下。理解这套结构是搞清楚朝向是怎么定义的前提因为这两类摄像头你去查它们朝向的方法是完全不同的。2. 娱乐框架里的朝向LENS_FACING只是正反语义SENSOR_ORIENTATION才是旋转真相既然标题问的是Android 15里的定义那我们先从娱乐框架讲透。这部分很多资料都讲过但常有人把两个元数据混为一谈或者只取一个就以为拿到了全部朝向信息。2.1 LENS_FACING的前置、后置、外接语义与镜像行为CameraCharacteristics.LENS_FACING是枚举值标准定义有三个LENS_FACING_FRONT前置、LENS_FACING_BACK后置、LENS_FACING_EXTERNAL外接。在Android 15上外接摄像头通常指的是通过USB接入的UVC摄像头比如行车记录仪、外置会议摄像头之类。这三个值的定义逻辑其实很直观LENS_FACING_FRONT镜头朝向与屏幕显示方向相同的摄像头也就是自拍那个方向。按AOSP的默认行为前置摄像头预览默认会做水平镜像这样屏幕里的自己看起来和照镜子一致。LENS_FACING_BACK镜头朝向屏幕反方向拍的是用户面前的世界。默认不镜像。LENS_FACING_EXTERNAL无法确定摄像头是在设备正面还是背面通常是USB外接或无线摄像头。AOSP对它的处理逻辑和后置类似不镜像。这里有个值得注意的坑很多车机系统里的内置摄像头比如DMS摄像头物理上它是装在驾驶员前方中控台上的、镜头对着驾驶员按道理它应该算LENS_FACING_FRONT但不少厂商在HAL层直接把它上报成了EXTERNAL导致应用层拿不到任何是否前置的信息只能当作外接镜头处理。所以当你用dumpsys media.camera看到一颗摄像头是EXTERNAL时不要急着判断它装在哪这个值只能说明供应商没有按前置/后置去标定它。2.2 SENSOR_ORIENTATION传感器的物理摆放角度决定你的预览要不要转图SENSOR_ORIENTATION表示摄像头传感器在设备自然方向下图像需要顺时针旋转多少度才能被正确显示。常见值有0、90、180、270。它的计算逻辑是这样的传感器芯片本身有一个物理的扫描方向和安装方向它输出的原始图像坐标系和设备的自然显示坐标系之间存在一个夹角。比如手机上常见的后置摄像头SENSOR_ORIENTATION通常是90因为传感器芯片默认长边是水平的而手机自然方向是竖屏必须旋转90度预览画面才是正的。放到车机场景里就有意思了。车机中控屏通常设计为横屏自然方向是横屏而接入的倒车摄像头、环视摄像头它们的传感器芯片安装角度各异有的可能是倒装有的可能是侧装。比如一个车机外接倒车摄像头芯片方向正好和屏幕长边一致那SENSOR_ORIENTATION可能就是0不需要旋转如果摄像头模块是竖着安装在车尾的那就可能需要90或270。我在Android 15上实测过一些车规级USB摄像头它们的SENSOR_ORIENTATION经常是错的原因在于HAL层没有针对每个设备做标定。供应商给UVC摄像头驱动的时候直接套用了默认值最后图像在预缆里就是歪的。这种情况你改应用代码没有用除非在HAL层或应用层做矩阵归一化补偿。2.3 多摄和逻辑摄像头PhysicalCamera的朝向怎么继承Android 15的设备上一个CameraDevice可能是一个逻辑摄像头它的背后由多个物理摄像头组成。逻辑摄像头也有自己的LENS_FACING和SENSOR_ORIENTATION但物理摄像头各自也有独立的朝向和旋转角度。在车机上做多摄合成环视效果时逻辑摄像头往往代表一组镜头比如前后左右四路环视被HAL抽象成一个逻辑摄像头它的SENSOR_ORIENTATION只能描述合成后画面的输出方向不能代表每一路物理镜头的实际朝向。如果你需要逐路判断朝哪边得通过CameraCharacteristics.getPhysicalCameraIds()拿到物理摄像头ID再逐个去查它们的LENS_FACING和SENSOR_ORIENTATION。这里也是很多车机适配团队容易翻车的地方他们在MediaCodec或CameraX里配置了逻辑摄像头然后去预览环视画面却发现图像方向和车身坐标系对不上。原因就是逻辑摄像头根本没有车身四个视角的信息它只是一路已经拼接好的图像流朝向定义已经失效了。真正要做车辆四周朝向逻辑的必须走下面讲的车机框架。2.4 代码实战读取一台Android 15设备的摄像头朝向信息在Android 15上读取这两项元数据很简单就是标准的camera2 API调用注意加权限和异常处理CameraManager manager (CameraManager) context.getSystemService(Context.CAMERA_SERVICE); for (String cameraId : manager.getCameraIdList()) { CameraCharacteristics characteristics manager.getCameraCharacteristics(cameraId); Integer lensFacing characteristics.get(CameraCharacteristics.LENS_FACING); Integer sensorOrientation characteristics.get(CameraCharacteristics.SENSOR_ORIENTATION); Log.d(CameraInfo, cameraId cameraId facing lensFacing orientation sensorOrientation); }输出示例cameraId0 facing1 orientation90 // 后置旋转90度 cameraId1 facing0 orientation270 // 前置旋转270度 cameraId2 facing2 orientation90 // 外接摄像头对于外接UVC摄像头LENS_FACING返回的通常就是EXTERNAL值2而SENSOR_ORIENTATION跟UVC设备上报的dwReserved1以及驱动配置有关。很多廉价摄像头模块根本不管这个值HAL层直接返回0最后显示就是歪的。我自己的习惯是在App层把这两个值打印出来和实际画面做一次对照把这个表格记录下来当作这台设备的摄像头标定表摄像头IDLENS_FACINGSENSOR_ORIENTATION预期预览方向实际画面方向0BACK90竖屏正向正向1FRONT270竖屏正向镜像正向镜像2EXTERNAL0横屏正向横屏正向3. 车机框架里的朝向从前后置变成装在车的哪个位置到了车机框架事情就完全不一样了。Android 15的AAOS体系里摄像头朝向不再是一个简单的枚举值而是一个结合车辆拓扑、HAL配置和应用场景的复合概念。3.1 车载摄像头拓扑是怎么进EVS的EVS是Android Automotive里专门负责车辆外部视野的子系统它的HAL接口定义了一个IEvsCamera每个EVS摄像头都有自己的ID、采集能力和基本的图像描述。EVS里没有LENS_FACING这个概念它的摄像头是通过配置表被系统认识的。通常在车机的BoardConfig或vendor的EVS HAL实现中会有一份摄像头列表描述每颗摄像头在车身的位置。比如front前视摄像头光轴指向车头前方rear后视摄像头光轴指向车尾后方left左视摄像头光轴指向车身左侧right右视摄像头光轴指向车身右侧cabin舱内摄像头光轴指向驾驶员或乘客区域这份列表不是Android公共框架里现成的而是由供应商在自己的EVS HAL service config里配置的。上层应用通过EVS Manager打开某个摄像头之前通常要知道自己想要的cameraId而这个ID就隐含了朝向语义。比如你要做倒车影像就要打开ID为rear的那颗摄像头。所以你可以简单理解娱乐框架用朝前朝后表达摄像头朝向车机框架用它装在车的哪个位置、镜头看哪个方向来表达朝向后者更接近物理拓扑。3.2 EVS的CameraDesc对朝向的可描述范围与局限EVS HAL里的EvsCameraDesc主要包含摄像头ID、反向引用等和图像格式相关的信息并不会直接给你一个角度偏移量值。这是EVS框架的一个特点它假设摄像头安装好之后朝向已经由器件厂商通过机械方式固定好了软件层面不需要再对朝向做动态定义。但是机械朝向固定不代表图像不需要旋转变换。倒车摄像头装好后它输出的图像可能是左右镜像的、可能是上下颠倒的这些旋转和镜像参数存储在哪儿有的厂商放在EVS应用层做有的放在系统属性里有的则直接通过VHALVehicle HAL的某个车辆属性来暴露完全取决于你自己系统怎么设计。AOSP的EVS应用packages/services/Car/evs里有一个View的概念用来把原始图像适配到屏幕方向。它也是通过读取摄像头描述里的一些基础字段再做变换的但并没有一个CameraCharaceristics.SENSOR_ORIENTATION这样的标准属性给你直接用。这就导致在车机框架里摄像头朝向必须在系统定制阶段自己去定义是一个vendor扩展属性。3.3 CarCameraManager上层怎么理解拍的是车头还是车尾除EVS之外Android Automotive还有一个CarCameraManager主要面向高权限的系统级应用比如倒车影像、行车记录和360环视合成应用。它提供了一系列摄像头使用场景相关的API比如申请打开某一颗车规级摄像头、释放、做流生命周期管理。这些API里的朝向信息同样不是LENS_FACING而是通过权限和摄像头ID来区分的。举个例子假设你的车机有倒车摄像头系统里会配置一个类似android.car.CAR_CAMERA_REAR的权限字符串应用持有这个权限才能打开倒车影像对应的摄像头。这个权限的命名本身就隐含了这颗摄像头是拍车辆后方的这一朝向语义。你在Android 15车机框架里做摄像头适配时第一件事不是去找CameraCharacteristics而是去看你申请的权限描述的是哪一个车辆位置。3.4 为什么车机倒车影像不能直接用手机那套Camera API经常有人问我直接调用camera2的openCamera(rear)不就行了吗那得看车机上这颗摄像头是挂在哪个框架下的。如果它被供应商接进了EVS HAL那它根本没有暴露给CameraService普通App你用CameraManager的getCameraIdList()根本看不到它。反过来如果一颗车规级摄像头被接进了标准Camera HAL那它会在娱乐框架里出现但它的LENS_FACING大概率是EXTERNAL因为标准框架根本没有车尾镜头这个语义。这时候你就得借助SENSOR_ORIENTATION和供应商文档来人工判断它拍的是哪个方向。所以在Android 15车载系统上做摄像头相关功能首先要确定目标摄像头挂在哪套框架上然后选择对应的朝向定义方式。挂娱乐框架的按camera2元数据处理挂EVS或CarCameraService的按物理位置和权限语义处理。两个混着用大概率会在预览方向、镜像关系、权限申请上出问题。4. 实操用dumpsys和HAL配置识别一颗摄像头到底朝哪边说了这么多原理下面进入实用环节。我在Android 15模拟器和真实车机开发板上总结了一套识别摄像头朝向的排查链路分享给你参考。4.1 dumpsys media.camera先看有哪些Camera可见第一步先确定你关心的摄像头在娱乐框架里是否可见。通过ADB执行adb shell dumpsys media.camera输出里会列出所有CameraService可见的摄像头ID以及每个摄像头的Facing和Orientation字段。这里你会看到类似这样的内容Camera ID: 0 Facing: BACK Orientation: 90 Camera ID: 1 Facing: FRONT Orientation: 270 Camera ID: 2 Facing: EXTERNAL Orientation: 0如果车的倒车摄像头挂在了标准Camera HAL下那么它的ID就会出现在这里Facing通常是EXTERNAL。但是这张表只能告诉你它在屏幕坐标系里如何旋转不能告诉你它拍的是车前方还是后方。4.2 从VHAL属性看current camera use case如果这颗摄像头同时也在车机框架里被使用那么它的朝向还会表现在VHAL的摄像头相关属性上。Android 15的Vehicle HAL里有一类属性专门描述当前摄像头使用场景比如VEHICLE_CAMERA_USE_CASE、VEHICLE_CAMERA_SERVICE_RUNNING_STATUS等。你可以通过调试工具查看当前的摄像头使用场景值或者直接在代码里监听VehiclePropertyIds相关的回调。当倒车档挂上时VHAL里current camera use case会变成REAR_VIEW之类枚举此时你打开的倒车影像摄像头它的朝向语义就直接和REAR_VIEW绑定。这里的朝向指的不是旋转角度而是它正在服务哪一个车辆场景。用这种方式来判断比你单纯去查SENSOR_ORIENTATION可靠得多因为REAR_VIEW是车辆控制器上报的不会因为你把屏横过来转过去就改变。4.3 一个外接UVC摄像头在两种框架里的真实数据再说一个我在Android 15车机上遇到的实际case。一台开发板上插了一颗UVC接口的倒车摄像头供应商把它同时暴露给了标准Camera HAL和EVS HAL两边都能打开。在娱乐框架里dumpsys media.camera看到的元数据Camera ID: 6 Facing: EXTERNAL Orientation: 180 ...这意味着如果你直接用Camera2 API拉流画面需要旋转180度才是正的。但注意这颗摄像头真实安装位置是在车后牌照架附近镜头朝后。它的FacingEXTERNAL并不能体现这一物理位置信息需要人工在应用层维护一个映射表cameraId 6 对应 rear位置。在EVS框架里它的描述文件配置为evsCamera idrear /上层倒车影像应用直接通过EVS Manager打开rear这个ID框架就自动知道它是安装在车辆尾部、镜头朝后方的摄像头。但这个ID并不提供旋转信息如果你发现EVS拉出来的画面旋转了90度你得在EVS应用层做相应的坐标变换。所以我强烈建议在系统集成阶段就把两套框架的映射关系做成一张配置表比如物理位置EVS cameraId标准CameraIdSENSOR_ORIENTATION是否需要镜像车头front390否车尾rear6180是车左left未挂载--车右right未挂载--这样在应用层做适配时就可以根据当前功能场景倒车、环视、行车记录直接找到摄像头ID并拿到对应的旋转参数不用每次都在代码里猜。4.4 几个实际排查经验排查摄像头朝向时我常用的一套组合拳是先dumpsys media.camera确认娱乐框架下的ID和方向再查EVS配置确认物理安装位置最后用一个标准测试画面比如在镜头前放一块有方向箭头的纸板验证实际输出和预期是否一致然后把结果写进配置表。这里有一个常被忽略的问题UVC摄像头设备名会变化。我在Android 15上遇到过USB摄像头在每次插拔后/dev/video*节点变化的情况如果系统里靠节点顺序来绑定朝向就很容易出现这次开机rear镜头变成了left的现象。稳妥的做法是通过USB VID/PID和物理端口绑定或者使用cameraId的固定别名配置不要依赖枚举顺序。5. 几种容易搞混的朝向场景和我的处理方式最后聊几个我在实际项目中经常看到的问题给做Android 15车机开发的朋友一些参考。第一个是逻辑摄像头和物理摄像头的朝向混用。有些车机方案商把环视摄像头合成后暴露成一个巨大的逻辑摄像头IDAndroid应用层直接拿这个ID去预览然后把四个物理镜头的朝向都抛到脑后。这样做出来的环视画面除非供应商已经帮你把图像拼接好了否则一旦需要叠加车身动态标定线方向就对不上。我的建议是只要涉及车辆四周相对位置就要回到EVS或物理摄像头粒度去处理不要用逻辑摄像头的朝向。第二个是镜像问题。手机后置摄像头默认不镜像前置默认镜像这是Android框架的标准行为。但车机上的倒车摄像头、DMS摄像头镜像规则完全取决于物理安装方式。比如有的车型倒车画面需要左右镜像有的车型不需要你要在应用层自己处理不能默认和手机一样。Android 15的Camera特性里没有对倒车画面是否镜像的标准定义这必须通过你的朝向配置表去管理。第三个是高通、瑞芯微、NXP这些平台在EVS实现上的差异。每个平台的EVS HAL对摄像头ID的命名方式不同有的叫front_0有的叫cam_0001还有的会把REAR_VIEW直接写死在配置里。做系统集成的厂商最好在vendor层统一转换一层接口对外提供标准语义的cameraId这样应用层就不用在各个平台之间来回适配了。第四个是动态切换问题。车机上的摄像头并不总是一路固定占用比如倒车摄像头在倒车时被EVS服务打开倒车结束就释放这时候如果你同时想用娱乐框架去读同一颗摄像头可能因为通道冲突拿不到流。Android 15在摄像头资源管理上比早期版本好一些但车机框架和娱乐框架之间的仲裁仍然需要自己做。我的经验是把摄像头使用场景按车辆状态排优先级在VHAL状态变化时统一调度摄像头服务比如倒车时优先确保REAR_VIEW通道其他应用再走标准Camera API。写到这里希望对正在搞Android 15车机摄像头适配的朋友有帮助。摄像头朝向这个问题表面看是一个API取值的事实际上牵扯到两套框架的语义、车辆物理安装方式、供应商HAL实现和应用层适配。你先搞清楚这颗摄像头挂在哪条链路上再去查对应框架里的朝向信息基本就不会走弯路。
