VisionBase（Core Vision Kit基类）-ArkTS API-Core Vision Kit（基础视觉服务）-AI

visionBase作为一个基础的视觉能力库，封装基本资源对象，视觉能力场景常用对象，数据结构，常用方法。减少冗余代码书写简化功能接口使用，而不必重复“造轮子”。开发者可以将它理解为一个“工具箱”，里面装着一些常用的“工具”，利用visionBase基类，会更高效、更标准地实现各自的功能。visionBase提供了Core Vision Kit AI能力所需的基础设施，如数据结构、接口模型、生命周期管理等。

导入模块

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

SceneMode

图片要素的枚举类。

系统能力：SystemCapability.AI.Vision.VisionBase

起始版本：5.0.0(12)

展开

名称	值	说明
FOREGROUND	1	（默认）前台模式。
BACKGROUND	2	后台模式。

ImageData

待识别的视觉信息对象。

系统能力：SystemCapability.AI.Vision.VisionBase

起始版本：5.0.0(12)

展开

名称	类型	只读	可选	说明
pixelMap	image.PixelMap	否	否	待识别的图片。

InputData

多个图像数据组成的数组。

系统能力：SystemCapability.AI.Vision.VisionBase

起始版本：5.0.0(12)

展开

类型	说明
ImageData \| ImageData[]	待识别的图片数组。可输入一个或多个图片。

BoundingBox

视觉AI能力的内切框。

系统能力：SystemCapability.AI.Vision.VisionBase

起始版本：5.0.0(12)

展开

名称	类型	只读	可选	说明
left	number	否	否	边界框左上角的x坐标。
top	number	否	否	边界框左上角的y坐标。
height	number	否	否	边界框高度，单位为像素。
width	number	否	否	边界框宽度，单位为像素。

Point

二维平面上的点。

系统能力：SystemCapability.AI.Vision.VisionBase

起始版本：5.0.0(12)

展开

名称	类型	只读	可选	说明
x	number	否	否	点的横坐标。
y	number	否	否	点的纵坐标。

Orientation

表示三维平面上的点。

系统能力：SystemCapability.AI.Vision.VisionBase

起始版本：5.0.0(12)

展开

名称	类型	只读	可选	说明
yaw	number	否	否	表示绕垂直轴（Y轴）旋转的角度，也称为“偏航角”，决定了物体在水平面上的朝向。取值范围[-180,180]。
pitch	number	否	否	表示绕水平轴（X轴）旋转的角度，也称为“俯仰角”，决定了物体在垂直平面上的朝向。取值范围[-180,180]。
roll	number	否	否	表示绕前后轴（Z轴）旋转的角度，也称为“翻滚角”，决定了物体在前后方向上的朝向。取值范围[-180,180]。

Request

入参变量的基类。

系统能力：SystemCapability.AI.Vision.VisionBase

起始版本：5.0.0(12)

展开

名称	类型	只读	可选	说明
inputData	InputData	否	否	待识别的图片（数组）。可以为一个对象也可以为对象数组。
scene	SceneMode	否	是	请求的前后台模式。该参数为预留字段，暂未实现。
requestId	string	否	是	请求的标识。用于开发者跟踪和管理自己的请求。该参数为预留字段，暂未实现。

名称

类型

只读

可选

说明

inputData

InputData

否

待识别的图片（数组）。可以为一个对象也可以为对象数组。

scene

SceneMode

否

是

请求的前后台模式。

该参数为预留字段，暂未实现。

requestId

string

否

是

请求的标识。用于开发者跟踪和管理自己的请求。

该参数为预留字段，暂未实现。

Response

响应基类，作为能力请求的返回结果。

系统能力：SystemCapability.AI.Vision.VisionBase

起始版本：5.0.0(12)

展开

名称	类型	只读	可选	说明
requestId	string	否	是	请求的唯一标识。开发者可用来跟踪和管理自己的请求。

Analyzer

Analyzer基类，充当能力引擎。

系统能力：SystemCapability.AI.Vision.VisionBase

起始版本：5.0.0(12)

destroy

destroy(): Promise<void>

释放接口。可以用于释放多种视觉能力的引擎能力。返回一个空的Promise对象。（示例：ObjectDetection.destroy）

系统能力：SystemCapability.AI.Vision.VisionBase

起始版本：5.0.0(12)

返回值：

展开

类型	说明
Promise<void>	Promise对象，释放接口无返回值。