Add 3 new parameters to create API from BigBlueButton 2.5

Author: GhaziTriki

.php-cs-fixer.php

@@ -31,6 +31,7 @@
     ->setRiskyAllowed(true)
     ->setRules([
         '@PhpCsFixer' => true,
+        '@PHP74Migration' => true,
         'general_phpdoc_annotation_remove' => ['annotations' => ['expectedDeprecation']], // one should use PHPUnit built-in method instead
         'header_comment' => ['header' => $header],
         'concat_space' => ['spacing' => 'one'],

src/Parameters/CreateMeetingParameters.php

@@ -295,6 +295,40 @@ class CreateMeetingParameters extends MetaParameters
      */
     private $userCameraCap;
 
+    /**
+     * @var int
+     */
+    private $meetingCameraCap;
+
+    /**
+     * @var int
+     */
+    private $meetingExpireIfNoUserJoinedInMinutes;
+
+    /**
+     * @var int
+     */
+    private $meetingExpireWhenLastUserLeftInMinutes;
+
+    /**
+     * @var bool
+     */
+    private $preUploadedPresentationOverrideDefault;
+
+    /**
+     * @var
+     *
+     * @todo
+     */
+    private $disabledFeatures;
+
+    /**
+     * @var
+     *
+     * @todo
+     */
+    private $breakoutRoomsGroups;
+
     /**
      * CreateMeetingParameters constructor.
      *
@@ -1219,11 +1253,13 @@ public function isBreakoutRoomsEnabled(): bool
     }
 
     /**
-     * @return CreateMeetingParameters
-     *
      * @deprecated
+     *
+     * @param mixed $breakoutRoomsEnabled
+     *
+     * @return CreateMeetingParameters
      */
-    public function setBreakoutRoomsEnabled(bool $breakoutRoomsEnabled): self
+    public function setBreakoutRoomsEnabled($breakoutRoomsEnabled)
     {
         $this->breakoutRoomsEnabled = $breakoutRoomsEnabled;
 
@@ -1236,24 +1272,26 @@ public function isBreakoutRoomsRecord(): bool
     }
 
     /**
-     * @return CreateMeetingParameters
+     * @param bool $breakoutRoomsRecord
+     *
+     * @return $this
      */
-    public function setBreakoutRoomsRecord(bool $breakoutRoomsRecord): self
+    public function setBreakoutRoomsRecord($breakoutRoomsRecord)
     {
         $this->breakoutRoomsRecord = $breakoutRoomsRecord;
 
         return $this;
     }
 
-    public function isBreakoutRoomsPrivateChatEnabled(): bool
+    public function isBreakoutRoomsPrivateChatEnabled()
     {
         return $this->breakoutRoomsPrivateChatEnabled;
     }
 
     /**
      * @return CreateMeetingParameters
      */
-    public function setBreakoutRoomsPrivateChatEnabled(bool $breakoutRoomsPrivateChatEnabled): self
+    public function setBreakoutRoomsPrivateChatEnabled(bool $breakoutRoomsPrivateChatEnabled)
     {
         $this->breakoutRoomsPrivateChatEnabled = $breakoutRoomsPrivateChatEnabled;
 
@@ -1268,41 +1306,55 @@ public function getMeetingEndedURL(): string
     /**
      * @return CreateMeetingParameters
      */
-    public function setMeetingEndedURL(string $meetingEndedURL): self
+    public function setMeetingEndedURL(string $meetingEndedURL)
     {
         $this->meetingEndedURL = $meetingEndedURL;
 
         return $this;
     }
 
-    public function getMeetingLayout(): string
+    /**
+     * @return string
+     */
+    public function getMeetingLayout()
     {
         return $this->meetingLayout;
     }
 
     /**
      * @return CreateMeetingParameters
      */
-    public function setMeetingLayout(string $meetingLayout): self
+    public function setMeetingLayout(string $meetingLayout)
     {
         $this->meetingLayout = $meetingLayout;
 
         return $this;
     }
 
-    public function isAllowRequestsWithoutSession(): bool
+    /**
+     * @return bool
+     */
+    public function isAllowRequestsWithoutSession()
     {
         return $this->allowRequestsWithoutSession;
     }
 
+    /**
+     * @param $allowRequestsWithoutSession
+     *
+     * @return $this
+     */
     public function setAllowRequestsWithoutSession($allowRequestsWithoutSession)
     {
         $this->allowRequestsWithoutSession = $allowRequestsWithoutSession;
 
         return $this;
     }
 
-    public function getUserCameraCap(): int
+    /**
+     * @return int
+     */
+    public function getUserCameraCap()
     {
         return $this->userCameraCap;
     }
@@ -1319,6 +1371,54 @@ public function setUserCameraCap($userCameraCap)
         return $this;
     }
 
+    public function getMeetingCameraCap(): int
+    {
+        return $this->meetingCameraCap;
+    }
+
+    public function setMeetingCameraCap(int $meetingCameraCap): CreateMeetingParameters
+    {
+        $this->meetingCameraCap = $meetingCameraCap;
+
+        return $this;
+    }
+
+    public function getMeetingExpireIfNoUserJoinedInMinutes(): int
+    {
+        return $this->meetingExpireIfNoUserJoinedInMinutes;
+    }
+
+    public function setMeetingExpireIfNoUserJoinedInMinutes(int $meetingExpireIfNoUserJoinedInMinutes): CreateMeetingParameters
+    {
+        $this->meetingExpireIfNoUserJoinedInMinutes = $meetingExpireIfNoUserJoinedInMinutes;
+
+        return $this;
+    }
+
+    public function getMeetingExpireWhenLastUserLeftInMinutes(): int
+    {
+        return $this->meetingExpireWhenLastUserLeftInMinutes;
+    }
+
+    public function setMeetingExpireWhenLastUserLeftInMinutes(int $meetingExpireWhenLastUserLeftInMinutes): CreateMeetingParameters
+    {
+        $this->meetingExpireWhenLastUserLeftInMinutes = $meetingExpireWhenLastUserLeftInMinutes;
+
+        return $this;
+    }
+
+    public function isPreUploadedPresentationOverrideDefault(): bool
+    {
+        return $this->preUploadedPresentationOverrideDefault;
+    }
+
+    public function setPreUploadedPresentationOverrideDefault(bool $preUploadedPresentationOverrideDefault): CreateMeetingParameters
+    {
+        $this->preUploadedPresentationOverrideDefault = $preUploadedPresentationOverrideDefault;
+
+        return $this;
+    }
+
     /**
      * @return array
      */
@@ -1428,6 +1528,10 @@ public function getHTTPQuery()
             'endWhenNoModerator'                     => $this->endWhenNoModerator ? 'true' : 'false',
             'meetingKeepEvents'                      => $this->meetingKeepEvents ? 'true' : 'false',
             'meetingLayout'                          => $this->meetingLayout,
+            'meetingCameraCap'                       => $this->meetingCameraCap,
+            'meetingExpireIfNoUserJoinedInMinutes'   => $this->meetingExpireIfNoUserJoinedInMinutes,
+            'meetingExpireWhenLastUserLeftInMinutes' => $this->meetingExpireWhenLastUserLeftInMinutes,
+            'preUploadedPresentationOverrideDefault' => $this->preUploadedPresentationOverrideDefault,
         ];
 
         // Add breakout rooms parameters only if the meeting is a breakout room

tests/Parameters/CreateMeetingParametersTest.php

@@ -82,6 +82,9 @@ public function testCreateMeetingParameters()
         $this->assertEquals($params['meetingEndedURL'], $createMeetingParams->getMeetingEndedURL());
         $this->assertEquals($params['meetingLayout'], $createMeetingParams->getMeetingLayout());
         $this->assertEquals($params['userCameraCap'], $createMeetingParams->getUserCameraCap());
+        $this->assertEquals($params['meetingExpireIfNoUserJoinedInMinutes'], $createMeetingParams->getMeetingExpireIfNoUserJoinedInMinutes());
+        $this->assertEquals($params['meetingExpireWhenLastUserLeftInMinutes'], $createMeetingParams->getMeetingExpireWhenLastUserLeftInMinutes());
+        $this->assertEquals($params['preUploadedPresentationOverrideDefault'], $createMeetingParams->isPreUploadedPresentationOverrideDefault());
         $this->assertEquals($params['meta_presenter'], $createMeetingParams->getMeta('presenter'));
         $this->assertEquals($params['meta_endCallbackUrl'], $createMeetingParams->getMeta('endCallbackUrl'));
         $this->assertEquals($params['meta_bbb-recording-ready-url'], $createMeetingParams->getMeta('bbb-recording-ready-url'));

tests/TestCase.php

@@ -175,6 +175,9 @@ protected function generateCreateParams()
             'breakoutRoomsPrivateChatEnabled'        => $this->faker->boolean(50),
             'meetingEndedURL'                        => $this->faker->url,
             'meetingLayout'                          => $this->faker->randomElement(MeetingLayout::getValues()),
+            'meetingExpireIfNoUserJoinedInMinutes'   => $this->faker->numberBetween(1, 10),
+            'meetingExpireWhenLastUserLeftInMinutes' => $this->faker->numberBetween(5, 15),
+            'preUploadedPresentationOverrideDefault' => $this->faker->boolean,
             'meta_presenter'                         => $this->faker->name,
             'meta_endCallbackUrl'                    => $this->faker->url,
             'meta_bbb-recording-ready-url'           => $this->faker->url,
@@ -363,7 +366,7 @@ protected function getUpdateRecordingsParamsMock($params)
 
     protected function loadXmlFile($path)
     {
-        return simplexml_load_string(file_get_contents(($path)));
+        return simplexml_load_string(file_get_contents($path));
     }
 
     protected function minifyString($string)