skeletonDetection（骨骼点检测）

导入模块

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

SkeletonPointType

骨骼点类型的枚举类。

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

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

起始版本： 5.0.0(12)

SkeletonPoint

详细的骨骼点信息。

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

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

起始版本： 5.0.0(12)

Skeleton

用于描述一个完整的人体骨骼检测结果。包括总体置信度和人体在图像中的大致位置，还详细列出了各个关键点的位置和类型。

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

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

起始版本： 5.0.0(12)

SkeletonDetectionResponse

用于表示一次骨骼点检测的完整结果。作为骨骼点检测的顶层输出，封装了一次检测的全部结果。继承自visionBase的Response。

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

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

起始版本： 5.0.0(12)

SkeletonDetector

定义骨骼点检测的接口和基本结构。继承自visionBase.Analyzer类。它有以下功能函数：

• constructor()：私有构造函数，不能直接通过new关键字实例化SkeletonDetector，必须通过create()静态方法来创建实例。

• create(): Promise<SkeletonDetector>：静态方法，用于创建SkeletonDetector的实例。使用Promise异步回调。

• process(request: visionBase.Request): Promise<SkeletonDetectionResponse>：实例方法，用于处理骨骼点检测请求。使用Promise异步回调。

• destroy(): Promise<void>：实例方法，用于销毁骨骼点检测进程，使用Promise异步回调。

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

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

起始版本： 5.0.0(12)

create

static create(): Promise<SkeletonDetector>

骨骼点检测的初始化接口。使用Promise异步回调。

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

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

起始版本： 5.0.0(12)

返回值：

错误码：

以下错误码的详细介绍请参见Core Vision Kit错误码。

示例：

import { skeletonDetection } from '@kit.CoreVisionKit';
import { hilog } from '@kit.PerformanceAnalysisKit';

async function createAndDestroyDetector() {
  try {
    const detector = await skeletonDetection.SkeletonDetector.create();
    if (detector) {
      hilog.info(0x0000, 'skeletonDetectionSample', 'Skeleton detector created successfully');
    } else {
      hilog.error(0x0000, 'skeletonDetectionSample', 'Failed to create Skeleton detector');
      return;
    }
    // 使用 detector 进行一些操作
    // ...

    // 完成后销毁 detector
    if (detector) {
      await detector.destroy();
      hilog.info(0x0000, 'skeletonDetectionSample', 'Skeleton detector destroyed successfully');
    } else {
      hilog.error(0x0000, 'skeletonDetectionSample', 'Failed to destroy Skeleton detector');
    }
  } catch (err) {
    hilog.error(0x0000, 'skeletonDetectionSample', `Skeleton detector error: ${err}`);
  }
}

@Entry
@Component
struct Page {

  build() {
    Column(){
      Button('createAndDestroyDetector').onClick(() => {
        void createAndDestroyDetector();
      })
    }
  }
}

destroy

destroy(): Promise<void>

销毁骨骼点检测能力。使用Promise异步回调。

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

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

起始版本： 5.0.0(12)

返回值：

示例：

import { skeletonDetection } from '@kit.CoreVisionKit';
import { hilog } from '@kit.PerformanceAnalysisKit';

async function createAndDestroyDetector() {
  try {
    const detector = await skeletonDetection.SkeletonDetector.create();
    if (detector) {
      hilog.info(0x0000, 'skeletonDetectionSample', 'Skeleton detector created successfully');
    } else {
      hilog.error(0x0000, 'skeletonDetectionSample', 'Failed to create Skeleton detector');
      return;
    }
    // 使用 detector 进行一些操作
    // ...

    // 完成后销毁 detector
    if (detector) {
      await detector.destroy();
      hilog.info(0x0000, 'skeletonDetectionSample', 'Skeleton detector destroyed successfully');
    } else {
      hilog.error(0x0000, 'skeletonDetectionSample', 'Failed to destroy Skeleton detector');
    }
  } catch (err) {
    hilog.error(0x0000, 'skeletonDetectionSample', `Skeleton detector error: ${err}`);
  }
}

