/src/Twilio/Rest/Api/V2010/Account/Conference/ParticipantOptions.php

http://github.com/twilio/twilio-php · PHP · 935 lines · 299 code · 64 blank · 572 comment · 0 complexity · 4028035d38cdb955dee4e0dc4eefea6c MD5 · raw file

Large files are truncated click here to view the full file

    

  1. <?php
    2. 

  2. 

  3. /**
    4. 

  4.  * This code was generated by
    5. 

  5.  * \ / _    _  _|   _  _
    6. 

  6.  * | (_)\/(_)(_|\/| |(/_  v1.0.0
    7. 

  7.  * /       /
    8. 

  8.  */
    9. 

  9. 

  10. namespace Twilio\Rest\Api\V2010\Account\Conference;
    11. 

  11. 

  12. use Twilio\Options;
    13. 

  13. use Twilio\Values;
    14. 

  14. 

  15. abstract class ParticipantOptions {
    16. 

  16.     /**
    17. 

  17.      * @param bool $muted Whether the participant should be muted
    18. 

  18.      * @param bool $hold Whether the participant should be on hold
    19. 

  19.      * @param string $holdUrl The URL we call using the `hold_method` for  music
    20. 

  20.      *                        that plays when the participant is on hold
    21. 

  21.      * @param string $holdMethod The HTTP method we should use to call hold_url
    22. 

  22.      * @param string $announceUrl The URL we call using the `announce_method` for
    23. 

  23.      *                            an announcement to the participant
    24. 

  24.      * @param string $announceMethod The HTTP method we should use to call
    25. 

  25.      *                               announce_url
    26. 

  26.      * @param string $waitUrl URL that hosts pre-conference hold music
    27. 

  27.      * @param string $waitMethod The HTTP method we should use to call `wait_url`
    28. 

  28.      * @param bool $beepOnExit Whether to play a notification beep to the
    29. 

  29.      *                         conference when the participant exit
    30. 

  30.      * @param bool $endConferenceOnExit Whether to end the conference when the
    31. 

  31.      *                                  participant leaves
    32. 

  32.      * @param bool $coaching Indicates if the participant changed to coach
    33. 

  33.      * @param string $callSidToCoach The SID of the participant who is being
    34. 

  34.      *                               `coached`
    35. 

  35.      * @return UpdateParticipantOptions Options builder
    36. 

  36.      */
    37. 

  37.     public static function update(bool $muted = Values::NONE, bool $hold = Values::NONE, string $holdUrl = Values::NONE, string $holdMethod = Values::NONE, string $announceUrl = Values::NONE, string $announceMethod = Values::NONE, string $waitUrl = Values::NONE, string $waitMethod = Values::NONE, bool $beepOnExit = Values::NONE, bool $endConferenceOnExit = Values::NONE, bool $coaching = Values::NONE, string $callSidToCoach = Values::NONE): UpdateParticipantOptions {
    38. 

  38.         return new UpdateParticipantOptions($muted, $hold, $holdUrl, $holdMethod, $announceUrl, $announceMethod, $waitUrl, $waitMethod, $beepOnExit, $endConferenceOnExit, $coaching, $callSidToCoach);
    39. 

  39.     }
    40. 

  40. 

  41.     /**
    42. 

  42.      * @param string $statusCallback The URL we should call to send status
    43. 

  43.      *                               information to your application
    44. 

  44.      * @param string $statusCallbackMethod The HTTP method we should use to call
    45. 

  45.      *                                     `status_callback`
    46. 

  46.      * @param string[] $statusCallbackEvent Set state change events that will
    47. 

  47.      *                                      trigger a callback
    48. 

  48.      * @param string $label The label of this participant
    49. 

  49.      * @param int $timeout he number of seconds that we should wait for an answer
    50. 

  50.      * @param bool $record Whether to record the participant and their conferences
    51. 

  51.      * @param bool $muted Whether to mute the agent
    52. 

  52.      * @param string $beep Whether to play a notification beep to the conference
    53. 

  53.      *                     when the participant joins
    54. 

  54.      * @param bool $startConferenceOnEnter Whether the conference starts when the
    55. 

  55.      *                                     participant joins the conference
    56. 

  56.      * @param bool $endConferenceOnExit Whether to end the conference when the
    57. 

  57.      *                                  participant leaves
    58. 

  58.      * @param string $waitUrl URL that hosts pre-conference hold music
    59. 

  59.      * @param string $waitMethod The HTTP method we should use to call `wait_url`
    60. 

  60.      * @param bool $earlyMedia Whether agents can hear the state of the outbound
    61. 

  61.      *                         call
    62. 

  62.      * @param int $maxParticipants The maximum number of agent conference
    63. 

  63.      *                             participants
    64. 

  64.      * @param string $conferenceRecord Whether to record the conference the
    65. 

  65.      *                                 participant is joining
    66. 

  66.      * @param string $conferenceTrim Whether to trim leading and trailing silence
    67. 

  67.      *                               from your recorded conference audio files
    68. 

  68.      * @param string $conferenceStatusCallback The callback URL for conference
    69. 

  69.      *                                         events
    70. 

  70.      * @param string $conferenceStatusCallbackMethod HTTP method for requesting
    71. 

  71.      *                                               `conference_status_callback`
    72. 

  72.      *                                               URL
    73. 

  73.      * @param string[] $conferenceStatusCallbackEvent The conference state changes
    74. 

  74.      *                                                that should generate a call
    75. 

  75.      *                                                to
    76. 

  76.      *                                                `conference_status_callback`
    77. 

  77.      * @param string $recordingChannels Specify `mono` or `dual` recording channels
    78. 

  78.      * @param string $recordingStatusCallback The URL that we should call using the
    79. 

  79.      *                                        `recording_status_callback_method`
    80. 

  80.      *                                        when the recording status changes
    81. 

  81.      * @param string $recordingStatusCallbackMethod The HTTP method we should use
    82. 

  82.      *                                              when we call
    83. 

  83.      *                                              `recording_status_callback`
    84. 

  84.      * @param string $sipAuthUsername The SIP username used for authentication
    85. 

  85.      * @param string $sipAuthPassword The SIP password for authentication
    86. 

  86.      * @param string $region The region where we should mix the conference audio
    87. 

  87.      * @param string $conferenceRecordingStatusCallback The URL we should call
    88. 

  88.      *                                                  using the
    89. 

  89.      *                                                  `conference_recording_status_callback_method` when the conference recording is available
    90. 

  90.      * @param string $conferenceRecordingStatusCallbackMethod The HTTP method we
    91. 

  91.      *                                                        should use to call
    92. 

  92.      *                                                        `conference_recording_status_callback`
    93. 

  93.      * @param string[] $recordingStatusCallbackEvent The recording state changes
    94. 

  94.      *                                               that should generate a call to
    95. 

  95.      *                                               `recording_status_callback`
    96. 

  96.      * @param string[] $conferenceRecordingStatusCallbackEvent The conference
    97. 

  97.      *                                                         recording state
    98. 

  98.      *                                                         changes that should
    99. 

  99.      *                                                         generate a call to
    100. 

  100.      *                                                         `conference_recording_status_callback`
    101. 

  101.      * @param bool $coaching Indicates if the participant changed to coach
    102. 

  102.      * @param string $callSidToCoach The SID of the participant who is being
    103. 

  103.      *                               `coached`
    104. 

  104.      * @param string $jitterBufferSize Jitter Buffer size for the connecting
    105. 

  105.      *                                 participant
    106. 

  106.      * @param string $byoc BYOC trunk SID (Beta)
    107. 

  107.      * @param string $callerId The phone number, Client identifier, or username
    108. 

  108.      *                         portion of SIP address that made this call.
    109. 

  109.      * @param string $callReason Reason for the call (Branded Calls Beta)
    110. 

  110.      * @param string $recordingTrack The track(s) to record
    111. 

  111.      * @param int $timeLimit The maximum duration of the call in seconds.
    112. 

  112.      * @return CreateParticipantOptions Options builder
    113. 

  113.      */
    114. 

  114.     public static function create(string $statusCallback = Values::NONE, string $statusCallbackMethod = Values::NONE, array $statusCallbackEvent = Values::ARRAY_NONE, string $label = Values::NONE, int $timeout = Values::NONE, bool $record = Values::NONE, bool $muted = Values::NONE, string $beep = Values::NONE, bool $startConferenceOnEnter = Values::NONE, bool $endConferenceOnExit = Values::NONE, string $waitUrl = Values::NONE, string $waitMethod = Values::NONE, bool $earlyMedia = Values::NONE, int $maxParticipants = Values::NONE, string $conferenceRecord = Values::NONE, string $conferenceTrim = Values::NONE, string $conferenceStatusCallback = Values::NONE, string $conferenceStatusCallbackMethod = Values::NONE, array $conferenceStatusCallbackEvent = Values::ARRAY_NONE, string $recordingChannels = Values::NONE, string $recordingStatusCallback = Values::NONE, string $recordingStatusCallbackMethod = Values::NONE, string $sipAuthUsername = Values::NONE, string $sipAuthPassword = Values::NONE, string $region = Values::NONE, string $conferenceRecordingStatusCallback = Values::NONE, string $conferenceRecordingStatusCallbackMethod = Values::NONE, array $recordingStatusCallbackEvent = Values::ARRAY_NONE, array $conferenceRecordingStatusCallbackEvent = Values::ARRAY_NONE, bool $coaching = Values::NONE, string $callSidToCoach = Values::NONE, string $jitterBufferSize = Values::NONE, string $byoc = Values::NONE, string $callerId = Values::NONE, string $callReason = Values::NONE, string $recordingTrack = Values::NONE, int $timeLimit = Values::NONE): CreateParticipantOptions {
    115. 

  115.         return new CreateParticipantOptions($statusCallback, $statusCallbackMethod, $statusCallbackEvent, $label, $timeout, $record, $muted, $beep, $startConferenceOnEnter, $endConferenceOnExit, $waitUrl, $waitMethod, $earlyMedia, $maxParticipants, $conferenceRecord, $conferenceTrim, $conferenceStatusCallback, $conferenceStatusCallbackMethod, $conferenceStatusCallbackEvent, $recordingChannels, $recordingStatusCallback, $recordingStatusCallbackMethod, $sipAuthUsername, $sipAuthPassword, $region, $conferenceRecordingStatusCallback, $conferenceRecordingStatusCallbackMethod, $recordingStatusCallbackEvent, $conferenceRecordingStatusCallbackEvent, $coaching, $callSidToCoach, $jitterBufferSize, $byoc, $callerId, $callReason, $recordingTrack, $timeLimit);
    116. 

  116.     }
    117. 

  117. 

  118.     /**
    119. 

  119.      * @param bool $muted Whether to return only participants that are muted
    120. 

  120.      * @param bool $hold Whether to return only participants that are on hold
    121. 

  121.      * @param bool $coaching Whether to return only participants who are coaching
    122. 

  122.      *                       another call
    123. 

  123.      * @return ReadParticipantOptions Options builder
    124. 

  124.      */
    125. 

  125.     public static function read(bool $muted = Values::NONE, bool $hold = Values::NONE, bool $coaching = Values::NONE): ReadParticipantOptions {
    126. 

  126.         return new ReadParticipantOptions($muted, $hold, $coaching);
    127. 

  127.     }
    128. 

  128. }
    129. 

  129. 

  130. class UpdateParticipantOptions extends Options {
    131. 

  131.     /**
    132. 

  132.      * @param bool $muted Whether the participant should be muted
    133. 

  133.      * @param bool $hold Whether the participant should be on hold
    134. 

  134.      * @param string $holdUrl The URL we call using the `hold_method` for  music
    135. 

  135.      *                        that plays when the participant is on hold
    136. 

  136.      * @param string $holdMethod The HTTP method we should use to call hold_url
    137. 

  137.      * @param string $announceUrl The URL we call using the `announce_method` for
    138. 

  138.      *                            an announcement to the participant
    139. 

  139.      * @param string $announceMethod The HTTP method we should use to call
    140. 

  140.      *                               announce_url
    141. 

  141.      * @param string $waitUrl URL that hosts pre-conference hold music
    142. 

  142.      * @param string $waitMethod The HTTP method we should use to call `wait_url`
    143. 

  143.      * @param bool $beepOnExit Whether to play a notification beep to the
    144. 

  144.      *                         conference when the participant exit
    145. 

  145.      * @param bool $endConferenceOnExit Whether to end the conference when the
    146. 

  146.      *                                  participant leaves
    147. 

  147.      * @param bool $coaching Indicates if the participant changed to coach
    148. 

  148.      * @param string $callSidToCoach The SID of the participant who is being
    149. 

  149.      *                               `coached`
    150. 

  150.      */
    151. 

  151.     public function __construct(bool $muted = Values::NONE, bool $hold = Values::NONE, string $holdUrl = Values::NONE, string $holdMethod = Values::NONE, string $announceUrl = Values::NONE, string $announceMethod = Values::NONE, string $waitUrl = Values::NONE, string $waitMethod = Values::NONE, bool $beepOnExit = Values::NONE, bool $endConferenceOnExit = Values::NONE, bool $coaching = Values::NONE, string $callSidToCoach = Values::NONE) {
    152. 

  152.         $this->options['muted'] = $muted;
    153. 

  153.         $this->options['hold'] = $hold;
    154. 

  154.         $this->options['holdUrl'] = $holdUrl;
    155. 

  155.         $this->options['holdMethod'] = $holdMethod;
    156. 

  156.         $this->options['announceUrl'] = $announceUrl;
    157. 

  157.         $this->options['announceMethod'] = $announceMethod;
    158. 

  158.         $this->options['waitUrl'] = $waitUrl;
    159. 

  159.         $this->options['waitMethod'] = $waitMethod;
    160. 

  160.         $this->options['beepOnExit'] = $beepOnExit;
    161. 

  161.         $this->options['endConferenceOnExit'] = $endConferenceOnExit;
    162. 

  162.         $this->options['coaching'] = $coaching;
    163. 

  163.         $this->options['callSidToCoach'] = $callSidToCoach;
    164. 

  164.     }
    165. 

  165. 

  166.     /**
    167. 

  167.      * Whether the participant should be muted. Can be `true` or `false`. `true` will mute the participant, and `false` will un-mute them. Anything value other than `true` or `false` is interpreted as `false`.
    168. 

  168.      *
    169. 

  169.      * @param bool $muted Whether the participant should be muted
    170. 

  170.      * @return $this Fluent Builder
    171. 

  171.      */
    172. 

  172.     public function setMuted(bool $muted): self {
    173. 

  173.         $this->options['muted'] = $muted;
    174. 

  174.         return $this;
    175. 

  175.     }
    176. 

  176. 

  177.     /**
    178. 

  178.      * Whether the participant should be on hold. Can be: `true` or `false`. `true` puts the participant on hold, and `false` lets them rejoin the conference.
    179. 

  179.      *
    180. 

  180.      * @param bool $hold Whether the participant should be on hold
    181. 

  181.      * @return $this Fluent Builder
    182. 

  182.      */
    183. 

  183.     public function setHold(bool $hold): self {
    184. 

  184.         $this->options['hold'] = $hold;
    185. 

  185.         return $this;
    186. 

  186.     }
    187. 

  187. 

  188.     /**
    189. 

  189.      * The URL we call using the `hold_method` for  music that plays when the participant is on hold. The URL may return an MP3 file, a WAV file, or a TwiML document that contains the `<Play>`, `<Say>` or `<Redirect>` commands.
    190. 

  190.      *
    191. 

  191.      * @param string $holdUrl The URL we call using the `hold_method` for  music
    192. 

  192.      *                        that plays when the participant is on hold
    193. 

  193.      * @return $this Fluent Builder
    194. 

  194.      */
    195. 

  195.     public function setHoldUrl(string $holdUrl): self {
    196. 

  196.         $this->options['holdUrl'] = $holdUrl;
    197. 

  197.         return $this;
    198. 

  198.     }
    199. 

  199. 

  200.     /**
    201. 

  201.      * The HTTP method we should use to call `hold_url`. Can be: `GET` or `POST` and the default is `GET`.
    202. 

  202.      *
    203. 

  203.      * @param string $holdMethod The HTTP method we should use to call hold_url
    204. 

  204.      * @return $this Fluent Builder
    205. 

  205.      */
    206. 

  206.     public function setHoldMethod(string $holdMethod): self {
    207. 

  207.         $this->options['holdMethod'] = $holdMethod;
    208. 

  208.         return $this;
    209. 

  209.     }
    210. 

  210. 

  211.     /**
    212. 

  212.      * The URL we call using the `announce_method` for an announcement to the participant. The URL must return an MP3 file, a WAV file, or a TwiML document that contains `<Play>` or `<Say>` commands.
    213. 

  213.      *
    214. 

  214.      * @param string $announceUrl The URL we call using the `announce_method` for
    215. 

  215.      *                            an announcement to the participant
    216. 

  216.      * @return $this Fluent Builder
    217. 

  217.      */
    218. 

  218.     public function setAnnounceUrl(string $announceUrl): self {
    219. 

  219.         $this->options['announceUrl'] = $announceUrl;
    220. 

  220.         return $this;
    221. 

  221.     }
    222. 

  222. 

  223.     /**
    224. 

  224.      * The HTTP method we should use to call `announce_url`. Can be: `GET` or `POST` and defaults to `POST`.
    225. 

  225.      *
    226. 

  226.      * @param string $announceMethod The HTTP method we should use to call
    227. 

  227.      *                               announce_url
    228. 

  228.      * @return $this Fluent Builder
    229. 

  229.      */
    230. 

  230.     public function setAnnounceMethod(string $announceMethod): self {
    231. 

  231.         $this->options['announceMethod'] = $announceMethod;
    232. 

  232.         return $this;
    233. 

  233.     }
    234. 

  234. 

  235.     /**
    236. 

  236.      * The URL we should call using the `wait_method` for the music to play while participants are waiting for the conference to start. The default value is the URL of our standard hold music. [Learn more about hold music](https://www.twilio.com/labs/twimlets/holdmusic).
    237. 

  237.      *
    238. 

  238.      * @param string $waitUrl URL that hosts pre-conference hold music
    239. 

  239.      * @return $this Fluent Builder
    240. 

  240.      */
    241. 

  241.     public function setWaitUrl(string $waitUrl): self {
    242. 

  242.         $this->options['waitUrl'] = $waitUrl;
    243. 

  243.         return $this;
    244. 

  244.     }
    245. 

  245. 

  246.     /**
    247. 

  247.      * The HTTP method we should use to call `wait_url`. Can be `GET` or `POST` and the default is `POST`. When using a static audio file, this should be `GET` so that we can cache the file.
    248. 

  248.      *
    249. 

  249.      * @param string $waitMethod The HTTP method we should use to call `wait_url`
    250. 

  250.      * @return $this Fluent Builder
    251. 

  251.      */
    252. 

  252.     public function setWaitMethod(string $waitMethod): self {
    253. 

  253.         $this->options['waitMethod'] = $waitMethod;
    254. 

  254.         return $this;
    255. 

  255.     }
    256. 

  256. 

  257.     /**
    258. 

  258.      * Whether to play a notification beep to the conference when the participant exits. Can be: `true` or `false`.
    259. 

  259.      *
    260. 

  260.      * @param bool $beepOnExit Whether to play a notification beep to the
    261. 

  261.      *                         conference when the participant exit
    262. 

  262.      * @return $this Fluent Builder
    263. 

  263.      */
    264. 

  264.     public function setBeepOnExit(bool $beepOnExit): self {
    265. 

  265.         $this->options['beepOnExit'] = $beepOnExit;
    266. 

  266.         return $this;
    267. 

  267.     }
    268. 

  268. 

  269.     /**
    270. 

  270.      * Whether to end the conference when the participant leaves. Can be: `true` or `false` and defaults to `false`.
    271. 

  271.      *
    272. 

  272.      * @param bool $endConferenceOnExit Whether to end the conference when the
    273. 

  273.      *                                  participant leaves
    274. 

  274.      * @return $this Fluent Builder
    275. 

  275.      */
    276. 

  276.     public function setEndConferenceOnExit(bool $endConferenceOnExit): self {
    277. 

  277.         $this->options['endConferenceOnExit'] = $endConferenceOnExit;
    278. 

  278.         return $this;
    279. 

  279.     }
    280. 

  280. 

  281.     /**
    282. 

  282.      * Whether the participant is coaching another call. Can be: `true` or `false`. If not present, defaults to `false` unless `call_sid_to_coach` is defined. If `true`, `call_sid_to_coach` must be defined.
    283. 

  283.      *
    284. 

  284.      * @param bool $coaching Indicates if the participant changed to coach
    285. 

  285.      * @return $this Fluent Builder
    286. 

  286.      */
    287. 

  287.     public function setCoaching(bool $coaching): self {
    288. 

  288.         $this->options['coaching'] = $coaching;
    289. 

  289.         return $this;
    290. 

  290.     }
    291. 

  291. 

  292.     /**
    293. 

  293.      * The SID of the participant who is being `coached`. The participant being coached is the only participant who can hear the participant who is `coaching`.
    294. 

  294.      *
    295. 

  295.      * @param string $callSidToCoach The SID of the participant who is being
    296. 

  296.      *                               `coached`
    297. 

  297.      * @return $this Fluent Builder
    298. 

  298.      */
    299. 

  299.     public function setCallSidToCoach(string $callSidToCoach): self {
    300. 

  300.         $this->options['callSidToCoach'] = $callSidToCoach;
    301. 

  301.         return $this;
    302. 

  302.     }
    303. 

  303. 

  304.     /**
    305. 

  305.      * Provide a friendly representation
    306. 

  306.      *
    307. 

  307.      * @return string Machine friendly representation
    308. 

  308.      */
    309. 

  309.     public function __toString(): string {
    310. 

  310.         $options = \http_build_query(Values::of($this->options), '', ' ');
    311. 

  311.         return '[Twilio.Api.V2010.UpdateParticipantOptions ' . $options . ']';
    312. 

  312.     }
    313. 

  313. }
    314. 

  314. 

  315. class CreateParticipantOptions extends Options {
    316. 

  316.     /**
    317. 

  317.      * @param string $statusCallback The URL we should call to send status
    318. 

  318.      *                               information to your application
    319. 

  319.      * @param string $statusCallbackMethod The HTTP method we should use to call
    320. 

  320.      *                                     `status_callback`
    321. 

  321.      * @param string[] $statusCallbackEvent Set state change events that will
    322. 

  322.      *                                      trigger a callback
    323. 

  323.      * @param string $label The label of this participant
    324. 

  324.      * @param int $timeout he number of seconds that we should wait for an answer
    325. 

  325.      * @param bool $record Whether to record the participant and their conferences
    326. 

  326.      * @param bool $muted Whether to mute the agent
    327. 

  327.      * @param string $beep Whether to play a notification beep to the conference
    328. 

  328.      *                     when the participant joins
    329. 

  329.      * @param bool $startConferenceOnEnter Whether the conference starts when the
    330. 

  330.      *                                     participant joins the conference
    331. 

  331.      * @param bool $endConferenceOnExit Whether to end the conference when the
    332. 

  332.      *                                  participant leaves
    333. 

  333.      * @param string $waitUrl URL that hosts pre-conference hold music
    334. 

  334.      * @param string $waitMethod The HTTP method we should use to call `wait_url`
    335. 

  335.      * @param bool $earlyMedia Whether agents can hear the state of the outbound
    336. 

  336.      *                         call
    337. 

  337.      * @param int $maxParticipants The maximum number of agent conference
    338. 

  338.      *                             participants
    339. 

  339.      * @param string $conferenceRecord Whether to record the conference the
    340. 

  340.      *                                 participant is joining
    341. 

  341.      * @param string $conferenceTrim Whether to trim leading and trailing silence
    342. 

  342.      *                               from your recorded conference audio files
    343. 

  343.      * @param string $conferenceStatusCallback The callback URL for conference
    344. 

  344.      *                                         events
    345. 

  345.      * @param string $conferenceStatusCallbackMethod HTTP method for requesting
    346. 

  346.      *                                               `conference_status_callback`
    347. 

  347.      *                                               URL
    348. 

  348.      * @param string[] $conferenceStatusCallbackEvent The conference state changes
    349. 

  349.      *                                                that should generate a call
    350. 

  350.      *                                                to
    351. 

  351.      *                                                `conference_status_callback`
    352. 

  352.      * @param string $recordingChannels Specify `mono` or `dual` recording channels
    353. 

  353.      * @param string $recordingStatusCallback The URL that we should call using the
    354. 

  354.      *                                        `recording_status_callback_method`
    355. 

  355.      *                                        when the recording status changes
    356. 

  356.      * @param string $recordingStatusCallbackMethod The HTTP method we should use
    357. 

  357.      *                                              when we call
    358. 

  358.      *                                              `recording_status_callback`
    359. 

  359.      * @param string $sipAuthUsername The SIP username used for authentication
    360. 

  360.      * @param string $sipAuthPassword The SIP password for authentication
    361. 

  361.      * @param string $region The region where we should mix the conference audio
    362. 

  362.      * @param string $conferenceRecordingStatusCallback The URL we should call
    363. 

  363.      *                                                  using the
    364. 

  364.      *                                                  `conference_recording_status_callback_method` when the conference recording is available
    365. 

  365.      * @param string $conferenceRecordingStatusCallbackMethod The HTTP method we
    366. 

  366.      *                                                        should use to call
    367. 

  367.      *                                                        `conference_recording_status_callback`
    368. 

  368.      * @param string[] $recordingStatusCallbackEvent The recording state changes
    369. 

  369.      *                                               that should generate a call to
    370. 

  370.      *                                               `recording_status_callback`
    371. 

  371.      * @param string[] $conferenceRecordingStatusCallbackEvent The conference
    372. 

  372.      *                                                         recording state
    373. 

  373.      *                                                         changes that should
    374. 

  374.      *                                                         generate a call to
    375. 

  375.      *                                                         `conference_recording_status_callback`
    376. 

  376.      * @param bool $coaching Indicates if the participant changed to coach
    377. 

  377.      * @param string $callSidToCoach The SID of the participant who is being
    378. 

  378.      *                               `coached`
    379. 

  379.      * @param string $jitterBufferSize Jitter Buffer size for the connecting
    380. 

  380.      *                                 participant
    381. 

  381.      * @param string $byoc BYOC trunk SID (Beta)
    382. 

  382.      * @param string $callerId The phone number, Client identifier, or username
    383. 

  383.      *                         portion of SIP address that made this call.
    384. 

  384.      * @param string $callReason Reason for the call (Branded Calls Beta)
    385. 

  385.      * @param string $recordingTrack The track(s) to record
    386. 

  386.      * @param int $timeLimit The maximum duration of the call in seconds.
    387. 

  387.      */
    388. 

  388.     public function __construct(string $statusCallback = Values::NONE, string $statusCallbackMethod = Values::NONE, array $statusCallbackEvent = Values::ARRAY_NONE, string $label = Values::NONE, int $timeout = Values::NONE, bool $record = Values::NONE, bool $muted = Values::NONE, string $beep = Values::NONE, bool $startConferenceOnEnter = Values::NONE, bool $endConferenceOnExit = Values::NONE, string $waitUrl = Values::NONE, string $waitMethod = Values::NONE, bool $earlyMedia = Values::NONE, int $maxParticipants = Values::NONE, string $conferenceRecord = Values::NONE, string $conferenceTrim = Values::NONE, string $conferenceStatusCallback = Values::NONE, string $conferenceStatusCallbackMethod = Values::NONE, array $conferenceStatusCallbackEvent = Values::ARRAY_NONE, string $recordingChannels = Values::NONE, string $recordingStatusCallback = Values::NONE, string $recordingStatusCallbackMethod = Values::NONE, string $sipAuthUsername = Values::NONE, string $sipAuthPassword = Values::NONE, string $region = Values::NONE, string $conferenceRecordingStatusCallback = Values::NONE, string $conferenceRecordingStatusCallbackMethod = Values::NONE, array $recordingStatusCallbackEvent = Values::ARRAY_NONE, array $conferenceRecordingStatusCallbackEvent = Values::ARRAY_NONE, bool $coaching = Values::NONE, string $callSidToCoach = Values::NONE, string $jitterBufferSize = Values::NONE, string $byoc = Values::NONE, string $callerId = Values::NONE, string $callReason = Values::NONE, string $recordingTrack = Values::NONE, int $timeLimit = Values::NONE) {
    389. 

  389.         $this->options['statusCallback'] = $statusCallback;
    390. 

  390.         $this->options['statusCallbackMethod'] = $statusCallbackMethod;
    391. 

  391.         $this->options['statusCallbackEvent'] = $statusCallbackEvent;
    392. 

  392.         $this->options['label'] = $label;
    393. 

  393.         $this->options['timeout'] = $timeout;
    394. 

  394.         $this->options['record'] = $record;
    395. 

  395.         $this->options['muted'] = $muted;
    396. 

  396.         $this->options['beep'] = $beep;
    397. 

  397.         $this->options['startConferenceOnEnter'] = $startConferenceOnEnter;
    398. 

  398.         $this->options['endConferenceOnExit'] = $endConferenceOnExit;
    399. 

  399.         $this->options['waitUrl'] = $waitUrl;
    400. 

  400.         $this->options['waitMethod'] = $waitMethod;
    401. 

  401.         $this->options['earlyMedia'] = $earlyMedia;
    402. 

  402.         $this->options['maxParticipants'] = $maxParticipants;
    403. 

  403.         $this->options['conferenceRecord'] = $conferenceRecord;
    404. 

  404.         $this->options['conferenceTrim'] = $conferenceTrim;
    405. 

  405.         $this->options['conferenceStatusCallback'] = $conferenceStatusCallback;
    406. 

  406.         $this->options['conferenceStatusCallbackMethod'] = $conferenceStatusCallbackMethod;
    407. 

  407.         $this->options['conferenceStatusCallbackEvent'] = $conferenceStatusCallbackEvent;
    408. 

  408.         $this->options['recordingChannels'] = $recordingChannels;
    409. 

  409.         $this->options['recordingStatusCallback'] = $recordingStatusCallback;
    410. 

  410.         $this->options['recordingStatusCallbackMethod'] = $recordingStatusCallbackMethod;
    411. 

  411.         $this->options['sipAuthUsername'] = $sipAuthUsername;
    412. 

  412.         $this->options['sipAuthPassword'] = $sipAuthPassword;
    413. 

  413.         $this->options['region'] = $region;
    414. 

  414.         $this->options['conferenceRecordingStatusCallback'] = $conferenceRecordingStatusCallback;
    415. 

  415.         $this->options['conferenceRecordingStatusCallbackMethod'] = $conferenceRecordingStatusCallbackMethod;
    416. 

  416.         $this->options['recordingStatusCallbackEvent'] = $recordingStatusCallbackEvent;
    417. 

  417.         $this->options['conferenceRecordingStatusCallbackEvent'] = $conferenceRecordingStatusCallbackEvent;
    418. 

  418.         $this->options['coaching'] = $coaching;
    419. 

  419.         $this->options['callSidToCoach'] = $callSidToCoach;
    420. 

  420.         $this->options['jitterBufferSize'] = $jitterBufferSize;
    421. 

  421.         $this->options['byoc'] = $byoc;
    422. 

  422.         $this->options['callerId'] = $callerId;
    423. 

  423.         $this->options['callReason'] = $callReason;
    424. 

  424.         $this->options['recordingTrack'] = $recordingTrack;
    425. 

  425.         $this->options['timeLimit'] = $timeLimit;
    426. 

  426.     }
    427. 

  427. 

  428.     /**
    429. 

  429.      * The URL we should call using the `status_callback_method` to send status information to your application.
    430. 

  430.      *
    431. 

  431.      * @param string $statusCallback The URL we should call to send status
    432. 

  432.      *                               information to your application
    433. 

  433.      * @return $this Fluent Builder
    434. 

  434.      */
    435. 

  435.     public function setStatusCallback(string $statusCallback): self {
    436. 

  436.         $this->options['statusCallback'] = $statusCallback;
    437. 

  437.         return $this;
    438. 

  438.     }
    439. 

  439. 

  440.     /**
    441. 

  441.      * The HTTP method we should use to call `status_callback`. Can be: `GET` and `POST` and defaults to `POST`.
    442. 

  442.      *
    443. 

  443.      * @param string $statusCallbackMethod The HTTP method we should use to call
    444. 

  444.      *                                     `status_callback`
    445. 

  445.      * @return $this Fluent Builder
    446. 

  446.      */
    447. 

  447.     public function setStatusCallbackMethod(string $statusCallbackMethod): self {
    448. 

  448.         $this->options['statusCallbackMethod'] = $statusCallbackMethod;
    449. 

  449.         return $this;
    450. 

  450.     }
    451. 

  451. 

  452.     /**
    453. 

  453.      * The conference state changes that should generate a call to `status_callback`. Can be: `initiated`, `ringing`, `answered`, and `completed`. Separate multiple values with a space. The default value is `completed`.
    454. 

  454.      *
    455. 

  455.      * @param string[] $statusCallbackEvent Set state change events that will
    456. 

  456.      *                                      trigger a callback
    457. 

  457.      * @return $this Fluent Builder
    458. 

  458.      */
    459. 

  459.     public function setStatusCallbackEvent(array $statusCallbackEvent): self {
    460. 

  460.         $this->options['statusCallbackEvent'] = $statusCallbackEvent;
    461. 

  461.         return $this;
    462. 

  462.     }
    463. 

  463. 

  464.     /**
    465. 

  465.      * A label for this participant. If one is supplied, it may subsequently be used to fetch, update or delete the participant.
    466. 

  466.      *
    467. 

  467.      * @param string $label The label of this participant
    468. 

  468.      * @return $this Fluent Builder
    469. 

  469.      */
    470. 

  470.     public function setLabel(string $label): self {
    471. 

  471.         $this->options['label'] = $label;
    472. 

  472.         return $this;
    473. 

  473.     }
    474. 

  474. 

  475.     /**
    476. 

  476.      * The number of seconds that we should allow the phone to ring before assuming there is no answer. Can be an integer between `5` and `600`, inclusive. The default value is `60`. We always add a 5-second timeout buffer to outgoing calls, so  value of 10 would result in an actual timeout that was closer to 15 seconds.
    477. 

  477.      *
    478. 

  478.      * @param int $timeout he number of seconds that we should wait for an answer
    479. 

  479.      * @return $this Fluent Builder
    480. 

  480.      */
    481. 

  481.     public function setTimeout(int $timeout): self {
    482. 

  482.         $this->options['timeout'] = $timeout;
    483. 

  483.         return $this;
    484. 

  484.     }
    485. 

  485. 

  486.     /**
    487. 

  487.      * Whether to record the participant and their conferences, including the time between conferences. Can be `true` or `false` and the default is `false`.
    488. 

  488.      *
    489. 

  489.      * @param bool $record Whether to record the participant and their conferences
    490. 

  490.      * @return $this Fluent Builder
    491. 

  491.      */
    492. 

  492.     public function setRecord(bool $record): self {
    493. 

  493.         $this->options['record'] = $record;
    494. 

  494.         return $this;
    495. 

  495.     }
    496. 

  496. 

  497.     /**
    498. 

  498.      * Whether the agent is muted in the conference. Can be `true` or `false` and the default is `false`.
    499. 

  499.      *
    500. 

  500.      * @param bool $muted Whether to mute the agent
    501. 

  501.      * @return $this Fluent Builder
    502. 

  502.      */
    503. 

  503.     public function setMuted(bool $muted): self {
    504. 

  504.         $this->options['muted'] = $muted;
    505. 

  505.         return $this;
    506. 

  506.     }
    507. 

  507. 

  508.     /**
    509. 

  509.      * Whether to play a notification beep to the conference when the participant joins. Can be: `true`, `false`, `onEnter`, or `onExit`. The default value is `true`.
    510. 

  510.      *
    511. 

  511.      * @param string $beep Whether to play a notification beep to the conference
    512. 

  512.      *                     when the participant joins
    513. 

  513.      * @return $this Fluent Builder
    514. 

  514.      */
    515. 

  515.     public function setBeep(string $beep): self {
    516. 

  516.         $this->options['beep'] = $beep;
    517. 

  517.         return $this;
    518. 

  518.     }
    519. 

  519. 

  520.     /**
    521. 

  521.      * Whether to start the conference when the participant joins, if it has not already started. Can be: `true` or `false` and the default is `true`. If `false` and the conference has not started, the participant is muted and hears background music until another participant starts the conference.
    522. 

  522.      *
    523. 

  523.      * @param bool $startConferenceOnEnter Whether the conference starts when the
    524. 

  524.      *                                     participant joins the conference
    525. 

  525.      * @return $this Fluent Builder
    526. 

  526.      */
    527. 

  527.     public function setStartConferenceOnEnter(bool $startConferenceOnEnter): self {
    528. 

  528.         $this->options['startConferenceOnEnter'] = $startConferenceOnEnter;
    529. 

  529.         return $this;
    530. 

  530.     }
    531. 

  531. 

  532.     /**
    533. 

  533.      * Whether to end the conference when the participant leaves. Can be: `true` or `false` and defaults to `false`.
    534. 

  534.      *
    535. 

  535.      * @param bool $endConferenceOnExit Whether to end the conference when the
    536. 

  536.      *                                  participant leaves
    537. 

  537.      * @return $this Fluent Builder
    538. 

  538.      */
    539. 

  539.     public function setEndConferenceOnExit(bool $endConferenceOnExit): self {
    540. 

  540.         $this->options['endConferenceOnExit'] = $endConferenceOnExit;
    541. 

  541.         return $this;
    542. 

  542.     }
    543. 

  543. 

  544.     /**
    545. 

  545.      * The URL we should call using the `wait_method` for the music to play while participants are waiting for the conference to start. The default value is the URL of our standard hold music. [Learn more about hold music](https://www.twilio.com/labs/twimlets/holdmusic).
    546. 

  546.      *
    547. 

  547.      * @param string $waitUrl URL that hosts pre-conference hold music
    548. 

  548.      * @return $this Fluent Builder
    549. 

  549.      */
    550. 

  550.     public function setWaitUrl(string $waitUrl): self {
    551. 

  551.         $this->options['waitUrl'] = $waitUrl;
    552. 

  552.         return $this;
    553. 

  553.     }
    554. 

  554. 

  555.     /**
    556. 

  556.      * The HTTP method we should use to call `wait_url`. Can be `GET` or `POST` and the default is `POST`. When using a static audio file, this should be `GET` so that we can cache the file.
    557. 

  557.      *
    558. 

  558.      * @param string $waitMethod The HTTP method we should use to call `wait_url`
    559. 

  559.      * @return $this Fluent Builder
    560. 

  560.      */
    561. 

  561.     public function setWaitMethod(string $waitMethod): self {
    562. 

  562.         $this->options['waitMethod'] = $waitMethod;
    563. 

  563.         return $this;
    564. 

  564.     }
    565. 

  565. 

  566.     /**
    567. 

  567.      * Whether to allow an agent to hear the state of the outbound call, including ringing or disconnect messages. Can be: `true` or `false` and defaults to `true`.
    568. 

  568.      *
    569. 

  569.      * @param bool $earlyMedia Whether agents can hear the state of the outbound
    570. 

  570.      *                         call
    571. 

  571.      * @return $this Fluent Builder
    572. 

  572.      */
    573. 

  573.     public function setEarlyMedia(bool $earlyMedia): self {
    574. 

  574.         $this->options['earlyMedia'] = $earlyMedia;
    575. 

  575.         return $this;
    576. 

  576.     }
    577. 

  577. 

  578.     /**
    579. 

  579.      * The maximum number of participants in the conference. Can be a positive integer from `2` to `250`. The default value is `250`.
    580. 

  580.      *
    581. 

  581.      * @param int $maxParticipants The maximum number of agent conference
    582. 

  582.      *                             participants
    583. 

  583.      * @return $this Fluent Builder
    584. 

  584.      */
    585. 

  585.     public function setMaxParticipants(int $maxParticipants): self {
    586. 

  586.         $this->options['maxParticipants'] = $maxParticipants;
    587. 

  587.         return $this;
    588. 

  588.     }
    589. 

  589. 

  590.     /**
    591. 

  591.      * Whether to record the conference the participant is joining. Can be: `true`, `false`, `record-from-start`, and `do-not-record`. The default value is `false`.
    592. 

  592.      *
    593. 

  593.      * @param string $conferenceRecord Whether to record the conference the
    594. 

  594.      *                                 participant is joining
    595. 

  595.      * @return $this Fluent Builder
    596. 

  596.      */
    597. 

  597.     public function setConferenceRecord(string $conferenceRecord): self {
    598. 

  598.         $this->options['conferenceRecord'] = $conferenceRecord;
    599. 

  599.         return $this;
    600. 

  600.     }
    601. 

  601. 

  602.     /**
    603. 

  603.      * Whether to trim leading and trailing silence from your recorded conference audio files. Can be: `trim-silence` or `do-not-trim` and defaults to `trim-silence`.
    604. 

  604.      *
    605. 

  605.      * @param string $conferenceTrim Whether to trim leading and trailing silence
    606. 

  606.      *                               from your recorded conference audio files
    607. 

  607.      * @return $this Fluent Builder
    608. 

  608.      */
    609. 

  609.     public function setConferenceTrim(string $conferenceTrim): self {
    610. 

  610.         $this->options['conferenceTrim'] = $conferenceTrim;
    611. 

  611.         return $this;
    612. 

  612.     }
    613. 

  613. 

  614.     /**
    615. 

  615.      * The URL we should call using the `conference_status_callback_method` when the conference events in `conference_status_callback_event` occur. Only the value set by the first participant to join the conference is used. Subsequent `conference_status_callback` values are ignored.
    616. 

  616.      *
    617. 

  617.      * @param string $conferenceStatusCallback The callback URL for conference
    618. 

  618.      *                                         events
    619. 

  619.      * @return $this Fluent Builder
    620. 

  620.      */
    621. 

  621.     public function setConferenceStatusCallback(string $conferenceStatusCallback): self {
    622. 

  622.         $this->options['conferenceStatusCallback'] = $conferenceStatusCallback;
    623. 

  623.         return $this;
    624. 

  624.     }
    625. 

  625. 

  626.     /**
    627. 

  627.      * The HTTP method we should use to call `conference_status_callback`. Can be: `GET` or `POST` and defaults to `POST`.
    628. 

  628.      *
    629. 

  629.      * @param string $conferenceStatusCallbackMethod HTTP method for requesting
    630. 

  630.      *                                               `conference_status_callback`
    631. 

  631.      *                                               URL
    632. 

  632.      * @return $this Fluent Builder
    633. 

  633.      */
    634. 

  634.     public function setConferenceStatusCallbackMethod(string $conferenceStatusCallbackMethod): self {
    635. 

  635.         $this->options['conferenceStatusCallbackMethod'] = $conferenceStatusCallbackMethod;
    636. 

  636.         return $this;
    637. 

  637.     }
    638. 

  638. 

  639.     /**
    640. 

  640.      * The conference state changes that should generate a call to `conference_status_callback`. Can be: `start`, `end`, `join`, `leave`, `mute`, `hold`, `modify`, `speaker`, and `announcement`. Separate multiple values with a space. Defaults to `start end`.
    641. 

  641.      *
    642. 

  642.      * @param string[] $conferenceStatusCallbackEvent The conference state changes
    643. 

  643.      *                                                that should generate a call
    644. 

  644.      *                                                to
    645. 

  645.      *                                                `conference_status_callback`
    646. 

  646.      * @return $this Fluent Builder
    647. 

  647.      */
    648. 

  648.     public function setConferenceStatusCallbackEvent(array $conferenceStatusCallbackEvent): self {
    649. 

  649.         $this->options['conferenceStatusCallbackEvent'] = $conferenceStatusCallbackEvent;
    650. 

  650.         return $this;
    651. 

  651.     }
    652. 

  652. 

  653.     /**
    654. 

  654.      * The recording channels for the final recording. Can be: `mono` or `dual` and the default is `mono`.
    655. 

  655.      *
    656. 

  656.      * @param string $recordingChannels Specify `mono` or `dual` recording channels
    657. 

  657.      * @return $this Fluent Builder
    658. 

  658.      */
    659. 

  659.     public function setRecordingChannels(string $recordingChannels): self {
    660. 

  660.         $this->options['recordingChannels'] = $recordingChannels;
    661. 

  661.         return $this;
    662. 

  662.     }
    663. 

  663. 

  664.     /**
    665. 

  665.      * The URL that we should call using the `recording_status_callback_method` when the recording status changes.
    666. 

  666.      *
    667. 

  667.      * @param string $recordingStatusCallback The URL that we should call using the
    668. 

  668.      *                                        `recording_status_callback_method`
    669. 

  669.      *                                        when the recording status changes
    670. 

  670.      * @return $this Fluent Builder
    671. 

  671.      */
    672. 

  672.     public function setRecordingStatusCallback(string $recordingStatusCallback): self {
    673. 

  673.         $this->options['recordingStatusCallback'] = $recordingStatusCallback;
    674. 

  674.         return $this;
    675. 

  675.     }
    676. 

  676. 

  677.     /**
    678. 

  678.      * The HTTP method we should use when we call `recording_status_callback`. Can be: `GET` or `POST` and defaults to `POST`.
    679. 

  679.      *
    680. 

  680.      * @param string $recordingStatusCallbackMethod The HTTP method we should use
    681. 

  681.      *                                              when we call
    682. 

  682.      *                                              `recording_status_callback`
    683. 

  683.      * @return $this Fluent Builder
    684. 

  684.      */
    685. 

  685.     public function setRecordingStatusCallbackMethod(string $recordingStatusCallbackMethod): self {
    686. 

  686.         $this->options['recordingStatusCallbackMethod'] = $recordingStatusCallbackMethod;
    687. 

  687.         return $this;
    688. 

  688.     }
    689. 

  689. 

  690.     /**
    691. 

  691.      * The SIP username used for authentication.
    692. 

  692.      *
    693. 

  693.      * @param string $sipAuthUsername The SIP username used for authentication
    694. 

  694.      * @return $this Fluent Builder
    695. 

  695.      */
    696. 

  696.     public function setSipAuthUsername(string $sipAuthUsername): self {
    697. 

  697.         $this->options['sipAuthUsername'] = $sipAuthUsername;
    698. 

  698.         return $this;
    699. 

  699.     }
    700. 

  700. 

  701.     /**
    702. 

  702.      * The SIP password for authentication.
    703. 

  703.      *
    704. 

  704.      * @param string $sipAuthPassword The SIP password for authentication
    705. 

  705.      * @return $this Fluent Builder
    706. 

  706.      */
    707. 

  707.     public function setSipAuthPassword(string $sipAuthPassword): self {
    708. 

  708.         $this->options['sipAuthPassword'] = $sipAuthPassword;
    709. 

  709.         return $this;
    710. 

  710.     }
    711. 

  711. 

  712.     /**
    713. 

  713.      * The [region](https://support.twilio.com/hc/en-us/articles/223132167-How-global-low-latency-routing-and-region-selection-work-for-conferences-and-Client-calls) where we should mix the recorded audio. Can be:`us1`, `ie1`, `de1`, `sg1`, `br1`, `au1`, or `jp1`.
    714. 

  714.      *
    715. 

  715.      * @param string $region The region where we should mix the conference audio
    716. 

  716.      * @return $this Fluent Builder
    717. 

  717.      */
    718. 

  718.     public function setRegion(string $region): self {
    719. 

  719.         $this->options['region'] = $region;
    720. 

  720.         return $this;
    721. 

  721.     }
    722. 

  722. 

  723.     /**
    724. 

  724.      * The URL we should call using the `conference_recording_status_callback_method` when the conference recording is available.
    725. 

  725.      *
    726. 

  726.      * @param string $conferenceRecordingStatusCallback The URL we should call
    727. 

  727.      *                                                  using the
    728. 

  728.      *                                                  `conference_recording_status_callback_method` when the conference recording is available
    729. 

  729.      * @return $this Fluent Builder
    730. 

  730.      */
    731. 

  731.     public function setConferenceRecordingStatusCallback(string $conferenceRecordingStatusCallback): self {
    732. 

  732.         $this->options['conferenceRecordingStatusCallback'] = $conferenceRecordingStatusCallback;
    733. 

  733.         return $this;
    734. 

  734.     }
    735. 

  735. 

  736.     /**
    737. 

  737.      * The HTTP method we should use to call `conference_recording_status_callback`. Can be: `GET` or `POST` and defaults to `POST`.
    738. 

  738.      *
    739. 

  739.      * @param string $conferenceRecordingStatusCallbackMethod The HTTP method we
    740. 

  740.      *                                                        should use to call
    741. 

  741.      *                                                        `conference_recording_status_callback`
    742. 

  742.      * @return $this Fluent Builder
    743. 

  743.      */
    744. 

  744.     public function setConferenceRecordingStatusCallbackMethod(string $conferenceRecordingStatusCallbackMethod): self {
    745. 

  745.         $this->options['conferenceRecordingStatusCallbackMethod'] = $conferenceRecordingStatusCallbackMethod;
    746. 

  746.         return $this;
    747. 

  747.     }
    748. 

  748. 

  749.     /**
    750. 

  750.      * The recording state changes that should generate a call to `recording_status_callback`. Can be: `started`, `in-progress`, `paused`, `resumed`, `stopped`, `completed`, `failed`, and `absent`. Separate multiple values with a space, ex: `'in-progress completed failed'`.
    751. 

  751.      *
    752. 

  752.      * @param string[] $recordingStatusCallbackEvent The recording state changes
    753. 

  753.      *                                               that should generate a call to
    754. 

  754.      *                                               `recording_status_callback`
    755. 

  755.      * @return $this Fluent Builder
    756. 

  756.      */
    757. 

  757.     public function setRecordingStatusCallbackEvent(array $recordingStatusCallbackEvent): self {
    758. 

  758.         $this->options['recordingStatusCallbackEvent'] = $recordingStatusCallbackEvent;
    759. 

  759.         return $this;
    760. 

  760.     }
    761. 

  761. 

  762.     /**
    763. 

  763.      * The conference recording state changes that generate a call to `conference_recording_status_callback`. Can be: `in-progress`, `completed`, `failed`, and `absent`. Separate multiple values with a space, ex: `'in-progress completed failed'`
    764. 

  764.      *
    765. 

  765.      * @param string[] $conferenceRecordingStatusCallbackEvent The conference
    766. 

  766.      *                                                         recording state
    767. 

  767.      *                                                         changes that should
    768. 

  768.      *                                                         generate a call to
    769. 

  769.      *                                                         `conference_recording_status_callback`
    770. 

  770.      * @return $this Fluent Builder
    771. 

  771.      */
    772. 

  772.     public function setConferenceRecordingStatusCallbackEvent(array $conferenceRecordingStatusCallbackEvent): self {
    773. 

  773.         $this->options['conferenceRecordingStatusCallbackEvent'] = $conferenceRecordingStatusCallbackEvent;
    774. 

  774.         return $this;
    775. 

  775.     }
    776. 

  776. 

  777.     /**
    778. 

  778.      * Whether the participant is coaching another call. Can be: `true` or `false`. If not present, defaults to `false` unless `call_sid_to_coach` is defined. If `true`, `call_sid_to_coach` must be defined.
    779. 

  779.      *
    780. 

  780.      * @param bool $coaching Indicates if the participant changed to coach
    781. 

  781.      * @return $this Fluent Builder
    782. 

  782.      */
    783. 

  783.     public function setCoaching(bool $coaching): self {
    784. 

  784.         $this->options['coaching'] = $coaching;
    785. 

  785.         return $this;
    786. 

  786.     }
    787. 

  787. 

  788.     /**
    789. 

  789.      * The SID of the participant who is being `coached`. The participant being coached is the only participant who can hear the participant who is `coaching`.
    790. 

  790.      *
    791. 

  791.      * @param string $callSidToCoach The SID of the participant who is being
    792. 

  792.      *                               `coached`
    793. 

  793.      * @return $this Fluent Builder
    794. 

  794.      */
    795. 

  795.     public function setCallSidToCoach(string $callSidToCoach): self {
    796. 

  796.         $this->options['callSidToCoach'] = $callSidToCoach;
    797. 

  797.         return $this;
    798. 

  798.     }
    799. 

  799. 

  800.     /**
    801. 

  801.      * Jitter buffer size for the connecting participant. Twilio will use this setting to apply Jitter Buffer before participant's audio is mixed into the conference. Can be: `off`, `small`, `medium`, and `large`. Default to `large`.
    802. 

  802.      *
    803. 

  803.      * @param string $jitterBufferSize Jitter Buffer size for the connecting
    804. 

  804.      *                                 participant
    805. 

  805.      * @return $this Fluent Builder
    806. 

  806.      */
    807. 

  807.     public function setJitterBufferSize(string $jitterBufferSize): self {
    808. 

  808.         $this->options['jitterBufferSize'] = $jitterBufferSize;
    809. 

  809.         return $this;
    810. 

  810.     }
    811. 

  811. 

  812.     /**
    813. 

  813.      * The SID of a BYOC (Bring Your Own Carrier) trunk to route this call with. Note that `byoc` is only meaningful when `to` is a phone number; it will otherwise be ignored. (Beta)
    814. 

  814.      *
    815. 

  815.      * @param string $byoc BYOC trunk SID (Beta)
    816. 

  816.      * @return $this Fluent Builder
    817. 

  817.      */
    818. 

  818.     public function setByoc(string $byoc): self {
    819. 

  819.         $this->options['byoc'] = $byoc;
    820. 

  820.         return $this;
    821. 

  821.     }
    822. 

  822. 

  823.     /**
    824. 

  824.      * The phone number, Client identifier, or username portion of SIP address that made this call. Phone numbers are in [E.164](https://www.twilio.com/docs/glossary/what-e164) format (e.g., +16175551212). Client identifiers are formatted `client:name`. If using a phone number, it must be a Twilio number or a Verified [outgoing caller id](https://www.twilio.com/docs/voice/api/outgoing-caller-ids) for your account. If the `to` parameter is a phone number, `callerId` must also be a phone number. If `to` is sip address, this value of `callerId` should be a username portion to be used to populate the From header that is passed to the SIP endpoint.
    825. 

  825.      *
    826. 

  826.      * @param string $callerId The phone number, Client identifier, or username
    827. 

  827.      *                         portion of SIP address that made this call.
    828. 

  828.      * @return $this Fluent Builder
    829. 

  829.      */
    830. 

  830.     public function setCallerId(string $callerId): self {
    831. 

  831.         $this->options['callerId'] = $callerId;
    832. 

  832.         return $this;
    833. 

  833.     }
    834. 

  834. 

  835.     /**
    836. 

  836.      * The Reason for the outgoing call. Use it to specify the purpose of the call that is presented on the called party's phone. (Branded Calls Beta)
    837. 

  837.      *
    838. 

  838.      * @param string $callReason Reason for the call (Branded Calls Beta)
    839. 

  839.      * @return $this Fluent Builder
    840. 

  840.      */
    841. 

  841.     public function setCallReason(string $callReason): self {
    842. 

  842.         $this->options['callReason'] = $callReason;
    843. 

  843.         return $this;
    844. 

  844.     }
    845. 

  845. 

  846.     /**
    847. 

  847.      * The audio track to record for the call. Can be: `inbound`, `outbound` or `both`. The default is `both`. `inbound` records the audio that is received by Twilio. `outbound` records the audio that is sent from Twilio. `both` records the audio that is received and sent by Twilio.
    848. 

  848.      *
    849. 

  849.      * @param string $recordingTrack The track(s) to record
    850. 

  850.      * @return $this Fluent Builder
    851. 

  851.      */
    852. 

  852.     public function setRecordingTrack(string $recordingTrack): self {
    853. 

  853.         $this->options['recordingTrack'] = $recordingTrack;
    854. 

  854.         return $this;
    855. 

  855.     }
    856. 

  856. 

  857.     /**
    858. 

  858.      * The maximum duration of the call in seconds. Constraints depend on account and configuration.
    859. 

  859.      *
    860. 

  860.      * @param int $timeLimit The maximum duration of the call in seconds.
    861. 

  861.      * @return $this Fluent Builder
    862. 

  862.      */
    863. 

  863.     public function setTimeLimit(int $timeLimit): self {
    864. 

  864.         $this->options['timeLimit'] = $timeLimit;
    865. 

  865.         return $this;
    866. 

  866.     }
    867. 

  867. 

  868.     /**
    869. 

  869.      * Provide a friendly representation
    870. 

  870.      *
    871. 

  871.      * @return string Machine friendly representation
    872. 

  872.      */
    873. 

  873.     public function __toString(): string {
    874. 

  874.         $options = \http_build_query(Values::of($this->options), '', ' ');
    875. 

  875.         return '[Twilio.Api.V2010.CreateParticipantOptions ' . $options . ']';
    876. 

  876.     }
    877. 

  877. }
    878. 

  878. 

  879. class ReadParticipantOptions extends Options {
    880. 

  880.     /**
    881. 

  881.      * @param bool $muted Whether to return only participants that are muted
    882. 

  882.      * @param bool $hold Whether to return only participants that are on hold
    883. 

  883.      * @param bool $coaching Whether to return only participants who are coaching
    884. 

  884.      *                       another call
    885. 

  885.      */
    886. 

  886.     public function __construct(bool $muted = Values::NONE, bool $hold = Values::NONE, bool $coaching = Values::NONE) {
    887. 

  887.         $this->options['muted'] = $muted;
    888. 

  888.         $this->options['hold'] = $hold;
    889. 

  889.         $this->options['coaching'] = $coaching;
    890. 

  890.     }
    891. 

  891. 

  892.     /**
    893. 

  893.      * Whether to return only participants that are muted. Can be: `true` or `false`.
    894. 

  894.      *
    895. 

  895.      * @param bool $muted Whether to return only participants that are muted
    896. 

  896.      * @return $this Fluent Builder
    897. 

  897.      */
    898. 

  898.     public function setMuted…
    899.