Add user camera cap feature

Author: samuelwei

src/Parameters/CreateMeetingParameters.php

@@ -111,6 +111,8 @@
  * @method $this setAllowRequestsWithoutSession(bool $isAllowRequestsWithoutSession)
  * @method bool|null isVirtualBackgroundsDisabled()
  * @method $this setVirtualBackgroundsDisabled(bool $isVirtualBackgroundsDisabled)
+ * @method int getUserCameraCap()
+ * @method $this setUserCameraCap(int $cap)
  *
  */
 class CreateMeetingParameters extends MetaParameters
@@ -360,6 +362,11 @@ class CreateMeetingParameters extends MetaParameters
      */
     protected $virtualBackgroundsDisabled;
 
+    /**
+     * @var int
+     */
+    protected $userCameraCap;
+
     /**
      * @var array
      */
@@ -528,6 +535,24 @@ public function isBreakout()
         return $this->isBreakout;
     }
 
+    /**
+     * @return bool
+     */
+    public function isUserCameraCapDisabled()
+    {
+        return $this->userCameraCap === 0;
+    }
+
+    /**
+     * @return CreateMeetingParameters
+     */
+    public function disableUserCameraCap()
+    {
+        $this->userCameraCap = 0;
+
+        return $this;
+    }
+
     /**
      * @return CreateMeetingParameters
      */

tests/TestCase.php

@@ -117,6 +117,7 @@ protected function generateCreateParams()
             'breakoutRoomsRecord'                       => $this->faker->boolean(50),
             'allowRequestsWithoutSession'               => $this->faker->boolean(50),
             'virtualBackgroundsDisabled'                => $this->faker->boolean(50),
+            'userCameraCap'                             => $this->faker->numberBetween(1, 5),
         ];
     }
 
@@ -186,7 +187,8 @@ protected function getCreateMock($params)
             ->setBreakoutRoomsPrivateChatEnabled($params['breakoutRoomsPrivateChatEnabled'])
             ->setBreakoutRoomsRecord($params['breakoutRoomsRecord'])
             ->setAllowRequestsWithoutSession($params['allowRequestsWithoutSession'])
-            ->setVirtualBackgroundsDisabled($params['virtualBackgroundsDisabled']);
+            ->setVirtualBackgroundsDisabled($params['virtualBackgroundsDisabled'])
+            ->setUserCameraCap($params['userCameraCap']);
     }
 
     /**

tests/unit/Parameters/CreateMeetingParametersTest.php

@@ -157,4 +157,16 @@ public function testGetPresentationsAsXMLWithFile()
         $createMeetingParams->addPresentation('bbb_logo.png', file_get_contents(__DIR__ . DIRECTORY_SEPARATOR . '..' . DIRECTORY_SEPARATOR . '..' . DIRECTORY_SEPARATOR . 'fixtures' . DIRECTORY_SEPARATOR . 'bbb_logo.png'));
         $this->assertXmlStringEqualsXmlFile(__DIR__ . DIRECTORY_SEPARATOR . '..' . DIRECTORY_SEPARATOR . '..' . DIRECTORY_SEPARATOR . 'fixtures' . DIRECTORY_SEPARATOR . 'presentation_with_embedded_file.xml', $createMeetingParams->getPresentationsAsXML());
     }
+
+    public function testUserCameraCap()
+    {
+        $params              = $this->generateCreateParams();
+        $createMeetingParams = $this->getCreateMock($params);
+        $this->assertEquals($params['userCameraCap'], $createMeetingParams->getUserCameraCap());
+        $this->assertFalse($createMeetingParams->isUserCameraCapDisabled());
+
+        $createMeetingParams->disableUserCameraCap();
+        $this->assertEquals(0, $createMeetingParams->getUserCameraCap());
+        $this->assertTrue($createMeetingParams->isUserCameraCapDisabled());
+    }
 }