
<html>

<head>

<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> 

<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0" /> 

<base href="https://wiki.asterisk.org/wiki" /> 

<title>Message Title</title>  

<style type="text/css">@media only screen and (max-device-width: 480px) {.mobile-only {

        width: auto !important;

        height: auto !important;

        overflow: visible !important;

        line-height: normal !important;

        font-size: inherit !important;

        mso-hide: all;

}


.desktop-only {

        display: none !important;

}


/* iPhone 3GS fix for unwanted 20px right margin */

body { min-width: 100% !important; padding: 0; margin: 0; }


#center-content-table { max-width: none; !important; }

#header-pattern-container { padding: 10px 10px 10px 10px !important; line-height: 20px !important; }

#header-avatar-image-container { padding-right: 8px !important; }

#email-content-container { padding: 0 !important; }

.mobile-expand { border-radius: 0 !important; border-left: 0 !important; border-right: 0 !important; padding-left: 26px !important;}

.mobile-resize-text { font-size: 16px !important; line-height: 22px !important; }

#page-title-pattern-header { font-size: 20px !important; line-height: 28px !important; }

#page-title-pattern-icon-image-container-cell { padding-top: 7px !important; }

#inline-user-pattern { display: block !important; }

#inline-user-pattern-avatar { padding-top: 3px !important; }

.contextual-area-pattern { border-bottom: 1px solid #ccc !important; padding: 15px 10px 0 10px !important;}

.users-involved-pattern-column-table { width: 100% !important;  }

.users-involved-pattern-avatar-table-cell { padding: 3px 5px 5px 0 !important; }

.users-involved-pattern-column-container { padding-right: 0 !important; }

.contextual-excerpt-pattern, #users-involved-pattern { border: 0 !important; }


/** Aui Typography upsized for mobile **/

#content-excerpt-pattern-container, #contextual-excerpt-pattern-text-container { font-size: 16px !important; line-height: 22px !important; }

#content-excerpt-pattern-container h1, #contextual-excerpt-pattern-text-container h1 { font-size: 24px !important; line-height: 28px !important; }

#content-excerpt-pattern-container h2, #contextual-excerpt-pattern-text-container h2 { font-size: 20px !important; line-height: 28px !important; }

#content-excerpt-pattern-container h3, #contextual-excerpt-pattern-text-container h3 { font-size: 18px !important; line-height: 24px !important; }

#content-excerpt-pattern-container h4, #contextual-excerpt-pattern-text-container h4 { font-size: 16px !important; line-height: 22px !important; }

#content-excerpt-pattern-container h5, #contextual-excerpt-pattern-text-container h5 { font-size: 14px !important; line-height: 20px !important; }

#content-excerpt-pattern-container h6, #contextual-excerpt-pattern-text-container h6 { font-size: 14px !important; line-height: 20px !important; }

.user-mention { line-height: 18px !important; }

/** Aui Typography end **/


/* Show appropriate footer logo on mobile, display links vertically */

#footer-pattern { padding: 15px 10px !important; }

#footer-pattern-logo-desktop-container { padding: 0 !important; }

#footer-pattern-logo-desktop { width: 0 !important; height: 0 !important; }

#footer-pattern-logo-mobile {

    padding-top: 10px !important;

    width: 30px !important;

    height: 27px !important;

    display: inline !important;

}

#footer-pattern-text {

    display: block !important;

}

#footer-pattern-links-container { line-height: 0 !important;}

.footer-pattern-links.mobile-resize-text,

.footer-pattern-links.mobile-resize-text,

#footer-pattern-text.mobile-resize-text,

#footer-pattern-links-container.no-footer-links {

    font-size: 14px !important;

    line-height: 20px !important;

}

.footer-link { display: block !important; }

#footer-pattern-links-container table { display: inline-block !important; float: none !important; }

#footer-pattern-links-container, #footer-pattern-text { text-align: center !important; }

#footer-pattern-links { padding-bottom: 5px !important; }


/** Team Calendar overrides, these should be removed when notifications are updated in Team Calendars. For now CSS

    overrides are being used because the structure of the content can't change without rereleasing the plugin */

.mail-calendar-container .day-header + table tr td:first-child {

    vertical-align: top !important;

    padding-top: 5px !important;

}}

