Type Method


Retrieves assets marked as key assets in the specified asset collection.


+ (PHFetchResult<PHAsset *> *)fetchKeyAssetsInAssetCollection:(PHAssetCollection *)assetCollection options:(PHFetchOptions *)options;



The asset collection from which to fetch assets.


Options that specify a filter predicate and sort order for the fetched assets, or nil to use default options. For details, see PHFetchOptions.

Return Value

A fetch result that contains the requested PHAsset objects, or an empty fetch result or nil if no objects match the request.


Most asset collections contain a key asset, which the Photos app displays as a proxy for the collection. Different types of asset collections have different ways of specifying one or more key assets. For example, in the Camera Roll collection, the most recently captured photo or video is the key asset.

This method returns nil if the assetCollection parameter references a transient asset collection (such as one created with the transientAssetCollectionWithAssets:title: method).

See Also

Fetching Assets

Fetching Assets

Retrieve asset metadata or request full asset content.

+ fetchAssetsInAssetCollection:options:

Retrieves assets from the specified asset collection.

+ fetchAssetsWithMediaType:options:

Retrieves assets with the specified media type.

+ fetchAssetsWithLocalIdentifiers:options:

Retrieves assets with the specified local-device-specific unique identifiers.

+ fetchAssetsWithOptions:

Retrieves all assets matching the specified options.

+ fetchAssetsWithBurstIdentifier:options:

Retrieves assets with the specified burst photo sequence identifier.

+ fetchAssetsWithALAssetURLs:options:

Retrieves assets using URLs provided by the Assets Library framework.