Added support for additional params

start_time / duration
output_path_variables

Author: NikitaYeryomin

autoload.php

@@ -9,9 +9,6 @@
     "Classes/Format.php",
     "Classes/Stream.php",
     "Classes/VideoCodecParameters.php",
-    "Classes/TranscodingTaskStatus.php",
-    "Classes/VideoStatus.php",
-    "Classes/VideoStorageInfo.php",
     "QencodeApiClient.php",
 );
 

examples/start_encode.php

@@ -6,35 +6,53 @@
 use Qencode\QencodeApiClient;
 
 // Replace this with your API key
-$apiKey = '5a5db6fa5b4c5';
+// API key and params below, such as transcoding profile id and transfer method id
+// can be found in your account on https://cloud.qencode.com under Project settings
+$apiKey = 'abcdefgh';
+$transcodingProfileId = 'abcdefgh';
+$transferMethodId = 'abcdefgh';
 
-$transcodingProfileId = '5a5db6fa5b8ac';
+$video_url = 'https://qa.qencode.com/static/bbb_sunflower_1080p_60fps_normal_339mb.mp4';
 
-$video_url = 'https://qa.stagevids.com/static/1.mp4';
-
-$q = new QencodeApiClient($apiKey, 'https://api-qa.qencode.com');
+$q = new QencodeApiClient($apiKey);
 
 try {
 
     $task = $q->createTask();
-    $task->start($transcodingProfileId, $video_url);
+    log_message("Created task: ".$task->getTaskToken());
+
+    //set start time (in seconds) in input video to begin transcoding from
+    $task->start_time = 30.0;
+    //duration of the video fragment (in seconds) to be transcoded
+    $task->duration = 10.0;
+
+    //Setting output file name with a custom output path variable.
+    //This refers to Output path values specified in transcoding profile for video or image settings
+    //See https://portal.qencode.com/docs for more examples
+    $task->output_path_variables->filename = 'qencode_test';
+
+    $task->start($transcodingProfileId, $video_url, $transferMethodId);
 
     do {
         sleep(5);
         $response = $task->getStatus();
     } while ($response['status'] != 'completed');
 
     foreach ($response['videos'] as $video) {
-        echo $video['user_tag'] . ': ' . $video['url'].'<BR>';
+        log_message($video['user_tag'] . ': ' . $video['url']);
     }
     echo "DONE!";
 
 
 } catch (QencodeApiException $e) {
     // API response status code was not successful
-    echo 'Qencode API Exception: ' . $e->getCode() . ' ' . $e->getMessage();
+    log_message('Qencode API Exception: ' . $e->getCode() . ' ' . $e->getMessage());
 } catch (QencodeException $e) {
     // API call failed
-    echo 'Qencode Exception: ' . $e->getMessage();
+    log_message('Qencode Exception: ' . $e->getMessage());
     var_export($pf->getLastResponseRaw());
 }
+
+function log_message($msg) {
+    echo $msg."\n";
+}

src/Classes/CustomTranscodingParams.php

@@ -11,7 +11,7 @@ class CustomTranscodingParams {
 
     /**
      * A list of objects, each describing params for a single output video stream (MP4, WEBM, HLS or MPEG-DASH).
-     * @var string
+     * @var Format
      */
     public $format;
 }

src/Classes/Format.php

@@ -23,13 +23,13 @@ class Format {
 
     /**
      * Segment duration to split media (in seconds). Defaults to 8.
-     * @var string
+     * @var int
      */
     public $segment_duration;
 
     /**
      * Contains a list of elements each describing a single view stream (e.g. for HLS format).
-     * @var string
+     * @var Stream
      */
     public $stream;
 }

src/Classes/Stream.php

@@ -113,6 +113,6 @@ class Stream {
      * Defaults to stereo
      * @var string
      */
-    public $downmix_mode;
+    //public $downmix_mode;
 
 }

src/Classes/TranscodingTask.php

@@ -9,6 +9,21 @@ class TranscodingTask {
     private $statusUrl;
     private $lastStatus;
 
+    /**
+     * Video clip start time
+     */
+    public $start_time;
+
+    /**
+     * Video duration
+     */
+    public $duration;
+
+    /**
+     * JSON-encoded string containing a dictionary (key-value pairs) of params for video or image output path.
+     */
+    public $output_path_variables;
+
     /**
      * Gets transcoding task token
      * @return string
@@ -25,6 +40,7 @@ public function getStatusUrl() {
         return $this->statusUrl;
     }
 
+    
     /**
      * @param QencodeApiClient $api a reference to QencodeApiClient object
      * @param string $task_token transcoding task token
@@ -33,6 +49,9 @@ public function __construct($api, $task_token) {
         $this->api = $api;
         $this->taskToken = $task_token;
         $this->statusUrl = null;
+        $this->start_time = null;
+        $this->duration = null;
+        $this->output_path_variables = new \stdClass();
     }
 
     /**
@@ -55,7 +74,15 @@ public function start($transcodingProfiles, $uri, $transferMethod = null, $paylo
         if ($payload) {
             $params['payload'] = $payload;
         }
-
+        if ($this->start_time) {
+            $params['start_time'] = $this->start_time;
+        }
+        if ($this->duration) {
+            $params['duration'] = $this->duration;
+        }
+        if ($this->output_path_variables) {
+            $params['output_path_variables'] = json_encode($this->output_path_variables);
+        }
         $response = $this->api->post('start_encode', $params);
         $this->statusUrl = $response['status_url'];
         return $response;