@media (min-width: 900px) {#center-content-table { width: 900px; }}

@media all {#outlook a {padding:0;} /* Force Outlook to provide a "view in browser" menu link. */

/* Prevent Webkit and Windows Mobile platforms from changing default font sizes.*/

body{-webkit-text-size-adjust:100%; -ms-text-size-adjust:100%;}

.ExternalClass {width:100%;} /* Force Hotmail to display emails at full width */

#background-table {margin:0; padding:0; width:100% !important; }

/* Needed to override highlighting on date and time links in iOS */

.grey a {color: #707070; text-decoration: none; }/* These styles are appended to the head element of a notification in order to prevent Apple Mail and similar

   clients from underlining the due dates with a blue hyperlink */

/* a lozenge outside an inline task should always be #333, lozenges inside an inline task should be

   colored according to their upcoming due dates, a completed task date lozenge or deleted task date

   lozenge should always be #707070 */

.date-time-lozenge a {color: #333333; text-decoration: none; }

.inline-task-text-container .date-time-lozenge.date-upcoming a {color: #DF6F00; text-decoration: none; }

.inline-task-text-container .date-time-lozenge.date-past a {color: #D04437; text-decoration: none; }

.inline-task-text-container.content-deleted-color .date-time-lozenge a,

.inline-task-text-container.checked .date-time-lozenge a {

    color: #707070; text-decoration: none;

}}

</style> 

</head>

<body>

<table id="background-table" cellpadding="0" cellspacing="0" width="100%" style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333; background-color: #f5f5f5"> 

<tbody> 

<tr> 

<td id="header-pattern-container" style="padding: 0px; border-collapse: collapse; padding: 10px 20px"> 

<table id="header-pattern" cellspacing="0" cellpadding="0" border="0" style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<tbody> 

<tr> 

<td id="header-avatar-image-container" valign="top" style="padding: 0px; border-collapse: collapse; vertical-align: top; width: 32px; padding-right: 9px"><a href="https://wiki.asterisk.org/wiki/display/~mjordan?src=email" style="color: #3b73af; text-decoration: none"><img id="header-avatar-image" class="image_fix" src="cid:avatar_ce51dcf276530e4a4b00548e2a6d0905" height="32" width="32" border="0" style="border-radius: 3px; vertical-align: top" /></a></td>

<td id="header-text-container" valign="middle" style="padding: 0px; border-collapse: collapse; vertical-align: middle; font-family: Arial, sans-serif; font-size: 14px; line-height: 20px; mso-line-height-rule: exactly; mso-text-raise: 1px">Matt Jordan <strong>edited</strong> a page</td> 

</tr> 

</tbody> 

</table> </td> 

</tr> 

<!-- End Header pattern --> 

<tr> 

<td id="email-content-container" style="padding: 0px; border-collapse: collapse; padding: 0 20px"> 

<table id="email-content-table" cellspacing="0" cellpadding="0" border="0" width="100%" style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333; border-spacing: 0; border-collapse: separate"> 

<tbody> 

<tr> 

<td class="email-content-rounded-top mobile-expand" style="padding: 0px; border-collapse: collapse; color: #fff; padding: 0 15px 0 16px; height: 15px; background-color: #fff; border-left: 1px solid #ccc; border-top: 1px solid #ccc; border-right: 1px solid #ccc; border-bottom: 0; border-top-right-radius: 5px; border-top-left-radius: 5px"> </td> 

</tr> 

<tr> 

<td class="email-content-main mobile-expand" style="padding: 0px; border-collapse: collapse; border-left: 1px solid #ccc; border-right: 1px solid #ccc; border-top: 0; border-bottom: 0; padding: 0 15px 15px 16px; background-color: #fff"> 

<table id="page-title-pattern" cellspacing="0" cellpadding="0" border="0" width="100%" style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<tbody> 

<tr> 

<td id="page-title-pattern-icon-image-container" valign="top" style="padding: 0px; border-collapse: collapse; width: 16px; vertical-align: top"> 

<table cellspacing="0" cellpadding="0" border="0" style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<tbody> 

<tr> 

<td id="page-title-pattern-icon-image-container-cell" style="padding: 0px; border-collapse: collapse; width: 16px; padding: 9px 8px 0px 0px; mso-text-raise: 5px; mso-line-height-rule: exactly"><a href="https://wiki.asterisk.org/wiki/display/AST/ARI+and+Bridges%3A+Basic+Mixing+Bridges?src=email" title="page icon" style="vertical-align: top;; color: #3b73af; text-decoration: none"><img style="vertical-align: top; display: block;" src="cid:page-icon" alt="page icon" title="page icon" height="16" width="16" border="0" /></a></td> 

</tr> 

</tbody> 

</table> </td>

<td style="vertical-align: top;; padding: 0px; border-collapse: collapse; padding-right: 5px; font-size: 20px; line-height: 30px; mso-line-height-rule: exactly" id="page-title-pattern-header-container"><span id="page-title-pattern-header" style="font-family: Arial, sans-serif; padding: 0; font-size: 20px; line-height: 30px; mso-text-raise: 2px; mso-line-height-rule: exactly; vertical-align: middle"><a href="https://wiki.asterisk.org/wiki/display/AST/ARI+and+Bridges%3A+Basic+Mixing+Bridges?src=email" title="ARI and Bridges: Basic Mixing Bridges" style="color: #3b73af; text-decoration: none">ARI and Bridges: Basic Mixing Bridges</a></span></td> 

</tr> 

</tbody> 

</table> </td> 

</tr> 

<tr> 

<td class="email-content-main mobile-expand" style="padding: 0px; border-collapse: collapse; border-left: 1px solid #ccc; border-right: 1px solid #ccc; border-top: 0; border-bottom: 0; padding: 0 15px 15px 16px; background-color: #fff"> 

<table class="content-excerpt-pattern" cellspacing="0" cellpadding="0" border="0" width="100%" style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333; font-family: Arial, sans-serif; font-size: 14px; line-height: 20px; mso-line-height-rule: exactly; mso-text-raise: 1px"> 

<tbody> 

<tr> 

<td class="content-excerpt-pattern-container mobile-resize-text " style="padding: 0px; border-collapse: collapse; padding: 0 0 0 24px"> 

<div class="contentLayout2 diff-block-target"> 

<table width="100%" style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<tbody>

<tr class="columnLayout two-right-sidebar" data-layout="two-right-sidebar"> 

<td valign="top" class="cell normal" data-type="normal" style="padding: 0px; border-collapse: collapse"> 

<div class="innerCell"> 

<h1 id="ARIandBridges:BasicMixingBridges-MixingBridges" style="margin: 10px 0 0 0; margin-top: 0; font-size: 24px; font-weight: normal; line-height: 30px; margin: 40px 0 0 0; margin-top: 0">Mixing Bridges</h1> 

<p style="margin: 10px 0 0 0">In a mixing bridge, Asterisk shares media between all the channels in the bridge. Depending on the attributes the bridge was created with and the types of channels in the bridge, a mixing bridge may attempt to share the media in a variety of ways. They are, in order of best performance to lowest performance:</p> 

<ul style="margin: 10px 0 0 0"> 

<li>Direct packet sharing between devices - when there are two channels in a mixing bridge of similar types, it may be possible to have the media bypass Asterisk completely. In this type of bridge, the channels will pass media directly between each other, and Asterisk will simply monitor the state of the channels. However, because the media is not going through Asterisk, most features - such as recording, speech detection, DTMF, etc. - are not available. The <code style="font-family: monospace">proxy_media</code> attribute or the <code style="font-family: monospace">dtmf_events</code> attribute will prevent this mixing type from being used.</li> 

<li>Native packet sharing through Asterisk - when there are two channels in a mixing bridge of similar types, but the media cannot flow directly between the devices, Asterisk will attempt to mix the media between the channels by directly passing media from one channel to the other, and vice versa. The media itself is not decoded, and so - much like when the media is directly shared between the devices - Asterisk cannot use many features. The <code style="font-family: monospace">proxy_media</code> attribute or the <code style="font-family: monospace">dtmf_events</code> attribute will prevent this mixing type from being used.</li> 

</ul> 

</div> </td> 

<td valign="top" width="30%" class="cell aside" data-type="aside" style="padding: 0px; border-collapse: collapse"> 

<div class="innerCell"> 

<table class="diff-macro" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<thead> 

<tr> 

<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5635/60fd2eb45debbf4ede2b669f4c9b96b4ce40a937.48/_/images/icons/macrobrowser/dropdown/panel.png" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Panel</th> 

</tr> 

</thead> 

<tbody> 

<tr> 

<td class="diff-macro-properties" style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;padding: 0; border: 1px solid #dddddd;; padding: 0px; border-collapse: collapse"> 

<table style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<tbody> 

<tr> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">title</td> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">On This Page</td> 

</tr> 

</tbody> 

</table> </td> 

</tr> 

</tbody> 

<tbody> 

<tr> 

<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; padding: 0px; border-collapse: collapse"> <p style="margin: 10px 0 0 0; margin-top: 0"></p> 

<table class="diff-macro bodyless" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;margin: 5px 0; padding: 0; width: auto;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<thead> 

<tr> 

<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5635/60fd2eb45debbf4ede2b669f4c9b96b4ce40a937.48/_/images/icons/macrobrowser/dropdown/toc.png" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Table of Contents</th> 

</tr> 

</thead> 

</table> <p style="margin: 10px 0 0 0"></p> </td> 

</tr> 

</tbody> 

</table> 

</div> </td> 

</tr> 

</tbody>

</table> 

<table width="100%" style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<tbody>

<tr class="columnLayout single" data-layout="single"> 

<td valign="top" class="cell normal" data-type="normal" style="padding: 0px; border-collapse: collapse"> 

<div class="innerCell"> 

<ul style="margin: 10px 0 0 0; margin-top: 0"> 

<li>Two party mixing - when there are two channels in a mixing bridge, regardless of the channel type, Asterisk will decode the media from each channel and pass it to the other participant. This mixing technology allows for all the various features of Asterisk to be used on the channels while they are in the bridge, but does not necessarily incur any penalties from transcoding.</li> 

<li>Multi-party mixing - when there are more than two channels in a mixing bridge, Asterisk will transcode the media from each participant into signed linear, mix the media from all participants together into a new media frame, then write the media back out to all participants.</li> 

</ul> 

<p style="margin: 10px 0 0 0">At all times, the bridge will attempt to mix the media in the most performant manner possible. As the situation in the bridge changes, Asterisk will switch the mixing technology to the best mixing technology available.</p> 

<h2 id="ARIandBridges:BasicMixingBridges-WhatCanHappeninaMixingBridge" style="margin: 10px 0 0 0; font-size: 20px; font-weight: normal; line-height: 30px; margin: 40px 0 0 0">What Can Happen in a Mixing Bridge</h2> 

<div class="table-wrap" style="margin: 10px 0 0 0; overflow-x: auto"> 

<table class="confluenceTable" style="border-collapse: collapse; border: 1px solid #ddd;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333; border-collapse: collapse; margin: 10px 0 0 0; overflow-x: auto; margin-top: 0"> 

<tbody> 

<tr> 

<th class="confluenceTh" style="border: 1px solid #DDD; padding: 5px 7px; min-width: 0.6em; text-align: left; vertical-align: top;background-color: #F0F0F0; font-weight: bold;; border: 1px solid #ddd; padding: 7px 10px; vertical-align: top; text-align: left; background-color: #f0f0f0; font-weight: bold">Action</th> 

<th class="confluenceTh" style="border: 1px solid #DDD; padding: 5px 7px; min-width: 0.6em; text-align: left; vertical-align: top;background-color: #F0F0F0; font-weight: bold;; border: 1px solid #ddd; padding: 7px 10px; vertical-align: top; text-align: left; background-color: #f0f0f0; font-weight: bold">Bridge Response</th> 

</tr> 

<tr> 

<td class="confluenceTd" style="border: 1px solid #DDD; padding: 5px 7px; min-width: 0.6em; text-align: left; vertical-align: top;; padding: 0px; border-collapse: collapse; border: 1px solid #ddd; padding: 7px 10px; vertical-align: top; text-align: left">A bridge is created using <code style="font-family: monospace">POST /bridges</code>, and Alice's channel - which supports having media be directly sent to another device - is added to the bridge using <code style="font-family: monospace">POST /bridges/{bridge_id}/addChannel</code>.</td> 

<td class="confluenceTd" style="border: 1px solid #DDD; padding: 5px 7px; min-width: 0.6em; text-align: left; vertical-align: top;; padding: 0px; border-collapse: collapse; border: 1px solid #ddd; padding: 7px 10px; vertical-align: top; text-align: left">Asterisk picks the basic two-party mixing technology. We don't know yet what other channel is going to join the bridge - it could be anything! - and so Asterisk picks the best one based on the information it currently has.</td> 

</tr> 

<tr> 

<td colspan="1" class="confluenceTd" style="border: 1px solid #DDD; padding: 5px 7px; min-width: 0.6em; text-align: left; vertical-align: top;; padding: 0px; border-collapse: collapse; border: 1px solid #ddd; padding: 7px 10px; vertical-align: top; text-align: left">Bob's channel - which also supports having media be directly sent to another device - also joins the bridge via <code style="font-family: monospace">POST /bridges/{bridge_id}/addChannel</code>.</td> 

<td colspan="1" class="confluenceTd" style="border: 1px solid #DDD; padding: 5px 7px; min-width: 0.6em; text-align: left; vertical-align: top;; padding: 0px; border-collapse: collapse; border: 1px solid #ddd; padding: 7px 10px; vertical-align: top; text-align: left"> <p style="margin: 10px 0 0 0; margin-top: 0">We have two channels in the bridge now, so Asterisk re-evaluates how the media is mixed. Since both channels support having their media be sent directly to each other, and mixing media that way is more performant than the current mixing technology, Asterisk picks the direct media mixing technology and instructs the channels to tell their devices to send the media to each other.</p> </td> 

</tr> 

<tr> 

<td colspan="1" class="confluenceTd" style="border: 1px solid #DDD; padding: 5px 7px; min-width: 0.6em; text-align: left; vertical-align: top;; padding: 0px; border-collapse: collapse; border: 1px solid #ddd; padding: 7px 10px; vertical-align: top; text-align: left">Carol's channel - which is a DAHDI channel (poor Carol, calling from the PSTN) - is also added to the bridge via <code style="font-family: monospace">POST /bridges/{bridge_id}/addChannel</code>.</td> 

<td colspan="1" class="confluenceTd" style="border: 1px solid #DDD; padding: 5px 7px; min-width: 0.6em; text-align: left; vertical-align: top;; padding: 0px; border-collapse: collapse; border: 1px solid #ddd; padding: 7px 10px; vertical-align: top; text-align: left">Since we now have three channels in the bridge, Asterisk switches the mixing technology to multi-mix. Alice and Bob's media is sent back to Asterisk, and Asterisk mixes the media from Alice, Bob, and Carol together and then sends the new media to each channel.</td> 

</tr> 

<tr> 

<td colspan="1" class="confluenceTd" style="border: 1px solid #DDD; padding: 5px 7px; min-width: 0.6em; text-align: left; vertical-align: top;; padding: 0px; border-collapse: collapse; border: 1px solid #ddd; padding: 7px 10px; vertical-align: top; text-align: left">Eventually, Alice hangs up, leaving only Bob and Carol in the bridge.</td> 

<td colspan="1" class="confluenceTd" style="border: 1px solid #DDD; padding: 5px 7px; min-width: 0.6em; text-align: left; vertical-align: top;; padding: 0px; border-collapse: collapse; border: 1px solid #ddd; padding: 7px 10px; vertical-align: top; text-align: left">Since Alice left, Asterisk switches back to the basic two-party mixing technology. We can't use a native mixing technology, as Bob and Carol's channels are incompatible, but we can use a mixing technology that is less expensive than the multi-mix technology.</td> 

</tr> 

</tbody> 

</table> 

</div> 

<h1 id="ARIandBridges:BasicMixingBridges-Example:Implementingabasicdial" style="margin: 10px 0 0 0; font-size: 24px; font-weight: normal; line-height: 30px; margin: 40px 0 0 0">Example: Implementing a basic dial</h1> 

<p style="margin: 10px 0 0 0">Dialing can be implemented by using the <a href="https://wiki.asterisk.org/wiki/display/AST/Asterisk+12+Channels+REST+API#Asterisk12ChannelsRESTAPI-originate" rel="nofollow" style="color: #3b73af; text-decoration: none"><code style="font-family: monospace">POST - /channels</code></a> operation and putting both the resulting channel and the original Stasis channel in a mixing bridge to allow media to flow between them. An endpoint should be specified along with the originate operation as well as a Stasis application name. This will cause the dialed channel to enter Stasis, where it can be added to a mixing bridge. It's also a good idea to use Stasis application arguments to flag that the dialed channel was dialed using originate in order to handle it differently from the original channel once it enters into the Stasis application.</p> 

<p style="margin: 10px 0 0 0">This example ARI application will do the following:</p> 

<ol style="margin: 10px 0 0 0"> 

<li>When a channel enters into the Stasis application, a call will be originated to the endpoint specified by the first command line argument to the script.</li> 

<li>When that channel enters into the Stasis application, a mixing bridge will be created and the two channels will be put in it so that media can flow between them.</li> 

<li>If either channel hangs up, the other channel will also be hung up.</li> 

<li>Once the dialed channel exists the Stasis application, the mixing bridge will be destroyed.</li> 

</ol> 

<h2 id="ARIandBridges:BasicMixingBridges-Dialplan" style="margin: 10px 0 0 0; font-size: 20px; font-weight: normal; line-height: 30px; margin: 40px 0 0 0">Dialplan</h2> 

<p style="margin: 10px 0 0 0">For this example, we'll use a Stasis application that species not only the application - <code style="font-family: monospace">bridge-dial</code> - but also:</p> 

<ul style="margin: 10px 0 0 0"> 

<li>Whether or not the channel is <code style="font-family: monospace">inbound</code> or a <code style="font-family: monospace">dialed</code> channel.</li> 

<li>If the channel is <code style="font-family: monospace">inbound</code>, the endpoint to dial.</li> 

</ul> 

<p style="margin: 10px 0 0 0">As an example, here is a dialplan that dials the <code style="font-family: monospace">PJSIP/bob</code> endpoint:</p> 

<table class="diff-macro" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<thead> 

<tr> 

<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5635/60fd2eb45debbf4ede2b669f4c9b96b4ce40a937.48/_/plugins/servlet/confluence/placeholder/macro-icon?name=code" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Code Block</th> 

</tr> 

</thead> 

<tbody> 

<tr> 

<td class="diff-macro-properties" style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;padding: 0; border: 1px solid #dddddd;; padding: 0px; border-collapse: collapse"> 

<table style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<tbody> 

<tr> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">title</td> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">extensions.conf</td> 

</tr> 

</tbody> 

</table> </td> 

</tr> 

</tbody> 

<tbody> 

<tr> 

<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; padding: 0px; border-collapse: collapse"> <pre style="margin: 10px 0 0 0; margin-top: 0">exten => 1000,1,NoOp()

 same =>      n,Stasis(bridge-dial,inbound,PJSIP/bob)

 same =>      n,Hangup()</pre> </td> 

</tr> 

</tbody> 

</table> 

<h2 id="ARIandBridges:BasicMixingBridges-Python" style="margin: 10px 0 0 0; font-size: 20px; font-weight: normal; line-height: 30px; margin: 40px 0 0 0">Python</h2> 

<p style="margin: 10px 0 0 0">As is typical for an ARI application, we'll start off by implementing a callback handler for the <code style="font-family: monospace">StasisStart</code> event. In this particular case, our callback handler will be called in two conditions:</p> 

<ol style="margin: 10px 0 0 0"> 

<li>When an inbound channel enters into the <code style="font-family: monospace">Stasis</code> dialplan application. In that case, we'll want to initiate the outbound dial.</li> 

<li>When an outbound channel answers. In that case, we'll want to defer processing to a different callback handler and - in that handler - initiate the bridging of the two channels.</li> 

</ol> 

<p style="margin: 10px 0 0 0">In our <code style="font-family: monospace">StasisStart</code> callback handler, we can expect to have two pieces of information passed to the application:</p> 

<ol style="margin: 10px 0 0 0"> 

<li>The "type" of channel entering the callback handler. In this case, we expect the type to be either <code style="font-family: monospace">inbound</code> or <code style="font-family: monospace">dialed</code>.</li> 

<li>If the "type" of channel is <code style="font-family: monospace">inbound</code>, we expect the second argument to be the endpoint to dial.</li> 

</ol> 

<p style="margin: 10px 0 0 0">The following code shows the <code style="font-family: monospace">StasisStart</code> callback handler for the <code style="font-family: monospace">inbound</code> channel. Note that if the "type" is not <code style="font-family: monospace">inbound</code>, we defer processing to another callback handler. We also tell the inbound channel to start ringing via the <code style="font-family: monospace">ring</code> operation, and initiate an outbound dial by creating a new channel to the endpoint specified. Finally, we subscribe to the <code style="font-family: monospace">StasisEnd</code> event for both channels, and instruct them to call a <code style="font-family: monospace">safe_hangup</code> function on the opposing channel. This ensures that if either party hangs up, we hang up the person they were talking to. We'll show the implementation of that function shortly.</p> 

<table class="diff-macro" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<thead> 

<tr> 

<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5635/60fd2eb45debbf4ede2b669f4c9b96b4ce40a937.48/_/images/icons/macrobrowser/dropdown/tip.png" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Tip</th> 

</tr> 

</thead> 

<tbody> 

<tr> 

<td class="diff-macro-properties" style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;padding: 0; border: 1px solid #dddddd;; padding: 0px; border-collapse: collapse"> 

<table style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<tbody> 

<tr> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">title</td> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">Be careful of errors!</td> 

</tr> 

</tbody> 

</table> </td> 

</tr> 

</tbody> 

<tbody> 

<tr> 

<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; padding: 0px; border-collapse: collapse"> <p style="margin: 10px 0 0 0; margin-top: 0">Note that we wrap the origination with a <code style="font-family: monospace">try / except</code> block, in case the endpoint provided by the dialplan doesn't exist. When taking in input from a user or from the Asterisk dialplan, it is always good to be mindful of possible errors.</p> </td> 

</tr> 

</tbody> 

</table> 

<table class="diff-macro" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<thead> 

<tr> 

<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5635/60fd2eb45debbf4ede2b669f4c9b96b4ce40a937.48/_/plugins/servlet/confluence/placeholder/macro-icon?name=code" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Code Block</th> 

</tr> 

</thead> 

<tbody> 

<tr> 

<td class="diff-macro-properties" style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;padding: 0; border: 1px solid #dddddd;; padding: 0px; border-collapse: collapse"> 

<table style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<tbody> 

<tr> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">linenumbers</td> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">true</td> 

</tr> 

<tr> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">language</td> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">py</td> 

</tr> 

<tr> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">firstline</td> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">31</td> 

</tr> 

</tbody> 

</table> </td> 

</tr> 

</tbody> 

<tbody> 

<tr> 

<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; padding: 0px; border-collapse: collapse"> <pre style="margin: 10px 0 0 0; margin-top: 0">def stasis_start_cb(channel_obj, ev):

    """Handler for StasisStart"""


    channel = channel_obj.get('channel')

    channel_name = channel.json.get('name')

    args = ev.get('args')


    if not args:

        print "Error: {} didn't provide any arguments!".format(channel_name)

        return


    if args and args[0] != 'inbound':

        # Only handle inbound channels here

        return


    if len(args) != 2:

        print "Error: {} didn't tell us who to dial".format(channel_name)

        channel.hangup()

        return


    <span class="diff-html-added" id="added-diff-0" style="font-size: 100%; background-color: #ddfade;">print "{} entered our application".format(</span>channel<span class="diff-html-added" id="added-diff-1" style="font-size: 100%; background-color: #ddfade;">_name)

    channel</span>.ring()


    try:

        <span class="diff-html-added" id="added-diff-2" style="font-size: 100%; background-color: #ddfade;">print "Dialing {}".format(args[1])

        </span>outgoing = client.channels.originate(endpoint=args[1],

                                             app='bridge-dial',

                                             appArgs='dialed')

    except requests.HTTPError:

        print "Whoops, pretty sure %s wasn't valid" % args[1]

        channel.hangup()

        return


    channel.on_event('StasisEnd', lambda *args: safe_hangup(outgoing))

    outgoing.on_event('StasisEnd', lambda *args: safe_hangup(channel))<span class="diff-html-removed" id="removed-diff-0" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;"> </span>

</pre> </td> 

</tr> 

</tbody> 

</table> 

<p style="margin: 10px 0 0 0">The <code style="font-family: monospace">safe_hangup</code> function referenced above simply does a "safe" hangup on the channel provided. This is because it is entirely possible for both parties to hang up nearly simultaneously. Since our Python code is running in a separate process from Asterisk, we may be processing the hang up of the first party and instruct Asterisk to hang up the second party when they are already technically hung up! Again, it is always a good idea to view the processing of a communications application in an asynchronous fashion: we live in an asynchronous world, and a user can take an action at any moment in time.</p> 

<table class="diff-macro" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<thead> 

<tr> 

<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5635/60fd2eb45debbf4ede2b669f4c9b96b4ce40a937.48/_/plugins/servlet/confluence/placeholder/macro-icon?name=code" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Code Block</th> 

</tr> 

</thead> 

<tbody> 

<tr> 

<td class="diff-macro-properties" style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;padding: 0; border: 1px solid #dddddd;; padding: 0px; border-collapse: collapse"> 

<table style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<tbody> 

<tr> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">linenumbers</td> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">true</td> 

</tr> 

<tr> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">language</td> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">py</td> 

</tr> 

<tr> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">firstline</td> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">12</td> 

</tr> 

</tbody> 

</table> </td> 

</tr> 

</tbody> 

<tbody> 

<tr> 

<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; padding: 0px; border-collapse: collapse"> <pre style="margin: 10px 0 0 0; margin-top: 0">def safe_hangup(channel):

    """Safely hang up the specified channel"""

    try:

        <span class="diff-html-added" id="added-diff-3" style="font-size: 100%; background-color: #ddfade;">channel.hangup()

        </span>print "<span class="diff-html-removed" id="removed-diff-1" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">Hanging</span><span class="diff-html-added" id="added-diff-4" style="font-size: 100%; background-color: #ddfade;">Hung</span> up <span class="diff-html-removed" id="removed-diff-2" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">%s" % </span><span class="diff-html-added" id="added-diff-5" style="font-size: 100%; background-color: #ddfade;">{}".format(</span>channel.json.get('name')<span class="diff-html-removed" id="removed-diff-3" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">

        channel.hangup(</span>)

    except requests.HTTPError as e:

        if e.response.status_code != requests.codes.not_found:

            raise e</pre> </td> 

</tr> 

</tbody> 

</table> 

<p style="margin: 10px 0 0 0">We now have to handle the outbound channel when it answers. Currently, when it answers it will be immediately placed in our Stasis application, which will call the <code style="font-family: monospace">stasis_start_cb</code> we previously defined. While we could have some additional <code style="font-family: monospace">if / else</code> blocks in that handler, we can also just apply a <code style="font-family: monospace">StasisStart</code> callback to the outbound channel after we create it, and handle its entrance separately.</p> 

<p style="margin: 10px 0 0 0">When the outbound channel is answered, we need to do the following:</p> 

<ol style="margin: 10px 0 0 0"> 

<li>Answer the inbound channel.</li> 

<li>Create a new mixing bridge.</li> 

<li>Put both channels into the mixing bridge.</li> 

<li>Ensure we destroy the mixing bridge when either channel leaves our application.</li> 

</ol> 

<p style="margin: 10px 0 0 0">This is shown in the following code:</p> 

<table class="diff-macro" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<thead> 

<tr> 

<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5635/60fd2eb45debbf4ede2b669f4c9b96b4ce40a937.48/_/plugins/servlet/confluence/placeholder/macro-icon?name=code" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Code Block</th> 

</tr> 

</thead> 

<tbody> 

<tr> 

<td class="diff-macro-properties" style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;padding: 0; border: 1px solid #dddddd;; padding: 0px; border-collapse: collapse"> 

<table style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<tbody> 

<tr> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">linenumbers</td> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">true</td> 

</tr> 

<tr> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">language</td> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">py</td> 

</tr> 

<tr> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">firstline</td> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse"><span class="diff-html-removed" id="removed-diff-4" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">65</span><span class="diff-html-added" id="added-diff-6" style="font-size: 100%; background-color: #ddfade;">67</span></td> 

</tr> 

</tbody> 

</table> </td> 

</tr> 

</tbody> 

<tbody> 

<tr> 

<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; padding: 0px; border-collapse: collapse"> <pre style="margin: 10px 0 0 0; margin-top: 0">    def outgoing_start_cb(channel_obj, ev):

        """StasisStart handler for our dialed channel"""


        print "{} answered; bridging with {}".format(outgoing.json.get('name'),

                                                     channel.json.get('name'))

        channel.answer()


        bridge = client.bridges.create(type='mixing')

        bridge.addChannel(channel=[channel.id, outgoing.id])


        # Clean up the bridge when done

        channel.on_event('StasisEnd', lambda *args:

                         safe_bridge_destroy(bridge))

        outgoing.on_event('StasisEnd', lambda *args:

                          safe_bridge_destroy(bridge))


    outgoing.on_event('StasisStart', outgoing_start_cb)<span class="diff-html-removed" id="removed-diff-5" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;"> </span>

</pre> </td> 

</tr> 

</tbody> 

</table> 

<p style="margin: 10px 0 0 0">Note that the <code style="font-family: monospace">safe_bridge_destroy</code> function is similar to the <code style="font-family: monospace">safe_hangup</code> function, except that it attempts to safely destroy the mixing bridge, as opposed to hanging up the other party.</p> 

<h3 id="ARIandBridges:BasicMixingBridges-bridge-dial.py" style="margin: 10px 0 0 0; font-size: 16px; line-height: 25px; margin: 30px 0 0 0">bridge-dial.py</h3> 

<p style="margin: 10px 0 0 0">The full source code for <code style="font-family: monospace">bridge-dial.py</code> is shown below:</p> 

<table class="diff-macro" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<thead> 

<tr> 

<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5635/60fd2eb45debbf4ede2b669f4c9b96b4ce40a937.48/_/plugins/servlet/confluence/placeholder/macro-icon?name=code" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Code Block</th> 

</tr> 

</thead> 

<tbody> 

<tr> 

<td class="diff-macro-properties" style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;padding: 0; border: 1px solid #dddddd;; padding: 0px; border-collapse: collapse"> 

<table style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<tbody> 

<tr> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">title</td> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">basic-dial.py</td> 

</tr> 

<tr> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">linenumbers</td> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">true</td> 

</tr> 

<tr> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">language</td> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">py</td> 

</tr> 

</tbody> 

</table> </td> 

</tr> 

</tbody> 

<tbody> 

<tr> 

<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; padding: 0px; border-collapse: collapse"> <pre style="margin: 10px 0 0 0; margin-top: 0">#!/usr/bin/env python


import logging

import requests

import ari


logging.basicConfig(level=logging.ERROR)


client = ari.connect('http://localhost:8088', 'asterisk', 'asterisk')


def safe_hangup(channel):

    """Safely hang up the specified channel"""

    try:

        <span class="diff-html-added" id="added-diff-7" style="font-size: 100%; background-color: #ddfade;">channel.hangup()

        </span>print "<span class="diff-html-removed" id="removed-diff-6" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">Hanging</span><span class="diff-html-added" id="added-diff-8" style="font-size: 100%; background-color: #ddfade;">Hung</span> up <span class="diff-html-removed" id="removed-diff-7" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">%s" % </span><span class="diff-html-added" id="added-diff-9" style="font-size: 100%; background-color: #ddfade;">{}".format(</span>channel.json.get('name')<span class="diff-html-removed" id="removed-diff-8" style="font-size: 100%; background-color: #ffe7e7; text-decoration: line-through;">

        channel.hangup(</span>)

    except requests.HTTPError as e:

        if e.response.status_code != requests.codes.not_found:

            raise e


def safe_bridge_destroy(bridge):

    """Safely destroy the specified bridge"""

    try:

        bridge.destroy()

    except requests.HTTPError as e:

        if e.response.status_code != requests.codes.not_found:

            raise e


def stasis_start_cb(channel_obj, ev):

    """Handler for StasisStart"""


    channel = channel_obj.get('channel')

    channel_name = channel.json.get('name')

    args = ev.get('args')


    if not args:

        print "Error: {} didn't provide any arguments!".format(channel_name)

        return


    if args and args[0] != 'inbound':

        # Only handle inbound channels here

        return


    if len(args) != 2:

        print "Error: {} didn't tell us who to dial".format(channel_name)

        channel.hangup()

        return


    <span class="diff-html-added" id="added-diff-10" style="font-size: 100%; background-color: #ddfade;">print "{} entered our application".format(</span>channel<span class="diff-html-added" id="added-diff-11" style="font-size: 100%; background-color: #ddfade;">_name)

    channel</span>.ring()


    try:

        <span class="diff-html-added" id="added-diff-12" style="font-size: 100%; background-color: #ddfade;">print "Dialing {}".format(args[1])

        </span>outgoing = client.channels.originate(endpoint=args[1],

                                             app='bridge-dial',

                                             appArgs='dialed')

    except requests.HTTPError:

        print "Whoops, pretty sure %s wasn't valid" % args[1]

        channel.hangup()

        return


    channel.on_event('StasisEnd', lambda *args: safe_hangup(outgoing))

    outgoing.on_event('StasisEnd', lambda *args: safe_hangup(channel))


    def outgoing_start_cb(channel_obj, ev):

        """StasisStart handler for our dialed channel"""


        print "{} answered; bridging with {}".format(outgoing.json.get('name'),

                                                     channel.json.get('name'))

        channel.answer()


        bridge = client.bridges.create(type='mixing')

        bridge.addChannel(channel=[channel.id, outgoing.id])


        # Clean up the bridge when done

        channel.on_event('StasisEnd', lambda *args:

                         safe_bridge_destroy(bridge))

        outgoing.on_event('StasisEnd', lambda *args:

                          safe_bridge_destroy(bridge))


    outgoing.on_event('StasisStart', outgoing_start_cb)


client.on_channel_event('StasisStart', stasis_start_cb)


client.run(apps='bridge-dial')


</pre> </td> 

</tr> 

</tbody> 

</table> 

<h3 id="ARIandBridges:BasicMixingBridges-bridge-dial.pyinaction" style="margin: 10px 0 0 0; font-size: 16px; line-height: 25px; margin: 30px 0 0 0">bridge-dial.py in action</h3> 

<p style="margin: 10px 0 0 0">The following shows the output of the <code style="font-family: monospace">bridge-dial.py</code> script when a <code style="font-family: monospace">PJSIP</code> channel for <code style="font-family: monospace">alice</code> enters the application and dials a <code style="font-family: monospace">PJSIP</code> channel for <code style="font-family: monospace">bob</code>:</p> 

<table class="diff-macro" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<thead> 

<tr> 

<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5635/60fd2eb45debbf4ede2b669f4c9b96b4ce40a937.48/_/images/icons/macrobrowser/dropdown/noformat.png" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>No Format</th> 

</tr> 

</thead> 

<tbody> 

<tr> 

<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; padding: 0px; border-collapse: collapse"> <pre style="margin: 10px 0 0 0; margin-top: 0">PJSIP/Alice-00000001 entered our application

Dialing PJSIP/Bob

PJSIP/Bob-00000002 answered; bridging with PJSIP/Alice-00000001

Hung up PJSIP/Bob-00000002</pre> </td> 

</tr> 

</tbody> 

</table> 

<p style="margin: 10px 0 0 0"> </p> 

<h2 id="ARIandBridges:BasicMixingBridges-JavaScript(Node.js)" style="margin: 10px 0 0 0; font-size: 20px; font-weight: normal; line-height: 30px; margin: 40px 0 0 0">JavaScript (Node.js)</h2> 

<p style="margin: 10px 0 0 0">This example shows how to use anonymous functions to call functions with extra parameters that would otherwise require a closer. This can be done to reduce the number of nested callbacks required to implement the flow of an application. First, we look for an application argument in our <code style="font-family: monospace">StasisStart</code> event callback to ensure that we will only originate a call if the channel entering Stasis is a channel that dialed our application extension we defined in the extensions.conf file above. We then play a sound on the channel asking the caller to wait while they are being connected and call the originate() function to process down the application flow:</p> 

<table class="diff-macro" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<thead> 

<tr> 

<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5635/60fd2eb45debbf4ede2b669f4c9b96b4ce40a937.48/_/plugins/servlet/confluence/placeholder/macro-icon?name=code" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Code Block</th> 

</tr> 

</thead> 

<tbody> 

<tr> 

<td class="diff-macro-properties" style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;padding: 0; border: 1px solid #dddddd;; padding: 0px; border-collapse: collapse"> 

<table style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<tbody> 

<tr> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">linenumbers</td> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">true</td> 

</tr> 

<tr> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">language</td> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">js</td> 

</tr> 

<tr> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">firstline</td> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">22</td> 

</tr> 

</tbody> 

</table> </td> 

</tr> 

</tbody> 

<tbody> 

<tr> 

<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; padding: 0px; border-collapse: collapse"> <pre style="margin: 10px 0 0 0; margin-top: 0">function stasisStart(event, channel) {

  // ensure the channel is not a dialed channel

  var dialed = event.args[0] === 'dialed';


  if (!dialed) {

    channel.answer(function(err) {

      if (err) {

        throw err;

      }


      console.log('Channel %s has entered our application', channel.name);


      var playback = client.Playback();

      channel.play({media: 'sound:pls-wait-connect-call'},

        playback, function(err, playback) {

          if (err) {

            throw err;

          }

      });


      originate(channel);

    });

  }

}</pre> </td> 

</tr> 

</tbody> 

</table> 

<p style="margin: 10px 0 0 0">We then prepare an object with a locally generate Id for the dialed channel and register event callbacks either channels hanging up and the dialed channel entering into the Stasis application. We then originate a call to the endpoint specified by the first command line argument to the script passing in a Stasis application argument of dialed so we can skip the dialed channel when the original StasisStart event callback fires for it:</p> 

<table class="diff-macro" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<thead> 

<tr> 

<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5635/60fd2eb45debbf4ede2b669f4c9b96b4ce40a937.48/_/plugins/servlet/confluence/placeholder/macro-icon?name=code" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Code Block</th> 

</tr> 

</thead> 

<tbody> 

<tr> 

<td class="diff-macro-properties" style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;padding: 0; border: 1px solid #dddddd;; padding: 0px; border-collapse: collapse"> 

<table style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<tbody> 

<tr> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">linenumbers</td> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">true</td> 

</tr> 

<tr> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">language</td> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">js</td> 

</tr> 

<tr> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">firstline</td> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">47</td> 

</tr> 

</tbody> 

</table> </td> 

</tr> 

</tbody> 

<tbody> 

<tr> 

<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; padding: 0px; border-collapse: collapse"> <pre style="margin: 10px 0 0 0; margin-top: 0">function originate(channel) {

  var dialed = client.Channel();


  channel.on('StasisEnd', function(event, channel) {

    hangupDialed(channel, dialed);

  });


  dialed.on('ChannelDestroyed', function(event, dialed) {

    hangupOriginal(channel, dialed);

  });


  dialed.on('StasisStart', function(event, dialed) {

    joinMixingBridge(channel, dialed);

  });


  dialed.originate(

    {endpoint: process.argv[2], app: 'bridge-dial', appArgs: 'dialed'},

    function(err, dialed) {

      if (err) {

        throw err;

      }

  });

}</pre> </td> 

</tr> 

</tbody> 

</table> 

<p style="margin: 10px 0 0 0">We then handle either channel hanging up by hanging up the other channel. Note that we skip any errors that occur on hangup since it is possible that the channel we are attempting to hang up is the one that has already left and would result in an HTTP error as it is no longer a Statis channel:</p> 

<table class="diff-macro" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<thead> 

<tr> 

<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5635/60fd2eb45debbf4ede2b669f4c9b96b4ce40a937.48/_/plugins/servlet/confluence/placeholder/macro-icon?name=code" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Code Block</th> 

</tr> 

</thead> 

<tbody> 

<tr> 

<td class="diff-macro-properties" style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;padding: 0; border: 1px solid #dddddd;; padding: 0px; border-collapse: collapse"> 

<table style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<tbody> 

<tr> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">linenumbers</td> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">true</td> 

</tr> 

<tr> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">language</td> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">js</td> 

</tr> 

<tr> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">firstline</td> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">73</td> 

</tr> 

</tbody> 

</table> </td> 

</tr> 

</tbody> 

<tbody> 

<tr> 

<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; padding: 0px; border-collapse: collapse"> <pre style="margin: 10px 0 0 0; margin-top: 0">function hangupDialed(channel, dialed) {

  console.log(

    'Channel %s left our application, hanging up dialed channel %s',

    channel.name, dialed.name);


  // hangup the other end

  dialed.hangup(function(err) {

    // ignore error since dialed channel could have hung up, causing the

    // original channel to exit Stasis

  });

}


// handler for the dialed channel hanging up so we can gracefully hangup the

// other end

function hangupOriginal(channel, dialed) {

  console.log('Dialed channel %s has been hung up, hanging up channel %s',

    dialed.name, channel.name);


  // hangup the other end

  channel.hangup(function(err) {

    // ignore error since original channel could have hung up, causing the

    // dialed channel to exit Stasis

  });

}</pre> </td> 

</tr> 

</tbody> 

</table> 

<p style="margin: 10px 0 0 0">We then handle the StasisStart event for the dialed channel by registered an event callback for the StasisEnd event on the dialed channel, answer that answer, creating a new mixing bridge, and finally calling a function to add the two channels to the new bridge:</p> 

<table class="diff-macro" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<thead> 

<tr> 

<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5635/60fd2eb45debbf4ede2b669f4c9b96b4ce40a937.48/_/plugins/servlet/confluence/placeholder/macro-icon?name=code" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Code Block</th> 

</tr> 

</thead> 

<tbody> 

<tr> 

<td class="diff-macro-properties" style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;padding: 0; border: 1px solid #dddddd;; padding: 0px; border-collapse: collapse"> 

<table style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<tbody> 

<tr> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">linenumbers</td> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">true</td> 

</tr> 

<tr> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">language</td> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">js</td> 

</tr> 

<tr> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">firstline</td> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">99</td> 

</tr> 

</tbody> 

</table> </td> 

</tr> 

</tbody> 

<tbody> 

<tr> 

<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; padding: 0px; border-collapse: collapse"> <pre style="margin: 10px 0 0 0; margin-top: 0">function joinMixingBridge(channel, dialed) {

  var bridge = client.Bridge();


  dialed.on('StasisEnd', function(event, dialed) {

    dialedExit(dialed, bridge);

  });


  dialed.answer(function(err) {

    if (err) {

      throw err;

    }

  });


  bridge.create({type: 'mixing'}, function(err, bridge) {

    if (err) {

      throw err;

    }


    console.log('Created bridge %s', bridge.id);


    addChannelsToBridge(channel, dialed, bridge);

  });

}</pre> </td> 

</tr> 

</tbody> 

</table> 

<p style="margin: 10px 0 0 0">We then handle the dialed channel exiting the Stasis application by destroying the mixing bridge:</p> 

<table class="diff-macro" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<thead> 

<tr> 

<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5635/60fd2eb45debbf4ede2b669f4c9b96b4ce40a937.48/_/plugins/servlet/confluence/placeholder/macro-icon?name=code" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Code Block</th> 

</tr> 

</thead> 

<tbody> 

<tr> 

<td class="diff-macro-properties" style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;padding: 0; border: 1px solid #dddddd;; padding: 0px; border-collapse: collapse"> 

<table style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<tbody> 

<tr> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">linenumbers</td> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">true</td> 

</tr> 

<tr> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">language</td> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">js</td> 

</tr> 

<tr> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">firstline</td> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">124</td> 

</tr> 

</tbody> 

</table> </td> 

</tr> 

</tbody> 

<tbody> 

<tr> 

<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; padding: 0px; border-collapse: collapse"> <pre style="margin: 10px 0 0 0; margin-top: 0">function dialedExit(dialed, bridge) {

  console.log(

      'Dialed channel %s has left our application, destroying bridge %s',

      dialed.name, bridge.id);


  bridge.destroy(function(err) {

    if (err) {

      throw err;

    }

  });

}</pre> </td> 

