mux_ruby 3.3.0 → 3.5.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (100) hide show
  1. checksums.yaml +4 -4
  2. data/Gemfile.lock +1 -1
  3. data/README.md +13 -7
  4. data/docs/Asset.md +1 -1
  5. data/docs/AssetNonStandardInputReasons.md +2 -2
  6. data/docs/AssetResponse.md +1 -1
  7. data/docs/AssetsApi.md +8 -0
  8. data/docs/Broadcast.md +30 -0
  9. data/docs/BroadcastLayout.md +15 -0
  10. data/docs/BroadcastResolution.md +15 -0
  11. data/docs/BroadcastResponse.md +18 -0
  12. data/docs/BroadcastStatus.md +15 -0
  13. data/docs/CreateBroadcastRequest.md +26 -0
  14. data/docs/CreateLiveStreamRequest.md +3 -1
  15. data/docs/CreatePlaybackIDResponse.md +1 -1
  16. data/docs/CreatePlaybackRestrictionRequest.md +1 -1
  17. data/docs/CreateSimulcastTargetRequest.md +1 -1
  18. data/docs/CreateSpaceRequest.md +22 -0
  19. data/docs/CreateTrackResponse.md +1 -1
  20. data/docs/DirectUploadsApi.md +6 -0
  21. data/docs/GetAssetPlaybackIDResponse.md +1 -1
  22. data/docs/GetLiveStreamPlaybackIDResponse.md +1 -1
  23. data/docs/IncidentResponse.md +1 -1
  24. data/docs/InputSettings.md +3 -3
  25. data/docs/ListPlaybackRestrictionsResponse.md +18 -0
  26. data/docs/ListSpacesResponse.md +18 -0
  27. data/docs/LiveStream.md +3 -1
  28. data/docs/LiveStreamResponse.md +1 -1
  29. data/docs/LiveStreamsApi.md +16 -4
  30. data/docs/MetricsApi.md +3 -3
  31. data/docs/PlaybackRestrictionResponse.md +4 -1
  32. data/docs/PlaybackRestrictionsApi.md +21 -21
  33. data/docs/SigningKeyResponse.md +1 -1
  34. data/docs/SimulcastTargetResponse.md +1 -1
  35. data/docs/Space.md +30 -0
  36. data/docs/SpaceResponse.md +18 -0
  37. data/docs/SpaceStatus.md +15 -0
  38. data/docs/SpaceType.md +15 -0
  39. data/docs/SpacesApi.md +658 -0
  40. data/docs/StartSpaceBroadcastResponse.md +18 -0
  41. data/docs/StopSpaceBroadcastResponse.md +18 -0
  42. data/docs/Track.md +9 -7
  43. data/docs/UpdateLiveStreamRequest.md +3 -1
  44. data/docs/UpdateReferrerDomainRestrictionRequest.md +37 -5
  45. data/docs/UploadResponse.md +1 -1
  46. data/docs/VideoViewResponse.md +1 -1
  47. data/gen/generator-config.json +1 -1
  48. data/gen/templates/README.mustache +9 -3
  49. data/lib/mux_ruby/api/assets_api.rb +8 -0
  50. data/lib/mux_ruby/api/direct_uploads_api.rb +6 -0
  51. data/lib/mux_ruby/api/live_streams_api.rb +14 -2
  52. data/lib/mux_ruby/api/metrics_api.rb +5 -5
  53. data/lib/mux_ruby/api/playback_restrictions_api.rb +23 -23
  54. data/lib/mux_ruby/api/spaces_api.rb +619 -0
  55. data/lib/mux_ruby/models/abridged_video_view.rb +7 -0
  56. data/lib/mux_ruby/models/asset.rb +1 -1
  57. data/lib/mux_ruby/models/asset_non_standard_input_reasons.rb +2 -2
  58. data/lib/mux_ruby/models/broadcast.rb +305 -0
  59. data/lib/mux_ruby/models/broadcast_layout.rb +37 -0
  60. data/lib/mux_ruby/models/broadcast_resolution.rb +41 -0
  61. data/lib/mux_ruby/models/broadcast_response.rb +223 -0
  62. data/lib/mux_ruby/models/broadcast_status.rb +37 -0
  63. data/lib/mux_ruby/models/create_broadcast_request.rb +266 -0
  64. data/lib/mux_ruby/models/create_live_stream_request.rb +40 -4
  65. data/lib/mux_ruby/models/create_simulcast_target_request.rb +1 -1
  66. data/lib/mux_ruby/models/create_space_request.rb +242 -0
  67. data/lib/mux_ruby/models/input_settings.rb +3 -3
  68. data/lib/mux_ruby/models/list_playback_restrictions_response.rb +220 -0
  69. data/lib/mux_ruby/models/list_spaces_response.rb +225 -0
  70. data/lib/mux_ruby/models/live_stream.rb +40 -4
  71. data/lib/mux_ruby/models/playback_restriction_response.rb +11 -2
  72. data/lib/mux_ruby/models/space.rb +301 -0
  73. data/lib/mux_ruby/models/space_response.rb +223 -0
  74. data/lib/mux_ruby/models/space_status.rb +37 -0
  75. data/lib/mux_ruby/models/space_type.rb +36 -0
  76. data/lib/mux_ruby/models/start_space_broadcast_response.rb +218 -0
  77. data/lib/mux_ruby/models/stop_space_broadcast_response.rb +218 -0
  78. data/lib/mux_ruby/models/track.rb +32 -10
  79. data/lib/mux_ruby/models/update_live_stream_request.rb +40 -4
  80. data/lib/mux_ruby/models/update_referrer_domain_restriction_request.rb +74 -179
  81. data/lib/mux_ruby/models/video_view.rb +103 -0
  82. data/lib/mux_ruby/version.rb +1 -1
  83. data/lib/mux_ruby.rb +16 -0
  84. data/spec/api/spaces_api_spec.rb +149 -0
  85. data/spec/models/broadcast_layout_spec.rb +28 -0
  86. data/spec/models/broadcast_resolution_spec.rb +28 -0
  87. data/spec/models/broadcast_response_spec.rb +34 -0
  88. data/spec/models/broadcast_spec.rb +70 -0
  89. data/spec/models/broadcast_status_spec.rb +28 -0
  90. data/spec/models/create_broadcast_request_spec.rb +58 -0
  91. data/spec/models/create_space_request_spec.rb +46 -0
  92. data/spec/models/list_playback_restrictions_response_spec.rb +34 -0
  93. data/spec/models/list_spaces_response_spec.rb +34 -0
  94. data/spec/models/space_response_spec.rb +34 -0
  95. data/spec/models/space_spec.rb +70 -0
  96. data/spec/models/space_status_spec.rb +28 -0
  97. data/spec/models/space_type_spec.rb +28 -0
  98. data/spec/models/start_space_broadcast_response_spec.rb +34 -0
  99. data/spec/models/stop_space_broadcast_response_spec.rb +34 -0
  100. metadata +169 -105
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 100603ac91cb5212144014d58eb7ef4dc296f26dd3b0bb71b94085011b62048e
4
- data.tar.gz: ad3388876ea716146d7cb99f3633cbfc1d7c9d02acafc1156a899e1b484ece3a
3
+ metadata.gz: f06799d3527381141aa85e61bb4ced77393cd093737749d367af058109ee1857
4
+ data.tar.gz: 31ba3d499a958823f814d721be3dc2673427a652f05d454b6ba24083204f6fe7
5
5
  SHA512:
