visionImageAnalyzer（AI识图控件）

导入模块

import { visionImageAnalyzer } from '@kit.VisionKit';

Menu

AI识图菜单。

系统能力： SystemCapability.AI.VisionImageAnalyzer

模型约束： 此接口仅可在Stage模型下使用。

起始版本： 5.0.0(12)

Rect

矩形数据结构。

系统能力： SystemCapability.AI.VisionImageAnalyzer

模型约束： 此接口仅可在Stage模型下使用。

起始版本： 5.0.0(12)

Subject

主体识别结果。

系统能力： SystemCapability.AI.VisionImageAnalyzer

模型约束： 此接口仅可在Stage模型下使用。

起始版本： 5.0.0(12)

SelectedStatus

识图对象选中状态的枚举值。

系统能力： SystemCapability.AI.VisionImageAnalyzer

模型约束： 此接口仅可在Stage模型下使用。

起始版本： 5.0.0(12)

ImageAnalyzerVisibility

AI识图控件可见状态的枚举值。

系统能力： SystemCapability.AI.VisionImageAnalyzer

模型约束： 此接口仅可在Stage模型下使用。

起始版本： 5.0.0(12)

AIButtonStatus

AIButton状态的枚举值。

系统能力： SystemCapability.AI.VisionImageAnalyzer

模型约束： 此接口仅可在Stage模型下使用。

起始版本： 5.0.0(12)

ObjectSearchPanelVisibility

图片搜索界面可见状态的枚举值。

系统能力： SystemCapability.AI.VisionImageAnalyzer

模型约束： 此接口仅可在Stage模型下使用。

起始版本： 5.0.1(13)

ImageAnalyzerUIStatus

图片分析界面状态的枚举值。

系统能力： SystemCapability.AI.VisionImageAnalyzer

模型约束： 此接口仅可在Stage模型下使用。

起始版本： 5.0.2(14)

VisionImageAnalyzerController

这是视觉图像控制器，用于控制交互。继承自ImageAnalyzerController类。

系统能力： SystemCapability.AI.VisionImageAnalyzer

模型约束： 此接口仅可在Stage模型下使用。

起始版本： 5.0.0(12)

setImageAnalyzerVisibility

setImageAnalyzerVisibility(visibility: ImageAnalyzerVisibility): void

设置AI识图控件的可见性。

系统能力： SystemCapability.AI.VisionImageAnalyzer

模型约束： 此接口仅可在Stage模型下使用。

起始版本： 5.0.0(12)

参数：

示例：

import { visionImageAnalyzer } from '@kit.VisionKit';

@Entry
@Component
struct ImageDemo {
  private visionImageAnalyzerController: visionImageAnalyzer.VisionImageAnalyzerController =
    new visionImageAnalyzer.VisionImageAnalyzerController();
  aboutToAppear() {
    this.visionImageAnalyzerController.setImageAnalyzerVisibility(visionImageAnalyzer.ImageAnalyzerVisibility.HIDDEN);
  }
  build() {
    Stack() {
      // 此处图片需单独配置，添加到src/main/resources/base/media路径下
      Image($r('app.media.img'), {
          types: [ImageAnalyzerType.TEXT, ImageAnalyzerType.SUBJECT, ImageAnalyzerType.OBJECT_LOOKUP],
          aiController: this.visionImageAnalyzerController
        })
        .width('100%')
        .height('100%')
        .enableAnalyzer(true)
        .objectFit(ImageFit.Contain)
    }.width('100%').height('100%')
  }
}

setAIButtonPosition

setAIButtonPosition(position: Rect): void

设置AIButton的位置。

系统能力： SystemCapability.AI.VisionImageAnalyzer

模型约束： 此接口仅可在Stage模型下使用。

起始版本： 5.0.0(12)

参数：

示例：

import { visionImageAnalyzer } from '@kit.VisionKit';

@Entry
@Component
struct ImageDemo {
  private visionImageAnalyzerController: visionImageAnalyzer.VisionImageAnalyzerController =
    new visionImageAnalyzer.VisionImageAnalyzerController();
  aboutToAppear() {
    let position: visionImageAnalyzer.Rect = {
      bottom: 300
    };
    this.visionImageAnalyzerController.setAIButtonPosition(position);
    this.visionImageAnalyzerController.setAIButtonVisibility(true);
  }
  build() {
    Stack() {
      // 此处图片需单独配置，添加到src/main/resources/base/media路径下
      Image($r('app.media.6'), {
        types: [ImageAnalyzerType.TEXT, ImageAnalyzerType.SUBJECT, ImageAnalyzerType.OBJECT_LOOKUP],
        aiController: this.visionImageAnalyzerController
      })
        .width('100%')
        .height('100%')
        .enableAnalyzer(true)
        .objectFit(ImageFit.Contain)
    }.width('100%').height('100%')
  }
}

示例图如下，AIButton离底部300vp

setAIButtonVisibility

setAIButtonVisibility(visible: boolean): void

设置AIButton的可见性。配置AIButton属性可见后，会对图片进行预分析，当图片中存在文本且文本区域大于图片区域的5%时AIButton才会显示。开启AIButton会触发图片的预分析从而导致一定的功耗开销，建议评估场景，对图片中文本内容较为关注的场景下按需开启，带给消费者良好的图片浏览体验的同时降低不必要的功耗开销。

系统能力： SystemCapability.AI.VisionImageAnalyzer

模型约束： 此接口仅可在Stage模型下使用。

起始版本： 5.0.0(12)

参数：

示例：

import { visionImageAnalyzer } from '@kit.VisionKit';

@Entry
@Component
struct ImageDemo {
  private visionImageAnalyzerController: visionImageAnalyzer.VisionImageAnalyzerController =
    new visionImageAnalyzer.VisionImageAnalyzerController();
  aboutToAppear() {
    this.visionImageAnalyzerController.setAIButtonVisibility(true);
  }
  build() {
    Stack() {
      // 此处图片需单独配置，添加到src/main/resources/base/media路径下
      Image($r('app.media.img'), {
          types: [ImageAnalyzerType.TEXT, ImageAnalyzerType.SUBJECT, ImageAnalyzerType.OBJECT_LOOKUP],
          aiController: this.visionImageAnalyzerController
        })
        .width('100%')
        .height('100%')
        .enableAnalyzer(true)
        .objectFit(ImageFit.Contain)
    }.width('100%').height('100%')
  }
}

AIButton可见时如下图所示

setCustomTextMenuItems

setCustomTextMenuItems(menus: Menu[]): void

设置自定义的文字分析菜单项。

系统能力： SystemCapability.AI.VisionImageAnalyzer

模型约束： 此接口仅可在Stage模型下使用。

起始版本： 5.0.0(12)

参数：

示例：

import { visionImageAnalyzer } from '@kit.VisionKit';

