HarmonyOS 真机实战：一张普通照片怎样自动抠出人物并生成旅行海报

HarmonyOS 真机实战一张普通照片怎样自动抠出人物并生成旅行海报真机环境ALN-AL80OpenHarmony 7.0.0.32Beta2API 26人物素材为专门生成的虚构成年旅行者测试图不包含真实用户和私人相册内容。为什么旅行合成最难的是第一步把人物放到海岸、雪山或古镇模板上看起来像一次普通的图片叠加。真正影响结果的却是人物边缘头发、背包带、衣服轮廓只要带着原背景换景后就会出现明显灰边让用户用手指一点点涂抹又很难成为相册里的高频功能。双镜记忆相机已经有旅行模板和图片编辑页缺少的是从普通照片直接得到透明前景的入口。本次实践使用 Core Vision Kit 主体分割从相册详情发起抠图得到人物前景后进入模板编辑最后导出一张新的 JPEG并保留原照片。验证链路按四个画面连续进行原始人物照片、主体分割后的默认模板、切换模板并调整大小、导出后回到真实照片详情。先确认官方能力边界Core Vision Kit 官方能力页将“主体分割”描述为检测并提取图片中区别于背景的前景物体或区域Vision Kit 官方能力页也把主体分割用于应用内图片浏览和抠图场景。本次使用的是kit.CoreVisionKit中的subjectSegmentation输入一张PixelMap配置需要的主体数量和前景图接口返回主体数量、主体明细以及带透明信息的前景图。旅行模板、人物缩放、位置调整和 JPEG 导出仍由应用完成。这条边界很重要。主体分割结果是可继续编辑的前景素材最终画面质量还取决于模板构图、人物比例、边缘融合和输出编码。准备一张可公开复现的人物图可复现的抠图测试需要固定、可公开使用的输入素材。本次使用一名虚构成年旅行者蓝色外套、浅色长裤、橙色背包人物完整站立在灰色背景前。服装与背景有足够色差手脚也没有被画面裁断便于观察主体轮廓。图 1从双镜记忆相机的照片详情进入“旅行画境”输入图仍是带灰色背景的完整照片。真实产品中人物照片可能存在逆光、头发与背景同色、肢体被遮挡等情况。入口应允许服务返回“未识别到清晰主体”不能用原图矩形直接覆盖模板来伪装抠图成功。从 JPEG 解码到主体前景主体分割服务接收PixelMap。沙箱中的 JPEG 需要先打开为只读文件再按RGBA_8888解码constsourceFileawaitfs.open(sourcePath,fs.OpenMode.READ_ONLY);constimageSourceimage.createImageSource(sourceFile.fd);constsourcePixelMapawaitimageSource.createPixelMap({editable:false,desiredPixelFormat:image.PixelMapFormat.RGBA_8888});随后初始化模型并明确要求返回一个主体的明细和前景图constinitializedawaitsubjectSegmentation.init();if(!initialized){thrownewError(主体分割服务初始化失败);}constresultawaitsubjectSegmentation.doSegmentation({pixelMap:sourcePixelMap},{maxCount:1,enableSubjectDetails:true,enableSubjectForegroundImage:true});if(result.subjectCount0){thrownewError(没有识别到清晰人物);}constforegroundresult.subjectDetails?.[0]?.foregroundImage??result.fullSubject.foregroundImage;subjectCount是进入编辑器前的硬条件。分割没有返回主体时页面保留原照片并提示换一张轮廓更清晰的图片不创建空白成片。文件、ImageSource、源PixelMap和模型都在finally中释放。大尺寸照片连续处理时如果只关注前景结果而忘记释放输入几次操作就可能累积明显内存压力。分割成功后直接进入模板编辑真机完成主体分割后灰色背景从人物周围消失编辑页把透明前景放到默认旅行模板中。截图里人物背包、外套和腿部轮廓已经与新背景分离。图 2Core Vision Kit 返回人物前景编辑页显示默认模板及可移动、缩放的人物图层。编辑页不再读取原始 JPEG 作为人物层而是持有分割后的前景PixelMap。模板层负责背景人物层负责平移、缩放和镜像两个图层在导出阶段合成。这样切换模板时不需要再次运行主体分割。人物初始比例通常只是可用起点。横向海岸模板需要人物略小竖向城市模板则可能需要上移。页面把比例限制在合理范围内避免缩成一个点或放大到完全超出画布。切换海岸模板并调整人物比例第二步选择“海岸珊瑚落日”把人物比例调到 85%。这次调整只改变编辑模型透明前景没有重新生成。图 3模板已经切换为海岸落日人物比例为 85%脚部位置落在前景岩石区域。模板切换和主体分割分开后交互会更稳定分割是耗时的模型任务只执行一次拖动、镜像和缩放是本地画布操作可以实时响应。导出前还要把人物位置限制在成片画布内避免手势结束后只剩一部分身体。合成时遵循固定顺序先绘制模板再根据编辑参数绘制人物前景最后生成一张新的PixelMap。原照片不会参与覆盖写入。导出新照片不覆盖原图完成编辑后应用把合成PixelMap以质量 94 编码为 JPEG写入独立的travel_compositions目录constoutputDirectory${context.filesDir}/travel_compositions;TravelComposeOutputService.ensureDirectory(outputDirectory);constsafeTemplateIdtemplateId.replace(/[^0-9a-zA-Z_-]/g,_);constoutputPath${outputDirectory}/travel_card_${safeTemplateId}_${Date.now()}.jpg;constoutputFilefs.openSync(outputPath,fs.OpenMode.CREATE|fs.OpenMode.WRITE_ONLY|fs.OpenMode.TRUNC);constpackerimage.createImagePacker();awaitpacker.packToFile(composite,outputFile.fd,{format:image/jpeg,quality:94});输出成功后新文件作为一条独立相册记录写入双镜记忆相机并继承必要的旅行信息原始人物照片仍保留在相册中。写文件或编码失败时会清理未完成的目标文件避免图库里出现零字节成片。图 4导出的海岸旅行成片已经进入照片详情页面提示原照片仍保留在相册中。这张图完成了结果闭环图 1 的灰底人物经过主体分割图 2 进入模板图 3 完成构图调整图 4 则是实际写出的新 JPEG而不是编辑页上的临时预览。实践中最容易踩的几个点1. 只要蒙版不请求前景图旅行合成需要直接绘制透明人物。配置中应打开enableSubjectForegroundImage只取区域或蒙版还要增加一次像素处理并承担边缘和透明通道的组合工作。2. 把模型任务放进手势更新主体分割应在进入编辑器时完成一次。缩放、移动和切换模板只更新本地编辑参数不能在每次手势变化时重新调用模型。3. 导出覆盖输入文件覆盖原图会让用户失去拍摄记录也会使相册索引和缓存失效。新成片使用独立路径和记录 ID成功写入后再刷新相册。4. 测试素材本身不适合抠图人物被裁断、主体太小、衣服与背景完全同色时分割边缘容易失真。公开测试素材保持完整人物和清晰轮廓真实相册仍需要失败提示与重新选图入口。最终效果ALN-AL80 真机已经完成从普通人物照片到旅行成片的完整路径JPEG 解码为RGBA_8888Core Vision Kit 返回透明人物前景编辑页切换海岸模板并把人物调整到 85%最后输出新的 JPEG 并进入真实照片详情。这套实现把模型能力放在最适合的位置主体分割负责提供可编辑前景画面设计由模板和本地编辑器完成文件服务负责生成独立成片。四张连续真机图分别对应输入、分割、编辑和输出最终结果可以在相册中继续查看、分享或制作回忆电影。