MediaIntelligence · IOS API REFERENCE

FaceGroupAnalyzer.Face

struct · iOS 27.0+ · SDK 27.1

struct Face

A face detected in an image asset. This type represents a single face that ``FaceGroupAnalyzer`` detects in an image. It records the face's location within the image, the identifier of the image it came from, and after ``FaceGroupAnalyzer/update(subprogress:)`` runs, the entity the face belongs to. The ``FaceGroupAnalyzer/Face/bounds`` rectangle uses normalized coordinates in the range `0.0` to `1.0` along both axes, with the origin at the top-left corner of the image.

Members (4)

get · iOS 27.0+

id

TypeScript

get id(): FaceGroupAnalyzer_Face_ID

Swift declaration

let id: FaceGroupAnalyzer.Face.ID

A unique identifier for the face.

get · iOS 27.0+

bounds

TypeScript

get bounds(): { x: number; y: number; width: number; height: number }

Swift declaration

let bounds: CGRect

A normalized rectangle describing the location of the face within its source image. The rectangle uses normalized coordinates, where `0.0` is the top-left corner and `1.0` is the bottom-right corner along each axis.

get · iOS 27.0+

assetID

TypeScript

get assetID(): MediaIntelligenceImageAsset_ID

Swift declaration

let assetID: MediaIntelligenceImageAsset.ID

An identifier for the image asset that contains this face.

get · iOS 27.0+

entityID

TypeScript

get entityID(): (FaceGroupAnalyzer_Entity_ID) | null

Swift declaration

let entityID: FaceGroupAnalyzer.Entity.ID?

An identifier for the entity this face belongs to. This value is `nil` until you call ``FaceGroupAnalyzer/update(subprogress:)``. After clustering runs, every face receives an entity identifier that groups it with other faces of the same person.

Skipped declarations

No declarations were skipped in this snapshot.

All MediaIntelligence types →