</tr> 

</tbody> 

</table> 

<p style="margin: 10px 0 0 0">Finally, the function that was called earlier by the callback handling the StasisStart event for the dialed channel adds the two channels to the mixing bridge which allows media to flow between the two channels:</p> 

<table class="diff-macro" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<thead> 

<tr> 

<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5635/60fd2eb45debbf4ede2b669f4c9b96b4ce40a937.48/_/plugins/servlet/confluence/placeholder/macro-icon?name=code" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Code Block</th> 

</tr> 

</thead> 

<tbody> 

<tr> 

<td class="diff-macro-properties" style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;padding: 0; border: 1px solid #dddddd;; padding: 0px; border-collapse: collapse"> 

<table style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<tbody> 

<tr> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">linenumbers</td> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">true</td> 

</tr> 

<tr> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">language</td> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">js</td> 

</tr> 

<tr> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">firstline</td> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">137</td> 

</tr> 

</tbody> 

</table> </td> 

</tr> 

</tbody> 

<tbody> 

<tr> 

<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; padding: 0px; border-collapse: collapse"> <pre style="margin: 10px 0 0 0; margin-top: 0">function addChannelsToBridge(channel, dialed, bridge) {

  console.log('Adding channel %s and dialed channel %s to bridge %s',

      channel.name, dialed.name, bridge.id);


  bridge.addChannel({channel: [channel.id, dialed.id]}, function(err) {

    if (err) {

      throw err;

    }

  });

}</pre> </td> 

