<?php
/**
* This code was generated by
* \ / _ _ _| _ _
* | (_)\/(_)(_|\/| |(/_ v1.0.0
* / /
*/
namespace Twilio\Rest\Video\V1;
use Twilio\Options;
use Twilio\Values;
/**
* PLEASE NOTE that this class contains preview products that are subject to change. Use them with caution. If you currently do not have developer preview access, please contact help@twilio.com.
*/
abstract class CompositionOptions {
/**
* @param string $status Only show Compositions with the given status.
* @param \DateTime $dateCreatedAfter Only show Compositions that started on or
* after this ISO8601 date-time.
* @param \DateTime $dateCreatedBefore Only show Compositions that started
* before this this ISO8601 date-time.
* @param string $roomSid The room_sid
* @return ReadCompositionOptions Options builder
*/
public static function read($status = Values::NONE, $dateCreatedAfter = Values::NONE, $dateCreatedBefore = Values::NONE, $roomSid = Values::NONE) {
return new ReadCompositionOptions($status, $dateCreatedAfter, $dateCreatedBefore, $roomSid);
}
/**
* @param string $roomSid Twilio Room SID.
* @param array $videoLayout The JSON video layout description.
* @param string $audioSources A list of audio sources related to this
* Composition.
* @param string $audioSourcesExcluded A list of audio sources excluded related
* to this Composition.
* @param string $resolution Pixel resolution of the composed video.
* @param string $format ontainer format of the Composition media file. Any of
* the following: `mp4`, `webm`.
* @param string $statusCallback A URL that Twilio sends asynchronous webhook
* requests to on every composition event.
* @param string $statusCallbackMethod HTTP method Twilio should use when
* requesting the above URL.
* @param boolean $trim Boolean flag for clipping intervals that have no media.
* @return CreateCompositionOptions Options builder
*/
public static function create($roomSid = Values::NONE, $videoLayout = Values::NONE, $audioSources = Values::NONE, $audioSourcesExcluded = Values::NONE, $resolution = Values::NONE, $format = Values::NONE, $statusCallback = Values::NONE, $statusCallbackMethod = Values::NONE, $trim = Values::NONE) {
return new CreateCompositionOptions($roomSid, $videoLayout, $audioSources, $audioSourcesExcluded, $resolution, $format, $statusCallback, $statusCallbackMethod, $trim);
}
}
class ReadCompositionOptions extends Options {
/**
* @param string $status Only show Compositions with the given status.
* @param \DateTime $dateCreatedAfter Only show Compositions that started on or
* after this ISO8601 date-time.
* @param \DateTime $dateCreatedBefore Only show Compositions that started
* before this this ISO8601 date-time.
* @param string $roomSid The room_sid
*/
public function __construct($status = Values::NONE, $dateCreatedAfter = Values::NONE, $dateCreatedBefore = Values::NONE, $roomSid = Values::NONE) {
$this->options['status'] = $status;
$this->options['dateCreatedAfter'] = $dateCreatedAfter;
$this->options['dateCreatedBefore'] = $dateCreatedBefore;
$this->options['roomSid'] = $roomSid;
}
/**
* Only show Compositions with the given status.
*
* @param string $status Only show Compositions with the given status.
* @return $this Fluent Builder
*/
public function setStatus($status) {
$this->options['status'] = $status;
return $this;
}
/**
* Only show Compositions that started on or after this ISO8601 date-time, given as `YYYY-MM-DDThh:mm:ss-hh:mm`.
*
* @param \DateTime $dateCreatedAfter Only show Compositions that started on or
* after this ISO8601 date-time.
* @return $this Fluent Builder
*/
public function setDateCreatedAfter($dateCreatedAfter) {
$this->options['dateCreatedAfter'] = $dateCreatedAfter;
return $this;
}
/**
* Only show Compositions that started before this this ISO8601 date-time, given as `YYYY-MM-DDThh:mm:ss-hh:mm`.
*
* @param \DateTime $dateCreatedBefore Only show Compositions that started
* before this this ISO8601 date-time.
* @return $this Fluent Builder
*/
public function setDateCreatedBefore($dateCreatedBefore) {
$this->options['dateCreatedBefore'] = $dateCreatedBefore;
return $this;
}
/**
* The room_sid
*
* @param string $roomSid The room_sid
* @return $this Fluent Builder
*/
public function setRoomSid($roomSid) {
$this->options['roomSid'] = $roomSid;
return $this;
}
/**
* Provide a friendly representation
*
* @return string Machine friendly representation
*/
public function __toString() {
$options = array();
foreach ($this->options as $key => $value) {
if ($value != Values::NONE) {
$options[] = "$key=$value";
}
}
return '[Twilio.Video.V1.ReadCompositionOptions ' . implode(' ', $options) . ']';
}
}
class CreateCompositionOptions extends Options {
/**
* @param string $roomSid Twilio Room SID.
* @param array $videoLayout The JSON video layout description.
* @param string $audioSources A list of audio sources related to this
* Composition.
* @param string $audioSourcesExcluded A list of audio sources excluded related
* to this Composition.
* @param string $resolution Pixel resolution of the composed video.
* @param string $format ontainer format of the Composition media file. Any of
* the following: `mp4`, `webm`.
* @param string $statusCallback A URL that Twilio sends asynchronous webhook
* requests to on every composition event.
* @param string $statusCallbackMethod HTTP method Twilio should use when
* requesting the above URL.
* @param boolean $trim Boolean flag for clipping intervals that have no media.
*/
public function __construct($roomSid = Values::NONE, $videoLayout = Values::NONE, $audioSources = Values::NONE, $audioSourcesExcluded = Values::NONE, $resolution = Values::NONE, $format = Values::NONE, $statusCallback = Values::NONE, $statusCallbackMethod = Values::NONE, $trim = Values::NONE) {
$this->options['roomSid'] = $roomSid;
$this->options['videoLayout'] = $videoLayout;
$this->options['audioSources'] = $audioSources;
$this->options['audioSourcesExcluded'] = $audioSourcesExcluded;
$this->options['resolution'] = $resolution;
$this->options['format'] = $format;
$this->options['statusCallback'] = $statusCallback;
$this->options['statusCallbackMethod'] = $statusCallbackMethod;
$this->options['trim'] = $trim;
}
/**
* Group Room SID owning the media tracks to be used as Composition sources.
*
* @param string $roomSid Twilio Room SID.
* @return $this Fluent Builder
*/
public function setRoomSid($roomSid) {
$this->options['roomSid'] = $roomSid;
return $this;
}
/**
* A JSON object defining the video layout of the Composition in terms of regions. See the section [Managing Video Layouts](#managing-video-layouts) below for further information.
*
* @param array $videoLayout The JSON video layout description.
* @return $this Fluent Builder
*/
public function setVideoLayout($videoLayout) {
$this->options['videoLayout'] = $videoLayout;
return $this;
}
/**
* An array of audio sources to merge. All the specified sources must belong to the same Group Room. It can include:<ul><li>Zero or more `RecordingTrackSid`</li><li>Zero or more `MediaTrackSid`</li><li>Zero or more `ParticipantSid`</li><li>Zero or more Track names. These can be specified using wildcards (e.g. `student*`)</li></ul>
*
* @param string $audioSources A list of audio sources related to this
* Composition.
* @return $this Fluent Builder
*/
public function setAudioSources($audioSources) {
$this->options['audioSources'] = $audioSources;
return $this;
}
/**
* An array of audio sources to exclude from the Composition. Any new Composition shall include all audio sources specified in `AudioSources` except for the ones specified in `AudioSourcesExcluded`. This parameter may include:<ul><li>Zero or more `RecordingTrackSid`</li><li>Zero or more `MediaTrackSid`</li><li>Zero or more `ParticipantSid`</li><li>Zero or more Track names. These can be specified using wildcards (e.g. `student*`)</li></ul>
*
* @param string $audioSourcesExcluded A list of audio sources excluded related
* to this Composition.
* @return $this Fluent Builder
*/
public function setAudioSourcesExcluded($audioSourcesExcluded) {
$this->options['audioSourcesExcluded'] = $audioSourcesExcluded;
return $this;
}
/**
* A string representing the numbers of pixels for rows (width) and columns (height) of the generated composed video. This string must have the format `{width}x{height}`. This parameter must comply with the following constraints:<ul><li>`width >= 16 && width <= 1280`</li><li>`height >= 16 && height <= 1280`</li><li>`width * height <= 921,600`</li></ul>Typical values are:<ul><li>HD = `1280x720`</li><li>PAL = `1024x576`</li><li>VGA = `640x480`</li><li>CIF = `320x240`</li></ul>Note that the `Resolution` implicitly imposes an aspect ratio to the resulting composition. When the original video tracks get constrained by this aspect ratio they are scaled-down to fit. You can find detailed information in the [Managing Video Layouts](#managing-video-layouts) section. Defaults to `640x480`.
*
* @param string $resolution Pixel resolution of the composed video.
* @return $this Fluent Builder
*/
public function setResolution($resolution) {
$this->options['resolution'] = $resolution;
return $this;
}
/**
* Container format of the Composition media file. Can be any of the following: `mp4`, `webm`. The use of `mp4` or `webm` makes mandatory the specification of `AudioSources` and/or one `VideoLayout` element containing a valid `video_sources` list, otherwise an error is fired. Defaults to `webm`.
*
* @param string $format ontainer format of the Composition media file. Any of
* the following: `mp4`, `webm`.
* @return $this Fluent Builder
*/
public function setFormat($format) {
$this->options['format'] = $format;
return $this;
}
/**
* A URL that Twilio sends asynchronous webhook requests to on every composition event. If not provided, status callback events will not be dispatched.
*
* @param string $statusCallback A URL that Twilio sends asynchronous webhook
* requests to on every composition event.
* @return $this Fluent Builder
*/
public function setStatusCallback($statusCallback) {
$this->options['statusCallback'] = $statusCallback;
return $this;
}
/**
* HTTP method Twilio should use when requesting the above URL. Defaults to `POST`.
*
* @param string $statusCallbackMethod HTTP method Twilio should use when
* requesting the above URL.
* @return $this Fluent Builder
*/
public function setStatusCallbackMethod($statusCallbackMethod) {
$this->options['statusCallbackMethod'] = $statusCallbackMethod;
return $this;
}
/**
* When activated, clips all the Composition intervals where there is no active media. This results in shorter compositions in cases when the Room was created but no Participant joined for some time, or if all the Participants left the room and joined at a later stage, as those gaps will be removed. You can find further information in the [Managing Video Layouts](#managing-video-layouts) section. Defaults to `true`.
*
* @param boolean $trim Boolean flag for clipping intervals that have no media.
* @return $this Fluent Builder
*/
public function setTrim($trim) {
$this->options['trim'] = $trim;
return $this;
}
/**
* Provide a friendly representation
*
* @return string Machine friendly representation
*/
public function __toString() {
$options = array();
foreach ($this->options as $key => $value) {
if ($value != Values::NONE) {
$options[] = "$key=$value";
}
}
return '[Twilio.Video.V1.CreateCompositionOptions ' . implode(' ', $options) . ']';
}
}