Release  Watch Party 2.3.0: a REST API and webhooks for your streaming tools

Gwendal

Developer
Moderator
Customer
Verified license
21 products BoardGameHub Classified Drafts Emporium Emporium Client Flick GameHub GroupFlair Immersive Messenger Journey Level Lucent Plans Prestige Teams Watch Party XenCard XenPing XenSpotlight XenStaff XenStreak
Watch Party 2.3.0 is on the store. If your parties start from a streaming setup, OBS, an HLS service, a scheduling script, the forum no longer has to be driven by hand: your tools can create the party, follow it and attach its recording on their own.

It came from the same customer who shaped 2.2.0, and who asked for exactly this. Thank you again.

A REST API, in XenForo's own API​

  • Parties: list them, read one with its current source and every video it played, start one now, change its title, visibility or thread, end it and reopen it.
  • Scheduled parties: create them ahead of time with their source, date and visibility, move them, change them or cancel them. They open their lobby and go live on their own, as when scheduled from the forum.
  • Recordings: once a live party has ended, attach its recording with the point where the party starts in it, mark it as being prepared, or remove it.
Keys come from Setup > API keys with the scopes watchparty:read and watchparty:write. Every call runs with the permissions of the key's member, so the approval queue and the per source permissions apply exactly as on the forum.

Webhooks, in XenForo's own Setup > Webhooks​

Your endpoint hears when a party opens its lobby, goes live, loses or gets back its source, ends or gets its recording, and when a scheduled party is created, submitted, approved, rejected, changed or cancelled. Each payload carries the whole party: state, visibility, host, links, current source and the event date.

Also new​

  • A discussion thread can be linked to any party, from the schedule form, the room settings or the API. The party page shows a Discussion button to members who can view the thread.
  • Private and unlisted scheduled parties. Only public ones appear under Upcoming, and the party opens with the same visibility.

Upgrade​

Install the archive over any 2.x version from the Admin CP. Nothing changes in your permissions. To use the API, create a key with the watchparty scopes; to receive events, add a webhook and tick the watch party events. The demo board already runs 2.3.0.

Watch Party on the store
 
Ready to make your forum unforgettable?Browse the storeSee the plans