@Entry
@Component
struct ImageDemo {
  private visionImageAnalyzerController: visionImageAnalyzer.VisionImageAnalyzerController =
    new visionImageAnalyzer.VisionImageAnalyzerController();
  aboutToAppear() {
    this.visionImageAnalyzerController.setAIButtonVisibility(true);
    this.visionImageAnalyzerController.setCustomTextMenuItems([
      {
        value: 'menu2',
        action: (param: string | visionImageAnalyzer.Subject[]) => {
          console.info('DEMO_TAG', 'text menu clicked');
        }
      }
    ]);
  }
  build() {
    Stack() {
      // 此处图片需单独配置，添加到src/main/resources/base/media路径下
      Image($r('app.media.img'), {
        types: [ImageAnalyzerType.TEXT, ImageAnalyzerType.SUBJECT, ImageAnalyzerType.OBJECT_LOOKUP],
        aiController: this.visionImageAnalyzerController
      })
        .width('100%')
        .height('100%')
        .enableAnalyzer(true)
        .objectFit(ImageFit.Contain)
    }.width('100%').height('100%')
  }
}

示例如下图所示，菜单右侧增加自定义菜单项。

startSubjectAnalyzer

startSubjectAnalyzer(): void

开启主体识别，前提需确保当前设备支持主体识别功能。可通过监听 “subjectAnalysis” 事件回调获取主体，注意在等待返回主体时增加超时处理，避免因未识别到主体而一直处于等待状态。

系统能力： SystemCapability.AI.VisionImageAnalyzer

模型约束： 此接口仅可在Stage模型下使用。

起始版本： 5.0.0(12)

示例：

import { visionImageAnalyzer } from '@kit.VisionKit';

@Entry
@Component
struct ImageDemo {
  private visionImageAnalyzerController: visionImageAnalyzer.VisionImageAnalyzerController =
    new visionImageAnalyzer.VisionImageAnalyzerController();
  aboutToAppear() {
    let supportTypes = this.visionImageAnalyzerController.getImageAnalyzerSupportTypes();
    if (supportTypes.includes(ImageAnalyzerType.SUBJECT)) {
       this.visionImageAnalyzerController.startSubjectAnalyzer();
    }
  }
  build() {
    Stack() {
      // 此处图片需单独配置，添加到src/main/resources/base/media路径下
      Image($r('app.media.img'), {
        types: [ImageAnalyzerType.TEXT, ImageAnalyzerType.SUBJECT, ImageAnalyzerType.OBJECT_LOOKUP],
        aiController: this.visionImageAnalyzerController
      })
        .width('100%')
        .height('100%')
        .enableAnalyzer(true)
        .objectFit(ImageFit.Contain)
    }.width('100%').height('100%')
  }
}

setCustomSubjectMenuItems

setCustomSubjectMenuItems(menus: Menu[]): void

设置自定义的主体分析菜单项。

系统能力： SystemCapability.AI.VisionImageAnalyzer

模型约束： 此接口仅可在Stage模型下使用。

起始版本： 5.0.0(12)

参数：

示例：

import { visionImageAnalyzer } from '@kit.VisionKit';

@Entry
@Component
struct ImageDemo {
  private visionImageAnalyzerController: visionImageAnalyzer.VisionImageAnalyzerController =
    new visionImageAnalyzer.VisionImageAnalyzerController();
  aboutToAppear() {
    this.visionImageAnalyzerController.setCustomSubjectMenuItems([
      {
        value: 'menu2',
        action: (param: string | visionImageAnalyzer.Subject[]) => {
          console.info('DEMO_TAG', 'subject menu clicked');
        }
      }
    ]);
  }
  build() {
    Stack() {
      // 此处图片需单独配置，添加到src/main/resources/base/media路径下
      Image($r('app.media.img'), {
        types: [ImageAnalyzerType.TEXT, ImageAnalyzerType.SUBJECT, ImageAnalyzerType.OBJECT_LOOKUP],
        aiController: this.visionImageAnalyzerController
      })
        .width('100%')
        .height('100%')
        .enableAnalyzer(true)
        .objectFit(ImageFit.Contain)
    }.width('100%').height('100%')
  }
}

setSelectedSubjects

setSelectedSubjects(subjectIds: number[]): void

根据主体id列表设置选中的主体。

系统能力： SystemCapability.AI.VisionImageAnalyzer

模型约束： 此接口仅可在Stage模型下使用。

起始版本： 5.0.0(12)

参数：

示例：

import { visionImageAnalyzer } from '@kit.VisionKit';

@Entry
@Component
struct SingleImageTest2 {
  private visionImageAnalyzerController: visionImageAnalyzer.VisionImageAnalyzerController =
    new visionImageAnalyzer.VisionImageAnalyzerController();
  aboutToAppear() {
    this.visionImageAnalyzerController.on('subjectAnalysis', (subjects: visionImageAnalyzer.Subject[]) => {
      console.info('DEMO_TAG', `subjectAnalysis result: ${JSON.stringify(subjects)}`);
      if (subjects.length > 0) {
        this.visionImageAnalyzerController.setSelectedSubjects([subjects[0].id]);
      }
    });
  }
  build() {
    Stack() {
      // 此处图片需单独配置，添加到src/main/resources/base/media路径下
      Image($r('app.media.img'), {
        types: [ImageAnalyzerType.TEXT, ImageAnalyzerType.SUBJECT, ImageAnalyzerType.OBJECT_LOOKUP],
        aiController: this.visionImageAnalyzerController
      })
        .width('100%')
        .height('100%')
        .enableAnalyzer(true)
        .objectFit(ImageFit.Contain)
    }.width('100%').height('100%')
  }
}

getSelectedSubjects

getSelectedSubjects(): Promise<Subject[] | null>

获取当前选中的主体。使用Promise异步回调。

系统能力： SystemCapability.AI.VisionImageAnalyzer

模型约束： 此接口仅可在Stage模型下使用。

起始版本： 5.0.0(12)

返回值：

示例：

import { visionImageAnalyzer } from '@kit.VisionKit';

@Entry
@Component
struct ImageDemo {
  private visionImageAnalyzerController: visionImageAnalyzer.VisionImageAnalyzerController =
    new visionImageAnalyzer.VisionImageAnalyzerController();
  getSelectedSubjects() {
    void this.visionImageAnalyzerController.getSelectedSubjects().then((subjects: visionImageAnalyzer.Subject[] | null) => {
      console.info('DEMO_TAG', `getSelectedSubjects result: ${JSON.stringify(subjects)}`);
    })
  }
  build() {
    Stack() {
      // 此处图片需单独配置，添加到src/main/resources/base/media路径下
      Image($r('app.media.img'), {
        types: [ImageAnalyzerType.TEXT, ImageAnalyzerType.SUBJECT, ImageAnalyzerType.OBJECT_LOOKUP],
        aiController: this.visionImageAnalyzerController
      })
        .width('100%')
        .height('100%')
        .enableAnalyzer(true)
        .objectFit(ImageFit.Contain)
    }.width('100%').height('100%')
  }
}

