Type Method

fetchKeyAssets(in:options:)

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

Declaration

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

Parameters

assetCollection

The asset collection from which to fetch assets.

options

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.

Discussion

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.

Deprecated

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