Added SIP Video support

Author: dragonmantank

src/OpenTok/OpenTok.php

@@ -743,6 +743,7 @@ public function dial($sessionId, $token, $sipUri, $options = [])
             'headers' => [],
             'secure' => true,
             'from' => null,
+            'video' => false,
         );
         $options = array_merge($defaults, array_intersect_key($options, $defaults));
         list($headers, $secure, $from) = array_values($options);

src/OpenTok/Util/Client.php

@@ -2,6 +2,7 @@
 
 namespace OpenTok\Util;
 
+use Exception as GlobalException;
 use OpenTok\Layout;
 use Firebase\JWT\JWT;
 use OpenTok\MediaMode;
@@ -13,6 +14,7 @@
 use Psr\Http\Message\RequestInterface;
 use OpenTok\Exception\ArchiveException;
 use GuzzleHttp\Exception\ClientException;
+use GuzzleHttp\Exception\GuzzleException;
 use GuzzleHttp\Exception\ServerException;
 use OpenTok\Exception\BroadcastException;
 use GuzzleHttp\Exception\RequestException;
@@ -475,7 +477,18 @@ public function setStreamClassLists($sessionId, $payload)
         }
     }
 
-
+    /**
+     * @param string $sessionId
+     * @param string $token
+     * @param string $sipUri
+     * @param array{secure: bool, headers?: array<string, string>, auth?: array{username: string, password: string}, from?: string, video?: boolean} $options
+     * @return array{id: string, streamId: string, connectId: string}
+     * @throws AuthenticationException
+     * @throws DomainException
+     * @throws UnexpectedValueException
+     * @throws GlobalException
+     * @throws GuzzleException
+     */
     public function dial($sessionId, $token, $sipUri, $options)
     {
         $body = array(
@@ -487,17 +500,22 @@ public function dial($sessionId, $token, $sipUri, $options)
             )
         );
 
-        if (isset($options) && array_key_exists('headers', $options) && count($options['headers']) > 0) {
+        if (array_key_exists('headers', $options) && count($options['headers']) > 0) {
             $body['sip']['headers'] = $options['headers'];
         }
 
-        if (isset($options) && array_key_exists('auth', $options)) {
+        if (array_key_exists('auth', $options)) {
             $body['sip']['auth'] = $options['auth'];
         }
-        if (isset($options) && array_key_exists('from', $options)) {
+
+        if (array_key_exists('from', $options)) {
             $body['sip']['from'] = $options['from'];
         }
 
+        if (array_key_exists('video', $options)) {
+            $body['sip']['video'] = (bool) $options['video'];
+        }
+
         // set up the request
         $request = new Request('POST', '/v2/project/' . $this->apiKey . '/call');
 
@@ -510,6 +528,7 @@ public function dial($sessionId, $token, $sipUri, $options)
         } catch (\Exception $e) {
             $this->handleException($e);
         }
+
         return $sipJson;
     }
 

tests/OpenTokTest/OpenTokTest.php

@@ -1633,6 +1633,37 @@ public function testSipCallFrom()
         $this->assertEquals($from, $body->sip->from);
     }
 
+    public function testSipCallVideo()
+    {
+        // Arrange
+        $this->setupOTWithMocks([[
+            'code' => 200,
+            'headers' => [
+                'Content-Type' => 'application/json'
+            ],
+            'path' => 'v2/project/APIKEY/dial'
+        ]]);
+
+        $sessionId = '1_MX4xMjM0NTY3OH4-VGh1IEZlYiAyNyAwNDozODozMSBQU1QgMjAxNH4wLjI0NDgyMjI';
+        $bogusToken = 'T1==TEST';
+        $bogusSipUri = 'sip:[email protected]';
+
+        // Act
+        $sipCall = $this->opentok->dial($sessionId, $bogusToken, $bogusSipUri, ['video' => true]);
+
+        // Assert
+        $this->assertInstanceOf('OpenTok\SipCall', $sipCall);
+        $this->assertNotNull($sipCall->id);
+        $this->assertNotNull($sipCall->connectionId);
+        $this->assertNotNull($sipCall->streamId);
+
+        $this->assertCount(1, $this->historyContainer);
+        $request = $this->historyContainer[0]['request'];
+
+        $body = json_decode($request->getBody());
+        $this->assertEquals(true, $body->sip->video);
+    }
+
     public function testSignalData()
     {
         // Arrange