@Entry
@Component
struct Page {

  build() {
    Column(){
      Button('createAndDestroyDetector').onClick(() => {
        void createAndDestroyDetector();
      })
    }
  }
}

process

process(request: visionBase.Request): Promise<SkeletonDetectionResponse>

创建骨骼点检测实例并执行骨骼点检测。使用Promise异步回调。

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

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

起始版本： 5.0.0(12)

参数：

返回值：

错误码：

以下错误码的详细介绍请参见Core Vision Kit错误码。

示例：

import { skeletonDetection, visionBase } from '@kit.CoreVisionKit';
import { image } from '@kit.ImageKit';
import { hilog } from '@kit.PerformanceAnalysisKit';
import { fileIo } from '@kit.CoreFileKit';
import { photoAccessHelper } from '@kit.MediaLibraryKit';

async function skeletonDetectTest() {
  try {
    let imageSource: image.ImageSource | undefined = undefined;
    let chooseImage: image.PixelMap | undefined = undefined;

    // 通过图库选择一张图片
    let photoSelectOptions = new photoAccessHelper.PhotoSelectOptions();
    photoSelectOptions.MIMEType = photoAccessHelper.PhotoViewMIMETypes.IMAGE_TYPE;
    photoSelectOptions.maxSelectNumber = 1;
    let photoPicker: photoAccessHelper.PhotoViewPicker = new photoAccessHelper.PhotoViewPicker();
    let photoSelectResult = await photoPicker.select(photoSelectOptions);
    let uri = photoSelectResult.photoUris[0];
    if (uri === undefined) {
      hilog.info(0x0000, 'skeletonDetectionSample', 'uri is undefined');
      return;
    }

    // 将图片转换为PixelMap
    let file = await fileIo.open(uri, fileIo.OpenMode.READ_ONLY);
    imageSource = image.createImageSource(file.fd);
    chooseImage = await imageSource.createPixelMap();
    hilog.info(0x0000, 'skeletonDetectionSample', 'chooseImage:', chooseImage);
    if (!chooseImage) {
      return;
    }

    // 创建检测器
    let detector = await skeletonDetection.SkeletonDetector.create();
    hilog.info(0x0000, 'skeletonDetectionSample', 'Skeleton detector created successfully');

    // 调用骨骼检测接口
    let request: visionBase.Request = {
      inputData: { pixelMap: chooseImage },
      scene: visionBase.SceneMode.FOREGROUND
    };
    let response: skeletonDetection.SkeletonDetectionResponse = await detector.process(request);

    if (response.skeletons.length === 0) {
      hilog.info(0x0000, 'skeletonDetectionSample', 'No skeletons detected in the image.');
    } else {
      hilog.info(0x0000, 'skeletonDetectionSample', `Detected ${response.skeletons.length} skeletons.`);
      response.skeletons.forEach((skeleton, index) => {
        hilog.info(0x0000, 'skeletonDetectionSample', `  Score: ${skeleton.score}`);
        hilog.info(0x0000, 'skeletonDetectionSample', `  Number of points: ${skeleton.points.length}`);
        skeleton.points.forEach(point => {
          hilog.info(0x0000, 'skeletonDetectionSample', `    ${skeletonDetection.SkeletonPointType[point.type]}: (${point.point.x}, ${point.point.y}), Score: ${point.score}`);
        });
      });
    }

    // 清理资源
    if (chooseImage && imageSource) {
      void chooseImage.release();
      void imageSource.release();
    }
    if (file) {
      await fileIo.close(file);
    }
    if (detector) {
      await detector.destroy();
      hilog.info(0x0000, 'skeletonDetectionSample', 'Skeleton detector destroyed successfully');
    }
  } catch (err) {
    hilog.error(0x0000, 'skeletonDetectionSample', `Skeleton detection error: ${err}`);
  }
}

@Entry
@Component
struct Page {

  build() {
    Column(){
      Button('Button').onClick(() => {
        // 调用函数
        void skeletonDetectTest();
      })
    }
  }
}