文档开发者中心
我的
|

相机能力

HarmonyOS 6

HarmonyOS 7

相机滤镜库

已解决
目前手机开发中有哪些三方或者官方的相机滤镜库?开发相机类应用需要申请哪些权限?前期需要做哪些准备?
点赞
1
收藏
回复
6
分享
举报
浏览105 发布于2026-09-16 00:18江苏
全部评论
最多点赞
最新发布
最早发布
|
采纳答复

HarmonyOS 滤镜能力分散在几个官方 Kit 里。下面按你问的三个问题逐个说。

一、滤镜相关官方能力

按使用场景分三档:

  1. 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
  ])

参考:基于colorFilter实现图片滤镜效果

  1. @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()

参考:@ohos.effectKit

  1. ImageEffect(C/C++) — 最强那档,API 12 起可用。支持滤镜链组合(亮度 OH_EFFECT_BRIGHTNESS_FILTER、对比度 OH_EFFECT_CONTRAST_FILTER、裁剪 OH_EFFECT_CROP_FILTER 等),支持注册自定义滤镜算法,输入源支持 Pixelmap / NativeWindow / NativeBuffer / URI / 纹理,还能接相机预览流做实时滤镜。这是目前唯一能接相机 Surface 做实时滤镜的官方方案。

参考:使用ImageEffect编辑图片

三方库方面,目前 HarmonyOS 还没有成熟的三方相机滤镜库上架,需要滤镜基本靠上面官方方案组合。

二、权限

根据申请相机开发的权限,自定义相机开发需要:

  • ohos.permission.CAMERA — 必须申请,用户授权授权
  • ohos.permission.MICROPHONE — 录像同时录音时需要
  • ohos.permission.MEDIA_LOCATION — 照片/视频带地理位置时需要

以上三个都是用户授权权限,需在 module.json5 声明 + 运行时弹窗申请。

如果你只是拍照拿图不做自定义相机,用 CameraPicker 就行,不需要申请任何权限。

读写图片/视频:优先用媒体库 Picker 或安全控件保存,不要直接申请 READ_IMAGEVIDEO / WRITE_IMAGEVIDEO(受限权限,AGC 审核很严)。

三、前期准备

  1. 确定方案:只需拍照拿图 → CameraPicker(零权限);需要自定义预览/滤镜/闪光灯控制 → 自定义相机(Camera Kit)
  2. 在 module.json5 声明权限,运行时调用 abilityAccessCtrl.requestPermissionsFromUser 申请
  3. 自定义相机需 XComponent 做预览 Surface,按 Camera Kit 文档走 设备输入→会话管理→预览→拍照/录像 流程
  4. 如果要做实时滤镜,走 ImageEffect 的 NativeWindow 输入方案,相机预览流 SurfaceId 传入 ImageEffect 的 InputSurface,输出 Surface 接 XComponent 显示
  5. 真机调试,模拟器只支持 1280x720 的预览和拍照

参考:Camera Kit简介

展开全部
3楼回复于2026-09-16 01:53 来自四川

按鸿蒙原生应用来说,可以这样选:

  • 官方方案: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、签名和真机,先跑通“预览—拍摄—保存”,再接滤镜。实时方案重点验证帧率、发热、前摄镜像和旋转方向,并查询设备支持的分辨率、帧率。

最容易踩的坑是:预览加了滤镜,保存出来却还是原图。拍照和录像输出也必须经过对应的滤镜处理链路。

2楼回复于2026-09-16 01:39 来自广东

先按场景选:拍照后基础调色可用 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 和安全控件,别默认申请整库媒体权限。先在真机跑通“预览—拍摄—保存”,再接滤镜,并重点测旋转、前摄镜像、发热和保存结果是否也经过滤镜链。

 

6楼回复于2026-09-16 07:59 来自四川
官方没有「滤镜库」这个概念,能力是分层的。

静态图调色用 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

5楼回复于2026-09-16 03:39 来自四川
滤镜库选择
官方方案
HarmonyOS 内置  image  模块( @kit.ArkUI  或  @kit.Image )提供基础滤镜能力,包括颜色调整、模糊、像素处理等。优点是系统原生、无需额外依赖;缺点是效果种类有限,偏基础。
三方库
- GPUImage — 跨平台,GPU 加速,效果丰富,HarmonyOS 有移植版本
- OpenCV — 图像处理能力强,滤镜只是其中一部分功能,学习曲线稍陡
- LUT 滤镜 — 自己实现的话,用颜色查找表(LUT)是最灵活的方式,加载一张 LUT 图片做颜色映射即可
如果追求效果丰富且性能优先,推荐 GPUImage 或自研 LUT 方案;如果只是基础调整,官方能力够用。
需要申请的权限
相机权限
-  ohos.permission.CAMERA  — 必须,相机访问权限
麦克风权限(如需录像)
-  ohos.permission.MICROPHONE  — 录音
存储权限(如需保存到相册)
-  ohos.permission.WRITE_IMAGEVIDEO  — 写入媒体库
-  ohos.permission.READ_IMAGEVIDEO  — 读取媒体库
定位权限(如需记录照片位置)
-  ohos.permission.APPROXIMATELY_LOCATION  或  ohos.permission.LOCATION 
权限在  module.json5  中声明,敏感权限需要运行时动态申请,用户拒绝时要有降级处理。
前期准备
1. 确定相机能力
HarmonyOS 相机能力分前置后置、分辨率、帧率、闪光灯、对焦模式等,用  CameraManager  获取支持的设备和能力列表,不要假设所有设备都支持同样的功能。
2. 预览流处理
相机预览需要  XComponent  作为载体,滤镜处理需要在预览流上做图像处理。如果用 GPU 方案,注意纹理共享和同步问题。
3. 拍照与录像流程
拍照走  CameraOutputCapability  +  PhotoCaptureSetting ,录像需要  AVRecorder  配合相机输出。两套流程分开处理,逻辑不同。
4. 性能考量
滤镜是计算密集型操作,实时预览时用 GPU 处理,别在主线程做像素级运算。帧率掉下来用户体验直接崩。
5. 测试覆盖
不同机型相机能力差异大,前置摄像头、后置主摄、超广角、长焦都要测。模拟器没摄像头,必须真机测试。
- 滤镜选 GPUImage 或自研 LUT,基础需求用官方能力
- 权限按需申请,敏感权限运行时动态申请
- 前期先摸清设备能力,别假设所有功能都可用
- 性能优先,滤镜处理走 GPU,别卡主线程
- 真机测试,模拟器跑不了相机
展开全部
4楼回复于2026-09-16 03:20 来自陕西
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 实现滤镜效果的序列化与反序列化,方便保存用户的编辑记录。
展开全部
1楼回复于2026-09-16 01:35 来自广东
写回答
新增插入模板功能
一键使用模板,快速填写内容,轻松发帖~
知道了
  • 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
  • 如您发布的内容为转载内容,请注明内容来源。

我要提问题

了解社区公约,与您携手共创和谐专业的开发者社区。