Interface (Macro)

Macro 继承自 MacroQuery。

提供使能微距能力的接口。

说明：

• 本模块首批接口从API version 10开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
• 本Interface首批接口从API version 19开始支持。

导入模块

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

enableMacro¹⁹⁺

enableMacro(enabled: boolean): void

使能当前的微距能力。

说明：

使用该接口前，需要先通过isMacroSupported接口查询当前设备是否支持微距能力。

原子化服务API： 从API version 19开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.Multimedia.Camera.Core

参数：

参数名	类型	必填	说明
enabled	boolean	是	是否开启微距能力。true表示开启微距能力，false表示关闭微距能力。

错误码：

以下错误码的详细介绍请参见Camera错误码。

错误码ID	错误信息
7400102	Operation not allowed.
7400103	Session not config.

示例：

function enableMacro(photoSession: camera.PhotoSession): void {
  let isSupported: boolean = photoSession.isMacroSupported();
  if (isSupported) {
    photoSession.enableMacro(true);
  }
}