<!--
{
  "availability" : [
    "tvOS: -",
    "visionOS: -"
  ],
  "documentType" : "symbol",
  "framework" : "AVKit",
  "identifier" : "/documentation/AVKit/AVInterfaceMetadata",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "AVKit"
    ],
    "preciseIdentifier" : "c:objc(cs)AVInterfaceMetadata"
  },
  "title" : "AVInterfaceMetadata"
}
-->

# AVInterfaceMetadata

Provides metadata information about media content including title, artwork, and content type.

```
@interface AVInterfaceMetadata : NSObject
```

## Topics

### Instance Properties

[`@property (nonatomic, copy, readonly) NSArray<AVInterfaceAlbumArtwork *> * albumArtworkRepresentations;`](/documentation/AVKit/AVInterfaceMetadata/albumArtworkRepresentations)

Array of available album artwork representations in various formats and sizes for this media content.
Multiple representations allow the system to choose the most appropriate artwork for different display contexts (thumbnails, full-screen, high-DPI displays).
Each representation specifies its dimensions, format, and URL for optimal loading and display performance.

[`@property (nonatomic, readonly, getter=isAudioOnly) BOOL audioOnly;`](/documentation/AVKit/AVInterfaceMetadata/audioOnly)

Indicates whether the content is audio-only (no video component). Used to optimize UI layout and player controls for audio-focused presentations.
When YES, video-related controls and layouts should be hidden or adapted for audio-only playback experiences.

[`@property (nonatomic, readonly) CGSize presentationSize;`](/documentation/AVKit/AVInterfaceMetadata/presentationSize)

The natural pixel dimensions of the video content for display purposes.
This represents the encoded size of the video stream and can be used to determine aspect ratio and optimal presentation layout. For audio-only content, this value is CGSizeZero.

[`@property (nonatomic, copy, readonly, nullable) NSString * subtitle;`](/documentation/AVKit/AVInterfaceMetadata/subtitle)

Secondary descriptive text such as artist name, episode description, or additional context for the content.
This provides supplementary information to help users identify and understand the content being played.

[`@property (nonatomic, copy, readonly, nullable) NSString * title;`](/documentation/AVKit/AVInterfaceMetadata/title)

Primary title or name of the media content for display in player UI and system interfaces.
This should be the main identifying text for the content, such as a song title, episode name, or movie title.

### Instance Methods

[`- (instancetype) initWithAudioOnly:(BOOL) audioOnly presentationSize:(CGSize) presentationSize title:(NSString *) title subtitle:(NSString *) subtitle albumArtworkRepresentations:(NSArray<AVInterfaceAlbumArtwork *> *) albumArtworkRepresentations;`](/documentation/AVKit/AVInterfaceMetadata/initWithAudioOnly:presentationSize:title:subtitle:albumArtworkRepresentations:)

Initializes a new metadata object with the specified properties.

[`- (instancetype) initWithTemplate:(AVInterfaceMetadataTemplate *) metadataTemplate;`](/documentation/AVKit/AVInterfaceMetadata/initWithTemplate:)

Initializes a new metadata object by copying values from a metadata template.

## Relationships

### Inherits From

[`NSObject-swift.class`](/documentation/ObjectiveC/NSObject-swift.class)

### Conforms To

[`NSCopying`](/documentation/Foundation/NSCopying)

[`NSSecureCoding`](/documentation/Foundation/NSSecureCoding)

---

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)