Interviews and questions on stage

A host live to an audience, and viewers who come on stage beside them: a question from the audience, an interview with a guest, a panel. A viewer raises a hand, the host sees it and invites them, and everyone watching sees both, in the layout the host chooses. The stage is on in every live stream, and the player and studio of Easy Stream show all of it.

Who is who

A live stream for each talk, named after it: talk:12.

Your server decides who does what. A page that opens the stream asks your server first, and a rule answers: a function your server registers once for every stream whose name fits talk:{id}. WordPlus Cloud then holds the page to the answer (permissions). This rule gives each person a role:

1. A visitor who is not signed in watches.
2. The host of the talk goes live, and brings people on stage.
3. Someone blocked from the talk is refused.
4. Everyone else watches, and may raise a hand to come on stage.

Node

realtime.streams( 'talk:{id}', async ( user, { id } ) => {
    // 1. A visitor watches.
    if ( user === null ) return 'viewer';

    // 2. The host.
    if ( await isHostOf( id, user ) ) return 'host';

    // 3. Someone blocked, and 4. everyone else, who may raise a hand.
    return ( await isBlockedFrom( id, user ) ) ? false : 'viewer';
}, { stage: true, reactions: true } );

PHP

$realtime->streams( 'talk:{id}', function ( $user, array $p ) {
    // 1. A visitor watches.
    if ( null === $user ) {
        return 'viewer';
    }

    // 2. The host.
    if ( is_host_of( $p['id'], $user ) ) {
        return 'host';
    }

    // 3. Someone blocked, and 4. everyone else, who may raise a hand.
    return is_blocked_from( $p['id'], $user ) ? false : 'viewer';
}, [ 'stage' => true, 'reactions' => true ] );

Python

def talk_role(user, p):
    # 1. A visitor watches.
    if user is None:
        return "viewer"

    # 2. The host.
    if is_host_of(p["id"], user):
        return "host"

    # 3. Someone blocked, and 4. everyone else, who may raise a hand.
    return False if is_blocked_from(p["id"], user) else "viewer"

realtime.streams("talk:{id}", talk_role, stage=True, reactions=True)

WordPress

wordplus_realtime()->streams( 'talk:{id}', function ( $user_id, array $p ) {
	// 1. A visitor watches.
	if ( 0 === $user_id ) {
		return 'viewer';
	}

	// 2. The host.
	if ( my_talk_host( (int) $p['id'] ) === $user_id ) {
		return 'host';
	}

	// 3. Someone blocked, and 4. everyone else, who may raise a hand.
	return my_talk_blocks( (int) $p['id'], $user_id ) ? false : 'viewer';
}, array( 'stage' => true, 'reactions' => true ) );

• stage is on unless it says false, as for a stream where nobody but the host appears.
• A visitor who is not signed in watches, and does not come on stage.

Ready-made

<wordplus-stream name="talk:12" title="Ask the designer"></wordplus-stream>

The viewer gets a Raise hand button, and Join when invited. The host gets the hands in the studio, with Invite beside each, the guests on stage with a way to take them off, and the layout.

Your own

The page of a viewer:

const calls = await rt.calls();
const talk = await calls.stream( 'talk:12' );
talk.watch( player );

raiseButton.onclick = () => talk.hand( true );         // talk.hand( false ) takes it down
talk.on( 'invited', () => offerToJoin() );
joinButton.onclick = () => talk.joinStage();          // on stage, the camera and microphone live
leaveButton.onclick = () => talk.leaveStage();
talk.on( 'stage', ( on ) => showOnStage( on ) );

The page of the host:

talk.on( 'hands', ( hands ) => drawHands( hands ) );   // [ { user, name, at } ], the oldest first
await talk.invite( hands[ 0 ].user );                  // or anyone watching, by their user id
await talk.unstage( 34 );                              // back to watching
await talk.layout( 'spotlight', 34 );                  // 'grid', 'speaker', or one person in the spotlight

• A guest sends their camera and microphone, the picture up to 720p, and everyone watching sees them in the picture of the stream.
• talk.tiles has each person on stage, a guest with role: 'guest', for a layout of your own.
• Refusals reject with their code: anonymous for a visitor, no_stage for a stream without a stage, not_invited for a join nobody asked for.

Variations

• Questions in writing, answered on stage: the chat of the stream, with a moderator pinning the next question (live streaming).
• Speakers and listeners in a group call, where everyone talks with low delay and nobody watches a stream: classes and audio rooms.
• On the phones of the audience: the iOS and Android SDKs raise hands and join the stage (iOS streams, Android streams).
• In a WordPress plugin: wordplus_realtime()->streams() (WordPress streams).