@aws-sdk/client-ivs-realtime 3.600.0 → 3.605.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (41) hide show
  1. package/README.md +49 -170
  2. package/dist-cjs/index.js +230 -0
  3. package/dist-es/IVSRealTime.js +8 -0
  4. package/dist-es/commands/DeletePublicKeyCommand.js +24 -0
  5. package/dist-es/commands/GetPublicKeyCommand.js +24 -0
  6. package/dist-es/commands/ImportPublicKeyCommand.js +24 -0
  7. package/dist-es/commands/ListPublicKeysCommand.js +24 -0
  8. package/dist-es/commands/index.js +4 -0
  9. package/dist-es/models/models_0.js +19 -0
  10. package/dist-es/pagination/ListPublicKeysPaginator.js +4 -0
  11. package/dist-es/pagination/index.js +1 -0
  12. package/dist-es/protocols/Aws_restJson1.js +115 -0
  13. package/dist-types/IVSRealTime.d.ts +53 -177
  14. package/dist-types/IVSRealTimeClient.d.ts +30 -179
  15. package/dist-types/commands/CreateStageCommand.d.ts +16 -0
  16. package/dist-types/commands/DeletePublicKeyCommand.d.ts +75 -0
  17. package/dist-types/commands/GetParticipantCommand.d.ts +3 -0
  18. package/dist-types/commands/GetPublicKeyCommand.d.ts +77 -0
  19. package/dist-types/commands/GetStageCommand.d.ts +10 -0
  20. package/dist-types/commands/ImportPublicKeyCommand.d.ts +87 -0
  21. package/dist-types/commands/ListParticipantsCommand.d.ts +2 -0
  22. package/dist-types/commands/ListPublicKeysCommand.d.ts +76 -0
  23. package/dist-types/commands/UpdateStageCommand.d.ts +16 -0
  24. package/dist-types/commands/index.d.ts +4 -0
  25. package/dist-types/index.d.ts +24 -177
  26. package/dist-types/models/models_0.d.ts +305 -22
  27. package/dist-types/pagination/ListPublicKeysPaginator.d.ts +7 -0
  28. package/dist-types/pagination/index.d.ts +1 -0
  29. package/dist-types/protocols/Aws_restJson1.d.ts +36 -0
  30. package/dist-types/ts3.4/IVSRealTime.d.ts +69 -0
  31. package/dist-types/ts3.4/IVSRealTimeClient.d.ts +24 -0
  32. package/dist-types/ts3.4/commands/DeletePublicKeyCommand.d.ts +39 -0
  33. package/dist-types/ts3.4/commands/GetPublicKeyCommand.d.ts +36 -0
  34. package/dist-types/ts3.4/commands/ImportPublicKeyCommand.d.ts +39 -0
  35. package/dist-types/ts3.4/commands/ListPublicKeysCommand.d.ts +39 -0
  36. package/dist-types/ts3.4/commands/index.d.ts +4 -0
  37. package/dist-types/ts3.4/models/models_0.d.ts +80 -0
  38. package/dist-types/ts3.4/pagination/ListPublicKeysPaginator.d.ts +11 -0
  39. package/dist-types/ts3.4/pagination/index.d.ts +1 -0
  40. package/dist-types/ts3.4/protocols/Aws_restJson1.d.ts +48 -0
  41. package/package.json +1 -1
package/README.md CHANGED
@@ -6,48 +6,46 @@
6
6
 
7
7
  AWS SDK for JavaScript IVSRealTime Client for Node.js, Browser and React Native.
8
8
 
9
- <p>
10
- <b>Introduction</b>
11
- </p>
12
9
  <p>The Amazon Interactive Video Service (IVS) real-time API is REST compatible, using a standard HTTP
13
10
  API and an AWS EventBridge event stream for responses. JSON is used for both requests and responses,
14
11
  including errors.
15
12
  </p>
16
- <p>Terminology:</p>
13
+ <p>
14
+ <b>Key Concepts</b>
15
+ </p>
17
16
  <ul>
18
17
  <li>
19
- <p>A <i>stage</i> is a virtual space where participants can exchange video in real time.</p>
18
+ <p>
19
+ <b>Stage</b> — A virtual space where participants can exchange video in real time.</p>
20
20
  </li>
21
21
  <li>
22
- <p>A <i>participant token</i> is a token that authenticates a participant when they join a stage.</p>
22
+ <p>
23
+ <b>Participant token</b> — A token that authenticates a participant when they join a stage.</p>
23
24
  </li>
24
25
  <li>
25
- <p>A <i>participant object</i> represents participants (people) in the stage and
26
+ <p>
27
+ <b>Participant object</b> — Represents participants (people) in the stage and
26
28
  contains information about them. When a token is created, it includes a participant ID;
27
29
  when a participant uses that token to join a stage, the participant is associated with
28
30
  that participant ID. There is a 1:1 mapping between participant tokens and
29
31
  participants.</p>
30
32
  </li>
