<!--
{
  "availability" : [
    "iOS: 14.0.0 -",
    "iPadOS: 14.0.0 -",
    "macCatalyst: 14.0.0 -",
    "macOS: 11.0.0 -",
    "tvOS: 14.0.0 -",
    "visionOS: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Vision",
  "identifier" : "/documentation/Vision/VNDetectHumanHandPoseRequest",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "Vision"
    ],
    "preciseIdentifier" : "c:objc(cs)VNDetectHumanHandPoseRequest"
  },
  "title" : "VNDetectHumanHandPoseRequest"
}
-->

# VNDetectHumanHandPoseRequest

A request that detects a human hand pose.

```
class VNDetectHumanHandPoseRequest
```

## Overview

The framework provides the detected hand pose as a `VNIdentifiedPointsObservation`.

## Topics

### Configuring the Request

[`maximumHandCount`](/documentation/Vision/VNDetectHumanHandPoseRequest/maximumHandCount)

The maximum number of hands to detect in an image.

### Determining Supported Joints

[`supportedJointNames`](/documentation/Vision/VNDetectHumanHandPoseRequest/supportedJointNames)

Retrieves the supported joint names.

[`supportedJointNames(forRevision:)`](/documentation/Vision/VNDetectHumanHandPoseRequest/supportedJointNames(forRevision:))

Retrieves the supported joint names for a revision.

[`supportedJointsGroupNames`](/documentation/Vision/VNDetectHumanHandPoseRequest/supportedJointsGroupNames)

Retrieves the supported joint group names.

[`supportedJointsGroupNames(forRevision:)`](/documentation/Vision/VNDetectHumanHandPoseRequest/supportedJointsGroupNames(forRevision:))

Retrieves the supported joint group names for a revision.

[`supportedJointNamesAndReturnError:`](/documentation/Vision/VNDetectHumanHandPoseRequest/supportedJointNamesAndReturnError:)

Retrieves the supported joint names.

[`supportedJointsGroupNamesAndReturnError:`](/documentation/Vision/VNDetectHumanHandPoseRequest/supportedJointsGroupNamesAndReturnError:)

Retrieves the supported joint group names.

### Accessing the Results

[`results`](/documentation/Vision/VNDetectHumanHandPoseRequest/results)

The observed hand poses.

### Identifying Hand Pose Revisions

[`VNDetectHumanHandPoseRequestRevision1`](/documentation/Vision/VNDetectHumanHandPoseRequestRevision1)

A constant for specifying revision 1 of the hand pose detection request.


---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)