Contents

PHLivePhotoView

A view that displays a Live Photo—a picture that also includes motion and sound from the moments just before and after its capture.

Declaration

class PHLivePhotoView

Mentioned in

Overview

Use a Live Photo view to display the photo and control playback of its motion and sound content. In iOS and tvOS, you can obtain Live Photo objects from the Photos library, using the PHPickerViewController or PHAsset and PHImageManager classes, or by creating one from asset resources exported from a Photos library. In macOS, Live Photo objects are available only when editing Live Photo content in a photo editing extension that runs in the Photos app—see the PHContentEditingInput class to access Live Photo content in an editing session.

By default, a Live Photo view uses its own gesture recognizer to allow the user to play the motion and sound content of a Live Photo with the same interactions and visual effects seen in the Photos app. To customize this gesture recognizer—for example, to install it on a different view for proper event handling in your app’s view hierarchy—use the playbackGestureRecognizer property.

To animate the view briefly to hint that a picture is a Live Photo, use the startPlayback(with:) method with the PHLivePhotoViewPlaybackStyle.hint option.

Topics

Choosing a Live Photo to Display

Managing Playback

Responding to Playback Events

Manually Playing Live Photo Content

Accessing User Interface Icons for Live Photos

Setting the Content Mode

Constants

Instance Properties

See Also

Shared photo library