</tr> 

</tbody> 

</table> 

<h3 id="ARIandBridges:BasicMixingBridges-bridge-dial.js" style="margin: 10px 0 0 0; font-size: 16px; line-height: 25px; margin: 30px 0 0 0">bridge-dial.js</h3> 

<p style="margin: 10px 0 0 0">The full source code for <code style="font-family: monospace">bridge-dial.js</code> is shown below:</p> 

<table class="diff-macro" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<thead> 

<tr> 

<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5635/60fd2eb45debbf4ede2b669f4c9b96b4ce40a937.48/_/plugins/servlet/confluence/placeholder/macro-icon?name=code" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Code Block</th> 

</tr> 

</thead> 

<tbody> 

<tr> 

<td class="diff-macro-properties" style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;padding: 0; border: 1px solid #dddddd;; padding: 0px; border-collapse: collapse"> 

<table style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<tbody> 

<tr> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">title</td> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">bridge-dial.js</td> 

</tr> 

<tr> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">linenumbers</td> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">true</td> 

</tr> 

<tr> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">language</td> 

<td style="background-color: #fafafa; padding: 0 0 0 5px; font-size: 12px; text-align: left;; padding: 0px; border-collapse: collapse">js</td> 

</tr> 

</tbody> 

</table> </td> 

