Instance Method


Returns an array of metadata items found in the container with the specified format.


- (NSArray<AVMetadataItem *> *)metadataForFormat:(AVMetadataFormat)format;



The metadata format for which you want items.

Return Value

An array of AVMetadataItem objects, one for each metadata item in the container of the specified format, or an empty array if there is no metadata for the specified format.


You can filter the resulting array to the specific items of interest using the class methods provided by AVMetadataItem, such as metadataItemsFromArray:filteredByIdentifier: or metadataItemsFromArray:withLocale:.

Special Considerations

This method becomes callable without blocking when the data in the availableMetadataFormats property is already loaded.

See Also

Accessing Metadata


The lyrics of the asset, in a language suitable for the current locale.


An array of metadata items for all metadata identifiers for which a value is available.


An array of metadata items for each common metadata key for which a value is available.


An array of strings, each representing a metadata format that’s available to the asset.

Beta Software

This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.

Learn more about using Apple's beta software