GITBOOK-528: Added support for selecting a specific track among tracks with the same VariantName during push

Author: Keukhan

docs/push-publishing.md

@@ -35,49 +35,70 @@ The RTMP protocol only supports H264 and AAC codecs.
 
 ### StreamMap
 
-`<StreamMap>` is used for automatically pushing content based on user-defined conditions. The XML file path should be specified relative to `<ApplicationPath>/conf`.
+`<StreamMap>` is used to automatically push content based on user-defined conditions. The XML file path must be specified relative to `<ApplicationPath>/conf`.
 
-`<StreamName>` is used to match output stream names and supports the use of wildcard characters. `<VariantNames>` can be used to select specific tracks. Multiple variants can be specified using commas (','). The `<Protocol>` supports `rtmp`, `mpegts`, and `srt`. You enter the destination address in the `<Url>` and `<StreamKey>` field, where macros can also be used.
+`<StreamName>` is used to match output stream names and supports wildcard characters.
+
+`<VariantNames>` can be used to select specific tracks. Multiple variants can be specified by separating them with commas (,). \
+If multiple tracks with the same `VariantName` exist in the output stream, a specific track can be selected by appending a `:[Index]` suffix.
+
+`<Protocol>` supports `rtmp`, `mpegts`, and `srt`. The destination address is specified in the `<Url>` and `<StreamKey>` fields, and macros can be used.
 
 <pre class="language-xml"><code class="lang-xml">&#x3C;?xml version="1.0" encoding="UTF-8"?>
 &#x3C;PushInfo>
+  &#x3C;!-- RTMP -->
   &#x3C;Push>
     &#x3C;!-- [Must] -->
     &#x3C;Enable>true&#x3C;/Enable>
+
     &#x3C;!-- [Must] -->
     &#x3C;StreamName>stream_a_*&#x3C;/StreamName>
+    
     &#x3C;!-- [Optional] -->
     &#x3C;VariantNames>video_h264,audio_aac&#x3C;/VariantNames>
+    &#x3C;!-- Select a specific track among tracks with the same VariantName -->
+    &#x3C;!-- &#x3C;VariantNames>video_h264:0,audio_aac:1&#x3C;/VariantNames> -->
+    
     &#x3C;!-- [Must] -->
     &#x3C;Protocol>rtmp&#x3C;/Protocol>
+    
     &#x3C;!-- [Must] -->
     &#x3C;Url>rtmp://1.2.3.4:1935/app/${SourceStream}&#x3C;/Url>
-    &#x3C;!-- &#x3C;Url>rtmp://1.2.3.4:1935/app/${Stream}&#x3C;/Url> -->
+    &#x3C;!-- &#x3C;Url>rtmp://1.2.3.4:1935/app/${<a data-footnote-ref href="#user-content-fn-1">Stream</a>}&#x3C;/Url> --> 
+    
     &#x3C;!-- [Optional] -->
-    &#x3C;StreamKey>&#x3C;/StreamKey>
     &#x3C;!-- &#x3C;StreamKey>some-stream-key&#x3C;/StreamKey> -->
 <strong>  &#x3C;/Push>  
-</strong>  &#x3C;Push>
+</strong>
+  &#x3C;!-- SRT -->
+  &#x3C;Push>
     &#x3C;!-- [Must] -->
     &#x3C;Enable>true&#x3C;/Enable>
+
     &#x3C;!-- [Must] -->
     &#x3C;StreamName>stream_b_*&#x3C;/StreamName>
+
     &#x3C;!-- [Optional] -->
     &#x3C;VariantNames>&#x3C;/VariantNames>
+
     &#x3C;!-- [Must] -->
     &#x3C;Protocol>srt&#x3C;/Protocol>
+
     &#x3C;!-- [Must] -->
     &#x3C;Url>srt://1.2.3.4:9999?streamid=srt%3A%2F%2F1.2.3.4%3A9999%2Fapp%2Fstream&#x3C;/Url>
-  &#x3C;/Push>      
+  &#x3C;/Push>
+
+  &#x3C;!-- MPEG-TS -->
   &#x3C;Push>
     &#x3C;!-- [Must] -->
     &#x3C;Enable>false&#x3C;/Enable>
+
     &#x3C;!-- [Must] -->
     &#x3C;StreamName>stream_c_*&#x3C;/StreamName>
-    &#x3C;!-- [Optional] -->
-    &#x3C;VariantNames>&#x3C;/VariantNames>
+
     &#x3C;!-- [Must] -->
     &#x3C;Protocol>mpegts&#x3C;/Protocol>
+
     &#x3C;!-- [Must] -->
     &#x3C;Url>udp://1.2.3.4:2400&#x3C;/Url>
   &#x3C;/Push>    
@@ -97,3 +118,5 @@ Push can be controlled using the REST API. Please refer to the documentation bel
 {% content-ref url="rest-api/v1/virtualhost/application/push.md" %}
 [push.md](rest-api/v1/virtualhost/application/push.md)
 {% endcontent-ref %}
+
+[^1]: