预览页黑了两天

需求写着"加个拍照上传",评估半天,实际干了四天。原因很简单:预览画面黑屏,怎么都不出图。后来看懂了相机框架的结构才明白,相机不是"调一个接口返回一张图",而是一条链路:物理设备、输入流、会话、预览输出、拍照输出,缺一环就是黑屏。这篇把最小可用链路和几个实际的门槛讲清楚。

▲ 示意图 · 相机拍照链路

会话是核心概念

相机的所有工作围绕会话(CaptureSession)展开:把输入(摄像头)和输出(预览、拍照)加进同一个会话,提交配置后开始跑。

import { camera } from '@kit.CameraKit';

const manager = camera.getCameraManager(context);
const devices = manager.getSupportedCameras();
const device = devices[0];

const input = manager.createCameraInput(device);
await input.open();

// 分辨率要从设备支持的 Profile 里选,不能硬配
const profiles = manager.getSupportedOutputCapability(device);
const previewProfile = profiles.previewProfiles[0];
const photoProfile = profiles.photoProfiles[0];

const session = camera.createCaptureSession(context);
await session.beginConfig();
await session.addInput(input);
await session.addOutput(manager.createPreviewOutput(previewProfile));
const photoOutput = manager.createPhotoOutput(photoProfile);
await session.addOutput(photoOutput);
await session.commitConfig();
await session.start();

黑屏的答案就在这段代码里。我第一版失败在两个地方:一是分辨率自己写死了 1920×1080,设备不支持,输出创建出来是死的,必须从 getSupportedOutputCapability 返回的 Profile 列表里选;二是 beginConfig 和 commitConfig 之间漏加了预览输出,会话里只有输入没有输出,画面自然什么都没有。

拍照与落盘

photoOutput.on('photoAvailable', (photo: camera.Photo) => {
  const buffer = photo.main.image; // 拿到原始图像数据
  // 用 image 组件打包成 jpeg 落盘
});

capture() 触发拍照,回调里拿到的是原始图像数据,要经过图像打包器转成 jpeg 再写文件。这里有个容易忽略的问题:图像方向。竖屏拍照时原始帧可能是横向的,落盘前要按设备方向处理旋转,否则用户相册里看到横躺的照片。

生命周期是资源大户

相机是整机竞争最激烈的资源之一。离开预览页时,session.stop()、input.close()、销毁各输出,一步不能省。应用切后台不释放,别的应用就打不开相机,用户会以为是对方应用坏了。我们把相机封装成一个独立的控制器类,页面销毁时统一释放,判断标准很简单:页面不可见了,相机就不该活着。

什么时候不该用 Camera Kit

和扫码那篇的结论呼应:如果需求只是"扫个码",用系统扫码页,十几行代码;如果只是"用户选一张照片上传",用系统图库选择器。Camera Kit 是给需要完全控制拍照过程的应用准备的——相机应用、带滤镜的拍摄、连拍。需求越往"拍照记录"靠,越应该用系统相机能力,cameraPicker 一行代码拉起系统拍照页,拍完返回图片,零生命周期管理。我们的上传场景最后用的就是它,四天的 Camera Kit 方案留在了分支里。

写在最后

这段经历的结论浓缩成几句:相机的结构是输入加会话加输出,黑屏九成是会话没组装完整;分辨率查 Profile 不硬配;离开页面就释放,相机资源别占着;最后自问一句——这个需求真的需要自己管相机吗。技术深度的价值在于知道哪条路成本多少,能选最便宜的路,比能走最难的路更有用。

Logo

作为“人工智能6S店”的官方数字引擎,为AI开发者与企业提供一个覆盖软硬件全栈、一站式门户。

更多推荐