shareplay-developer

Implement and troubleshoot SharePlay experiences using GroupActivities across Apple platforms.

60|8|Updated Dec 23, 2025
One-click install
npx skills add https://github.com/tomkrikorian/visionOSAgents --skill shareplay-developer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: shareplay-developer
Source: https://github.com/tomkrikorian/visionOSAgents/tree/main/skills/shareplay-developer
Command: npx skills add https://github.com/tomkrikorian/visionOSAgents --skill shareplay-developer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

SharePlay development can be complex, requiring careful orchestration of GroupActivities, session lifecycles, state synchronization, and spatial coordination across Apple platforms. This skill provides guided approaches and best practices to implement and troubleshoot GroupActivities experiences, including visionOS integration.

Core Features & Use Cases

  • Define and activate GroupActivity types with minimal, Codable payloads and rich metadata.
  • Manage GroupSession lifecycle, messaging via GroupSessionMessenger, and durable state with GroupSessionJournal.
  • Render and coordinate spatial experiences using SystemCoordinator and SharePlay UI surfaces (ShareLink, GroupActivitySharingController).
  • Handle late joiners, state catch-up, and cross-device participation in visionOS environments.

Quick Start

  • Enable the Group Activities entitlement (com.apple.developer.group-session) in your Xcode project and declare a GroupActivity type for your experience.
  • Define metadata including a title, type, and a fallback URL; implement a minimal Codable payload for sharing state.
  • Observe and join sessions using the appropriate GroupActivity APIs and configure spatial coordination when immersive spaces are involved.

Frequently Asked Questions about shareplay-developer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I implement SharePlay experiences using GroupActivities in SwiftUI?

You implement SharePlay by declaring a GroupActivity type with minimal Codable payloads and rich metadata, then observing and joining sessions via GroupActivity APIs. This skill guides activity activation, session lifecycle management, and spatial coordination.

How does GroupSessionMessenger handle state synchronization for late joiners?

GroupSessionMessenger manages real-time messaging during the GroupSession, while GroupSessionJournal provides durable state storage. Together they ensure late joiners can catch up on synchronized state across participating devices.

Can I use SystemCoordinator for spatial SharePlay coordination on visionOS?

Yes, SystemCoordinator enables spatial SharePlay coordination on visionOS by managing immersive spaces and cross-device participation. It integrates with SharePlay UI surfaces like GroupActivitySharingController for rendering coordinated experiences.

What do I need to configure in Xcode to enable SharePlay with GroupActivities?

You need to enable the Group Activities entitlement (com.apple.developer.group-session) in your Xcode project. Then declare a GroupActivity type with metadata including a title, type, fallback URL, and a minimal Codable payload for sharing state.

What is the best way to troubleshoot GroupActivities session lifecycle issues?

Troubleshoot GroupActivities lifecycle issues by verifying proper GroupSession observation, messenger synchronization, and journal state durability. This skill provides guided approaches to resolve session activation, state catch-up, and messaging failures across Apple platforms.

Do I need a fallback URL when defining a GroupActivity type?

Yes, a fallback URL is required when defining a GroupActivity type. Along with a title and type, the fallback URL ensures proper ShareLink integration and allows the activity to function correctly when SharePlay is unavailable.