---
title: PHLivePhoto
framework: photos
role: symbol
role_heading: Class
path: photos/phlivephoto
---

# PHLivePhoto

A displayable representation of a Live Photo—a picture that includes motion and sound from the moments just before and after its capture.

## Declaration

```swift
class PHLivePhoto
```

## Mentioned in

Displaying Live Photos

## Overview

Overview In iOS and tvOS, you can use this class to reference Live Photos from the user’s library (fetched with the PHAsset and PHImageManager classes), to load displayable Live Photo objects from data obtained elsewhere (such as pictures shared through a social network), and to assign Live Photos to PHLivePhotoView objects for display. In iOS, tvOS, and macOS, you can use this class to display edits in progress for Live Photo content in a photo editing extension. note: For guidance on how to integrate Live Photos with your app’s user experience, see Live Photos in iOS Human Interface Guidelines. The PHLivePhoto class serves in much the same role for Live Photos as the UIImage or NSImage class serves for static images. A UIImage or NSImage object represents not the data file an image is loaded from, but instead a ready-to-use image that can be displayed in a view—similarly, a PHLivePhoto object represents a Live Photo ready to display with motion and sound using a PHLivePhotoView object, not an entry in the Photos library or the data resources that constitute a Live Photo. (To work with Live Photos as elements of the Photos library, use the PHAsset class. To work with the data files that constitute a Live Photo, use the PHAssetResource class.) tip: To display Live Photo content on the web, use the LivePhotosKit JS framework.

## Topics

### Inspecting a Live Photo

- [size](photos/phlivephoto/size.md)

### Loading a Live Photo from Data Files

- [request(withResourceFileURLs:placeholderImage:targetSize:contentMode:resultHandler:)](photos/phlivephoto/request(withresourcefileurls:placeholderimage:targetsize:contentmode:resulthandler:).md)
- [cancelRequest(withRequestID:)](photos/phlivephoto/cancelrequest(withrequestid:).md)

### Constants

- [PHLivePhotoRequestID](photos/phlivephotorequestid.md)
- [Image Request Identifiers](photokit/image-request-identifiers.md)
- [Result Handler Info Dictionary Keys](photokit/result-handler-info-dictionary-keys.md)

### Initializers

- [init(coder:)](photos/phlivephoto/init(coder:).md)

## Relationships

### Inherits From

- [NSObject](objectivec/nsobject-swift.class.md)

### Conforms To

- [CVarArg](swift/cvararg.md)
- [Copyable](swift/copyable.md)
- [CustomDebugStringConvertible](swift/customdebugstringconvertible.md)
- [CustomStringConvertible](swift/customstringconvertible.md)
- [Equatable](swift/equatable.md)
- [Escapable](swift/escapable.md)
- [Hashable](swift/hashable.md)
- [NSCoding](foundation/nscoding.md)
- [NSCopying](foundation/nscopying.md)
- [NSItemProviderReading](foundation/nsitemproviderreading.md)
- [NSObjectProtocol](objectivec/nsobjectprotocol.md)
- [NSSecureCoding](foundation/nssecurecoding.md)
- [Sendable](swift/sendable.md)
- [SendableMetatype](swift/sendablemetatype.md)
- [Transferable](coretransferable/transferable.md)