Rooms
A room is the main workspace in SyncTV. One watching session, a set of members, a playlist, permissions, and current playback state all belong to a room. The controls a user sees depend on room settings and that user’s room role.
What a Room Contains
Section titled “What a Room Contains”| Item | Purpose |
|---|---|
| Members | Creator, room admins, members, and guests |
| Playlist | Media items, child lists, and order |
| Current playback | Current media, position, pause state, speed, and version |
| Chat | Room messages controlled by permissions and room switches |
| Join rules | Visibility, password, review requirement, and member limit |
| Permissions | Role defaults and member-level overrides |
| Livestream entry | RTMP/live sessions for the room |
Who Manages a Room
Section titled “Who Manages a Room”Platform administrators and room administrators are different roles. A global root or admin can maintain the instance, but long-term room responsibility should still be represented through room roles. Use member overrides for exceptions.
Common Room States
Section titled “Common Room States”| State | User experience | Administration action |
|---|---|---|
| Open to join | Users can enter from the list or invite | Control default permissions and member limits |
| Password required | Users must enter the room password | Rotate leaked passwords |
| Review required | Users wait for approval | Approve or reject with a clear reason |
| Suspended | Users cannot continue joining or operating | Ban the room or close entry points |
Next Steps
Section titled “Next Steps”- Users creating or joining rooms: Create and Join Rooms.
- Managing members and settings: Room and Member Management.
- Permission details: Permissions Model and Rooms, Permissions, and Preferences.