getSubject

getSubject(point: visionBase.Point): Promise<Subject | null>

根据点位获取对应位置的主体。使用Promise异步回调。调用此接口前需先调用startSubjectAnalyzer开启主体识别。

系统能力： SystemCapability.AI.VisionImageAnalyzer

模型约束： 此接口仅可在Stage模型下使用。

起始版本： 5.0.0(12)

参数：

返回值：

示例：

import { visionImageAnalyzer } from '@kit.VisionKit';
import { visionBase } from '@kit.CoreVisionKit';

@Entry
@Component
struct ImageDemo {
  private visionImageAnalyzerController: visionImageAnalyzer.VisionImageAnalyzerController = new visionImageAnalyzer.VisionImageAnalyzerController();
  getSelectedSubjects() {
    let searchPoint: visionBase.Point = { x: 100, y: 100 };
    void this.visionImageAnalyzerController.getSubject(searchPoint).then((subjects: visionImageAnalyzer.Subject | null) => {
      console.info('DEMO_TAG', `getSubject result: ${JSON.stringify(subjects)}`);
    });
  }
  build() {
    Stack() {
      // 此处图片需单独配置，添加到src/main/resources/base/media路径下
      Image($r('app.media.img'), {
        types: [ImageAnalyzerType.TEXT, ImageAnalyzerType.SUBJECT, ImageAnalyzerType.OBJECT_LOOKUP],
        aiController: this.visionImageAnalyzerController
      })
        .width('100%')
        .height('100%')
        .enableAnalyzer(true)
        .objectFit(ImageFit.Contain)
    }.width('100%').height('100%')
  }
}

getSubjectsImage

getSubjectsImage(subjectIds: number[]): Promise<PixelMap | null>

根据主体id获取对应主体组装成的图像。使用Promise异步回调。

系统能力： SystemCapability.AI.VisionImageAnalyzer

模型约束： 此接口仅可在Stage模型下使用。

起始版本： 5.0.0(12)

参数：

返回值：

示例：

import { visionImageAnalyzer } from '@kit.VisionKit';
import { BusinessError } from '@kit.BasicServicesKit';

@Entry
@Component
struct ImageDemo {
  private visionImageAnalyzerController: visionImageAnalyzer.VisionImageAnalyzerController =
    new visionImageAnalyzer.VisionImageAnalyzerController();
  getSubjectsImage() {
    this.visionImageAnalyzerController.on('subjectAnalysis', (subjects: visionImageAnalyzer.Subject[]) => {
      console.info('DEMO_TAG', `subjectAnalysis result: ${JSON.stringify(subjects)}`);
      if (subjects.length > 0) {
        let ids: number[] = [subjects[0].id];
        this.visionImageAnalyzerController.getSubjectsImage(ids).then((image: PixelMap | null) => {
          console.info('DEMO_TAG', 'Image data obtained successfully');
        }).catch((error: BusinessError) => {
          console.error('DEMO_TAG', `Failed to obtain image data. Code: ${error.code}, message: ${error.message}`);
        })
      }
    });
  }
  build() {
    Stack() {
      // 此处图片需单独配置，添加到src/main/resources/base/media路径下
      Image($r('app.media.img'), {
        types: [ImageAnalyzerType.TEXT, ImageAnalyzerType.SUBJECT, ImageAnalyzerType.OBJECT_LOOKUP],
        aiController: this.visionImageAnalyzerController
      })
        .width('100%')
        .height('100%')
        .enableAnalyzer(true)
        .objectFit(ImageFit.Contain)
    }.width('100%').height('100%')
  }
}

getImageAnalyzerUIStatus

getImageAnalyzerUIStatus(): Promise<ImageAnalyzerUIStatus>

获取当前图片分析UI状态。使用Promise异步回调。

系统能力： SystemCapability.AI.VisionImageAnalyzer

模型约束： 此接口仅可在Stage模型下使用。

起始版本： 5.0.2(14)

返回值：

示例：

import { visionImageAnalyzer } from '@kit.VisionKit';
import { BusinessError } from '@kit.BasicServicesKit';

@Entry
@Component
struct ImageDemo {
  private visionImageAnalyzerController: visionImageAnalyzer.VisionImageAnalyzerController =
    new visionImageAnalyzer.VisionImageAnalyzerController();
  aboutToAppear() {
    this.visionImageAnalyzerController.setAIButtonVisibility(true);
    this.visionImageAnalyzerController.on('objectSearchPanelVisibilityChange', (objectSearchPanelVisibility: visionImageAnalyzer.ObjectSearchPanelVisibility) => {
      this.visionImageAnalyzerController.getImageAnalyzerUIStatus().then((status: visionImageAnalyzer.ImageAnalyzerUIStatus) => {
        console.info('Image data obtained successfully: ', status);
      }).catch((error: BusinessError) => {
        console.error('DEMO_TAG', `Failed to obtain image data. Code: ${error.code}, message: ${error.message}`);
      })
    });
  }
  build() {
    Stack() {
      Image($r('app.media.img'), {
        types: [ImageAnalyzerType.TEXT, ImageAnalyzerType.SUBJECT, ImageAnalyzerType.OBJECT_LOOKUP],
        aiController: this.visionImageAnalyzerController
      })
        .width('100%')
        .height('60%')
        .enableAnalyzer(true)
        .objectFit(ImageFit.Contain)

      Button('获取当前图片分析UI状态', { stateEffect: true, type: ButtonType.Capsule })
        .width('80%')
        .height(40)
        .onClick(() => {
          this.visionImageAnalyzerController.getImageAnalyzerUIStatus()
            .then((status: visionImageAnalyzer.ImageAnalyzerUIStatus) => {
              console.info('DEMO_TAG', 'Image data obtained successfully: ', status);
            })
            .catch((error: BusinessError) => {
              console.error('DEMO_TAG', `Failed to obtain image data. Code: ${error.code}, message: ${error.message}`);
            })
        })
        .id('getImageAnalyzerUIStatus')
        .width('40%')
    }.width('100%').height('100%')
  }
}

startObjectSearch

startObjectSearch(): Promise<boolean>

开启视觉搜索。使用Promise异步回调。

系统能力： SystemCapability.AI.VisionImageAnalyzer

设备行为差异： 该接口在PC/2in1上无效果，在其他设备类型中可正常调用。

模型约束： 此接口仅可在Stage模型下使用。

起始版本： 5.0.0(12)

返回值：

示例：

import { visionImageAnalyzer } from '@kit.VisionKit';

