输入关键字搜索
开发者能力认证
鸿蒙高校创新赛
HarmonyOS 7
animation
HarmonyOS行业解决方案
layoutWeight
HarmonyOS模板&组件
bindPopup
bindsheet
CTRL+K
文档管理中心

HarmonyOS

输入关键字搜索
开发者能力认证
鸿蒙高校创新赛
HarmonyOS 7
animation
HarmonyOS行业解决方案
layoutWeight
HarmonyOS模板&组件
bindPopup
bindsheet
CTRL+K
版本说明
指南媒体Camera Kit（相机服务）开发相机应用基础能力(ArkTS)微距能力设置(ArkTS)

微距能力设置(ArkTS)

更新时间: 2026-03-09 02:50
本文导读

从API version 19开始，支持设置微距能力。微距能力是指通过光学设计与算法优化，实现近距离对焦并清晰捕捉微小物体细节的相机功能。

开发步骤

详细的API说明请参考Camera。

  1. 导入camera接口，接口中提供了相机相关的属性和方法，导入方法如下。

    收起
    自动换行
    深色代码主题
    复制
    1. import { camera } from '@kit.CameraKit';
    2. import { BusinessError } from '@kit.BasicServicesKit';

  2. 通过isMacroSupported接口，查询当前设备是否支持微距能力。

    收起
    自动换行
    深色代码主题
    复制
    1. let isSupported: boolean = photoSession.isMacroSupported();

  3. 通过enableMacro接口，开启或关闭微距能力。

    收起
    自动换行
    深色代码主题
    复制
    1. function EnableMacro(photoSession: camera.PhotoSession): void {
    2.    let isSupported: boolean = photoSession.isMacroSupported();
    3.    if (isSupported) {
    4.       photoSession.enableMacro(true);
    5.    }
    6. }

状态监听

从API version 20开始，支持监听微距能力是否发生改变。

注册macroStatusChanged事件监听微距能力变化，事件监听可参考on('macroStatusChanged')。

收起
自动换行
深色代码主题
复制
  1. function callback(err: BusinessError, macroStatus: boolean): void {
  2.    if (err !== undefined && err.code !== 0) {
  3.       console.error(`Callback Error, errorCode: ${err.code}`);
  4.       return;
  5.    }
  6.    console.info(`Macro state: ${macroStatus}`);
  7. }
  8. 

  9. // 注册回调函数。
  10. function registerMacroStatusChanged(photoSession: camera.PhotoSession): void {
  11.    photoSession.on('macroStatusChanged', callback);
  12. }
  13. 

  14. // 解注册。
  15. function unregisterMacroStatusChanged(photoSession: camera.PhotoSession): void {
  16.    photoSession.off('macroStatusChanged');
  17. }
相机控制器(ArkTS)
多摄同开(ArkTS)
相关推荐
文档微距能力设置(C/C++)
文档对焦(ArkTS)
文档相机控制器(ArkTS)
文档Interface (MacroQuery)
文档多摄同开(ArkTS)
文档白平衡设置(ArkTS)
文档压力管控(ArkTS)
文档自动切换摄像头实践(ArkTS)
文档设备输入(ArkTS)
示例代码基于预配置实现相机预览、拍照和录像（ArkTS）
简体中文
华为开发者联盟 版权所有 ©2026
问题反馈
使用条款
华为开发者联盟用户协议
关于华为开发者联盟与隐私的声明
Cookies
开源软件声明
搜索
请输入您想要搜索的关键词