<!--
{
  "availability" : [
    "iOS: 17.0.0 -",
    "iPadOS: 17.0.0 -",
    "macCatalyst: 17.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "SensorKit",
  "identifier" : "/documentation/SensorKit/SRFaceMetrics",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "SensorKit"
    ],
    "preciseIdentifier" : "c:objc(cs)SRFaceMetrics"
  },
  "title" : "SRFaceMetrics"
}
-->

# SRFaceMetrics

An object that represents metrics about the user’s face.

```
class SRFaceMetrics
```

## Overview

The [`faceMetrics`](/documentation/SensorKit/SRSensor/faceMetrics) sensor provides this class as its [`sample`](/documentation/SensorKit/SRFetchResult/sample) type.

## Topics

### Getting session information

[`sessionIdentifier`](/documentation/SensorKit/SRFaceMetrics/sessionIdentifier)

An identifier for the camera session.

[`context`](/documentation/SensorKit/SRFaceMetrics/context-swift.property)

The context of the system during the camera session.

[`SRFaceMetrics.Context`](/documentation/SensorKit/SRFaceMetrics/Context-swift.struct)

The context of the system during the camera session.

[`version`](/documentation/SensorKit/SRFaceMetrics/version)

The version of the algorithm that the system uses to generate the face metrics and analytics.

### Getting face analytics

[`faceAnchor`](/documentation/SensorKit/SRFaceMetrics/faceAnchor)

The anchor for the face that the sensor detects in front of the camera.

[`partialFaceExpressions`](/documentation/SensorKit/SRFaceMetrics/partialFaceExpressions)

The partial face expressions that the algorithm detects.

[`wholeFaceExpressions`](/documentation/SensorKit/SRFaceMetrics/wholeFaceExpressions)

The whole face expressions that the algorithm detects.

[`SRFaceMetricsExpression`](/documentation/SensorKit/SRFaceMetricsExpression)

An object that represents a facial expression.


---

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)