@Entry
@Component
struct ImageDemo {
  private visionImageAnalyzerController: visionImageAnalyzer.VisionImageAnalyzerController =
    new visionImageAnalyzer.VisionImageAnalyzerController();
  async startObjectSearch() {
    // 开启视觉搜索后会拉起搜索界面
    let result: boolean = await this.visionImageAnalyzerController.startObjectSearch();
    console.info('DEMO_TAG', `startObjectSearch result: ${result}`);
  }
  build() {
    Stack() {
      // 此处图片需单独配置，添加到src/main/resources/base/media路径下
      Image($r('app.media.img'), {
        types: [ImageAnalyzerType.TEXT, ImageAnalyzerType.SUBJECT, ImageAnalyzerType.OBJECT_LOOKUP],
        aiController: this.visionImageAnalyzerController
      })
        .width('100%')
        .height('100%')
        .enableAnalyzer(true)
        .objectFit(ImageFit.Contain)
    }.width('100%').height('100%')
  }
}

stopObjectSearch

stopObjectSearch(): void

关闭视觉搜索功能。 如果当前在视觉搜索交互状态，则不支持关闭。

系统能力： SystemCapability.AI.VisionImageAnalyzer

设备行为差异： 该接口在PC/2in1上无效果，在其他设备类型中可正常调用。

起始版本： 5.0.0(12)

模型约束： 此接口仅可在Stage模型下使用。

示例：

import { visionImageAnalyzer } from '@kit.VisionKit';

@Entry
@Component
struct ImageDemo {
  private visionImageAnalyzerController: visionImageAnalyzer.VisionImageAnalyzerController =
    new visionImageAnalyzer.VisionImageAnalyzerController();
  stopObjectSearch() {
    this.visionImageAnalyzerController.stopObjectSearch();
  }
  build() {
    Stack() {
      // 此处图片需单独配置，添加到src/main/resources/base/media路径下
      Image($r('app.media.img'), {
        types: [ImageAnalyzerType.TEXT, ImageAnalyzerType.SUBJECT, ImageAnalyzerType.OBJECT_LOOKUP],
        aiController: this.visionImageAnalyzerController
      })
        .width('100%')
        .height('100%')
        .enableAnalyzer(true)
        .objectFit(ImageFit.Contain)
    }.width('100%').height('100%')
  }
}

setSubjectMenuVisibility

setSubjectMenuVisibility(visible: boolean): void

设置图像分割菜单状态。

系统能力： SystemCapability.AI.VisionImageAnalyzer

模型约束： 此接口仅可在Stage模型下使用。

起始版本： 5.0.1(13)

参数：

import { visionImageAnalyzer } from '@kit.VisionKit';

@Entry
@Component
struct ImageDemo {
  private visionImageAnalyzerController: visionImageAnalyzer.VisionImageAnalyzerController =
    new visionImageAnalyzer.VisionImageAnalyzerController();
  setSubjectMenuVisibility(visible: boolean) {
    this.visionImageAnalyzerController.setSubjectMenuVisibility(visible);
  }
  build() {
    Stack() {
      // 此处图片需单独配置，添加到src/main/resources/base/media路径下
      Image($r('app.media.img'), {
        types: [ImageAnalyzerType.TEXT, ImageAnalyzerType.SUBJECT, ImageAnalyzerType.OBJECT_LOOKUP],
        aiController: this.visionImageAnalyzerController
      })
        .width('100%')
        .height('100%')
        .enableAnalyzer(true)
        .objectFit(ImageFit.Contain)
    }.width('100%').height('100%')
  }
}

on(type: 'aiButtonStatusChange')

on(type: 'aiButtonStatusChange', callback: Callback<AIButtonStatus>): void

监听AIButton展示状态。使用callback异步回调。

系统能力： SystemCapability.AI.VisionImageAnalyzer

模型约束： 此接口仅可在Stage模型下使用。

起始版本： 5.0.0(12)

参数：

示例：

import { visionImageAnalyzer } from '@kit.VisionKit';

@Entry
@Component
struct ImageDemo {
  private visionImageAnalyzerController: visionImageAnalyzer.VisionImageAnalyzerController =
    new visionImageAnalyzer.VisionImageAnalyzerController();
  aboutToAppear(): void {
    this.visionImageAnalyzerController?.setAIButtonVisibility(true);
    this.visionImageAnalyzerController.on('aiButtonStatusChange', (aiButtonState: visionImageAnalyzer.AIButtonStatus) => {
      console.info('DEMO_TAG', `aiButtonStatusChange result: ${JSON.stringify(aiButtonState)}`);
    });
  }
  build() {
    Stack() {
      // 此处图片需单独配置，添加到src/main/resources/base/media路径下
      Image($r('app.media.img'), {
        types: [ImageAnalyzerType.TEXT, ImageAnalyzerType.SUBJECT, ImageAnalyzerType.OBJECT_LOOKUP],
        aiController: this.visionImageAnalyzerController
      })
        .width('100%')
        .height('100%')
        .enableAnalyzer(true)
        .objectFit(ImageFit.Contain)
    }.width('100%').height('100%')
  }
}

off(type: 'aiButtonStatusChange')

off(type: 'aiButtonStatusChange', callback?: Callback<AIButtonStatus>): void

取消监听AIButton展示状态。使用callback异步回调。

系统能力： SystemCapability.AI.VisionImageAnalyzer

模型约束： 此接口仅可在Stage模型下使用。

起始版本： 5.0.0(12)

参数：

示例：

import { visionImageAnalyzer } from '@kit.VisionKit';

@Entry
@Component
struct ImageDemo {
  private visionImageAnalyzerController: visionImageAnalyzer.VisionImageAnalyzerController =
    new visionImageAnalyzer.VisionImageAnalyzerController();
  aboutToAppear(): void {
    this.visionImageAnalyzerController?.setAIButtonVisibility(true);
    this.visionImageAnalyzerController.on('aiButtonStatusChange', (aiButtonState: visionImageAnalyzer.AIButtonStatus) => {
      console.info('DEMO_TAG', `aiButtonStatusChange result: ${JSON.stringify(aiButtonState)}`);
    });
  }
  aboutToDisappear(): void {
    this.visionImageAnalyzerController.off('aiButtonStatusChange');
  }
  build() {
    Stack() {
      // 此处图片需单独配置，添加到src/main/resources/base/media路径下
      Image($r('app.media.img'), {
        types: [ImageAnalyzerType.TEXT, ImageAnalyzerType.SUBJECT, ImageAnalyzerType.OBJECT_LOOKUP],
        aiController: this.visionImageAnalyzerController
      })
        .width('100%')
        .height('100%')
        .enableAnalyzer(true)
        .objectFit(ImageFit.Contain)
    }.width('100%').height('100%')
  }
}

on(type: 'imageAnalyzerVisibilityChange')

on(type: 'imageAnalyzerVisibilityChange', callback: Callback<ImageAnalyzerVisibility>): void

监听AI识图控件可见状态。使用callback异步回调。

系统能力： SystemCapability.AI.VisionImageAnalyzer

模型约束： 此接口仅可在Stage模型下使用。

起始版本： 5.0.0(12)

参数：

示例：

import { visionImageAnalyzer } from '@kit.VisionKit';

