when would I use custom spatial templates?
Asked on 2024-07-30
1 search
You would use custom spatial templates when the built-in system templates do not adequately serve the needs of your specific activity. For example:
- Chess App: You might want two players seated across from each other, with the remaining participants arranged as spectators to the side.
- Card Game: You might want the dealer placed across from the other players.
Custom spatial templates give your app complete control over the placement of spatial Personas relative to your shared scene, allowing for unique social experiences on visionOS.
However, before deciding to create a custom template, you should evaluate whether your experience will truly benefit from it. System templates are extensively tuned for great experiences and automatically adapt to the number of participants, ensuring a familiar and comfortable experience.
For more detailed guidance, you can refer to the session Customize spatial Persona templates in SharePlay starting at 25:13.

Meet TabletopKit for visionOS
Build a board game for visionOS from scratch using TabletopKit. We’ll show you how to set up your game, add powerful rendering using RealityKit, and enable multiplayer using spatial Personas in FaceTime with only a few extra lines of code.

Customize spatial Persona templates in SharePlay
Learn how to use custom spatial Persona templates in your visionOS SharePlay experience to fine-tune the placement of Personas relative to your app. We’ll show you how to adopt custom spatial Persona templates in a sample app with SharePlay, move participants between seats, and test your changes in Simulator. We’ll also share best practices for designing custom spatial templates that will make your experience shine.
