shareplay-activities

Coordinate GroupActivities for iOS, macOS, tvOS, and visionOS with synchronized media and state.

Updated Mar 31, 2026
One-click install
npx skills add https://github.com/DFly7/iOS-FastAPI-Supabase-AI --skill shareplay-activities-dfly7
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: shareplay-activities
Source: https://github.com/DFly7/iOS-FastAPI-Supabase-AI/tree/main/.agents/skills/shareplay-activities
Command: npx skills add https://github.com/DFly7/iOS-FastAPI-Supabase-AI --skill shareplay-activities-dfly7

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill consolidates patterns and practical guidance for building SharePlay GroupActivities so developers can reliably synchronize media playback, app state, and file transfers across participants while avoiding common pitfalls.

Core Features & Use Cases

  • GroupActivity definition and metadata: define Codable activity types and meaningful metadata for discovery and fallbacks.
  • Session lifecycle and participant management: observe sessions, handle join/leave/invalidation, and send full state to late joiners.
  • Messaging and file transfer: use GroupSessionMessenger with appropriate delivery modes for state and ephemeral data, and GroupSessionJournal for large attachments.
  • Coordinated media playback: integrate AVPlaybackCoordinator with AVPlayer to automatically synchronize play, pause, and seek across devices.
  • Use Case: implement a watch-together video player, collaborative drawing canvas, or a real-time quiz game with robust late-join recovery.

Quick Start

Start a WatchTogether GroupActivity, join incoming sessions, and synchronize playback and state across participants using GroupSessionMessenger and AVPlaybackCoordinator.

Frequently Asked Questions about shareplay-activities

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

FAQPage Schema
How do I synchronize media playback across devices using SharePlay GroupActivities?

SharePlay GroupActivities require defining Codable activity types, configuring entitlements and Info.plist, and managing session lifecycle to handle join, leave, and invalidation events for group participants.

What is the best way to handle late joiners in a SharePlay group session?

GroupSessionMessenger supports different delivery modes to send both persistent state updates and ephemeral data, while GroupSessionJournal handles large file transfers and attachments within a group session.

Does SharePlay support real-time collaborative canvases and multiplayer interactions on iOS and visionOS?

SharePlay supports real-time collaborative canvases and multiplayer interactions on iOS, macOS, tvOS, and visionOS by leveraging GroupSessionMessenger for state synchronization and ephemeral messaging across participants.

Why is my GroupSessionJournal file transfer failing in a SharePlay session?

GroupSessionJournal is intended for large attachments, while GroupSessionMessenger handles smaller state and ephemeral data, ensuring reliable messaging and file transfer across group participants without overwhelming the session.