</tr> 

</tbody> 

<tbody> 

<tr> 

<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; padding: 0px; border-collapse: collapse"> <pre style="margin: 10px 0 0 0; margin-top: 0">/*jshint node:true*/

'use strict';


var ari = require('ari-client');

var util = require('util');


// ensure endpoint was passed in to script

if (!process.argv[2]) {

  console.error('usage: node bridge-dial.js endpoint');

  process.exit(1);

}


ari.connect('http://localhost:8088', 'asterisk', 'asterisk', clientLoaded);


// handler for client being loaded

function clientLoaded (err, client) {

  if (err) {

    throw err;

  }


  // handler for StasisStart event

  function stasisStart(event, channel) {

    // ensure the channel is not a dialed channel

    var dialed = event.args[0] === 'dialed';


    if (!dialed) {

      channel.answer(function(err) {

        if (err) {

          throw err;

        }


        console.log('Channel %s has entered our application', channel.name);


        var playback = client.Playback();

        channel.play({media: 'sound:pls-wait-connect-call'},

          playback, function(err, playback) {

            if (err) {

              throw err;

            }

        });


        originate(channel);

      });

    }

  }


  function originate(channel) {

    var dialed = client.Channel();


    channel.on('StasisEnd', function(event, channel) {

      hangupDialed(channel, dialed);

    });


    dialed.on('ChannelDestroyed', function(event, dialed) {

      hangupOriginal(channel, dialed);

    });


    dialed.on('StasisStart', function(event, dialed) {

      joinMixingBridge(channel, dialed);

    });


    dialed.originate(

      {endpoint: process.argv[2], app: 'bridge-dial', appArgs: 'dialed'},

      function(err, dialed) {

        if (err) {

          throw err;

        }

    });

  }


  // handler for original channel hanging up so we can gracefully hangup the

  // other end

  function hangupDialed(channel, dialed) {

    console.log(

      'Channel %s left our application, hanging up dialed channel %s',

      channel.name, dialed.name);


    // hangup the other end

    dialed.hangup(function(err) {

      // ignore error since dialed channel could have hung up, causing the

      // original channel to exit Stasis

    });

  }


  // handler for the dialed channel hanging up so we can gracefully hangup the

  // other end

  function hangupOriginal(channel, dialed) {

    console.log('Dialed channel %s has been hung up, hanging up channel %s',

      dialed.name, channel.name);


    // hangup the other end

    channel.hangup(function(err) {

      // ignore error since original channel could have hung up, causing the

      // dialed channel to exit Stasis

    });

  }


  // handler for dialed channel entering Stasis

  function joinMixingBridge(channel, dialed) {

    var bridge = client.Bridge();


    dialed.on('StasisEnd', function(event, dialed) {

      dialedExit(dialed, bridge);

    });


    dialed.answer(function(err) {

      if (err) {

        throw err;

      }

    });


    bridge.create({type: 'mixing'}, function(err, bridge) {

      if (err) {

        throw err;

      }


      console.log('Created bridge %s', bridge.id);


      addChannelsToBridge(channel, dialed, bridge);

    });

  }


  // handler for the dialed channel leaving Stasis

  function dialedExit(dialed, bridge) {

    console.log(

        'Dialed channel %s has left our application, destroying bridge %s',

        dialed.name, bridge.id);


    bridge.destroy(function(err) {

      if (err) {

        throw err;

      }

    });

  }


  // handler for new mixing bridge ready for channels to be added to it

  function addChannelsToBridge(channel, dialed, bridge) {

    console.log('Adding channel %s and dialed channel %s to bridge %s',

        channel.name, dialed.name, bridge.id);


    bridge.addChannel({channel: [channel.id, dialed.id]}, function(err) {

      if (err) {

        throw err;

      }

    });

  }


  client.on('StasisStart', stasisStart);


  client.start('bridge-dial');

}</pre> </td> 

