Receive collab:presentation-sync
Which item the presenter is showing, and which page of it, broadcast to the other members.
collab channel. Socket.IO event name: collab:presentation-sync.Which item the presenter is showing, and which page of it, broadcast to the other members.
Only the current presenter socket may broadcast; other senders receive collab:presentation-sync:rejected instead and nothing is relayed. Client -> server -> all other sockets in the same namespace. The server sanitises the client payload (tracks are capped and trimmed to identity fields only — never file URLs, so each follower re-fetches the asset under its own rights), then appends the authenticated user identity (userId, displayName, color, avatarUrl), the annotationColor assigned on collab:join and a timestamp; client supplied values for those keys are overwritten. The sanitised result is cached as the namespace presentation state and replayed to late joiners on collab:presenter-state.
Payload: collab:presentation-sync
Payload of the 'collab:presentation-sync' socket event.
| Property | Type | Required | Description |
|---|---|---|---|
tracks | object[] | no | The presented queue, in order. Capped server-side. |
currentTrackId | string | null | no | The track currently on screen, or null when the queue is empty. |
page | integer | null | no | 1-based page of a paged item (documents), or null. |
pageCount | integer | null | no | |
userId | string | no | Authenticated user ID (server supplied, cannot be spoofed). |
displayName | string | null | no | Display name (falls back to first + last name). |
color | string | null | no | The user's profile colour. |
avatarUrl | string | null | no | keyPath of the user's avatar thumbnail file, if any. |
annotationColor | string | no | Annotation colour assigned to this user for the collab session. |
timestamp | integer | no | Server time in milliseconds since epoch when the event was relayed. |
tracks (items)
| Property | Type | Required | Description |
|---|---|---|---|
id | string | no | Asset ID; the follower re-fetches the asset itself through the API. |
name | string | no | |
mediaType | "image" | "video" | "audio" | "3d" | "document" | no | |
thumbUrl | string | null | no |