Stop Stream

The StopStream verb is used to stop a stream that was started with a previous <StartStream> verb.

If there is no stream with the given name on the call, this verb has no effect.

Text Content

There is no text content available to be set for the <StopStream> verb.

Attributes

Attribute	Description
name	(required) The name of the stream to stop. This is either the user selected name when sending the <StartStream> verb, or the system generated name returned in the Media Stream Started webhook if <StartStream> was sent with no name attribute.
wait	(optional) If set to true, the verb will wait for the WebSocket set in the <StartStream> destination attribute to stop before continuing. This is useful if you need to ensure that the WebSocket has stopped before taking further action. Default is false.

Webhooks Received

Webhooks	Can reply with more BXML
Media Stream Stopped	No

Examples

Stopping a media stream

XML

<?xml version="1.0" encoding="UTF-8"?>
<Response>
    <StopStream name="live_audience"/>
</Response>

Java

StopStream stopStream = new StopStream().builder()
        .name("live_audience")
        .build();

Response response = new Response()
        .with(stopStream);

System.out.println(response.toBXML());

C#

StopStream stopStream = new StopStream
{
    Name = "live_audience",
};

Response response = new Response();
response.Add(stopStream);

Console.WriteLine(response.ToBXML());

Ruby

stop_stream = Bandwidth::Bxml::StopStream.new({ name: 'live_audience' })
response = Bandwidth::Bxml::Response.new([stop_stream])

p response.to_bxml

NodeJS

const stopStream = new Bxml.StopStream({
    name: 'live_audience'
});
const response = new Bxml.Response(stopStream);

console.log(response.toBxml());

Python

stop_stream = StopStream(
    name="live_audience",
)

response = Response()
response.add_verb(stop_stream)

print(response.to_bxml())

PHP

$stopStream = new BandwidthLib\Voice\Bxml\StopStream("live_audience");

$response = new BandwidthLib\Voice\Bxml\Response();
$response->addVerb($stopStream);

echo $response->toBxml();