<!--
{
  "documentType" : "article",
  "framework" : "PhotoKit",
  "identifier" : "/documentation/PhotoKit/displaying-live-photos",
  "metadataVersion" : "0.1.0",
  "role" : "article",
  "title" : "Displaying Live Photos"
}
-->

# Displaying Live Photos

Provide the same interactive playback of Live Photos as in the iOS Photos app.

## Discussion

The [`PHLivePhotoView`](/documentation/PhotosUI/PHLivePhotoView) class provides a way to display Live Photos—pictures, taken on compatible hardware, that include motion and sound from the moments just before and after their capture. A Live Photo view provides the same interactive playback features found in the Photos app.

In iOS and tvOS, you can fetch Live Photo objects to display in a Live Photo view with the [`PHLivePhoto`](/documentation/Photos/PHLivePhoto) class in the Photos framework. In macOS, the [`PHLivePhoto`](/documentation/Photos/PHLivePhoto) class provides access to Live Photos being edited in a photo editing extension for the Photos app.

To display Live Photo content on the web, use the <doc://com.apple.documentation/documentation/LivePhotosKitJS> framework.

### Control Live Photo Playback

After obtaining a [`PHLivePhoto`](/documentation/Photos/PHLivePhoto) object, 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 Photos from the user’s photo library using the <doc://com.apple.documentation/documentation/UIKit/UIImagePickerController>, [`PHAsset`](/documentation/Photos/PHAsset), and [`PHImageManager`](/documentation/Photos/PHImageManager) classes, or by creating one from asset resources exported from a photo library. In macOS, Live Photos are available only when editing Live Photo content in a photo editing extension that runs in the Photos app—see the [`PHContentEditingInput`](/documentation/Photos/PHContentEditingInput) class to access Live Photos in an editing session.

> Note:
> For guidance on how to integrate Live Photos with your app’s user experience, see [Live Photos](https://developer.apple.com/library/archive/documentation/UserExperience/Conceptual/MobileHIG/LivePhotos.html#//apple_ref/doc/uid/TP40006556-CH74) in [iOS Human Interface Guidelines](https://developer.apple.com/ios/human-interface-guidelines/).

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`](/documentation/PhotosUI/PHLivePhotoView/playbackGestureRecognizer) property.

Typically, an app doesn’t need to directly control Live Photo playback. In some situations, however, it can be useful to briefly animate the view to indicate to the user that a picture is a Live Photo. To do this, use the [`startPlayback(with:)`](/documentation/PhotosUI/PHLivePhotoView/startPlayback(with:)) method with the [`PHLivePhotoViewPlaybackStyle.hint`](/documentation/PhotosUI/PHLivePhotoViewPlaybackStyle/hint) option.

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)