Type Method


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


class func fetchKeyAssets(in assetCollection: PHAssetCollection, options: PHFetchOptions?) -> PHFetchResult<PHAsset>?



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 transientAssetCollection(with:title:) method).

See Also

Fetching Assets

Fetching Assets

Retrieve asset metadata or request full asset content.

class func fetchAssets(withLocalIdentifiers: [String], options: PHFetchOptions?) -> PHFetchResult<PHAsset>

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

class func fetchAssets(with: PHFetchOptions?) -> PHFetchResult<PHAsset>

Retrieves all assets matching the specified options.

class func fetchAssets(withALAssetURLs: [URL], options: PHFetchOptions?) -> PHFetchResult<PHAsset>

Retrieves assets using URLs provided by the Assets Library framework.