6
- metadata.gz: 6cfc04a05fae4dce6414074b9c7cf3d380ca125770752a82484fce551c5cfb891d42d76fbc9c18fd5db6d0bf75d0e20ba97f5eb1456c52177f9616ba7836310c
7
- data.tar.gz: 84f958bec106296f151ce7ef7d012276b8824996562399df36f0a1104815010daa3de80acc877785d14abf35c03e24f70dd0bed626ccdcedd0c254fccbd2c2de
6
+ metadata.gz: 6d42942a820771f914aa2954e1317422f8960d89fac567729e6373ffb0157d6851cfb1080a655f934f779067adb7c9bfdbd9c54f060230a11901c50a931116b8
7
+ data.tar.gz: 869f8926e6f4e5f5b034ca5ae49f0b5713fd3b508feccf7bb61c22f48b5e8b5d1279bbb993dce76efad1414cc967172cc7f768a45634a66a6fd3d1c01ad73f5f
data/Gemfile.lock CHANGED
@@ -1,7 +1,7 @@
1
1
  PATH
2
2
  remote: .
3
3
  specs:
4
- mux_ruby (3.3.0)
4
+ mux_ruby (3.5.0)
5
5
  typhoeus (~> 1.0, >= 1.0.1)
6
6
 
7
7
  GEM
data/README.md CHANGED
@@ -1,8 +1,14 @@
1
1
  ![Mux Ruby Banner](github-ruby-sdk.png)
2
2
 
