Retrieves assets marked as key assets in the specified asset collection.
- iOS 8+
- macOS 10.13+
- Mac Catalyst 13.0+
- tvOS 10.0+
The asset collection from which to fetch assets.
Options that specify a filter predicate and sort order for the fetched assets, or
nilto use default options. For details, see
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
asset parameter references a transient asset collection (such as one created with the