</tr> 

</tbody> 

</table> 

<h3 id="ARIandBridges:BasicMixingBridges-bridge-dial.jsinaction" style="margin: 10px 0 0 0; font-size: 16px; line-height: 25px; margin: 30px 0 0 0">bridge-dial.js in action</h3> 

<p style="margin: 10px 0 0 0">The following shows the output of the <code style="font-family: monospace">bridge-dial.js</code> script when a <code style="font-family: monospace">PJSIP</code> channel for <code style="font-family: monospace">alice</code> enters the application and dials a PJSIP channel for bob:</p> 

<table class="diff-macro" style="background-color: #f0f0f0;border: 1px solid #dddddd;margin: 10px 1px;padding: 0 2px 2px;width: 100%;; border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<thead> 

<tr> 

<th class="diff-macro-title" style="background-color: transparent; text-align: left; font-weight: normal;padding: 5px;"><span class="icon macro-placeholder-icon" style="background-color: ;line-height: 20px;"><img src="https://wiki.asterisk.org/wiki/s/en_GB/5635/60fd2eb45debbf4ede2b669f4c9b96b4ce40a937.48/_/plugins/servlet/confluence/placeholder/macro-icon?name=code" style="padding-right: 5px; vertical-align: text-bottom;" /> </span>Code Block</th> 

