mux_ruby 3.3.1 → 3.5.1
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/Gemfile.lock +1 -1
- data/README.md +13 -7
- data/docs/Asset.md +1 -1
- data/docs/AssetNonStandardInputReasons.md +2 -2
- data/docs/AssetResponse.md +1 -1
- data/docs/AssetsApi.md +8 -0
- data/docs/Broadcast.md +30 -0
- data/docs/BroadcastLayout.md +15 -0
- data/docs/BroadcastResolution.md +15 -0
- data/docs/BroadcastResponse.md +18 -0
- data/docs/BroadcastStatus.md +15 -0
- data/docs/CreateBroadcastRequest.md +26 -0
- data/docs/CreateLiveStreamRequest.md +3 -1
- data/docs/CreatePlaybackIDResponse.md +1 -1
- data/docs/CreatePlaybackRestrictionRequest.md +1 -1
- data/docs/CreateSimulcastTargetRequest.md +1 -1
- data/docs/CreateSpaceRequest.md +22 -0
- data/docs/CreateTrackResponse.md +1 -1
- data/docs/DirectUploadsApi.md +6 -0
- data/docs/GetAssetPlaybackIDResponse.md +1 -1
- data/docs/GetLiveStreamPlaybackIDResponse.md +1 -1
- data/docs/IncidentResponse.md +1 -1
- data/docs/InputSettings.md +3 -3
- data/docs/ListSpacesResponse.md +18 -0
- data/docs/LiveStream.md +3 -1
- data/docs/LiveStreamResponse.md +1 -1
- data/docs/LiveStreamsApi.md +16 -4
- data/docs/MetricsApi.md +3 -3
- data/docs/PlaybackRestrictionResponse.md +1 -1
- data/docs/PlaybackRestrictionsApi.md +6 -6
- data/docs/RealTimeApi.md +2 -2
- data/docs/SigningKeyResponse.md +1 -1
- data/docs/SimulcastTargetResponse.md +1 -1
- data/docs/Space.md +30 -0
- data/docs/SpaceResponse.md +18 -0
- data/docs/SpaceStatus.md +15 -0
- data/docs/SpaceType.md +15 -0
- data/docs/SpacesApi.md +658 -0
- data/docs/StartSpaceBroadcastResponse.md +18 -0
- data/docs/StopSpaceBroadcastResponse.md +18 -0
- data/docs/Track.md +9 -7
- data/docs/UpdateLiveStreamRequest.md +3 -1
- data/docs/UpdateReferrerDomainRestrictionRequest.md +37 -5
- data/docs/UploadResponse.md +1 -1
- data/docs/VideoViewResponse.md +1 -1
- data/gen/generator-config.json +1 -1
- data/gen/templates/README.mustache +9 -3
- data/lib/mux_ruby/api/assets_api.rb +8 -0
- data/lib/mux_ruby/api/direct_uploads_api.rb +6 -0
- data/lib/mux_ruby/api/live_streams_api.rb +14 -2
- data/lib/mux_ruby/api/metrics_api.rb +5 -5
- data/lib/mux_ruby/api/playback_restrictions_api.rb +9 -9
- data/lib/mux_ruby/api/real_time_api.rb +2 -2
- data/lib/mux_ruby/api/spaces_api.rb +619 -0
- data/lib/mux_ruby/models/abridged_video_view.rb +7 -0
- data/lib/mux_ruby/models/asset.rb +1 -1
- data/lib/mux_ruby/models/asset_non_standard_input_reasons.rb +2 -2
- data/lib/mux_ruby/models/broadcast.rb +305 -0
- data/lib/mux_ruby/models/broadcast_layout.rb +37 -0
- data/lib/mux_ruby/models/broadcast_resolution.rb +41 -0
- data/lib/mux_ruby/models/broadcast_response.rb +223 -0
- data/lib/mux_ruby/models/broadcast_status.rb +37 -0
- data/lib/mux_ruby/models/create_broadcast_request.rb +266 -0
- data/lib/mux_ruby/models/create_live_stream_request.rb +40 -4
- data/lib/mux_ruby/models/create_simulcast_target_request.rb +1 -1
- data/lib/mux_ruby/models/create_space_request.rb +242 -0
- data/lib/mux_ruby/models/input_settings.rb +3 -3
- data/lib/mux_ruby/models/list_spaces_response.rb +225 -0
- data/lib/mux_ruby/models/live_stream.rb +40 -4
- data/lib/mux_ruby/models/space.rb +301 -0
- data/lib/mux_ruby/models/space_response.rb +223 -0
- data/lib/mux_ruby/models/space_status.rb +37 -0
- data/lib/mux_ruby/models/space_type.rb +36 -0
- data/lib/mux_ruby/models/start_space_broadcast_response.rb +218 -0
- data/lib/mux_ruby/models/stop_space_broadcast_response.rb +218 -0
- data/lib/mux_ruby/models/track.rb +32 -10
- data/lib/mux_ruby/models/update_live_stream_request.rb +40 -4
- data/lib/mux_ruby/models/update_referrer_domain_restriction_request.rb +74 -179
- data/lib/mux_ruby/models/video_view.rb +103 -0
- data/lib/mux_ruby/version.rb +1 -1
- data/lib/mux_ruby.rb +15 -0
- data/spec/api/spaces_api_spec.rb +149 -0
- data/spec/models/broadcast_layout_spec.rb +28 -0
- data/spec/models/broadcast_resolution_spec.rb +28 -0
- data/spec/models/broadcast_response_spec.rb +34 -0
- data/spec/models/broadcast_spec.rb +70 -0
- data/spec/models/broadcast_status_spec.rb +28 -0
- data/spec/models/create_broadcast_request_spec.rb +58 -0
- data/spec/models/create_space_request_spec.rb +46 -0
- data/spec/models/list_spaces_response_spec.rb +34 -0
- data/spec/models/space_response_spec.rb +34 -0
- data/spec/models/space_spec.rb +70 -0
- data/spec/models/space_status_spec.rb +28 -0
- data/spec/models/space_type_spec.rb +28 -0
- data/spec/models/start_space_broadcast_response_spec.rb +34 -0
- data/spec/models/stop_space_broadcast_response_spec.rb +34 -0
- metadata +159 -99
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: abd3fbe606bb7ce4df59507592aff18e57d872ada172147a4961f0ccbe6ee41d
|
4
|
+
data.tar.gz: 77eef8d8a0f203f7a9129ffa4fb78d6942538263a236f0e454b28a43a5460e09
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: a8b77a6218923a14c88f8072c8c957c06e0a5c4e377f9ac46df2b18af3441993e761e641105b1358b8d7171731ce0181e95f010d79a7158114d4d8567ddd5f3d
|
7
|
+
data.tar.gz: 8a4621013a5051633075b6192946a0e34dea208090b41fa02e20b8f9eddb6b391235c102b473631034789039bcb35e063e48e9b5d9ec445b2be01a89880f120e
|
data/Gemfile.lock
CHANGED
data/README.md
CHANGED
@@ -1,8 +1,14 @@
|
|
1
1
|
![Mux Ruby Banner](github-ruby-sdk.png)
|
2
2
|
|
3
|
-
|
4
|
-
|
5
|
-
|
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.
|
26
|
+
- Package version: 3.5.1
|
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.
|
43
|
+
gem install ./mux_ruby-3.5.1.gem
|
38
44
|
```
|
39
45
|
|
40
|
-
(for development, run `gem install --dev ./mux_ruby-3.
|
46
|
+
(for development, run `gem install --dev ./mux_ruby-3.5.1.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.
|
52
|
+
gem 'mux_ruby', '~> 3.5.1'
|
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** |
|
19
|
+
| **is_live** | **Boolean** | Indicates whether the live stream that created this asset is currently `active` and not in `idle` 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 `hevc` video codec is non-standard and the value of this parameter is `hevc`. | [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 `high`. This parameter is present when the gop is greater than
|
10
|
-
| **video_frame_rate** | **String** | The video frame rate of the input file. Video with average frames per second (fps) less than
|
9
|
+
| **video_gop_size** | **String** | The video key frame Interval (also called as Group of Picture or GOP) of the input file is `high`. 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 `-1` 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 `width` x `height` in pixels. | [optional] |
|
12
12
|
| **video_bitrate** | **String** | The video bitrate of the input file is `high`. 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'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] |
|
data/docs/AssetResponse.md
CHANGED
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 'gallery'] |
|
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 '1920x1080'] |
|
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,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,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 'gallery'] |
|
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 '1920x1080'] |
|
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<CreateSimulcastTargetRequest>**](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
|
-
| **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: &#
|
9
|
+
| **url** | **String** | RTMP hostname including application name for the third party live streaming service. Example: `rtmp://live.example.com/app`. | |
|
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 'server'] |
|
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<CreateBroadcastRequest>**](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
|
+
|
data/docs/CreateTrackResponse.md
CHANGED
data/docs/DirectUploadsApi.md
CHANGED
@@ -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
|
data/docs/IncidentResponse.md
CHANGED
@@ -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<Integer>** | | [optional] |
|
9
9
|
|
10
10
|
## Example
|
data/docs/InputSettings.md
CHANGED
@@ -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's starting marker. The default value is 0 when not included. This parameter is only applicable for creating clips when `input.url` has `mux://assets/{asset_id}` format. | [optional] |
|
10
10
|
| **end_time** | **Float** | The time offset in seconds from the beginning of the video, indicating the clip's ending marker. The default value is the duration of the video when not included. This parameter is only applicable for creating clips when `input.url` has `mux://assets/{asset_id}` format. | [optional] |
|
11
|
-
| **type** | **String** | This parameter is required for
|
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 `text`
|
11
|
+
| **type** | **String** | This parameter is required for `text` 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 `text` 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 `text` type tracks. The hls manifest will associate a subtitle text track with this value. For example, the value should be \"English\" for subtitles text track with language_code as en. This optional parameter should be used only for `text` type and subtitles `text` type
|
14
|
+
| **name** | **String** | The name of the track containing a human-readable description. This value must be unique across all text type and subtitles `text` type tracks. The hls manifest will associate a subtitle text track with this value. For example, the value should be \"English\" for subtitles text track with language_code as en. This optional parameter should be used only for `text` type and subtitles `text` type tracks. If this parameter is not included, Mux will auto-populate based on the `input[].language_code` 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 `text` type and subtitles `text` type tracks. | [optional] |
|
16
16
|
| **passthrough** | **String** | This optional parameter should be used for `text` type and subtitles `text` type tracks. | [optional] |
|
17
17
|
|
@@ -0,0 +1,18 @@
|
|
1
|
+
# MuxRuby::ListSpacesResponse
|
2
|
+
|
3
|
+
## Properties
|
4
|
+
|
5
|
+
| Name | Type | Description | Notes |
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
7
|
+
| **data** | [**Array<Space>**](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<SimulcastTarget>**](SimulcastTarget.md) | Each Simulcast Target contains configuration details to broadcast (or \"restream\") 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
|
|
data/docs/LiveStreamResponse.md
CHANGED
data/docs/LiveStreamsApi.md
CHANGED
@@ -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 stream
|
19
|
+
| [**reset_stream_key**](LiveStreamsApi.md#reset_stream_key) | **POST** /video/v1/live-streams/{LIVE_STREAM_ID}/reset-stream-key | Reset a live stream'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'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 stream
|
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 stream
|
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 stream
|
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. 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
|
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: '
|
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 hours inclusive, the default granularity is `hour`. The granularity of timeframes that exceed 15 hours 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<String>**](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 `!` 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` | [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 `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
|
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 `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 behavior is subject to change; it is strongly suggested that you explicitly specify the granularity. | [optional] |
|
81
81
|
|
82
82
|
### Return type
|
83
83
|
|