@Entry
@Component
struct ImageDemo {
  private visionImageAnalyzerController: visionImageAnalyzer.VisionImageAnalyzerController =
    new visionImageAnalyzer.VisionImageAnalyzerController();
  aboutToAppear(): void {
    this.visionImageAnalyzerController?.setAIButtonVisibility(true);
    this.visionImageAnalyzerController.on('imageAnalyzerVisibilityChange', (visibility: visionImageAnalyzer.ImageAnalyzerVisibility) => {
      console.info('DEMO_TAG', `imageAnalyzerVisibilityChange result: ${JSON.stringify(visibility)}`);
    });
  }
  aboutToDisappear(): void {
    this.visionImageAnalyzerController.off('imageAnalyzerVisibilityChange');
  }
  build() {
    Stack() {
      // 此处图片需单独配置，添加到src/main/resources/base/media路径下
      Image($r('app.media.img'), {
        types: [ImageAnalyzerType.TEXT, ImageAnalyzerType.SUBJECT, ImageAnalyzerType.OBJECT_LOOKUP],
        aiController: this.visionImageAnalyzerController
      })
        .width('100%')
        .height('100%')
        .enableAnalyzer(true)
        .objectFit(ImageFit.Contain)
    }.width('100%').height('100%')
  }
}

off(type: 'imageAnalyzerVisibilityChange')

off(type: 'imageAnalyzerVisibilityChange', callback?: Callback<ImageAnalyzerVisibility>): void

取消AI识图控件可见状态的监听。使用callback异步回调。

系统能力： SystemCapability.AI.VisionImageAnalyzer

模型约束： 此接口仅可在Stage模型下使用。

起始版本： 5.0.0(12)

参数：

示例：

import { visionImageAnalyzer } from '@kit.VisionKit';

@Entry
@Component
struct ImageDemo {
  private visionImageAnalyzerController: visionImageAnalyzer.VisionImageAnalyzerController =
    new visionImageAnalyzer.VisionImageAnalyzerController();
  aboutToAppear(): void {
    this.visionImageAnalyzerController?.setAIButtonVisibility(true);
    this.visionImageAnalyzerController.on('imageAnalyzerVisibilityChange', (visibility: visionImageAnalyzer.ImageAnalyzerVisibility) => {
      console.info('DEMO_TAG', `imageAnalyzerVisibilityChange result: ${JSON.stringify(visibility)}`);
    });
  }
  aboutToDisappear(): void {
    this.visionImageAnalyzerController.off('imageAnalyzerVisibilityChange');
  }
  build() {
    Stack() {
      // 此处图片需单独配置，添加到src/main/resources/base/media路径下
      Image($r('app.media.img'), {
        types: [ImageAnalyzerType.TEXT, ImageAnalyzerType.SUBJECT, ImageAnalyzerType.OBJECT_LOOKUP],
        aiController: this.visionImageAnalyzerController
      })
        .width('100%')
        .height('100%')
        .enableAnalyzer(true)
        .objectFit(ImageFit.Contain)
    }.width('100%').height('100%')
  }
}

on(type: 'textAnalysis')

on(type: 'textAnalysis', callback: Callback<string>): void

监听文字分析结果。默认在首次长按图片文本时触发文本分析，PC/2in1是在图片首次加载时触发文本分析。使用callback异步回调。

系统能力： SystemCapability.AI.VisionImageAnalyzer

模型约束： 此接口仅可在Stage模型下使用。

起始版本： 5.0.0(12)

参数：

示例：

import { visionImageAnalyzer } from '@kit.VisionKit';

@Entry
@Component
struct ImageDemo {
  private visionImageAnalyzerController: visionImageAnalyzer.VisionImageAnalyzerController =
    new visionImageAnalyzer.VisionImageAnalyzerController();
  aboutToAppear(): void {
    this.visionImageAnalyzerController.on('textAnalysis', (text: string) => {
      console.info('DEMO_TAG', `textAnalysis result: ${JSON.stringify(text)}`);
    });
  }
  aboutToDisappear(): void {
    this.visionImageAnalyzerController.off('textAnalysis');
  }
  build() {
    Stack() {
      // 此处图片需单独配置，添加到src/main/resources/base/media路径下
      Image($r('app.media.img'), {
        types: [ImageAnalyzerType.TEXT, ImageAnalyzerType.SUBJECT, ImageAnalyzerType.OBJECT_LOOKUP],
        aiController: this.visionImageAnalyzerController
      })
        .width('100%')
        .height('100%')
        .enableAnalyzer(true)
        .objectFit(ImageFit.Contain)
    }.width('100%').height('100%')
  }
}

off(type: 'textAnalysis')

off(type: 'textAnalysis', callback?: Callback<string>): void

取消文字分析结果的监听。使用callback异步回调。

系统能力： SystemCapability.AI.VisionImageAnalyzer

模型约束： 此接口仅可在Stage模型下使用。

起始版本： 5.0.0(12)

参数：

示例：

import { visionImageAnalyzer } from '@kit.VisionKit';

@Entry
@Component
struct ImageDemo {
  private visionImageAnalyzerController: visionImageAnalyzer.VisionImageAnalyzerController =
    new visionImageAnalyzer.VisionImageAnalyzerController();
  aboutToAppear(): void {
    this.visionImageAnalyzerController.on('textAnalysis', (text: string) => {
      console.info('DEMO_TAG', `textAnalysis result: ${JSON.stringify(text)}`);
    })
  }
  aboutToDisappear(): void {
    this.visionImageAnalyzerController.off('textAnalysis');
  }
  build() {
    Stack() {
      // 此处图片需单独配置，添加到src/main/resources/base/media路径下
      Image($r('app.media.img'), {
        types: [ImageAnalyzerType.TEXT, ImageAnalyzerType.SUBJECT, ImageAnalyzerType.OBJECT_LOOKUP],
        aiController: this.visionImageAnalyzerController
      })
        .width('100%')
        .height('100%')
        .enableAnalyzer(true)
        .objectFit(ImageFit.Contain)
    }.width('100%').height('100%')
  }
}

on(type: 'selectedTextChange')

on(type: 'selectedTextChange', callback: Callback<string>): void

监听文字选中结果。使用callback异步回调。

系统能力： SystemCapability.AI.VisionImageAnalyzer

模型约束： 此接口仅可在Stage模型下使用。

起始版本： 5.0.0(12)

参数：

示例：

import { visionImageAnalyzer } from '@kit.VisionKit';

