|
|
|
|
@ -1,29 +1,29 @@ |
|
|
|
|
<?php |
|
|
|
|
/** |
|
|
|
|
* This script initiates a videoconference session, calling the BigBlueButton |
|
|
|
|
* Class bbb |
|
|
|
|
* This script initiates a video conference session, calling the BigBlueButton |
|
|
|
|
* API |
|
|
|
|
* @package chamilo.plugin.bigbluebutton |
|
|
|
|
*/ |
|
|
|
|
/** |
|
|
|
|
* |
|
|
|
|
* BigBlueButton-Chamilo connector class |
|
|
|
|
*/ |
|
|
|
|
class bbb { |
|
|
|
|
|
|
|
|
|
var $url; |
|
|
|
|
var $salt; |
|
|
|
|
var $api; |
|
|
|
|
var $user_complete_name = null; |
|
|
|
|
var $protocol = 'http://'; |
|
|
|
|
var $debug = false; |
|
|
|
|
var $logout_url = null; |
|
|
|
|
var $plugin_enabled = false; |
|
|
|
|
class bbb |
|
|
|
|
{ |
|
|
|
|
public $url; |
|
|
|
|
public $salt; |
|
|
|
|
public $api; |
|
|
|
|
public $user_complete_name = null; |
|
|
|
|
public $protocol = 'http://'; |
|
|
|
|
public $debug = false; |
|
|
|
|
public $logout_url = null; |
|
|
|
|
public $plugin_enabled = false; |
|
|
|
|
|
|
|
|
|
/** |
|
|
|
|
* Constructor (generates a connection to the API and the Chamilo settings |
|
|
|
|
* required for the connection to the videoconference server) |
|
|
|
|
*/ |
|
|
|
|
function __construct() { |
|
|
|
|
|
|
|
|
|
public function __construct() |
|
|
|
|
{ |
|
|
|
|
// initialize video server settings from global settings |
|
|
|
|
$plugin = BBBPlugin::create(); |
|
|
|
|
|
|
|
|
|
@ -55,11 +55,13 @@ class bbb { |
|
|
|
|
$this->plugin_enabled = true; |
|
|
|
|
} |
|
|
|
|
} |
|
|
|
|
|
|
|
|
|
/** |
|
|
|
|
* Checks whether a user is teacher in the current course |
|
|
|
|
* @return bool True if the user can be considered a teacher in this course, false otherwise |
|
|
|
|
*/ |
|
|
|
|
function is_teacher() { |
|
|
|
|
public function is_teacher() |
|
|
|
|
{ |
|
|
|
|
return api_is_course_admin() || api_is_coach() || api_is_platform_admin(); |
|
|
|
|
} |
|
|
|
|
|
|
|
|
|
@ -94,7 +96,8 @@ class bbb { |
|
|
|
|
defaultMeetingCreateJoinDuration=5 |
|
|
|
|
* |
|
|
|
|
*/ |
|
|
|
|
function create_meeting($params) { |
|
|
|
|
public function create_meeting($params) |
|
|
|
|
{ |
|
|
|
|
$params['c_id'] = api_get_course_int_id(); |
|
|
|
|
$course_code = api_get_course_id(); |
|
|
|
|
$params['session_id'] = api_get_session_id(); |
|
|
|
|
@ -147,19 +150,31 @@ class bbb { |
|
|
|
|
return $this->logout; |
|
|
|
|
} |
|
|
|
|
} |
|
|
|
|
|
|
|
|
|
/** |
|
|
|
|
* Tells whether the given meeting exists and is running |
|
|
|
|
* Tells whether the given meeting exists and is running |
|
|
|
|
* (using course code as name) |
|
|
|
|
* @param string Meeting name (usually the course code) |
|
|
|
|
* @return bool True if meeting exists, false otherwise |
|
|
|
|
* @assert ('') === false |
|
|
|
|
* @assert ('abcdefghijklmnopqrstuvwxyzabcdefghijklmno') === false |
|
|
|
|
*/ |
|
|
|
|
function meeting_exists($meeting_name) { |
|
|
|
|
public function meeting_exists($meeting_name) |
|
|
|
|
{ |
|
|
|
|
if (empty($meeting_name)) { return false; } |
|
|
|
|
$course_id = api_get_course_int_id(); |
|
|
|
|
$session_id = api_get_session_id(); |
|
|
|
|
$meeting_data = Database::select('*', $this->table, array('where' => array('c_id = ? AND session_id = ? AND meeting_name = ? AND status = 1 ' => array($course_id, $session_id, $meeting_name))), 'first'); |
|
|
|
|
$meeting_data = Database::select( |
|
|
|
|
'*', |
|
|
|
|
$this->table, |
|
|
|
|
array( |
|
|
|
|
'where' => array( |
|
|
|
|
'c_id = ? AND session_id = ? AND meeting_name = ? AND status = 1 ' => |
|
|
|
|
array($course_id, $session_id, $meeting_name) |
|
|
|
|
) |
|
|
|
|
), |
|
|
|
|
'first' |
|
|
|
|
); |
|
|
|
|
if ($this->debug) error_log("meeting_exists ".print_r($meeting_data,1)); |
|
|
|
|
if (empty($meeting_data)) { |
|
|
|
|
return false; |
|
|
|
|
@ -176,12 +191,14 @@ class bbb { |
|
|
|
|
* @assert ('') === false |
|
|
|
|
* @assert ('abcdefghijklmnopqrstuvwxyzabcdefghijklmno') === false |
|
|
|
|
*/ |
|
|
|
|
function join_meeting($meeting_name) { |
|
|
|
|
public function join_meeting($meeting_name) |
|
|
|
|
{ |
|
|
|
|
if (empty($meeting_name)) { return false; } |
|
|
|
|
$pass = $this->get_user_meeting_password(); |
|
|
|
|
$meeting_data = Database::select('*', $this->table, array('where' => array('meeting_name = ? AND status = 1 ' => $meeting_name)), 'first'); |
|
|
|
|
if (empty($meeting_data)) { |
|
|
|
|
if ($this->debug) error_log("meeting does not exist: $meeting_name "); |
|
|
|
|
|
|
|
|
|
return false; |
|
|
|
|
} |
|
|
|
|
|
|
|
|
|
@ -214,13 +231,15 @@ class bbb { |
|
|
|
|
if ($this->debug) error_log("return url :".$url); |
|
|
|
|
return $url; |
|
|
|
|
} |
|
|
|
|
|
|
|
|
|
/** |
|
|
|
|
* Get information about the given meeting |
|
|
|
|
* @param array ...? |
|
|
|
|
* @return mixed Array of information on success, false on error |
|
|
|
|
* @assert (array()) === false |
|
|
|
|
*/ |
|
|
|
|
function get_meeting_info($params) { |
|
|
|
|
public function get_meeting_info($params) |
|
|
|
|
{ |
|
|
|
|
try { |
|
|
|
|
$result = $this->api->getMeetingInfoWithXmlResponseArray($params); |
|
|
|
|
if ($result == null) { |
|
|
|
|
@ -238,7 +257,8 @@ class bbb { |
|
|
|
|
* Gets all the course meetings saved in the plugin_bbb_meeting table |
|
|
|
|
* @return array Array of current open meeting rooms |
|
|
|
|
*/ |
|
|
|
|
function get_course_meetings() { |
|
|
|
|
public function get_course_meetings() |
|
|
|
|
{ |
|
|
|
|
$pass = $this->get_user_meeting_password(); |
|
|
|
|
$meeting_list = Database::select('*', $this->table, array('where' => array('c_id = ? AND session_id = ? ' => array(api_get_course_int_id(), api_get_session_id())))); |
|
|
|
|
$new_meeting_list = array(); |
|
|
|
|
@ -338,18 +358,23 @@ class bbb { |
|
|
|
|
} |
|
|
|
|
return $new_meeting_list; |
|
|
|
|
} |
|
|
|
|
|
|
|
|
|
/** |
|
|
|
|
* Function disabled |
|
|
|
|
*/ |
|
|
|
|
function publish_meeting($id) { |
|
|
|
|
public function publish_meeting($id) |
|
|
|
|
{ |
|
|
|
|
//return BigBlueButtonBN::setPublishRecordings($id, 'true', $this->url, $this->salt); |
|
|
|
|
} |
|
|
|
|
|
|
|
|
|
/** |
|
|
|
|
* Function disabled |
|
|
|
|
*/ |
|
|
|
|
function unpublish_meeting($id) { |
|
|
|
|
public function unpublish_meeting($id) |
|
|
|
|
{ |
|
|
|
|
//return BigBlueButtonBN::setPublishRecordings($id, 'false', $this->url, $this->salt); |
|
|
|
|
} |
|
|
|
|
|
|
|
|
|
/** |
|
|
|
|
* Closes a meeting (usually when the user click on the close button from |
|
|
|
|
* the conferences listing. |
|
|
|
|
@ -357,7 +382,8 @@ class bbb { |
|
|
|
|
* @return void |
|
|
|
|
* @assert (0) === false |
|
|
|
|
*/ |
|
|
|
|
function end_meeting($id) { |
|
|
|
|
public function end_meeting($id) |
|
|
|
|
{ |
|
|
|
|
if (empty($id)) { return false; } |
|
|
|
|
$pass = $this->get_user_meeting_password(); |
|
|
|
|
$endParams = array( |
|
|
|
|
@ -367,22 +393,26 @@ class bbb { |
|
|
|
|
$this->api->endMeetingWithXmlResponseArray($endParams); |
|
|
|
|
Database::update($this->table, array('status' => 0, 'closed_at' => api_get_utc_datetime()), array('id = ? ' => $id)); |
|
|
|
|
} |
|
|
|
|
|
|
|
|
|
/** |
|
|
|
|
* Gets the password for a specific meeting for the current user |
|
|
|
|
* @return string A moderator password if user is teacher, or the course code otherwise |
|
|
|
|
*/ |
|
|
|
|
function get_user_meeting_password() { |
|
|
|
|
public function get_user_meeting_password() |
|
|
|
|
{ |
|
|
|
|
if ($this->is_teacher()) { |
|
|
|
|
return $this->get_mod_meeting_password(); |
|
|
|
|
} else { |
|
|
|
|
return api_get_course_id(); |
|
|
|
|
} |
|
|
|
|
} |
|
|
|
|
|
|
|
|
|
/** |
|
|
|
|
* Generated a moderator password for the meeting |
|
|
|
|
* @return string A password for the moderation of the videoconference |
|
|
|
|
*/ |
|
|
|
|
function get_mod_meeting_password() { |
|
|
|
|
public function get_mod_meeting_password() |
|
|
|
|
{ |
|
|
|
|
return api_get_course_id().'mod'; |
|
|
|
|
} |
|
|
|
|
|
|
|
|
|
@ -391,7 +421,8 @@ class bbb { |
|
|
|
|
* @return int The number of users currently connected to the videoconference |
|
|
|
|
* @assert () > -1 |
|
|
|
|
*/ |
|
|
|
|
function get_users_online_in_current_room() { |
|
|
|
|
public function get_users_online_in_current_room() |
|
|
|
|
{ |
|
|
|
|
$course_id = api_get_course_int_id(); |
|
|
|
|
$session_id = api_get_session_id(); |
|
|
|
|
$meeting_data = Database::select('*', $this->table, array('where' => array('c_id = ? AND session_id = ? AND status = 1 ' => array($course_id, $session_id))), 'first'); |
|
|
|
|
@ -407,6 +438,7 @@ class bbb { |
|
|
|
|
} |
|
|
|
|
return 0; |
|
|
|
|
} |
|
|
|
|
|
|
|
|
|
/** |
|
|
|
|
* Deletes a previous recording of a meeting |
|
|
|
|
* @param int integral ID of the recording |
|
|
|
|
@ -414,12 +446,13 @@ class bbb { |
|
|
|
|
* @assert () === false |
|
|
|
|
* @todo Also delete links and agenda items created from this recording |
|
|
|
|
*/ |
|
|
|
|
function delete_record($ids) { |
|
|
|
|
public function delete_record($ids) |
|
|
|
|
{ |
|
|
|
|
if (empty($ids) or (is_array($ids) && count($ids)==0)) { return false; } |
|
|
|
|
$recordingParams = array( |
|
|
|
|
/* |
|
|
|
|
* NOTE: Set the recordId below to a valid id after you have |
|
|
|
|
* created a recorded meeting, and received a real recordID |
|
|
|
|
* NOTE: Set the recordId below to a valid id after you have |
|
|
|
|
* created a recorded meeting, and received a real recordID |
|
|
|
|
* back from your BBB server using the |
|
|
|
|
* getRecordingsWithXmlResponseArray method. |
|
|
|
|
*/ |
|
|
|
|
@ -429,6 +462,7 @@ class bbb { |
|
|
|
|
); |
|
|
|
|
return $this->api->deleteRecordingsWithXmlResponseArray($recordingParams); |
|
|
|
|
} |
|
|
|
|
|
|
|
|
|
/** |
|
|
|
|
* Creates a link in the links tool from the given videoconference recording |
|
|
|
|
* @param int ID of the item in the plugin_bbb_meeting table |
|
|
|
|
@ -438,7 +472,8 @@ class bbb { |
|
|
|
|
* @assert (1, null) === false |
|
|
|
|
* @assert (null, 'abcdefabcdefabcdefabcdef') === false |
|
|
|
|
*/ |
|
|
|
|
function copy_record_to_link_tool($id, $record_id) { |
|
|
|
|
public function copy_record_to_link_tool($id, $record_id) |
|
|
|
|
{ |
|
|
|
|
if (empty($id) or empty($record_id)) { |
|
|
|
|
return false; |
|
|
|
|
} |
|
|
|
|
@ -462,13 +497,15 @@ class bbb { |
|
|
|
|
} |
|
|
|
|
return false; |
|
|
|
|
} |
|
|
|
|
|
|
|
|
|
/** |
|
|
|
|
* Checks if the videoconference server is running. |
|
|
|
|
* Function currently disabled (always returns 1) |
|
|
|
|
* @return bool True if server is running, false otherwise |
|
|
|
|
* @assert () === false |
|
|
|
|
*/ |
|
|
|
|
function is_server_running() { |
|
|
|
|
public function is_server_running() |
|
|
|
|
{ |
|
|
|
|
return true; |
|
|
|
|
//return BigBlueButtonBN::isServerRunning($this->protocol.$this->url); |
|
|
|
|
} |
|
|
|
|
|