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.
The user-specified name of this Stream, if one was given when the Stream was created. This may be used to stop the Stream.
The status - one of stopped
, in-progress
in-progress
stopped
The date and time in GMT that this resource was last updated, specified in RFC 2822 format.
The URI of the resource, relative to https://api.twilio.com
.
_10POST https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Calls/{CallSid}/Stream.json
POST https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Calls/{CallSid}/Streams.json
The SID of the Call the Stream resource is associated with.
Relative or absolute url where WebSocket connection will be established.
The user-specified name of this Stream, if one was given when the Stream was created. This may be used to stop the Stream.
One of inbound_track
, outbound_track
, both_tracks
.
inbound_track
outbound_track
both_tracks
The http method for the status_callback (one of GET, POST).
HEAD
GET
POST
PATCH
PUT
DELETE
Parameter value