33
+ </ul>
34
+ <p>For server-side composition:</p>
35
+ <ul>
31
36
  <li>
32
- <p>Server-side composition: The <i>composition</i> process composites participants
37
+ <p>
38
+ <b>Composition process</b> — Composites participants
33
39
  of a stage into a single video and forwards it to a set of outputs (e.g., IVS channels).
34
40
  Composition endpoints support this process.</p>
35
41
  </li>
36
42
  <li>
37
- <p>Server-side composition: A <i>composition</i> controls the look of the outputs,
38
- including how participants are positioned in the video.</p>
39
- </li>
40
- </ul>
41
43
  <p>
42
- <b>Resources</b>
43
- </p>
44
- <p>The following resources contain information about your IVS live stream (see <a href="https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/getting-started.html">Getting Started with Amazon IVS Real-Time Streaming</a>):</p>
45
- <ul>
46
- <li>
47
- <p>
48
- <b>Stage</b> — A stage is a virtual space where participants can exchange video in real time.</p>
44
+ <b>Composition</b> — Controls the look of the outputs,
45
+ including how participants are positioned in the video.</p>
49
46
  </li>
50
47
  </ul>
48
+ <p>For more information about your IVS live stream, also see <a href="https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/getting-started.html">Getting Started with Amazon IVS Real-Time Streaming</a>.</p>
51
49
  <p>
52
50
  <b>Tagging</b>
53
51
  </p>
