Creates a request for modifying the specified asset collection, with a fetch result for tracking changes.
SDKs
- iOS 8+
- macOS 10.15+
- Mac Catalyst 13.0+
- tvOS 10+
Framework
- Photos
Declaration
+ (instancetype)changeRequestForAssetCollection:(PHAsset Collection *)assetCollection assets:(PHFetch Result<PHAsset *> *)assets;
Parameters
assetCollection
The asset collection to be modified.
assets
A fetch result listing the assets in the collection.
Return Value
An asset collection change request.
Discussion
After you create a change request within a photo library change block, you propose changes to the collection’s title or list of member assets with the properties and instance methods of the change request. After Photos runs your change block, the asset collection reflects your changes. For details on change blocks, see PHPhoto
.
Use this method when you need to insert, remove, or rearrange assets at specified indexes in the asset collection’s list of member assets. By passing in a fetch result reflecting what your app sees as the current state of the collection’s membership, the Photos framework can ensure that the indexes you specify are valid even if the collection has changed since you last fetched it. If you don’t need to work with indexes in the list of member assets, you can use the change
method instead.