Skip to content

Commit 11f3ce5

Browse files
authored
Update live-events-outputs-concept.md
1 parent 605a5de commit 11f3ce5

File tree

1 file changed

+23
-17
lines changed

1 file changed

+23
-17
lines changed

articles/media-services/latest/live-events-outputs-concept.md

Lines changed: 23 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -84,7 +84,9 @@ You can either use non-vanity URLs or vanity URLs.
8484
8585
* Non-vanity URL
8686

87-
Non-vanity URL is the default mode in AMS v3. You potentially get the Live Event quickly but ingest URL is known only when the live event is started. The URL will change if you do stop/start the Live Event. <br/>Non-Vanity is useful in scenarios when an end user wants to stream using an app where the app wants to get a live event ASAP and having a dynamic ingest URL is not a problem.
87+
Non-vanity URL is the default mode in Media Services v3. You potentially get the Live Event quickly but ingest URL is known only when the live event is started. The URL will change if you do stop/start the Live Event. <br/>Non-Vanity is useful in scenarios when an end user wants to stream using an app where the app wants to get a live event ASAP and having a dynamic ingest URL is not a problem.
88+
89+
If a client application doesn’t need to pre-generate an ingest URL before the Live Event is created, just let Media Services auto-generate the Access Token for the live event.
8890
* Vanity URL
8991

9092
Vanity mode is preferred by large media broadcasters who use hardware broadcast encoders and don't want to re-configure their encoders when they start the Live Event. They want a predictive ingest URL, which does not change over time.
@@ -93,7 +95,7 @@ You can either use non-vanity URLs or vanity URLs.
9395

9496
The access token needs to be unique in your data center. If your application needs to use a vanity URL, it is recommended to always create a new GUID instance for your access token (instead of reusing any existing GUID).
9597

96-
Use the following APIs to enable the Vanity URL and set the access token to a valid GUID (for example `"accessToken": "1fce2e4b-fb15-4718-8adc-68c6eb4c26a7"`):
98+
Use the following APIs to enable the Vanity URL and set the access token to a valid GUID (for example `"accessToken": "1fce2e4b-fb15-4718-8adc-68c6eb4c26a7"`). The GUID string and can contain hyphens.
9799

98100
|Language|Enable vanity URL|Set access token|
99101
|---|---|---|
@@ -103,37 +105,41 @@ You can either use non-vanity URLs or vanity URLs.
103105

104106
### Live ingest URL naming rules
105107

106-
The *random* string below is a 128-bit hex number (which is composed of 32 characters of 0-9 a-f).<br/>
107-
The *access token* is what you need to specify for fixed URL. You must set an access token string that is a valid length GUID string. <br/>
108-
The *stream name* indicates the stream name for a specific connection. The stream name value is usually added by the live encoder that you use.
108+
* The *random* string below is a 128-bit hex number (which is composed of 32 characters of 0-9 a-f).
109+
* *auto-generated access token* - When not using the vanity mode.
110+
* *your access token* - Your valid GUID string. For example, `"1fce2e4b-fb15-4718-8adc-68c6eb4c26a7"`.
111+
* The *stream name* indicates the stream name for a specific connection. The stream name value is usually added by the live encoder that you use.
112+
113+
> [!TIP]
114+
> Some live encoders ask you to go get the “Stream Key/ID” from the service. In the case of Media Services, you would prove the value of the access token.
109115
110116
#### Non-vanity URL
111117

112118
##### RTMP
113119

114-
`rtmp://<random 128bit hex string>.channel.media.azure.net:1935/live/<access token>/<stream name>`<br/>
115-
`rtmp://<random 128bit hex string>.channel.media.azure.net:1936/live/<access token>/<stream name>`<br/>
116-
`rtmps://<random 128bit hex string>.channel.media.azure.net:2935/live/<access token>/<stream name>`<br/>
117-
`rtmps://<random 128bit hex string>.channel.media.azure.net:2936/live/<access token>/<stream name>`<br/>
120+
`rtmp://<random 128bit hex string>.channel.media.azure.net:1935/live/<auto-generated access token>/<stream name>`<br/>
121+
`rtmp://<random 128bit hex string>.channel.media.azure.net:1936/live/<auto-generated access token>/<stream name>`<br/>
122+
`rtmps://<random 128bit hex string>.channel.media.azure.net:2935/live/<auto-generated access token>/<stream name>`<br/>
123+
`rtmps://<random 128bit hex string>.channel.media.azure.net:2936/live/<auto-generated access token>/<stream name>`<br/>
118124

119125
##### Smooth Streaming
120126

121-
`http://<random 128bit hex string>.channel.media.azure.net/<access token>/ingest.isml/streams(<stream name>)`<br/>
122-
`https://<random 128bit hex string>.channel.media.azure.net/<access token>/ingest.isml/streams(<stream name>)`<br/>
127+
`http://<random 128bit hex string>.channel.media.azure.net/<auto-generated access token>/ingest.isml/streams(<stream name>)`<br/>
128+
`https://<random 128bit hex string>.channel.media.azure.net/<auto-generated access token>/ingest.isml/streams(<stream name>)`<br/>
123129

124130
#### Vanity URL
125131

126132
##### RTMP
127133

128-
`rtmp://<live event name>-<ams account name>-<region abbrev name>.channel.media.azure.net:1935/live/<access token>/<stream name>`<br/>
129-
`rtmp://<live event name>-<ams account name>-<region abbrev name>.channel.media.azure.net:1936/live/<access token>/<stream name>`<br/>
130-
`rtmps://<live event name>-<ams account name>-<region abbrev name>.channel.media.azure.net:2935/live/<access token>/<stream name>`<br/>
131-
`rtmps://<live event name>-<ams account name>-<region abbrev name>.channel.media.azure.net:2936/live/<access token>/<stream name>`<br/>
134+
`rtmp://<live event name>-<ams account name>-<region abbrev name>.channel.media.azure.net:1935/live/<your access token>/<stream name>`<br/>
135+
`rtmp://<live event name>-<ams account name>-<region abbrev name>.channel.media.azure.net:1936/live/<your access token>/<stream name>`<br/>
136+
`rtmps://<live event name>-<ams account name>-<region abbrev name>.channel.media.azure.net:2935/live/<your access token>/<stream name>`<br/>
137+
`rtmps://<live event name>-<ams account name>-<region abbrev name>.channel.media.azure.net:2936/live/<your access token>/<stream name>`<br/>
132138

133139
##### Smooth Streaming
134140

135-
`http://<live event name>-<ams account name>-<region abbrev name>.channel.media.azure.net/<access token>/ingest.isml/streams(<stream name>)`<br/>
136-
`https://<live event name>-<ams account name>-<region abbrev name>.channel.media.azure.net/<access token>/ingest.isml/streams(<stream name>)`<br/>
141+
`http://<live event name>-<ams account name>-<region abbrev name>.channel.media.azure.net/<your access token>/ingest.isml/streams(<stream name>)`<br/>
142+
`https://<live event name>-<ams account name>-<region abbrev name>.channel.media.azure.net/<your access token>/ingest.isml/streams(<stream name>)`<br/>
137143

138144
## Live Event preview URL
139145

0 commit comments

Comments
 (0)