@Entry
@Component
struct ImageDemo {
  private visionImageAnalyzerController: visionImageAnalyzer.VisionImageAnalyzerController =
    new visionImageAnalyzer.VisionImageAnalyzerController();
  aboutToAppear(): void {
    this.visionImageAnalyzerController.on('selectedTextChange', (selectedText: string) => {
      console.info('DEMO_TAG', `selectedTextChange result: ${JSON.stringify(selectedText)}`);
    });
  }
  aboutToDisappear(): void {
    this.visionImageAnalyzerController.off('selectedTextChange');
  }
  build() {
    Stack() {
      // 此处图片需单独配置，添加到src/main/resources/base/media路径下
      Image($r('app.media.img'), {
        types: [ImageAnalyzerType.TEXT, ImageAnalyzerType.SUBJECT, ImageAnalyzerType.OBJECT_LOOKUP],
        aiController: this.visionImageAnalyzerController
      })
        .width('100%')
        .height('100%')
        .enableAnalyzer(true)
        .objectFit(ImageFit.Contain)
    }.width('100%').height('100%')
  }
}

off(type: 'selectedTextChange')

off(type: 'selectedTextChange', callback?: Callback<string>): void

取消文字选中结果的监听。使用callback异步回调。

系统能力： SystemCapability.AI.VisionImageAnalyzer

模型约束： 此接口仅可在Stage模型下使用。

起始版本： 5.0.0(12)

参数：

示例：

import { visionImageAnalyzer } from '@kit.VisionKit';

@Entry
@Component
struct ImageDemo {
  private visionImageAnalyzerController: visionImageAnalyzer.VisionImageAnalyzerController =
    new visionImageAnalyzer.VisionImageAnalyzerController();
  aboutToAppear(): void {
    this.visionImageAnalyzerController.on('selectedTextChange', (selectedText: string) => {
      console.info('DEMO_TAG', `selectedTextChange result: ${JSON.stringify(selectedText)}`);
    });
  }
  aboutToDisappear(): void {
    this.visionImageAnalyzerController.off('selectedTextChange');
  }
  build() {
    Stack() {
      // 此处图片需单独配置，添加到src/main/resources/base/media路径下
      Image($r('app.media.img'), {
        types: [ImageAnalyzerType.TEXT, ImageAnalyzerType.SUBJECT, ImageAnalyzerType.OBJECT_LOOKUP],
        aiController: this.visionImageAnalyzerController
      })
        .width('100%')
        .height('100%')
        .enableAnalyzer(true)
        .objectFit(ImageFit.Contain)
    }.width('100%').height('100%')
  }
}

on(type: 'subjectAnalysis')

on(type: 'subjectAnalysis', callback: Callback<Subject[]>): void

监听主体分析结果，返回所有主体信息。使用callback异步回调。

系统能力： SystemCapability.AI.VisionImageAnalyzer

模型约束： 此接口仅可在Stage模型下使用。

起始版本： 5.0.0(12)

参数：

示例：

import { visionImageAnalyzer } from '@kit.VisionKit';

@Entry
@Component
struct ImageDemo {
  private visionImageAnalyzerController: visionImageAnalyzer.VisionImageAnalyzerController =
    new visionImageAnalyzer.VisionImageAnalyzerController();
  aboutToAppear(): void {
    this.visionImageAnalyzerController.on('subjectAnalysis', (subjects: visionImageAnalyzer.Subject[]) => {
      console.info('DEMO_TAG', `subjectAnalysis result: ${JSON.stringify(subjects)}`);
    });
  }
  aboutToDisappear(): void {
    this.visionImageAnalyzerController.off('subjectAnalysis');
  }
  build() {
    Stack() {
      // 此处图片需单独配置，添加到src/main/resources/base/media路径下
      Image($r('app.media.img'), {
        types: [ImageAnalyzerType.TEXT, ImageAnalyzerType.SUBJECT, ImageAnalyzerType.OBJECT_LOOKUP],
        aiController: this.visionImageAnalyzerController
      })
        .width('100%')
        .height('100%')
        .enableAnalyzer(true)
        .objectFit(ImageFit.Contain)
    }.width('100%').height('100%')
  }
}

off(type: 'subjectAnalysis')

off(type: 'subjectAnalysis', callback?: Callback<Subject[]>): void

取消主体分析结果的监听。使用callback异步回调。

系统能力： SystemCapability.AI.VisionImageAnalyzer

模型约束： 此接口仅可在Stage模型下使用。

起始版本： 5.0.0(12)

参数：

示例：

import { visionImageAnalyzer } from '@kit.VisionKit';

@Entry
@Component
struct ImageDemo {
  private visionImageAnalyzerController: visionImageAnalyzer.VisionImageAnalyzerController =
    new visionImageAnalyzer.VisionImageAnalyzerController();
  aboutToAppear(): void {
    this.visionImageAnalyzerController.on('subjectAnalysis', (subjects: visionImageAnalyzer.Subject[]) => {
      console.info('DEMO_TAG', `subjectAnalysis result: ${JSON.stringify(subjects)}`);
    });
  }
  aboutToDisappear(): void {
    this.visionImageAnalyzerController.off('subjectAnalysis');
  }
  build() {
    Stack() {
      // 此处图片需单独配置，添加到src/main/resources/base/media路径下
      Image($r('app.media.img'), {
        types: [ImageAnalyzerType.TEXT, ImageAnalyzerType.SUBJECT, ImageAnalyzerType.OBJECT_LOOKUP],
        aiController: this.visionImageAnalyzerController
      })
        .width('100%')
        .height('100%')
        .enableAnalyzer(true)
        .objectFit(ImageFit.Contain)
    }.width('100%').height('100%')
  }
}

on(type: 'selectedSubjectsChange')

on(type: 'selectedSubjectsChange', callback: Callback<Subject[]>): void

监听选中的主体。使用callback异步回调。

系统能力： SystemCapability.AI.VisionImageAnalyzer

模型约束： 此接口仅可在Stage模型下使用。

起始版本： 5.0.0(12)

参数：

示例：

import { visionImageAnalyzer } from '@kit.VisionKit';

@Entry
@Component
struct ImageDemo {
  private visionImageAnalyzerController: visionImageAnalyzer.VisionImageAnalyzerController =
    new visionImageAnalyzer.VisionImageAnalyzerController();
  aboutToAppear(): void {
    this.visionImageAnalyzerController.on('selectedSubjectsChange', (subjects: visionImageAnalyzer.Subject[]) => {
      console.info('DEMO_TAG', `selectedSubjectsChange result: ${JSON.stringify(subjects)}`);
    });
  }
  aboutToDisappear(): void {
    this.visionImageAnalyzerController.off('selectedSubjectsChange');
  }
  build() {
    Stack() {
      // 此处图片需单独配置，添加到src/main/resources/base/media路径下
      Image($r('app.media.img'), {
        types: [ImageAnalyzerType.TEXT, ImageAnalyzerType.SUBJECT, ImageAnalyzerType.OBJECT_LOOKUP],
        aiController: this.visionImageAnalyzerController
      })
        .width('100%')
        .height('100%')
        .enableAnalyzer(true)
        .objectFit(ImageFit.Contain)
    }.width('100%').height('100%')
  }
}

off(type: 'selectedSubjectsChange')

off(type: 'selectedSubjectsChange', callback?: Callback<Subject[]>): void

取消对选中主体的监听。使用callback异步回调。

