From 896a34f7e53db0c80379b9f78b10e9b55f9cc5e2 Mon Sep 17 00:00:00 2001 From: Richard Fuchs Date: Thu, 2 Apr 2026 11:27:25 -0400 Subject: [PATCH] MT#55283 docs for If751f137 Change-Id: I0c373075b7402f3b33785353e7f382177bc8915e --- docs/ng_control_protocol.md | 20 ++++++++++++++++++-- 1 file changed, 18 insertions(+), 2 deletions(-) diff --git a/docs/ng_control_protocol.md b/docs/ng_control_protocol.md index 2848593a6..500e9595f 100644 --- a/docs/ng_control_protocol.md +++ b/docs/ng_control_protocol.md @@ -2696,7 +2696,7 @@ Example: This message makes it possible to directly connect the media of two call parties without the need for a full offer/answer exchange. The required keys are -`call-id` to identify the call, and `from-tag and `to-tag` to identify the two +`call-id` to identify the call, and `from-tag` and `to-tag` to identify the two call parties to connect. By default, the media will be connected in the same way as it would through an offer/answer exchange. Transcoding will automatically be engaged if needed. @@ -2709,12 +2709,28 @@ object, with both call IDs then corresponding to the same call. This will be visible in certain statistics (e.g. two call IDs appearing in the list, but only one call being counted). -Adding the flag `directional` changes the behaviour from doing a full call transfer (similar to an offer/answer) to only setting up additional media subscriptions. In this mode, `connect` instructs *rtpengine* that (a copy of the) media received from the call party identified by the `from-tag` shall also be delivered to the call party identified by the `to-tag`. Other existing media subscriptions are not affected. +Adding the flag `directional` changes the behaviour from doing a full call +transfer (similar to an offer/answer) to only setting up additional media +subscriptions. In this mode, `connect` instructs *rtpengine* that (a copy of +the) media received from the call party identified by the `from-tag` shall also +be delivered to the call party identified by the `to-tag`. Other existing media +subscriptions are not affected. + +Directional mode also makes it possible to specify not just one `from-tag` but +multiple call parties in order to create multiple new subscriptions with a +single call. This can be done either with a list of tags in `from-tags` or +using the `all` flag described elsewhere. In addition to `directional`, the flag `bidirectional` can be set to set up subscriptions not just from the `from-tag` to the `to-tag`, but also in the other direction at the same time. +Note that creating multiple source subscriptions for a single destination +doesn't automatically create a typical "conference" scenario. Specifically, by +default the destination would get multiple RTP streams delivered, which may be +acceptable for some clients, but isn't what is usually expected. The `audio +player` feature described elsewhere is a useful option for this. + ## `create` and `create answer` Messages The `create` message can be used to create a new call, a new party to a call,