</tr> 

</thead> 

<tbody> 

<tr> 

<td class="diff-macro-body" style="background-color: #fff;border: 1px solid #dddddd;padding: 10px;; padding: 0px; border-collapse: collapse"> <pre style="margin: 10px 0 0 0; margin-top: 0">Channel PJSIP/alice-00000001 has entered our application

Created bridge 30430e82-83ed-4242-9f37-1bc040f70724

Adding channel PJSIP/alice-00000001 and dialed channel PJSIP/bob-00000002 to bridge 30430e82-83ed-4242-9f37-1bc040f70724

Dialed channel PJSIP/bob-00000002 has left our application, destroying bridge 30430e82-83ed-4242-9f37-1bc040f70724

Dialed channel PJSIP/bob-00000002 has been hung up, hanging up channel PJSIP/alice-00000001

Channel PJSIP/alice-00000001 left our application, hanging up dialed channel undefined</pre> </td> 

</tr> 

</tbody> 

</table> 

</div> </td> 

</tr> 

</tbody>

</table> 

</div> </td> 

</tr> 

</tbody> 

</table> </td> 

</tr> 

<tr> 

<td class="email-content-main mobile-expand action-padding last-row-padding" style="padding: 0px; border-collapse: collapse; border-left: 1px solid #ccc; border-right: 1px solid #ccc; border-top: 0; border-bottom: 0; padding: 0 15px 15px 16px; background-color: #fff; padding-bottom: 10px; padding-bottom: 10px"> 