系统能力： SystemCapability.AI.VisionImageAnalyzer

模型约束： 此接口仅可在Stage模型下使用。

起始版本： 5.0.0(12)

参数：

示例：

import { visionImageAnalyzer } from '@kit.VisionKit';

@Entry
@Component
struct ImageDemo {
  private visionImageAnalyzerController: visionImageAnalyzer.VisionImageAnalyzerController =
    new visionImageAnalyzer.VisionImageAnalyzerController();
  aboutToAppear(): void {
    this.visionImageAnalyzerController.on('selectedSubjectsChange', (subjects: visionImageAnalyzer.Subject[]) => {
      console.info('DEMO_TAG', `selectedSubjectsChange result: ${JSON.stringify(subjects)}`);
    });
  }
  aboutToDisappear(): void {
    this.visionImageAnalyzerController.off('selectedSubjectsChange');
  }
  build() {
    Stack() {
      // 此处图片需单独配置，添加到src/main/resources/base/media路径下
      Image($r('app.media.img'), {
        types: [ImageAnalyzerType.TEXT, ImageAnalyzerType.SUBJECT, ImageAnalyzerType.OBJECT_LOOKUP],
        aiController: this.visionImageAnalyzerController
      })
        .width('100%')
        .height('100%')
        .enableAnalyzer(true)
        .objectFit(ImageFit.Contain)
    }.width('100%').height('100%')
  }
}

on(type: 'objectSearchPanelVisibilityChange')

on(type: 'objectSearchPanelVisibilityChange', callback: Callback<ObjectSearchPanelVisibility>): void

监听图片搜索事件。

系统能力： SystemCapability.AI.VisionImageAnalyzer

模型约束： 此接口仅可在Stage模型下使用。

起始版本： 5.0.1(13)

参数：

import { visionImageAnalyzer } from '@kit.VisionKit';

@Entry
@Component
struct ImageDemo {
  private visionImageAnalyzerController: visionImageAnalyzer.VisionImageAnalyzerController =
    new visionImageAnalyzer.VisionImageAnalyzerController();
  aboutToAppear(): void {
    this.visionImageAnalyzerController.on('objectSearchPanelVisibilityChange', (status: visionImageAnalyzer.ObjectSearchPanelVisibility) => {
      console.info('DEMO_TAG', `objectSearchPanelVisibilityChange result: ${JSON.stringify(status)}`);
    });
  }
  aboutToDisappear(): void {
    this.visionImageAnalyzerController.off('objectSearchPanelVisibilityChange');
  }
  build() {
    Stack() {
      // 此处图片需单独配置，添加到src/main/resources/base/media路径下
      Image($r('app.media.img'), {
        types: [ImageAnalyzerType.TEXT, ImageAnalyzerType.SUBJECT, ImageAnalyzerType.OBJECT_LOOKUP],
        aiController: this.visionImageAnalyzerController
      })
        .width('100%')
        .height('100%')
        .enableAnalyzer(true)
        .objectFit(ImageFit.Contain)
    }.width('100%').height('100%')
  }
}

off(type: 'objectSearchPanelVisibilityChange')

off(type: 'objectSearchPanelVisibilityChange', callback?: Callback<ObjectSearchPanelVisibility>): void

取消图片搜索事件的监听。使用callback异步回调。

系统能力： SystemCapability.AI.VisionImageAnalyzer

模型约束： 此接口仅可在Stage模型下使用。

起始版本： 5.0.1(13)

参数：

import { visionImageAnalyzer } from '@kit.VisionKit';

@Entry
@Component
struct ImageDemo {
  private visionImageAnalyzerController: visionImageAnalyzer.VisionImageAnalyzerController =
    new visionImageAnalyzer.VisionImageAnalyzerController();
  aboutToAppear(): void {
    this.visionImageAnalyzerController.on('objectSearchPanelVisibilityChange', (status: visionImageAnalyzer.ObjectSearchPanelVisibility) => {
      console.info('DEMO_TAG', `objectSearchPanelVisibilityChange result: ${JSON.stringify(status)}`);
    });
  }
  aboutToDisappear(): void {
    this.visionImageAnalyzerController.off('objectSearchPanelVisibilityChange');
  }
  build() {
    Stack() {
      // 此处图片需单独配置，添加到src/main/resources/base/media路径下
      Image($r('app.media.img'), {
        types: [ImageAnalyzerType.TEXT, ImageAnalyzerType.SUBJECT, ImageAnalyzerType.OBJECT_LOOKUP],
        aiController: this.visionImageAnalyzerController
      })
        .width('100%')
        .height('100%')
        .enableAnalyzer(true)
        .objectFit(ImageFit.Contain)
    }.width('100%').height('100%')
  }
}

on(type: 'cursorMoveInText')

on(type: 'cursorMoveInText', callback: Callback<void>): void

监听光标移入图片内文字区域事件。使用callback异步回调。

系统能力： SystemCapability.AI.VisionImageAnalyzer

模型约束： 此接口仅可在Stage模型下使用。

起始版本： 5.1.0(18)

参数：

import { visionImageAnalyzer } from '@kit.VisionKit';

@Entry
@Component
struct ImageDemo {
  private visionImageAnalyzerController: visionImageAnalyzer.VisionImageAnalyzerController =
    new visionImageAnalyzer.VisionImageAnalyzerController();
  aboutToAppear(): void {
    this.visionImageAnalyzerController.on('cursorMoveInText', () => {
      console.info('DEMO_TAG', `cursorMoveInText on`);
    });
  }
  aboutToDisappear(): void {
    this.visionImageAnalyzerController.off('cursorMoveInText');
  }
  build() {
    Stack() {
      // 此处图片需单独配置，添加到src/main/resources/base/media路径下
      Image($r('app.media.img'), {
        types: [ImageAnalyzerType.TEXT, ImageAnalyzerType.SUBJECT, ImageAnalyzerType.OBJECT_LOOKUP],
        aiController: this.visionImageAnalyzerController
      })
        .width('100%')
        .height('100%')
        .enableAnalyzer(true)
        .objectFit(ImageFit.Contain)
    }.width('100%').height('100%')
  }
}

off(type: 'cursorMoveInText')

off(type: 'cursorMoveInText', callback?: Callback<void>): void

取消光标移入图片内文字区域事件的监听。使用callback异步回调。

系统能力： SystemCapability.AI.VisionImageAnalyzer

模型约束： 此接口仅可在Stage模型下使用。

起始版本： 5.1.0(18)

参数：

import { visionImageAnalyzer } from '@kit.VisionKit';

