File: platform/plugins/Streams/handlers/Streams/join/post.php

<?php

/**
 * @module Streams
 */

/**
 * Used by HTTP clients to join an existing stream
 * @class HTTP Streams join
 * @method post
 * @param {array} [$_REQUEST] Parameters that can come from the request
 *   @param {string} $_REQUEST.publisherId  Required. The id of the user to publish the stream.
 *   @param {string} $_REQUEST.streamName Required. The name of the stream.
 */
function Streams_join_post()
{
	$user = Users::loggedInUser(true);
	$publisherId = Streams::requestedPublisherId();
	$streamName = Streams::requestedName(true);
	$stream = Streams::fetchOne($user->id, $publisherId, $streamName, true);
	// SECURITY: Do not allow client to set options here
	// because then they can set participant extra.
	if ($participant = $stream->join()) {
		Q_Response::setSlot('participant', $participant->exportArray());
	}
}