<table id="actions-pattern" cellspacing="0" cellpadding="0" border="0" width="100%" style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333; font-family: Arial, sans-serif; font-size: 14px; line-height: 20px; mso-line-height-rule: exactly; mso-text-raise: 1px"> 

<tbody> 

<tr> 

<td id="actions-pattern-container" valign="middle" style="padding: 0px; border-collapse: collapse; padding: 15px 0 0 24px; vertical-align: middle"> 

<table align="left" style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<tbody> 

<tr> 

<td class="actions-pattern-action-icon-container" style="padding: 0px; border-collapse: collapse; font-family: Arial, sans-serif; font-size: 14px; line-height: 20px; mso-line-height-rule: exactly; mso-text-raise: 0px; vertical-align: middle"><a href="https://wiki.asterisk.org/wiki/display/AST/ARI+and+Bridges%3A+Basic+Mixing+Bridges?src=email" title="View page Icon" style="color: #3b73af; text-decoration: none"><img class="actions-pattern-action-icon-image" height="16" width="16" border="0" title="View page Icon" src="cid:com.atlassian.confluence.plugins.confluence-email-resources%3Aview-page-email-adg-footer-item%3Aicon" alt="View page Icon" style="vertical-align: middle" /></a></td>

<td class="actions-pattern-action-text-container" style="padding: 0px; border-collapse: collapse; font-family: Arial, sans-serif; font-size: 14px; line-height: 20px; mso-line-height-rule: exactly; mso-text-raise: 4px; padding-left: 5px; white-space: nowrap"><a href="https://wiki.asterisk.org/wiki/display/AST/ARI+and+Bridges%3A+Basic+Mixing+Bridges?src=email" title="View page" style="color: #3b73af; text-decoration: none">View page</a></td>

<td class="actions-pattern-action-bull" style="padding: 0px; border-collapse: collapse; font-family: Arial, sans-serif; font-size: 14px; line-height: 20px; mso-line-height-rule: exactly; mso-text-raise: 4px; color: #999; padding: 0 5px">•</td> 

</tr> 

</tbody> 

</table> 

<table align="left" style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<tbody> 

<tr> 

<td class="actions-pattern-action-icon-container" style="padding: 0px; border-collapse: collapse; font-family: Arial, sans-serif; font-size: 14px; line-height: 20px; mso-line-height-rule: exactly; mso-text-raise: 0px; vertical-align: middle"><a href="https://wiki.asterisk.org/wiki/display/AST/ARI+and+Bridges%3A+Basic+Mixing+Bridges?showComments=true&showCommentArea=true&src=email#addcomment" title="Add comment Icon" style="color: #3b73af; text-decoration: none"><img class="actions-pattern-action-icon-image" height="16" width="16" border="0" title="Add comment Icon" src="cid:com.atlassian.confluence.plugins.confluence-email-resources%3Aadd-comment-to-content-email-adg-footer-item%3Aicon" alt="Add comment Icon" style="vertical-align: middle" /></a></td>

<td class="actions-pattern-action-text-container" style="padding: 0px; border-collapse: collapse; font-family: Arial, sans-serif; font-size: 14px; line-height: 20px; mso-line-height-rule: exactly; mso-text-raise: 4px; padding-left: 5px; white-space: nowrap"><a href="https://wiki.asterisk.org/wiki/display/AST/ARI+and+Bridges%3A+Basic+Mixing+Bridges?showComments=true&showCommentArea=true&src=email#addcomment" title="Add comment" style="color: #3b73af; text-decoration: none">Add comment</a></td>

<td class="actions-pattern-action-bull" style="padding: 0px; border-collapse: collapse; font-family: Arial, sans-serif; font-size: 14px; line-height: 20px; mso-line-height-rule: exactly; mso-text-raise: 4px; color: #999; padding: 0 5px">•</td> 

</tr> 

</tbody> 

</table> 

<table style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<tbody> 

<tr> 

<td class="actions-pattern-action-icon-container" style="padding: 0px; border-collapse: collapse; font-family: Arial, sans-serif; font-size: 14px; line-height: 20px; mso-line-height-rule: exactly; mso-text-raise: 0px; vertical-align: middle"><a href="https://wiki.asterisk.org/wiki/plugins/likes/like.action?contentId=29396220&src=email" title="Like Icon" style="color: #3b73af; text-decoration: none"><img class="actions-pattern-action-icon-image" height="16" width="16" border="0" title="Like Icon" src="cid:com.atlassian.confluence.plugins.confluence-like%3Aview-email-adg-content-item%3Aicon" alt="Like Icon" style="vertical-align: middle" /></a></td>

<td class="actions-pattern-action-text-container" style="padding: 0px; border-collapse: collapse; font-family: Arial, sans-serif; font-size: 14px; line-height: 20px; mso-line-height-rule: exactly; mso-text-raise: 4px; padding-left: 5px; white-space: nowrap"><a href="https://wiki.asterisk.org/wiki/plugins/likes/like.action?contentId=29396220&src=email" title="Like" style="color: #3b73af; text-decoration: none">Like</a></td> 

</tr> 

</tbody> 

</table> </td> 

</tr> 

</tbody> 

</table> </td> 

</tr> 

<tr> 

<td class="email-content-rounded-bottom mobile-expand" style="padding: 0px; border-collapse: collapse; color: #fff; height: 5px; line-height: 5px; padding: 0 15px 0 16px; background-color: #fff; border-bottom-right-radius: 5px; border-bottom-left-radius: 5px; border-top: 0; border-left: 1px solid #ccc; border-bottom: 1px solid #ccc; border-right: 1px solid #ccc; mso-line-height-rule: exactly"> </td> 

</tr> 

</tbody> 

</table> </td> 

</tr> 

<tr> 

<td id="footer-pattern" style="padding: 0px; border-collapse: collapse; padding: 12px 20px"> 

<table id="footer-pattern-container" cellspacing="0" cellpadding="0" border="0" width="100%" style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333"> 

<tbody> 

<tr> 

<td id="footer-pattern-links-container" width="100%" style="padding: 0px; border-collapse: collapse; color: #999; font-size: 12px; line-height: 18px; font-family: Arial, sans-serif; mso-line-height-rule: exactly; mso-text-raise: 2px"> 

<table align="left" style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333; font-size: 12px; line-height: 18px; font-family: Arial, sans-serif; mso-line-height-rule: exactly; mso-text-raise: 2px"> 

<tbody> 

<tr> 

<td class="footer-pattern-links mobile-resize-text" style="padding: 0px; border-collapse: collapse"><a href="https://wiki.asterisk.org/wiki/users/removespacenotification.action?spaceKey=AST&src=email" title="" style="color: #3b73af; text-decoration: none">Stop watching space</a></td>

<td class="footer-pattern-links-bull" style="padding: 0px; border-collapse: collapse; padding: 0 5px; color: #999">•</td> 

</tr> 

</tbody> 

</table> 

<table style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333; font-size: 12px; line-height: 18px; font-family: Arial, sans-serif; mso-line-height-rule: exactly; mso-text-raise: 2px"> 

<tbody> 

<tr> 

<td class="footer-pattern-links mobile-resize-text" style="padding: 0px; border-collapse: collapse"><a href="https://wiki.asterisk.org/wiki/users/editmyemailsettings.action?src=email" title="" style="color: #3b73af; text-decoration: none">Manage notifications</a></td> 

</tr> 

</tbody> 

</table> </td> 

</tr> 

<tr> 

<td id="footer-pattern-text" class="mobile-resize-text" width="100%" style="padding: 0px; border-collapse: collapse; color: #999; font-size: 12px; line-height: 18px; font-family: Arial, sans-serif; mso-line-height-rule: exactly; mso-text-raise: 2px; display: none">This message was sent by Atlassian Confluence 5.6.1</td> 

</tr> 

</tbody> 

</table> </td> 

</tr> 

</tbody> 

</table> 

<table id="sealed-section" border="0" cellpadding="0" cellspacing="0" width="0" style="border-collapse: collapse; mso-table-lspace: 0pt; mso-table-rspace: 0pt; color: #333; display: none"> 

<tbody> 

<tr> 

<td style="padding: 0px; border-collapse: collapse; border: 0; font-size: 0px; line-height: 0; mso-line-height-rule: exactly"></td> 

</tr> 

</tbody> 

</table>

</body>

</html>