Media Streams
Start/Stop Media Streams
The Media Stream Resource allows you to start a stream on a phone call and send that stream to a secure websocket URL or one of the available partners via the streams connector configuration. You can also stop streams started via the <Start><Stream> TwiML instruction.
Connectors are configured via the Marketplace Add-on in the Twilio Stream Connectors Console page. Connectors cannot be configured outside of the console via TwiML. This requirement is in place to ensure that the credentials needed to send the stream to a partner are stored securely.
Any communication issues encountered while streaming media to the partner will be reported in the Twilio Debugger with additional information about the failure.
There are a maximum of 4 forked streams allowed per call. Media Streams by default uses 2 forked streams for both the inbound and outbound tracks.
Resource Properties in REST API format | |
---|---|
sid
|
The SID of the Stream resource. |
account_sid
|
The SID of the Account that created this Stream resource. |
call_sid
|
The SID of the Call the Stream resource is associated with. |
name
|
The user-specified name of this Stream, if one was given when the Stream was created. This may be used to stop the Stream. |
status
|
The status - one of |
date_updated
|
The date and time in GMT that this resource was last updated, specified in RFC 2822 format. |
uri
|
The URI of the resource, relative to |
POST https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Calls/{CallSid}/Stream.json
Create a Stream resource
https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Calls/{CallSid}/Streams.json
Parameters
Parameters in REST API format | |
---|---|
account_sid
Path
|
The SID of the Account that created this Stream resource. |
call_sid
Path
|
The SID of the Call the Stream resource is associated with. |
url
Required
|
Relative or absolute url where WebSocket connection will be established. |
name
Optional
|
The user-specified name of this Stream, if one was given when the Stream was created. This may be used to stop the Stream. |
track
Optional
|
One of |
status_callback
Optional
|
Absolute URL of the status callback. |
status_callback_method
Optional
|
The http method for the status_callback (one of GET, POST). |
parameter1.name
Optional
|
Parameter name |
parameter1.value
Optional
|
Parameter value |
parameter2.name
Optional
|
Parameter name |
parameter2.value
Optional
|
Parameter value |
parameter3.name
Optional
|
Parameter name |
parameter3.value
Optional
|
Parameter value |
parameter4.name
Optional
|
Parameter name |
parameter4.value
Optional
|
Parameter value |
parameter5.name
Optional
|
Parameter name |
parameter5.value
Optional
|
Parameter value |
parameter6.name
Optional
|
Parameter name |
parameter6.value
Optional
|
Parameter value |
parameter7.name
Optional
|
Parameter name |
parameter7.value
Optional
|
Parameter value |
parameter8.name
Optional
|
Parameter name |
parameter8.value
Optional
|
Parameter value |
parameter9.name
Optional
|
Parameter name |
parameter9.value
Optional
|
Parameter value |
parameter10.name
Optional
|
Parameter name |
parameter10.value
Optional
|
Parameter value |
parameter11.name
Optional
|
Parameter name |
parameter11.value
Optional
|
Parameter value |
parameter12.name
Optional
|
Parameter name |
parameter12.value
Optional
|
Parameter value |
parameter13.name
Optional
|
Parameter name |
parameter13.value
Optional
|
Parameter value |
parameter14.name
Optional
|
Parameter name |
parameter14.value
Optional
|
Parameter value |
parameter15.name
Optional
|
Parameter name |
parameter15.value
Optional
|
Parameter value |
parameter16.name
Optional
|
Parameter name |
parameter16.value
Optional
|
Parameter value |
parameter17.name
Optional
|
Parameter name |
parameter17.value
Optional
|
Parameter value |
parameter18.name
Optional
|
Parameter name |
parameter18.value
Optional
|
Parameter value |
parameter19.name
Optional
|
Parameter name |
parameter19.value
Optional
|
Parameter value |
parameter20.name
Optional
|
Parameter name |
parameter20.value
Optional
|
Parameter value |
parameter21.name
Optional
|
Parameter name |
parameter21.value
Optional
|
Parameter value |
parameter22.name
Optional
|
Parameter name |
parameter22.value
Optional
|
Parameter value |
parameter23.name
Optional
|
Parameter name |
parameter23.value
Optional
|
Parameter value |
parameter24.name
Optional
|
Parameter name |
parameter24.value
Optional
|
Parameter value |
parameter25.name
Optional
|
Parameter name |
parameter25.value
Optional
|
Parameter value |
parameter26.name
Optional
|
Parameter name |
parameter26.value
Optional
|
Parameter value |
parameter27.name
Optional
|
Parameter name |
parameter27.value
Optional
|
Parameter value |
parameter28.name
Optional
|
Parameter name |
parameter28.value
Optional
|
Parameter value |
parameter29.name
Optional
|
Parameter name |
parameter29.value
Optional
|
Parameter value |
parameter30.name
Optional
|
Parameter name |
parameter30.value
Optional
|
Parameter value |
parameter31.name
Optional
|
Parameter name |
parameter31.value
Optional
|
Parameter value |
parameter32.name
Optional
|
Parameter name |
parameter32.value
Optional
|
Parameter value |
parameter33.name
Optional
|
Parameter name |
parameter33.value
Optional
|
Parameter value |
parameter34.name
Optional
|
Parameter name |
parameter34.value
Optional
|
Parameter value |
parameter35.name
Optional
|
Parameter name |
parameter35.value
Optional
|
Parameter value |
parameter36.name
Optional
|
Parameter name |
parameter36.value
Optional
|
Parameter value |
parameter37.name
Optional
|
Parameter name |
parameter37.value
Optional
|
Parameter value |
parameter38.name
Optional
|
Parameter name |
parameter38.value
Optional
|
Parameter value |
parameter39.name
Optional
|
Parameter name |
parameter39.value
Optional
|
Parameter value |
parameter40.name
Optional
|
Parameter name |
parameter40.value
Optional
|
Parameter value |
parameter41.name
Optional
|
Parameter name |
parameter41.value
Optional
|
Parameter value |
parameter42.name
Optional
|
Parameter name |
parameter42.value
Optional
|
Parameter value |
parameter43.name
Optional
|
Parameter name |
parameter43.value
Optional
|
Parameter value |
parameter44.name
Optional
|
Parameter name |
parameter44.value
Optional
|
Parameter value |
parameter45.name
Optional
|
Parameter name |
parameter45.value
Optional
|
Parameter value |
parameter46.name
Optional
|
Parameter name |
parameter46.value
Optional
|
Parameter value |
parameter47.name
Optional
|
Parameter name |
parameter47.value
Optional
|
Parameter value |
parameter48.name
Optional
|
Parameter name |
parameter48.value
Optional
|
Parameter value |
parameter49.name
Optional
|
Parameter name |
parameter49.value
Optional
|
Parameter value |
parameter50.name
Optional
|
Parameter name |
parameter50.value
Optional
|
Parameter value |
parameter51.name
Optional
|
Parameter name |
parameter51.value
Optional
|
Parameter value |
parameter52.name
Optional
|
Parameter name |
parameter52.value
Optional
|
Parameter value |
parameter53.name
Optional
|
Parameter name |
parameter53.value
Optional
|
Parameter value |
parameter54.name
Optional
|
Parameter name |
parameter54.value
Optional
|
Parameter value |
parameter55.name
Optional
|
Parameter name |
parameter55.value
Optional
|
Parameter value |
parameter56.name
Optional
|
Parameter name |
parameter56.value
Optional
|
Parameter value |
parameter57.name
Optional
|
Parameter name |
parameter57.value
Optional
|
Parameter value |
parameter58.name
Optional
|
Parameter name |
parameter58.value
Optional
|
Parameter value |
parameter59.name
Optional
|
Parameter name |
parameter59.value
Optional
|
Parameter value |
parameter60.name
Optional
|
Parameter name |
parameter60.value
Optional
|
Parameter value |
parameter61.name
Optional
|
Parameter name |
parameter61.value
Optional
|
Parameter value |
parameter62.name
Optional
|
Parameter name |
parameter62.value
Optional
|
Parameter value |
parameter63.name
Optional
|
Parameter name |
parameter63.value
Optional
|
Parameter value |
parameter64.name
Optional
|
Parameter name |
parameter64.value
Optional
|
Parameter value |
parameter65.name
Optional
|
Parameter name |
parameter65.value
Optional
|
Parameter value |
parameter66.name
Optional
|
Parameter name |
parameter66.value
Optional
|
Parameter value |
parameter67.name
Optional
|
Parameter name |
parameter67.value
Optional
|
Parameter value |
parameter68.name
Optional
|
Parameter name |
parameter68.value
Optional
|
Parameter value |
parameter69.name
Optional
|
Parameter name |
parameter69.value
Optional
|
Parameter value |
parameter70.name
Optional
|
Parameter name |
parameter70.value
Optional
|
Parameter value |
parameter71.name
Optional
|
Parameter name |
parameter71.value
Optional
|
Parameter value |
parameter72.name
Optional
|
Parameter name |
parameter72.value
Optional
|
Parameter value |
parameter73.name
Optional
|
Parameter name |
parameter73.value
Optional
|
Parameter value |
parameter74.name
Optional
|
Parameter name |
parameter74.value
Optional
|
Parameter value |
parameter75.name
Optional
|
Parameter name |
parameter75.value
Optional
|
Parameter value |
parameter76.name
Optional
|
Parameter name |
parameter76.value
Optional
|
Parameter value |
parameter77.name
Optional
|
Parameter name |
parameter77.value
Optional
|
Parameter value |
parameter78.name
Optional
|
Parameter name |
parameter78.value
Optional
|
Parameter value |
parameter79.name
Optional
|
Parameter name |
parameter79.value
Optional
|
Parameter value |
parameter80.name
Optional
|
Parameter name |
parameter80.value
Optional
|
Parameter value |
parameter81.name
Optional
|
Parameter name |
parameter81.value
Optional
|
Parameter value |
parameter82.name
Optional
|
Parameter name |
parameter82.value
Optional
|
Parameter value |
parameter83.name
Optional
|
Parameter name |
parameter83.value
Optional
|
Parameter value |
parameter84.name
Optional
|
Parameter name |
parameter84.value
Optional
|
Parameter value |
parameter85.name
Optional
|
Parameter name |
parameter85.value
Optional
|
Parameter value |
parameter86.name
Optional
|
Parameter name |
parameter86.value
Optional
|
Parameter value |
parameter87.name
Optional
|
Parameter name |
parameter87.value
Optional
|
Parameter value |
parameter88.name
Optional
|
Parameter name |
parameter88.value
Optional
|
Parameter value |
parameter89.name
Optional
|
Parameter name |
parameter89.value
Optional
|
Parameter value |
parameter90.name
Optional
|
Parameter name |
parameter90.value
Optional
|
Parameter value |
parameter91.name
Optional
|
Parameter name |
parameter91.value
Optional
|
Parameter value |
parameter92.name
Optional
|
Parameter name |
parameter92.value
Optional
|
Parameter value |
parameter93.name
Optional
|
Parameter name |
parameter93.value
Optional
|
Parameter value |
parameter94.name
Optional
|
Parameter name |
parameter94.value
Optional
|
Parameter value |
parameter95.name
Optional
|
Parameter name |
parameter95.value
Optional
|
Parameter value |
parameter96.name
Optional
|
Parameter name |
parameter96.value
Optional
|
Parameter value |
parameter97.name
Optional
|
Parameter name |
parameter97.value
Optional
|
Parameter value |
parameter98.name
Optional
|
Parameter name |
parameter98.value
Optional
|
Parameter value |
parameter99.name
Optional
|
Parameter name |
parameter99.value
Optional
|
Parameter value |
Example 1
Example 2
Example 3
Need some help?
We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd by visiting Twilio's Stack Overflow Collective or browsing the Twilio tag on Stack Overflow.