Update (see description)

- Updated all.php
- Updated README.md

Author: qcardona

README.md

@@ -28,13 +28,16 @@ You can use JSON2Video PHP SDK as a Composer package or with a simple require_on
 ### Using require_once
 The simplest way :-)
 
-1) Download all.php from the /bundled folder into your project directory
+1) Download [all.php](https://github.com/JSON2Video/json2video-php-sdk/blob/main/bundled/all.php) from the /bundled folder into your project directory
 2) Import the library:
 
 ```php
 <?php
     require_once 'path/to/the/sdk/all.php';
 
+    use JSON2Video\Movie;
+    use JSON2Video\Scene;
+
 ```
 
 ### Using Composer
@@ -44,14 +47,20 @@ The SDK has no external dependencies on other packages.
 2) Use composer:
 
 ```
-$ composer require json2video/json2video-php-sdk
+composer require json2video/json2video-php-sdk
 ```
 
 ## Hello world
 JSON2Video makes video creation easy as a piece of cake:
 
 ```php
 <?php
+
+    require 'vendor/autoload.php';
+
+    use JSON2Video\Movie;
+    use JSON2Video\Scene;
+
     // Create a new movie
     $movie = new Movie;
 
@@ -88,8 +97,11 @@ JSON2Video makes video creation easy as a piece of cake:
     // Add the scene to the movie
     $movie->addScene($scene);
 
-    // Call the API and render the movie
+    // Call the API and start rendering the movie
     $movie->render();
+
+    // Wait for the render to finish
+    $movie->waitToFinish();
 ```
 
 This is the resulting video:

bundled/all.php

@@ -57,19 +57,8 @@ public function getObject() {
 
 
 class Scene extends Base {
-    protected $properties = ['comment', 'background_color', 'duration', 'cache'];
-
+    protected $properties = ['comment', 'background_color', 'transition', 'duration', 'cache'];
     protected $object = [];
-
-    public function setTransition($style=null, $duration=null, $type=null) {
-        if ($style || $duration || $type) {
-            if (!isset($this->object['transition'])) $this->object['transition'] = [];
-            if (!is_null($style)) $this->object['transition']['style'] = $style;
-            if (!is_null($duration)) $this->object['transition']['duration'] = $duration;
-            if (!is_null($type)) $this->object['transition']['type'] = $type;
-        }
-    }
-    
 }
 
 class Movie extends Base {
@@ -170,4 +159,39 @@ public function getStatus() {
 
         return false;
     }
+
+    public function waitToFinish($delay=5, $callback=null) {
+
+        $max_loops = 100;
+        $loops = 0;
+
+        while ($loops<$max_loops) {
+            $response = $this->getStatus();
+            
+            if ($response && ($response['success']??false) && isset($response['movies']) && count($response['movies'])==1) {
+                if (isset($response['movies'][0]['status']) && $response['movies'][0]['status']=='done') {
+                    if (is_callable($callback)) $callback($response['movies'][0]);
+                    else $this->printStatus($response['movies'][0]);
+
+                    return $response['movies'][0];
+                }
+            }
+            else {
+                throw new \Error('Invalid API response');
+            }
+
+            if (is_callable($callback)) $callback($response['movies'][0]);
+            else $this->printStatus($response['movies'][0]);
+
+            sleep($delay);
+            $loops++;
+        }
+    }
+
+    public function printStatus($response) {
+        echo 'Status: ', $response['status'], ' / ', $response['task'], PHP_EOL;
+        if ($response['status']=='done') {
+            echo PHP_EOL, 'Movie URL: ', $response['url'], PHP_EOL, PHP_EOL;
+        }
+    }
 }