@@ -63,157 +61,6 @@ manage access (see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/acc
63
61
  <p>The Amazon IVS real-time API has these tag-related endpoints: <a>TagResource</a>, <a>UntagResource</a>, and
64
62
  <a>ListTagsForResource</a>. The following resource supports tagging: Stage.</p>
65
63
  <p>At most 50 tags can be applied to a resource.</p>
66
- <p>
67
- <b>Stages Endpoints</b>
68
- </p>
69
- <ul>
70
- <li>
71
- <p>
72
- <a>CreateParticipantToken</a> — Creates an additional token for a specified stage. This can be done after stage creation or when tokens expire.</p>
73
- </li>
74
- <li>
75
- <p>
76
- <a>CreateStage</a> — Creates a new stage (and optionally participant tokens).</p>
77
- </li>
78
- <li>
79
- <p>
80
- <a>DeleteStage</a> — Shuts down and deletes the specified stage (disconnecting all participants).</p>
81
- </li>
82
- <li>
83
- <p>
84
- <a>DisconnectParticipant</a> — Disconnects a specified participant and revokes the participant permanently from a specified stage.</p>
85
- </li>
86
- <li>
87
- <p>
88
- <a>GetParticipant</a> — Gets information about the specified
89
- participant token.</p>
90
- </li>
91
- <li>
92
- <p>
93
- <a>GetStage</a> — Gets information for the specified stage.</p>
94
- </li>
95
- <li>
96
- <p>
97
- <a>GetStageSession</a> — Gets information for the specified stage
98
- session.</p>
99
- </li>
100
- <li>
101
- <p>
102
- <a>ListParticipantEvents</a> — Lists events for a specified
103
- participant that occurred during a specified stage session.</p>
104
- </li>
105
- <li>
106
- <p>
107
- <a>ListParticipants</a> — Lists all participants in a specified stage
108
- session.</p>
109
- </li>
110
- <li>
111
- <p>
112
- <a>ListStages</a> — Gets summary information about all stages in your account, in the AWS region where the API request is processed.</p>
113
- </li>
114
- <li>
115
- <p>
116
- <a>ListStageSessions</a> — Gets all sessions for a specified stage.</p>
117
- </li>
118
- <li>
119
- <p>
120
- <a>UpdateStage</a> — Updates a stage’s configuration.</p>
121
- </li>
122
- </ul>
123
- <p>
124
- <b>Composition Endpoints</b>
125
- </p>
126
- <ul>
127
- <li>
128
- <p>
129
- <a>GetComposition</a> — Gets information about the specified
130
- Composition resource.</p>
131
- </li>
132
- <li>
133
- <p>
134
- <a>ListCompositions</a> — Gets summary information about all
135
- Compositions in your account, in the AWS region where the API request is processed.</p>
136
- </li>
137
- <li>
138
- <p>
139
- <a>StartComposition</a> — Starts a Composition from a stage based on
140
- the configuration provided in the request.</p>
141
- </li>
142
- <li>
143
- <p>
144
- <a>StopComposition</a> — Stops and deletes a Composition resource.
145
- Any broadcast from the Composition resource is stopped.</p>
146
- </li>
147
- </ul>
148
- <p>
149
- <b>EncoderConfiguration Endpoints</b>
150
- </p>
151
- <ul>
152
- <li>
153
- <p>
154
- <a>CreateEncoderConfiguration</a> — Creates an EncoderConfiguration object.</p>
155
- </li>
156
- <li>
157
- <p>
158
- <a>DeleteEncoderConfiguration</a> — Deletes an EncoderConfiguration
159
- resource. Ensures that no Compositions are using this template; otherwise, returns an
160
- error.</p>
161
- </li>
162
- <li>
163
- <p>
164
- <a>GetEncoderConfiguration</a> — Gets information about the specified
165
- EncoderConfiguration resource.</p>
166
- </li>
167
- <li>
168
- <p>
169
- <a>ListEncoderConfigurations</a> — Gets summary information about all
170
- EncoderConfigurations in your account, in the AWS region where the API request is
171
- processed.</p>
172
- </li>
173
- </ul>
174
- <p>
175
- <b>StorageConfiguration Endpoints</b>
176
- </p>
177
- <ul>
178
- <li>
179
- <p>
180
- <a>CreateStorageConfiguration</a> — Creates a new storage configuration, used to enable
181
- recording to Amazon S3.</p>
182
- </li>
183
- <li>
184
- <p>
185
- <a>DeleteStorageConfiguration</a> — Deletes the storage configuration for the specified ARN.</p>
186
- </li>
187
- <li>
188
- <p>
189
- <a>GetStorageConfiguration</a> — Gets the storage configuration for the specified ARN.</p>
190
- </li>
191
- <li>
192
- <p>
193
- <a>ListStorageConfigurations</a> — Gets summary information about all storage configurations in your
194
- account, in the AWS region where the API request is processed.</p>
195
- </li>
196
- </ul>
197
- <p>
198
- <b>Tags Endpoints</b>
199
- </p>
200
- <ul>
201
- <li>
202
- <p>
203
- <a>ListTagsForResource</a> — Gets information about AWS tags for the
204
- specified ARN.</p>
205
- </li>
206
- <li>
207
- <p>
208
- <a>TagResource</a> — Adds or updates tags for the AWS resource with
209
- the specified ARN.</p>
210
- </li>
211
- <li>
212
- <p>
213
- <a>UntagResource</a> — Removes tags from the resource with the
214
- specified ARN.</p>
215
- </li>
216
- </ul>
217
64
 
218
65
  ## Installing
219
66
 
@@ -449,6 +296,14 @@ DeleteEncoderConfiguration
449
296
 
450
297
  [Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/ivs-realtime/command/DeleteEncoderConfigurationCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-ivs-realtime/Interface/DeleteEncoderConfigurationCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-ivs-realtime/Interface/DeleteEncoderConfigurationCommandOutput/)
451
298
 
299
+ </details>
300
+ <details>
301
+ <summary>
302
+ DeletePublicKey
303
+ </summary>
304
+
305
+ [Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/ivs-realtime/command/DeletePublicKeyCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-ivs-realtime/Interface/DeletePublicKeyCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-ivs-realtime/Interface/DeletePublicKeyCommandOutput/)
306
+
452
307
  </details>
453
308
  <details>
454
309
  <summary>
@@ -497,6 +352,14 @@ GetParticipant
497
352
 
498
353
  [Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/ivs-realtime/command/GetParticipantCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-ivs-realtime/Interface/GetParticipantCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-ivs-realtime/Interface/GetParticipantCommandOutput/)
499
354
 
355
+ </details>
356
+ <details>
357
+ <summary>
358
+ GetPublicKey
359
+ </summary>
360
+
361
+ [Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/ivs-realtime/command/GetPublicKeyCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-ivs-realtime/Interface/GetPublicKeyCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-ivs-realtime/Interface/GetPublicKeyCommandOutput/)
362
+
500
363
  </details>
501
364
  <details>
502
365
  <summary>
@@ -521,6 +384,14 @@ GetStorageConfiguration
521
384
 
522
385
  [Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/ivs-realtime/command/GetStorageConfigurationCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-ivs-realtime/Interface/GetStorageConfigurationCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-ivs-realtime/Interface/GetStorageConfigurationCommandOutput/)
523
386
 
387
+ </details>
388
+ <details>
389
+ <summary>
390
+ ImportPublicKey
391
+ </summary>
392
+
393
+ [Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/ivs-realtime/command/ImportPublicKeyCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-ivs-realtime/Interface/ImportPublicKeyCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-ivs-realtime/Interface/ImportPublicKeyCommandOutput/)
394
+
524
395
  </details>
525
396
  <details>
526
397
  <summary>
@@ -553,6 +424,14 @@ ListParticipants
553
424
 
554
425
  [Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/ivs-realtime/command/ListParticipantsCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-ivs-realtime/Interface/ListParticipantsCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-ivs-realtime/Interface/ListParticipantsCommandOutput/)
555
426
 
427
+ </details>
428
+ <details>
429
+ <summary>
430
+ ListPublicKeys
431
+ </summary>
432
+
433
+ [Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/ivs-realtime/command/ListPublicKeysCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-ivs-realtime/Interface/ListPublicKeysCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-ivs-realtime/Interface/ListPublicKeysCommandOutput/)
434
+
556
435
  </details>
557
436
  <details>
558
437
  <summary>