prepareLivePhotoForPlayback(withTargetSize:options:completionHandler:)
prepareLivePhotoForPlayback(withTargetSize:options:completionHandler:)
prepareLivePhotoForPlayback(withTargetSize:options:completionHandler:) Instance Method of PHLivePhotoEditingContext Processes a Live Photo with your edits for viewing.
func prepareLivePhotoForPlayback(withTargetSize targetSize: CGSize, options: [String : Any]? = nil, completionHandler handler: @escaping @Sendable (PHLivePhoto?, (any Error)?) -> Void)Parameters
targetSize
The size of the view in which you plan to preview the edited Live Photo output.
options
Options that affect Live Photo rendering. See Live Photo Processing Options.
handler
A block that Photos calls on the main queue after processing is complete. The block takes the following parameters: - term livePhoto: The rendered Live Photo, suitable for displaying in a `doc://com.apple.photokit/documentation/PhotosUI/PHLivePhotoView object. - term error: If preparing the edited Live Photo for display succeeds, this parameter is nil. If processing fails, the livePhoto parameter is nil`, and this parameter contains an error object describing the failure.
Discussion
Use this method to generate preview versions of the edited Live Photo—for example, to display in your editing UI.
Note: This method does not guarantee performance appropriate for interactive editing. Instead, you might preview edits interactively using a still image (see the `
doc://com.apple.photokit/documentation/Photos/PHLivePhotoEditingContext/fullSizeImage` property), and use this method to produce animated reviews upon the user’s request.