3
- ![](https://github.com/muxinc/mux-ruby/workflows/Integration%20Test/badge.svg)
4
-
5
- MuxRuby - the Ruby gem for the Mux API
3
+ <p align="center">
4
+ <a href="https://rubygems.org/gems/mux_ruby"><img src="https://img.shields.io/gem/v/mux_ruby" title="RubyGems" /></a>
5
+ <a href="https://github.com/muxinc/mux-ruby/workflows/ci.yaml"><img src="https://github.com/muxinc/mux-ruby/actions/workflows/ci.yaml/badge.svg" title="CI" /></a>
6
+ </p>
7
+ <p align="center">
8
+ <a href="https://rubygems.org/gems/mux_ruby">RubyGems</a> |
9
+ <a href="https://docs.mux.com">Mux Docs</a> |
10
+ <a href="https://docs.mux.com/api-reference">Mux API Reference </a>
11
+ </p>
6
12
 
7
13
  # Mux Ruby
8
14
 
@@ -17,7 +23,7 @@ Not familiar with Mux? Check out https://mux.com/ for more information.
17
23
  This SDK is automatically generated by the [OpenAPI Generator](https://openapi-generator.tech) project:
18
24
 
19
25
  - API version: v1
20
- - Package version: 3.3.0
26
+ - Package version: 3.5.0
21
27
  - Build package: org.openapitools.codegen.languages.RubyClientCodegen
22
28
  For more information, please visit [https://docs.mux.com](https://docs.mux.com)
23
29
 
@@ -34,16 +40,16 @@ gem build mux_ruby.gemspec
34
40
  Then either install the gem locally:
35
41
 
36
42
  ```shell
37
- gem install ./mux_ruby-3.3.0.gem
43
+ gem install ./mux_ruby-3.5.0.gem
38
44
  ```
39
45
 
40
- (for development, run `gem install --dev ./mux_ruby-3.3.0.gem` to install the development dependencies)
46
+ (for development, run `gem install --dev ./mux_ruby-3.5.0.gem` to install the development dependencies)
41
47
 
42
48
  or publish the gem to a gem hosting service, e.g. [RubyGems](https://rubygems.org/).
43
49
 
44
50
  Finally add this to the Gemfile:
45
51
 
46
- gem 'mux_ruby', '~> 3.3.0'
52
+ gem 'mux_ruby', '~> 3.5.0'
47
53
 
48
54
  ### Install from Git
49
55
 
data/docs/Asset.md CHANGED
@@ -16,7 +16,7 @@
16
16
  | **errors** | [**AssetErrors**](AssetErrors.md) | | [optional] |
17
17
  | **per_title_encode** | **Boolean** | | [optional] |
18
18
  | **upload_id** | **String** | Unique identifier for the Direct Upload. This is an optional parameter added when the asset is created from a direct upload. | [optional] |
19
- | **is_live** | **Boolean** | Whether the asset is created from a live stream and the live stream is currently &#x60;active&#x60; and not in &#x60;idle&#x60; state. | [optional] |
19
+ | **is_live** | **Boolean** | Indicates whether the live stream that created this asset is currently &#x60;active&#x60; and not in &#x60;idle&#x60; state. This is an optional parameter added when the asset is created from a live stream. | [optional] |
20
20
  | **passthrough** | **String** | Arbitrary user-supplied metadata set for the asset. Max 255 characters. | [optional] |
21
21
  | **live_stream_id** | **String** | Unique identifier for the live stream. This is an optional parameter added when the asset is created from a live stream. | [optional] |
22
22
  | **master** | [**AssetMaster**](AssetMaster.md) | | [optional] |
@@ -6,8 +6,8 @@
6
6
  | ---- | ---- | ----------- | ----- |
7
7
  | **video_codec** | **String** | The video codec used on the input file. For example, the input file encoded with &#x60;hevc&#x60; video codec is non-standard and the value of this parameter is &#x60;hevc&#x60;. | [optional] |
8
8
  | **audio_codec** | **String** | The audio codec used on the input file. Non-AAC audio codecs are non-standard. | [optional] |
9
- | **video_gop_size** | **String** | The video key frame Interval (also called as Group of Picture or GOP) of the input file is &#x60;high&#x60;. This parameter is present when the gop is greater than 10 seconds. | [optional] |
10
- | **video_frame_rate** | **String** | The video frame rate of the input file. Video with average frames per second (fps) less than 10 or greater than 120 is non-standard. A &#x60;-1&#x60; frame rate value indicates Mux could not determine the frame rate of the video track. | [optional] |
9
+ | **video_gop_size** | **String** | The video key frame Interval (also called as Group of Picture or GOP) of the input file is &#x60;high&#x60;. This parameter is present when the gop is greater than 20 seconds. | [optional] |
10
+ | **video_frame_rate** | **String** | The video frame rate of the input file. Video with average frames per second (fps) less than 5 or greater than 120 is non-standard. A &#x60;-1&#x60; frame rate value indicates Mux could not determine the frame rate of the video track. | [optional] |
11
11
  | **video_resolution** | **String** | The video resolution of the input file. Video resolution higher than 2048 pixels on any one dimension (height or width) is considered non-standard, The resolution value is presented as &#x60;width&#x60; x &#x60;height&#x60; in pixels. | [optional] |
12
12
  | **video_bitrate** | **String** | The video bitrate of the input file is &#x60;high&#x60;. This parameter is present when the average bitrate of any key frame interval (also known as Group of Pictures or GOP) is higher than what&#39;s considered standard which typically is 16 Mbps. | [optional] |
13
13
  | **pixel_aspect_ratio** | **String** | The video pixel aspect ratio of the input file. | [optional] |
@@ -4,7 +4,7 @@
4
4
 
5
5
  | Name | Type | Description | Notes |
6
6
  | ---- | ---- | ----------- | ----- |
7
- | **data** | [**Asset**](.md) | | [optional] |
7
+ | **data** | [**Asset**](Asset.md) | | [optional] |
8
8
 
9
9
  ## Example
10
10
 
data/docs/AssetsApi.md CHANGED
@@ -95,6 +95,8 @@ end
95
95
 
96
96
  Create a playback ID
97
97
 
98
+ Creates a playback ID that can be used to stream the asset to a viewer.
99
+
98
100
  ### Examples
99
101
 
100
102
  ```ruby
@@ -165,6 +167,8 @@ end
165
167
 
166
168
  Create an asset track
167
169
 
170
+ Adds an asset track (for example, subtitles) to an asset.
171
+
168
172
  ### Examples
169
173
 
170
174
  ```ruby
@@ -304,6 +308,8 @@ nil (empty response body)
304
308
 
305
309
  Delete a playback ID
306
310
 
311
+ Deletes a playback ID, rendering it nonfunctional for viewing an asset's video content. Please note that deleting the playback ID removes access to the underlying asset; a viewer who started playback before the playback ID was deleted may be able to watch the entire video for a limited duration.
312
+
307
313
  ### Examples
308
314
 
309
315
  ```ruby
@@ -584,6 +590,8 @@ end
584
590
 
585
591
  Retrieve a playback ID
586
592
 
593
+ Retrieves information about the specified playback ID.
594
+
587
595
  ### Examples
588
596
 
589
597
  ```ruby
data/docs/Broadcast.md ADDED
@@ -0,0 +1,30 @@
1
+ # MuxRuby::Broadcast
2
+
3
+ ## Properties
4
+
5
+ | Name | Type | Description | Notes |
6
+ | ---- | ---- | ----------- | ----- |
7
+ | **id** | **String** | Unique identifier for the broadcast. Max 255 characters. | |
8
+ | **passthrough** | **String** | Arbitrary user-supplied metadata that will be included in the broadcast details and related webhooks. Max: 255 characters. | [optional] |
9
+ | **live_stream_id** | **String** | The ID of the live stream that the broadcast will be sent to. | |
10
+ | **status** | [**BroadcastStatus**](BroadcastStatus.md) | | |
11
+ | **layout** | [**BroadcastLayout**](BroadcastLayout.md) | | [default to &#39;gallery&#39;] |
12
+ | **background** | **String** | URL of an image to display as the background of the broadcast. Its dimensions should match the provided resolution. | [optional] |
13
+ | **resolution** | [**BroadcastResolution**](BroadcastResolution.md) | | [default to &#39;1920x1080&#39;] |
14
+
15
+ ## Example
16
+
17
+ ```ruby
18
+ require 'mux_ruby'
19
+
20
+ instance = MuxRuby::Broadcast.new(
21
+ id: null,
22
+ passthrough: null,
23
+ live_stream_id: null,
24
+ status: null,
25
+ layout: null,
26
+ background: null,
27
+ resolution: null
28
+ )
29
+ ```
30
+
@@ -0,0 +1,15 @@
1
+ # MuxRuby::BroadcastLayout
2
+
3
+ ## Properties
4
+
5
+ | Name | Type | Description | Notes |
6
+ | ---- | ---- | ----------- | ----- |
7
+
8
+ ## Example
9
+
10
+ ```ruby
11
+ require 'mux_ruby'
12
+
13
+ instance = MuxRuby::BroadcastLayout.new()
14
+ ```
15
+
@@ -0,0 +1,15 @@
1
+ # MuxRuby::BroadcastResolution
2
+
3
+ ## Properties
4
+
5
+ | Name | Type | Description | Notes |
6
+ | ---- | ---- | ----------- | ----- |
7
+
8
+ ## Example
9
+
10
+ ```ruby
11
+ require 'mux_ruby'
12
+
13
+ instance = MuxRuby::BroadcastResolution.new()
14
+ ```
15
+
@@ -0,0 +1,18 @@
1
+ # MuxRuby::BroadcastResponse
2
+
3
+ ## Properties
4
+
5
+ | Name | Type | Description | Notes |
6
+ | ---- | ---- | ----------- | ----- |
7
+ | **data** | [**Broadcast**](Broadcast.md) | | |
8
+
9
+ ## Example
10
+
11
+ ```ruby
12
+ require 'mux_ruby'
13
+
14
+ instance = MuxRuby::BroadcastResponse.new(
15
+ data: null
16
+ )
17
+ ```
18
+
@@ -0,0 +1,15 @@
1
+ # MuxRuby::BroadcastStatus
2
+
3
+ ## Properties
4
+
5
+ | Name | Type | Description | Notes |
6
+ | ---- | ---- | ----------- | ----- |
7
+
8
+ ## Example
9
+
10
+ ```ruby
11
+ require 'mux_ruby'
12
+
13
+ instance = MuxRuby::BroadcastStatus.new()
14
+ ```
15
+
@@ -0,0 +1,26 @@
1
+ # MuxRuby::CreateBroadcastRequest
2
+
3
+ ## Properties
4
+
5
+ | Name | Type | Description | Notes |
6
+ | ---- | ---- | ----------- | ----- |
7
+ | **passthrough** | **String** | Arbitrary user-supplied metadata that will be included in the broadcast details and related webhooks. Max: 255 characters. | [optional] |
8
+ | **live_stream_id** | **String** | The ID of the live stream that you want to broadcast to. | |
9
+ | **layout** | [**BroadcastLayout**](BroadcastLayout.md) | | [optional][default to &#39;gallery&#39;] |
10
+ | **background** | **String** | URL of an image to display as the background of the broadcast. Its dimensions should match the provided resolution. | [optional] |
11
+ | **resolution** | [**BroadcastResolution**](BroadcastResolution.md) | | [optional][default to &#39;1920x1080&#39;] |
12
+
13
+ ## Example
14
+
15
+ ```ruby
16
+ require 'mux_ruby'
17
+
18
+ instance = MuxRuby::CreateBroadcastRequest.new(
19
+ passthrough: null,
20
+ live_stream_id: null,
21
+ layout: null,
22
+ background: null,
23
+ resolution: null
24
+ )
25
+ ```
26
+
@@ -15,6 +15,7 @@
15
15
  | **latency_mode** | **String** | Latency is the time from when the streamer transmits a frame of video to when you see it in the player. Set this as an alternative to setting low latency or reduced latency flags. The Low Latency value is a beta feature. Note: Reconnect windows are incompatible with Reduced Latency and Low Latency and will always be set to zero (0) seconds. Read more here: https://mux.com/blog/introducing-low-latency-live-streaming/ | [optional] |
16
16
  | **test** | **Boolean** | Marks the live stream as a test live stream when the value is set to true. A test live stream can help evaluate the Mux Video APIs without incurring any cost. There is no limit on number of test live streams created. Test live streams are watermarked with the Mux logo and limited to 5 minutes. The test live stream is disabled after the stream is active for 5 mins and the recorded asset also deleted after 24 hours. | [optional] |
17
17
  | **simulcast_targets** | [**Array&lt;CreateSimulcastTargetRequest&gt;**](CreateSimulcastTargetRequest.md) | | [optional] |
18
+ | **max_continuous_duration** | **Integer** | The time in seconds a live stream may be continuously active before being disconnected. Defaults to 12 hours. | [optional][default to 43200] |
18
19
 
19
20
  ## Example
20
21
 
@@ -32,7 +33,8 @@ instance = MuxRuby::CreateLiveStreamRequest.new(
32
33
  low_latency: null,
33
34
  latency_mode: null,
34
35
  test: null,
35
- simulcast_targets: null
36
+ simulcast_targets: null,
37
+ max_continuous_duration: null
36
38
  )
37
39
  ```
38
40
 
@@ -4,7 +4,7 @@
4
4
 
5
5
  | Name | Type | Description | Notes |
6
6
  | ---- | ---- | ----------- | ----- |
7
- | **data** | [**PlaybackID**](.md) | | [optional] |
7
+ | **data** | [**PlaybackID**](PlaybackID.md) | | [optional] |
8
8
 
9
9
  ## Example
10
10
 
@@ -4,7 +4,7 @@
4
4
 
5
5
  | Name | Type | Description | Notes |
6
6
  | ---- | ---- | ----------- | ----- |
7
- | **referrer** | [**ReferrerDomainRestriction**](.md) | | [optional] |
7
+ | **referrer** | [**ReferrerDomainRestriction**](ReferrerDomainRestriction.md) | | [optional] |
8
8
 
9
9
  ## Example
10
10
 
@@ -6,7 +6,7 @@
6
6
  | ---- | ---- | ----------- | ----- |
7
7
  | **passthrough** | **String** | Arbitrary user-supplied metadata set by you when creating a simulcast target. | [optional] |
8
8
  | **stream_key** | **String** | Stream Key represents a stream identifier on the third party live streaming service to send the parent live stream to. | [optional] |
9
- | **url** | **String** | RTMP hostname including application name for the third party live streaming service. Example: &#39;rtmp://live.example.com/app&#39;. | |
9
+ | **url** | **String** | RTMP hostname including application name for the third party live streaming service. Example: &#x60;rtmp://live.example.com/app&#x60;. | |
10
10
 
11
11
  ## Example
12
12
 
@@ -0,0 +1,22 @@
1
+ # MuxRuby::CreateSpaceRequest
2
+
3
+ ## Properties
4
+
5
+ | Name | Type | Description | Notes |
6
+ | ---- | ---- | ----------- | ----- |
7
+ | **type** | [**SpaceType**](SpaceType.md) | | [optional][default to &#39;server&#39;] |
8
+ | **passthrough** | **String** | Arbitrary user-supplied metadata that will be included in the space details and related webhooks. Max: 255 characters. | [optional] |
9
+ | **broadcasts** | [**Array&lt;CreateBroadcastRequest&gt;**](CreateBroadcastRequest.md) | An array of broadcast destinations you want to stream the space to. **Note:** By default only a single broadcast destination can be specified. Contact Mux support if you need more. | [optional] |
10
+
11
+ ## Example
12
+
13
+ ```ruby
14
+ require 'mux_ruby'
15
+
16
+ instance = MuxRuby::CreateSpaceRequest.new(
17
+ type: null,
18
+ passthrough: null,
19
+ broadcasts: null
20
+ )
21
+ ```
22
+
@@ -4,7 +4,7 @@
4
4
 
5
5
  | Name | Type | Description | Notes |
6
6
  | ---- | ---- | ----------- | ----- |
7
- | **data** | [**Track**](.md) | | [optional] |
7
+ | **data** | [**Track**](Track.md) | | [optional] |
8
8
 
9
9
  ## Example
10
10
 
@@ -86,6 +86,8 @@ end
86
86
 
87
87
  Create a new direct upload URL
88
88
 
89
+ Creates a new direct upload, through which video content can be uploaded for ingest to Mux.
90
+
89
91
  ### Examples
90
92
 
91
93
  ```ruby
@@ -154,6 +156,8 @@ end
154
156
 
155
157
  Retrieve a single direct upload's info
156
158
 
159
+ Fetches information about a single direct upload in the current environment.
160
+
157
161
  ### Examples
158
162
 
159
163
  ```ruby
@@ -222,6 +226,8 @@ end
222
226
 
223
227
  List direct uploads
224
228
 
229
+ Lists currently extant direct uploads in the current environment.
230
+
225
231
  ### Examples
226
232
 
227
233
  ```ruby
@@ -4,7 +4,7 @@
4
4
 
5
5
  | Name | Type | Description | Notes |
6
6
  | ---- | ---- | ----------- | ----- |
7
- | **data** | [**PlaybackID**](.md) | | [optional] |
7
+ | **data** | [**PlaybackID**](PlaybackID.md) | | [optional] |
8
8
 
9
9
  ## Example
10
10
 
@@ -4,7 +4,7 @@
4
4
 
5
5
  | Name | Type | Description | Notes |
6
6
  | ---- | ---- | ----------- | ----- |
7
- | **data** | [**PlaybackID**](.md) | | [optional] |
7
+ | **data** | [**PlaybackID**](PlaybackID.md) | | [optional] |
8
8
 
9
9
  ## Example
10
10
 
@@ -4,7 +4,7 @@
4
4
 
5
5
  | Name | Type | Description | Notes |
6
6
  | ---- | ---- | ----------- | ----- |
7
- | **data** | [**Incident**](.md) | | [optional] |
7
+ | **data** | [**Incident**](Incident.md) | | [optional] |
8
8
  | **timeframe** | **Array&lt;Integer&gt;** | | [optional] |
9
9
 
10
10
  ## Example
@@ -8,10 +8,10 @@
8
8
  | **overlay_settings** | [**InputSettingsOverlaySettings**](InputSettingsOverlaySettings.md) | | [optional] |
9
9
  | **start_time** | **Float** | The time offset in seconds from the beginning of the video indicating the clip&#39;s starting marker. The default value is 0 when not included. This parameter is only applicable for creating clips when &#x60;input.url&#x60; has &#x60;mux://assets/{asset_id}&#x60; format. | [optional] |
10
10
  | **end_time** | **Float** | The time offset in seconds from the beginning of the video, indicating the clip&#39;s ending marker. The default value is the duration of the video when not included. This parameter is only applicable for creating clips when &#x60;input.url&#x60; has &#x60;mux://assets/{asset_id}&#x60; format. | [optional] |
11
- | **type** | **String** | This parameter is required for the &#x60;text&#x60; track type. | [optional] |
12
- | **text_type** | **String** | Type of text track. This parameter only supports subtitles value. For more information on Subtitles / Closed Captions, [see this blog post](https://mux.com/blog/subtitles-captions-webvtt-hls-and-those-magic-flags/). This parameter is required for &#x60;text&#x60; track type. | [optional] |
11
+ | **type** | **String** | This parameter is required for &#x60;text&#x60; type tracks. | [optional] |
12
+ | **text_type** | **String** | Type of text track. This parameter only supports subtitles value. For more information on Subtitles / Closed Captions, [see this blog post](https://mux.com/blog/subtitles-captions-webvtt-hls-and-those-magic-flags/). This parameter is required for &#x60;text&#x60; type tracks. | [optional] |
13
13
  | **language_code** | **String** | The language code value must be a valid [BCP 47](https://tools.ietf.org/html/bcp47) specification compliant value. For example, en for English or en-US for the US version of English. This parameter is required for text type and subtitles text type track. | [optional] |
14
- | **name** | **String** | The name of the track containing a human-readable description. This value must be unique across all text type and subtitles &#x60;text&#x60; type tracks. The hls manifest will associate a subtitle text track with this value. For example, the value should be \&quot;English\&quot; for subtitles text track with language_code as en. This optional parameter should be used only for &#x60;text&#x60; type and subtitles &#x60;text&#x60; type track. If this parameter is not included, Mux will auto-populate based on the &#x60;input[].language_code&#x60; value. | [optional] |
14
+ | **name** | **String** | The name of the track containing a human-readable description. This value must be unique across all text type and subtitles &#x60;text&#x60; type tracks. The hls manifest will associate a subtitle text track with this value. For example, the value should be \&quot;English\&quot; for subtitles text track with language_code as en. This optional parameter should be used only for &#x60;text&#x60; type and subtitles &#x60;text&#x60; type tracks. If this parameter is not included, Mux will auto-populate based on the &#x60;input[].language_code&#x60; value. | [optional] |
15
15
  | **closed_captions** | **Boolean** | Indicates the track provides Subtitles for the Deaf or Hard-of-hearing (SDH). This optional parameter should be used for &#x60;text&#x60; type and subtitles &#x60;text&#x60; type tracks. | [optional] |
16
16
  | **passthrough** | **String** | This optional parameter should be used for &#x60;text&#x60; type and subtitles &#x60;text&#x60; type tracks. | [optional] |
17
17
 
@@ -0,0 +1,18 @@
1
+ # MuxRuby::ListPlaybackRestrictionsResponse
2
+
3
+ ## Properties
4
+
5
+ | Name | Type | Description | Notes |
6
+ | ---- | ---- | ----------- | ----- |
7
+ | **data** | [**Array&lt;PlaybackRestriction&gt;**](PlaybackRestriction.md) | | [optional] |
8
+
9
+ ## Example
10
+
11
+ ```ruby
12
+ require 'mux_ruby'
13
+
14
+ instance = MuxRuby::ListPlaybackRestrictionsResponse.new(
15
+ data: null
16
+ )
17
+ ```
18
+
@@ -0,0 +1,18 @@
1
+ # MuxRuby::ListSpacesResponse
2
+
3
+ ## Properties
4
+
5
+ | Name | Type | Description | Notes |
6
+ | ---- | ---- | ----------- | ----- |
7
+ | **data** | [**Array&lt;Space&gt;**](Space.md) | | |
8
+
9
+ ## Example
10
+
11
+ ```ruby
12
+ require 'mux_ruby'
13
+
14
+ instance = MuxRuby::ListSpacesResponse.new(
15
+ data: null
16
+ )
17
+ ```
18
+
data/docs/LiveStream.md CHANGED
@@ -21,6 +21,7 @@
21
21
  | **simulcast_targets** | [**Array&lt;SimulcastTarget&gt;**](SimulcastTarget.md) | Each Simulcast Target contains configuration details to broadcast (or \&quot;restream\&quot;) a live stream to a third-party streaming service. [See the Stream live to 3rd party platforms guide](https://docs.mux.com/guides/video/stream-live-to-3rd-party-platforms). | [optional] |
22
22
  | **latency_mode** | **String** | Latency is the time from when the streamer transmits a frame of video to when you see it in the player. Set this as an alternative to setting low latency or reduced latency flags. The Low Latency value is a beta feature. Note: Reconnect windows are incompatible with Reduced Latency and Low Latency and will always be set to zero (0) seconds. Read more here: https://mux.com/blog/introducing-low-latency-live-streaming/ | [optional] |
23
23
  | **test** | **Boolean** | True means this live stream is a test live stream. Test live streams can be used to help evaluate the Mux Video APIs for free. There is no limit on the number of test live streams, but they are watermarked with the Mux logo, and limited to 5 minutes. The test live stream is disabled after the stream is active for 5 mins and the recorded asset also deleted after 24 hours. | [optional] |
24
+ | **max_continuous_duration** | **Integer** | The time in seconds a live stream may be continuously active before being disconnected. Defaults to 12 hours. | [optional][default to 43200] |
24
25
 
25
26
  ## Example
26
27
 
@@ -44,7 +45,8 @@ instance = MuxRuby::LiveStream.new(
44
45
  low_latency: null,
45
46
  simulcast_targets: null,
46
47
  latency_mode: null,
47
- test: null
48
+ test: null,
49
+ max_continuous_duration: null
48
50
  )
49
51
  ```
50
52
 
@@ -4,7 +4,7 @@
4
4
 
5
5
  | Name | Type | Description | Notes |
6
6
  | ---- | ---- | ----------- | ----- |
7
- | **data** | [**LiveStream**](.md) | | [optional] |
7
+ | **data** | [**LiveStream**](LiveStream.md) | | [optional] |
8
8
 
9
9
  ## Example
10
10
 
@@ -16,7 +16,7 @@ All URIs are relative to *https://api.mux.com*
16
16
  | [**get_live_stream_playback_id**](LiveStreamsApi.md#get_live_stream_playback_id) | **GET** /video/v1/live-streams/{LIVE_STREAM_ID}/playback-ids/{PLAYBACK_ID} | Retrieve a live stream playback ID |
17
17
  | [**get_live_stream_simulcast_target**](LiveStreamsApi.md#get_live_stream_simulcast_target) | **GET** /video/v1/live-streams/{LIVE_STREAM_ID}/simulcast-targets/{SIMULCAST_TARGET_ID} | Retrieve a Live Stream Simulcast Target |
18
18
  | [**list_live_streams**](LiveStreamsApi.md#list_live_streams) | **GET** /video/v1/live-streams | List live streams |
19
- | [**reset_stream_key**](LiveStreamsApi.md#reset_stream_key) | **POST** /video/v1/live-streams/{LIVE_STREAM_ID}/reset-stream-key | Reset a live streams stream key |
19
+ | [**reset_stream_key**](LiveStreamsApi.md#reset_stream_key) | **POST** /video/v1/live-streams/{LIVE_STREAM_ID}/reset-stream-key | Reset a live stream&#39;s stream key |
20
20
  | [**signal_live_stream_complete**](LiveStreamsApi.md#signal_live_stream_complete) | **PUT** /video/v1/live-streams/{LIVE_STREAM_ID}/complete | Signal a live stream is finished |
21
21
  | [**update_live_stream**](LiveStreamsApi.md#update_live_stream) | **PATCH** /video/v1/live-streams/{LIVE_STREAM_ID} | Update a live stream |
22
22
  | [**update_live_stream_embedded_subtitles**](LiveStreamsApi.md#update_live_stream_embedded_subtitles) | **PUT** /video/v1/live-streams/{LIVE_STREAM_ID}/embedded-subtitles | Update a live stream&#39;s embedded subtitles |
@@ -28,6 +28,8 @@ All URIs are relative to *https://api.mux.com*
28
28
 
29
29
  Create a live stream
30
30
 
31
+ Creates a new live stream. Once created, an encoder can connect to Mux via the specified stream key and begin streaming to an audience.
32
+
31
33
  ### Examples
32
34
 
33
35
  ```ruby
@@ -96,6 +98,8 @@ end
96
98
 
97
99
  Create a live stream playback ID
98
100
 
101
+ Create a new playback ID for this live stream, through which a viewer can watch the streamed content of the live stream.
102
+
99
103
  ### Examples
100
104
 
101
105
  ```ruby
@@ -238,6 +242,8 @@ end
238
242
 
239
243
  Delete a live stream
240
244
 
245
+ Deletes a live stream from the current environment. If the live stream is currently active and being streamed to, ingest will be terminated and the encoder will be disconnected.
246
+
241
247
  ### Examples
242
248
 
243
249
  ```ruby
@@ -305,6 +311,8 @@ nil (empty response body)
305
311
 
306
312
  Delete a live stream playback ID
307
313
 
314
+ Deletes the playback ID for the live stream. This will not disable ingest (as the live stream still exists). New attempts to play back the live stream will fail immediately. However, current viewers will be able to continue watching the stream for some period of time.
315
+
308
316
  ### Examples
309
317
 
310
318
  ```ruby
@@ -655,6 +663,8 @@ end
655
663
 
656
664
  Retrieve a live stream playback ID
657
665
 
666
+ Fetches information about a live stream's playback ID, through which a viewer can watch the streamed content from this live stream.
667
+
658
668
  ### Examples
659
669
 
660
670
  ```ruby
@@ -797,6 +807,8 @@ end
797
807
 
798
808
  List live streams
799
809
 
810
+ Lists the live streams that currently exist in the current environment.
811
+
800
812
  ### Examples
801
813
 
802
814
  ```ruby
@@ -871,7 +883,7 @@ end
871
883
 
872
884
  > <LiveStreamResponse> reset_stream_key(live_stream_id)
873
885
 
874
- Reset a live streams stream key
886
+ Reset a live stream's stream key
875
887
 
876
888
  Reset a live stream key if you want to immediately stop the current stream key from working and create a new stream key that can be used for future broadcasts.
877
889
 
@@ -891,7 +903,7 @@ api_instance = MuxRuby::LiveStreamsApi.new
891
903
  live_stream_id = 'live_stream_id_example' # String | The live stream ID
892
904
 
893
905
  begin
894
- # Reset a live streams stream key
906
+ # Reset a live stream's stream key
895
907
  result = api_instance.reset_stream_key(live_stream_id)
896
908
  p result
897
909
  rescue MuxRuby::ApiError => e
@@ -907,7 +919,7 @@ This returns an Array which contains the response data, status code and headers.
907
919
 
908
920
  ```ruby
909
921
  begin
910
- # Reset a live streams stream key
922
+ # Reset a live stream's stream key
911
923
  data, status_code, headers = api_instance.reset_stream_key_with_http_info(live_stream_id)
912
924
  p status_code # => 2xx
913
925
  p headers # => { ... }
data/docs/MetricsApi.md CHANGED
@@ -17,7 +17,7 @@ All URIs are relative to *https://api.mux.com*
17
17
 
18
18
  Get metric timeseries data
19
19
 
20
- Returns timeseries data for a specific metric.
20
+ Returns timeseries data for a specific metric. Each interval represented in the data array contains an array with the following values: * the first element is the interval time * the second element is the calculated metric value * the third element is the number of views in the interval that have a valid metric value
21
21
 
22
22
  ### Examples
23
23
 
@@ -38,7 +38,7 @@ opts = {
38
38
  filters: ['inner_example'], # Array<String> | Limit the results to rows that match conditions from provided key:value pairs. Must be provided as an array query string parameter. To exclude rows that match a certain condition, prepend a `!` character to the dimension. Possible filter names are the same as returned by the List Filters endpoint. Example: * `filters[]=operating_system:windows&filters[]=!country:US`
39
39
  measurement: '95th', # String | Measurement for the provided metric. If omitted, the default for the metric will be used.
40
40
  order_direction: 'asc', # String | Sort order.
41
- group_by: 'hour' # String | Time granularity to group results by. If this value is omitted, a default granularity is chosen based on the timeframe. For timeframes of 6 hours or less, the default granularity is `ten_minutes`. Between 6 hours and 15 hours inclusive, the default granularity is `hour`. The granularity of timeframes that exceed 15 hours is `day`. This default behaviour is subject to change; it is strongly suggested that you explicitly specify the granularity.
41
+ group_by: 'ten_minutes' # String | Time granularity to group results by. If this value is omitted, a default granularity is chosen based on the timeframe. For timeframes of 6 hours or less, the default granularity is `ten_minutes`. Between 6 hours and 15 days inclusive, the default granularity is `hour`. The granularity of timeframes that exceed 15 days is `day`. This default behavior is subject to change; it is strongly suggested that you explicitly specify the granularity.
42
42
  }
43
43
 
44
44
  begin
@@ -77,7 +77,7 @@ end
77
77
  | **filters** | [**Array&lt;String&gt;**](String.md) | Limit the results to rows that match conditions from provided key:value pairs. Must be provided as an array query string parameter. To exclude rows that match a certain condition, prepend a &#x60;!&#x60; character to the dimension. Possible filter names are the same as returned by the List Filters endpoint. Example: * &#x60;filters[]&#x3D;operating_system:windows&amp;filters[]&#x3D;!country:US&#x60; | [optional] |
78
78
  | **measurement** | **String** | Measurement for the provided metric. If omitted, the default for the metric will be used. | [optional] |
79
79
  | **order_direction** | **String** | Sort order. | [optional] |
80
- | **group_by** | **String** | Time granularity to group results by. If this value is omitted, a default granularity is chosen based on the timeframe. For timeframes of 6 hours or less, the default granularity is &#x60;ten_minutes&#x60;. Between 6 hours and 15 hours inclusive, the default granularity is &#x60;hour&#x60;. The granularity of timeframes that exceed 15 hours is &#x60;day&#x60;. This default behaviour is subject to change; it is strongly suggested that you explicitly specify the granularity. | [optional] |
80
+ | **group_by** | **String** | Time granularity to group results by. If this value is omitted, a default granularity is chosen based on the timeframe. For timeframes of 6 hours or less, the default granularity is &#x60;ten_minutes&#x60;. Between 6 hours and 15 days inclusive, the default granularity is &#x60;hour&#x60;. The granularity of timeframes that exceed 15 days is &#x60;day&#x60;. This default behavior is subject to change; it is strongly suggested that you explicitly specify the granularity. | [optional] |
81
81
 
82
82
  ### Return type
83
83
 
@@ -4,12 +4,15 @@
4
4
 
5
5
  | Name | Type | Description | Notes |
6
6
  | ---- | ---- | ----------- | ----- |
7
+ | **data** | [**PlaybackRestriction**](PlaybackRestriction.md) | | [optional] |
7
8
 
8
9
  ## Example
9
10
 
10
11
  ```ruby
11
12
  require 'mux_ruby'
12
13
 
13
- instance = MuxRuby::PlaybackRestrictionResponse.new()
14
+ instance = MuxRuby::PlaybackRestrictionResponse.new(
15
+ data: null
16
+ )
14
17
  ```
15
18