芒里偷闲相机能力
HarmonyOS 6
HarmonyOS 7
相机滤镜库
仙银
HarmonyOS 滤镜能力分散在几个官方 Kit 里。下面按你问的三个问题逐个说。
一、滤镜相关官方能力
按使用场景分三档:
- ArkUI Image 组件的 colorFilter — 最轻量,直接在 Image 组件上用 4x5 颜色矩阵做滤镜,适合展示层实时调色。官方给了复古、反色、饱和度增强、美白等矩阵模板,开箱即用。API 9 起可用。
Image(pixelMap)
.colorFilter([
0.213, 0.715, 0.072, 0, 0,
0.213, 0.715, 0.072, 0, 0,
0.213, 0.715, 0.072, 0, 0,
0, 0, 0, 1, 0
])
- @ohos.effectKit — ArkTS 层离线图像处理,支持 blur、brightness、grayscale、invert、setColorMatrix 等效果链式调用,处理 PixelMap 后输出新图。API 9 起可用。
import { effectKit } from '@kit.ArkGraphics2D'
let headFilter = effectKit.createEffect(pixelMap)
headFilter.brightness(0.5).grayscale()
let result = await headFilter.getEffectPixelMap()
- ImageEffect(C/C++) — 最强那档,API 12 起可用。支持滤镜链组合(亮度 OH_EFFECT_BRIGHTNESS_FILTER、对比度 OH_EFFECT_CONTRAST_FILTER、裁剪 OH_EFFECT_CROP_FILTER 等),支持注册自定义滤镜算法,输入源支持 Pixelmap / NativeWindow / NativeBuffer / URI / 纹理,还能接相机预览流做实时滤镜。这是目前唯一能接相机 Surface 做实时滤镜的官方方案。
三方库方面,目前 HarmonyOS 还没有成熟的三方相机滤镜库上架,需要滤镜基本靠上面官方方案组合。
二、权限
根据申请相机开发的权限,自定义相机开发需要:
- ohos.permission.CAMERA — 必须申请,用户授权授权
- ohos.permission.MICROPHONE — 录像同时录音时需要
- ohos.permission.MEDIA_LOCATION — 照片/视频带地理位置时需要
以上三个都是用户授权权限,需在 module.json5 声明 + 运行时弹窗申请。
如果你只是拍照拿图不做自定义相机,用 CameraPicker 就行,不需要申请任何权限。
读写图片/视频:优先用媒体库 Picker 或安全控件保存,不要直接申请 READ_IMAGEVIDEO / WRITE_IMAGEVIDEO(受限权限,AGC 审核很严)。
三、前期准备
- 确定方案:只需拍照拿图 → CameraPicker(零权限);需要自定义预览/滤镜/闪光灯控制 → 自定义相机(Camera Kit)
- 在 module.json5 声明权限,运行时调用 abilityAccessCtrl.requestPermissionsFromUser 申请
- 自定义相机需 XComponent 做预览 Surface,按 Camera Kit 文档走 设备输入→会话管理→预览→拍照/录像 流程
- 如果要做实时滤镜,走 ImageEffect 的 NativeWindow 输入方案,相机预览流 SurfaceId 传入 ImageEffect 的 InputSurface,输出 Surface 接 XComponent 显示
- 真机调试,模拟器只支持 1280x720 的预览和拍照
参考:Camera Kit简介
蓝瘦的蜕变
按鸿蒙原生应用来说,可以这样选:
- 官方方案:Camera Kit 负责预览、拍照、录像;Image Kit 的 ImageEffect 提供基础滤镜、滤镜链和自定义滤镜,主要走 Native C/C++ 接口。拍照后简单调亮度、灰度、模糊,也可用
effectKit。 - 三方方案:相芯 FaceUnity、腾讯特效 SDK都有鸿蒙版本,适合实时美颜、滤镜、贴纸等。选型前先跑鸿蒙 Demo,确认所需效果、最低 API、授权费用及素材授权。
权限按功能申请:
- 自建相机预览、拍摄:
ohos.permission.CAMERA。 - 录像需要声音:再申请
ohos.permission.MICROPHONE。 - 两者都要在
module.json5声明,并在使用时动态申请。 - 相册选图优先用 PhotoViewPicker,保存优先用安全保存控件,不必一上来申请整库读写权限。
- 仅调用系统相机拍摄:用 CameraPicker,无需申请相机权限,但不适合自定义实时滤镜界面。
前期先明确做实时预览滤镜还是拍照后处理,准备 DevEco Studio、匹配的 SDK、签名和真机,先跑通“预览—拍摄—保存”,再接滤镜。实时方案重点验证帧率、发热、前摄镜像和旋转方向,并查询设备支持的分辨率、帧率。
最容易踩的坑是:预览加了滤镜,保存出来却还是原图。拍照和录像输出也必须经过对应的滤镜处理链路。
橙动创意先按场景选:拍照后基础调色可用 effectKit/颜色矩阵,专业滤镜链或实时 Surface 处理看 ImageEffect;美颜、贴纸等三方 SDK 要实际跑其 HarmonyOS Demo,再比较最低 API、帧率、费用和素材授权。自定义相机最小权限通常是:
"requestPermissions": [
{ "name": "ohos.permission.CAMERA", "reason": "$string:camera_reason" },
{ "name": "ohos.permission.MICROPHONE", "reason": "$string:mic_reason" }
]第二项只在录像录音时申请。仅拉起系统相机可优先用 CameraPicker;选图/保存优先 Picker 和安全控件,别默认申请整库媒体权限。先在真机跑通“预览—拍摄—保存”,再接滤镜,并重点测旋转、前摄镜像、发热和保存结果是否也经过滤镜链。
训犬者静态图调色用 ImageEffect 就够了:亮度、对比度、饱和度、颜色矩阵都有现成接口,实现简单、性能可控。
要自定义 LUT 或做实时相机滤镜,得走 XComponent 加 GLES 或 Vulkan 着色器,相机预览的 OES 纹理可以直接采样,省一次拷贝。
权限按实际能力申请:相机用 ohos.permission.CAMERA,要保存到媒体库再加媒体读写权限,只声明真正用到的。
前期先确认目标机型的相机能力集(前后摄、分辨率、支持的格式),再决定滤镜放在哪一层。
不要在 ArkTS 层逐像素处理高分辨率图,必卡。
官方资料:
使用ImageEffect编辑图片 https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/image-effect-guidelines
基于colorFilter实现图片滤镜效果 https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/arkts-implementing-image-filters
心系天下
AI助手在HarmonyOS开发中,相机滤镜和图像处理能力由官方Kit和社区三方库共同支撑。以下从滤镜库、权限申请和前期准备三个方面进行详细说明。
一、相机/图像滤镜库
1. 官方能力
HarmonyOS 官方提供了多层级的图像滤镜处理能力,开发者可根据场景选择:
| 能力 | 模块/Kit | 语言 | 适用场景 |
|---|---|---|---|
| effectKit | @kit.ArkGraphics2D |
ArkTS | 亮度调节、高斯模糊、灰度化、智能取色等基础滤镜 |
| ImageEffect | Image Kit C/C++ API | C/C++ | 滤镜链(多滤镜叠加)、自定义滤镜注册、支持 PixelMap/NativeBuffer/URI 等多种输入 |
| colorFilter | ArkUI Image 组件属性 | ArkTS | 通过 4x5 颜色矩阵对图片做色彩变换(复古、暖色、亮度等) |
| SVG 滤镜标签 | ArkUI SVG 组件 | ArkTS | 高斯模糊、偏移、混合、颜色矩阵等 SVG 原语滤镜 |
| Spatial Recon Kit | @kit.SpatialReconKit |
ArkTS | 3DGS 模型渲染画面的风格化滤镜(复古、漫画、黑白、颜色编辑) |
其中,effectKit 是最常用的 ArkTS 级别滤镜方案,导入方式如下:
import { effectKit } from '@kit.ArkGraphics2D';
import { image } from '@kit.ImageKit';
ImageEffect 是 C/C++ 级别的高级滤镜引擎,支持滤镜链组合和自定义滤镜注册,适合专业图像编辑应用。其核心 API 包括 OH_ImageEffect_AddFilter、OH_ImageEffect_InsertFilter、OH_EffectFilter_SetValue 等,起始版本为 API 12。
2. 三方库
社区生态中也有多个可用于滤镜和图像处理的三方库:
| 三方库 | 安装方式 | 说明 |
|---|---|---|
@ohos/aki |
ohpm install @ohos/aki |
NAPI 极简绑定框架,用于将 C++ 滤镜算法(高斯模糊、Sobel 边缘检测、色彩变换等)高效暴露给 ArkTS,适合高性能滤镜开发 |
@ohos/ffmpeg-kit |
ohpm install @ohos/ffmpeg-kit |
FFmpeg 的 HarmonyOS 移植版,支持视频滤镜、转码、剪辑等音视频处理能力 |
| G'MIC CLI | 源码编译迁移 | 开源图像处理框架,提供 1000+ 图像处理命令和滤镜效果,已有 OpenHarmony 平台适配实践 |
@ohos/imageknifepro |
ohpm install @ohos/imageknifepro |
图片加载库(Glide 思路),支持自定义解码、缓存拦截器,可配合滤镜处理使用 |
对于性能要求高的滤镜算法(如对 1080p 图片逐像素浮点运算),推荐使用 C++ 编写算法,通过 @ohos/aki 桥接调用,可从数秒优化到几十毫秒。
二、开发相机类应用需要申请的权限
开发相机类应用涉及以下权限,均为 user_grant(用户授权)类型,需在配置文件中声明并在运行时向用户申请:
| 权限名 | 说明 | 必要性 |
|---|---|---|
ohos.permission.CAMERA |
允许应用使用相机 | 必选(自定义相机界面时) |
ohos.permission.MICROPHONE |
允许应用使用麦克风 | 录像时必选 |
ohos.permission.MEDIA_LOCATION |
访问媒体文件中的地理位置信息 | 需要读取照片位置时选配 |
ohos.permission.READ_IMAGEVIDEO |
读取媒体库图片和视频 | 需要读取相册时必选(受限权限) |
ohos.permission.WRITE_IMAGEVIDEO |
写入媒体库图片和视频 | 需要保存照片/视频到相册时必选(受限权限) |
需要注意的是,如果仅需要拉起系统相机拍摄一张照片或录制一段视频,可以直接使用 CameraPicker,无需申请相机权限。只有需要自定义相机界面或开发专业相机应用时,才需要申请上述权限。
三、前期准备工作
1. 在 module.json5 中声明权限
在 entry/src/main/module.json5 中配置所需权限:
{
"module": {
"requestPermissions": [
{
"name": "ohos.permission.CAMERA",
"reason": "$string:permission_CAMERA",
"usedScene": {
"abilities": ["EntryAbility"],
"when": "inuse"
}
},
{
"name": "ohos.permission.MICROPHONE",
"reason": "$string:permission_MICROPHONE",
"usedScene": {
"abilities": ["EntryAbility"],
"when": "inuse"
}
}
]
}
}
2. 运行时向用户申请授权
在应用启动或进入相机功能页时,通过 abilityAccessCtrl 主动请求用户授权:
import { abilityAccessCtrl, common } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';
async function requestCameraPermissions(context: common.UIAbilityContext): Promise<boolean> {
const atManager: abilityAccessCtrl.AtManager = abilityAccessCtrl.createAtManager();
const permissions: string[] = [
'ohos.permission.CAMERA',
'ohos.permission.MICROPHONE'
];
try {
const grantStatus: abilityAccessCtrl.GrantStatus[] =
await atManager.requestPermissionsFromUser(context, permissions);
return grantStatus.every((status: abilityAccessCtrl.GrantStatus) =>
status === abilityAccessCtrl.GrantStatus.PERMISSION_GRANTED);
} catch (err) {
const e = err as BusinessError;
console.error(`请求权限失败: ${e.message}`);
return false;
}
}
3. 导入相机模块并初始化
import { camera } from '@kit.CameraKit';
import { image } from '@kit.ImageKit';
import { BusinessError } from '@kit.BasicServicesKit';
相机应用开发的核心流程包括:相机管理(CameraManager) → 设备输入(CameraInput) → 预览输出(PreviewOutput) → 拍照输出(PhotoOutput)/ 录像输出(VideoOutput) → 会话管理(CaptureSession)。如果仅需自定义拍照界面而无需开发完整的专业相机应用,还可以使用相机预配置(Preconfig)接口快速完成参数配置。
4. 受限权限额外申请
ohos.permission.READ_IMAGEVIDEO 和 ohos.permission.WRITE_IMAGEVIDEO 属于受限 ACL 权限,除了在 module.json5 中声明外,还需要在应用上架时通过华为开发者平台提交权限使用说明并申请 ACL 凭证。
5. 滤镜处理准备
如果需要在相机预览流上实时添加滤镜,可以通过 ImageReceiver 获取预览流实时数据,再结合 effectKit 或 ImageEffect 进行二次处理。若使用 C/C++ 方案,还需在 CMakeLists.txt 中链接相关动态库:
target_link_libraries(entry PUBLIC
libace_napi.z.so
libhilog_ndk.z.so
libohimage.so
libimage_receiver.so
libnative_image.so
libohcamera.so
libnative_buffer.so
)
补充说明
- 如果应用只需要获取拍摄照片或视频而不需要自定义相机界面,推荐使用 CameraPicker,无需申请任何相机权限,开发成本最低。
- 滤镜性能优化方面,ArkTS 层适合简单色彩矩阵变换,复杂逐像素算法建议用 C++ 实现并通过 NAPI 或
@ohos/aki桥接。 - ImageEffect 的滤镜链支持多滤镜顺序叠加,还可以通过
OH_ImageEffect_Save/OH_ImageEffect_Restore实现滤镜效果的序列化与反序列化,方便保存用户的编辑记录。
- 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
- 如您发布的内容为转载内容,请注明内容来源。
我要提问题
HarmonyOS 如何在基于Artks的双路预览中绘制ROI框 (API12+)
HarmonyOS 如何实现XComponent预览相机画面并实现画中画功能 (API12+)
HarmonyOS 相机拍照希望闪光灯常亮 (API12+)
HarmonyOS 请问针对同一物体直接使用系统相机拍摄出来的图片和使用cameraPicker.pick接口掉起相机拍摄的到的图片清晰度上是否会有差别?(API12+)
HarmonyOS 求一个“使用相机模式进行开发”完整可运行的代码工程 (API12+)
HarmonyOS 第三方文本编辑类软件怎么开发放大镜功能 (API12+)
HarmonyOS 如何申请相机权限ohos.permission.CAMERA?(API12)
手机和大屏是否支持组成分布式相机




































苏公安网备 32011402010933号