Source: Apple Inc. Canonical content at https://developer.apple.com/design/human-interface-guidelines/shareplay. This file is a structured index of that content, snapshot 2025-02-02. Apple HIG text and imagery are © Apple Inc.; this repository provides organization and cross-referencing for AI agent consumption only.
SharePlay
Best practices
Let people know that you support SharePlay.
If part of your app requires a subscription, consider ways to help nonsubscriber participants quickly join a group activity.
Support Picture in Picture (PiP) when possible.
Use the term SharePlay correctly.
Sharing activities
Briefly describe each activity.
Make it easy to start sharing an activity.
Help people prepare to join a session before displaying the activity.
When possible, defer app tasks that might delay a shared activity.
Platform considerations
visionOS
Choose the spatial Persona template that suits your shared activity.
Be prepared to launch directly into your shared activity.
Help people enter a shared activity together, but don’t force them.
Smoothly update a shared activity when new participants join.
Maintaining a shared context
Make sure everyone views the same state of your app.
Use Spatial Audio to enrich your shared activity.
When possible, let people discover natural, social solutions to confusions or conflicts that might arise during a shared experience.
Help people keep their private and shared content separate.
- Private
- Selected
- Shared
Adjusting a shared context
Let people personalize their experience without changing the experience for others.
Consider when to give each participant a unique view of the shared content.
Make it easy for people to exit and rejoin a shared activity.
Resources
Related
Developer documentation
Videos
Change log
For the complete guidance, including worked examples and illustrations, see the canonical page: https://developer.apple.com/design/human-interface-guidelines/shareplay