Platforms to show: All Mac Windows Linux Cross-Platform

PHLivePhotoControlMBS control

See also desktop control: DesktopPHLivePhotoControlMBS

Type Topic Plugin Version macOS Windows Linux iOS Targets
control Photos MBS Mac64bit Plugin 20.2 ✅ Yes ❌ No ❌ No ❌ No Desktop only
A view that displays a Live Photo—a picture that also includes motion and sound from the moments just before and after its capture.

Use a Live Photo view to display the photo and control playback of its motion and sound content.

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 PHContentEditingInputMBS 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 method with the PlaybackStyleHint option.

Content Modes

Constant Value Description
ContentModeAspectFill 1 Aspect Fill.
ContentModeAspectFit 0 Aspect Fit.

Playback Styles

Constant Value Description
PlaybackStyleFull 1 Plays back the entire motion and sound content of the Live Photo, including transition effects at the start and end.
PlaybackStyleHint 2 Plays back only a brief section of the motion content of the Live Photo, without sound.
PlaybackStyleUndefined 0 This value is invalid for use.

Some examples using this control:

Blog Entries

Xojo Developer Magazine

Release notes

  • Version 20.2

The items on this page are in the following plugins: MBS Mac64bit Plugin.


PDFViewIOSControlMBS   -   QCViewControlMBS


The biggest plugin in space...