@Entry
@Component
struct ImageDemo {
  private visionImageAnalyzerController: visionImageAnalyzer.VisionImageAnalyzerController =
    new visionImageAnalyzer.VisionImageAnalyzerController();
  aboutToAppear(): void {
    this.visionImageAnalyzerController.on('cursorMoveInText', () => {
      console.info('DEMO_TAG', `cursorMoveInText on`);
    });
  }
  aboutToDisappear(): void {
    this.visionImageAnalyzerController.off('cursorMoveInText');
  }
  build() {
    Stack() {
      // 此处图片需单独配置，添加到src/main/resources/base/media路径下
      Image($r('app.media.img'), {
        types: [ImageAnalyzerType.TEXT, ImageAnalyzerType.SUBJECT, ImageAnalyzerType.OBJECT_LOOKUP],
        aiController: this.visionImageAnalyzerController
      })
        .width('100%')
        .height('100%')
        .enableAnalyzer(true)
        .objectFit(ImageFit.Contain)
    }.width('100%').height('100%')
  }
}

on(type: 'cursorMoveOutText')

on(type: 'cursorMoveOutText', callback: Callback<void>): void

监听光标移出图片内文字区域事件。使用callback异步回调。

系统能力： SystemCapability.AI.VisionImageAnalyzer

模型约束： 此接口仅可在Stage模型下使用。

起始版本： 5.1.0(18)

参数：

import { visionImageAnalyzer } from '@kit.VisionKit';

@Entry
@Component
struct ImageDemo {
  private visionImageAnalyzerController: visionImageAnalyzer.VisionImageAnalyzerController =
    new visionImageAnalyzer.VisionImageAnalyzerController();
  aboutToAppear(): void {
    this.visionImageAnalyzerController.on('cursorMoveOutText', () => {
      console.info('DEMO_TAG', `cursorMoveOutText on`);
    });
  }
  aboutToDisappear(): void {
    this.visionImageAnalyzerController.off('cursorMoveOutText');
  }
  build() {
    Stack() {
      // 此处图片需单独配置，添加到src/main/resources/base/media路径下
      Image($r('app.media.img'), {
        types: [ImageAnalyzerType.TEXT, ImageAnalyzerType.SUBJECT, ImageAnalyzerType.OBJECT_LOOKUP],
        aiController: this.visionImageAnalyzerController
      })
        .width('100%')
        .height('100%')
        .enableAnalyzer(true)
        .objectFit(ImageFit.Contain)
    }.width('100%').height('100%')
  }
}

off(type: 'cursorMoveOutText')

off(type: 'cursorMoveOutText', callback?: Callback<void>): void

取消光标移出图片内文字区域事件的监听。使用callback异步回调。

系统能力： SystemCapability.AI.VisionImageAnalyzer

模型约束： 此接口仅可在Stage模型下使用。

起始版本： 5.1.0(18)

参数：

import { visionImageAnalyzer } from '@kit.VisionKit';

@Entry
@Component
struct ImageDemo {
  private visionImageAnalyzerController: visionImageAnalyzer.VisionImageAnalyzerController =
    new visionImageAnalyzer.VisionImageAnalyzerController();
  aboutToAppear(): void {
    this.visionImageAnalyzerController.on('cursorMoveOutText', () => {
      console.info('DEMO_TAG', `cursorMoveOutText on`);
    });
  }
  aboutToDisappear(): void {
    this.visionImageAnalyzerController.off('cursorMoveOutText');
  }
  build() {
    Stack() {
      // 此处图片需单独配置，添加到src/main/resources/base/media路径下
      Image($r('app.media.img'), {
        types: [ImageAnalyzerType.TEXT, ImageAnalyzerType.SUBJECT, ImageAnalyzerType.OBJECT_LOOKUP],
        aiController: this.visionImageAnalyzerController
      })
        .width('100%')
        .height('100%')
        .enableAnalyzer(true)
        .objectFit(ImageFit.Contain)
    }.width('100%').height('100%')
  }
}

on(type: 'analyzerFailed')

on(type: 'analyzerFailed', callback: ErrorCallback): void

监听AI识图的异常场景。使用callback异步回调。

系统能力： SystemCapability.AI.VisionImageAnalyzer

模型约束： 此接口仅可在Stage模型下使用。

起始版本： 5.0.0(12)

参数：

错误码：

以下错误码的详细介绍请参见通用错误码和ArkTS API错误码。

示例：

import { visionImageAnalyzer } from '@kit.VisionKit';
import { BusinessError } from '@kit.BasicServicesKit';

@Entry
@Component
struct ImageDemo {
  private visionImageAnalyzerController: visionImageAnalyzer.VisionImageAnalyzerController =
    new visionImageAnalyzer.VisionImageAnalyzerController();
  aboutToAppear(): void {
    this.visionImageAnalyzerController.on('analyzerFailed', (error: BusinessError) => {
      console.error('DEMO_TAG', `Failed to analyzer image. Code: ${error.code}, message: ${error.message}`);
    });
  }
  aboutToDisappear(): void {
    this.visionImageAnalyzerController.off('analyzerFailed');
  }
  build() {
    Stack() {
      // 此处图片需单独配置，添加到src/main/resources/base/media路径下
      Image($r('app.media.img'), {
        types: [ImageAnalyzerType.TEXT, ImageAnalyzerType.SUBJECT, ImageAnalyzerType.OBJECT_LOOKUP],
        aiController: this.visionImageAnalyzerController
      })
        .width('100%')
        .height('100%')
        .enableAnalyzer(true)
        .objectFit(ImageFit.Contain)
    }.width('100%').height('100%')
  }
}

off(type: 'analyzerFailed')

off(type: 'analyzerFailed', callback?: ErrorCallback): void

取消AI识图异常场景的监听。使用callback异步回调。

系统能力： SystemCapability.AI.VisionImageAnalyzer

模型约束： 此接口仅可在Stage模型下使用。

起始版本： 5.0.0(12)

参数：

错误码：

以下错误码的详细介绍请参见通用错误码和ArkTS API错误码。

示例：

import { visionImageAnalyzer } from '@kit.VisionKit';
import { BusinessError } from '@kit.BasicServicesKit';

@Entry
@Component
struct ImageDemo {
  private visionImageAnalyzerController: visionImageAnalyzer.VisionImageAnalyzerController =
    new visionImageAnalyzer.VisionImageAnalyzerController();
  aboutToAppear(): void {
    this.visionImageAnalyzerController.on('analyzerFailed', (error: BusinessError) => {
      console.error('DEMO_TAG', `Failed to analyzer image. Code: ${error.code}, message: ${error.message}`);
    });
  }
  aboutToDisappear(): void {
    this.visionImageAnalyzerController.off('analyzerFailed');
  }
  build() {
    Stack() {
      // 此处图片需单独配置，添加到src/main/resources/base/media路径下
      Image($r('app.media.img'), {
        types: [ImageAnalyzerType.TEXT, ImageAnalyzerType.SUBJECT, ImageAnalyzerType.OBJECT_LOOKUP],
        aiController: this.visionImageAnalyzerController
      })
        .width('100%')
        .height('100%')
        .enableAnalyzer(true)
        .objectFit(ImageFit.Contain)
    }.width('100%').height('100%')
  }
}