mux_ruby 1.8.1 → 1.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 949908e8ddb5270a36db4c9df9991f878e91b8e95ad6a1260506b956861f7ec6
-  data.tar.gz: 368bcacc1322c6308fce401c068e74a5ae0bd3627e1eb2261db5d30bd53e0fa7
+  metadata.gz: 57380e4202d460cfdb8bde993e835818799ea3c1df4f52f3f513eec8d10552cc
+  data.tar.gz: 1acb2eeb73ab3c670ca81f6cf3095cc8b4681b20d458e235d969f5f103ef072e
 SHA512:
-  metadata.gz: fde803ebf5c4db63c13522a8d4513282d74e1305725f122e87232be2d3126fdd1ff95c931f1e535c8d9d5de227d31924d7163a53cc51791294fb41c9afed78aa
-  data.tar.gz: 279bdcfeb349d5f4176e0e4408597644053052ef7a3cd85152a6443e50f9c7e6704e8e2dc5d7341814cd37e96b8f9cd8bf3be6fefca36989462eddaa28152f1b
+  metadata.gz: 01bc513413c7663ef490a4e193755479e7b0e6739f9f1b7ddd621e8f1146a8ec9a219be4d8b78f2b7f259105b26f203b1da04d7835bc34b718fdef3e759988c2
+  data.tar.gz: 20adae366398998ae7861471860cb36579d2e6594620ebd6c8073d3872e326b070d33859e2244c2a0420cf5c71c8483358895cf0daf6013dcd5bf76c3c9df809

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    mux_ruby (1.8.1)
+    mux_ruby (1.9.0)
       json (~> 2.1, >= 2.1.0)
       typhoeus (~> 1.0, >= 1.0.1)
 
@@ -78,4 +78,4 @@ DEPENDENCIES
   webmock (~> 1.24, >= 1.24.3)
 
 BUNDLED WITH
-   1.17.2
+   2.2.13

data/docs/Asset.md

@@ -3,28 +3,29 @@
 ## Properties
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**id** | **String** |  | [optional] 
-**created_at** | **String** |  | [optional] 
+**id** | **String** | Unique identifier for the Asset. | [optional] 
+**created_at** | **String** | Time at which the object was created. Measured in seconds since the Unix epoch. | [optional] 
 **deleted_at** | **String** |  | [optional] 
-**status** | **String** |  | [optional] 
-**duration** | **Float** |  | [optional] 
-**max_stored_resolution** | **String** |  | [optional] 
-**max_stored_frame_rate** | **Float** |  | [optional] 
-**aspect_ratio** | **String** |  | [optional] 
+**status** | **String** | The status of the asset. | [optional] 
+**duration** | **Float** | The duration of the asset in seconds (max duration for a single asset is 24 hours). | [optional] 
+**max_stored_resolution** | **String** | The maximum resolution that has been stored for the asset. The asset may be delivered at lower resolutions depending on the device and bandwidth, however it cannot be delivered at a higher value than is stored. | [optional] 
+**max_stored_frame_rate** | **Float** | The maximum frame rate that has been stored for the asset. The asset may be delivered at lower frame rates depending on the device and bandwidth, however it cannot be delivered at a higher value than is stored. This field may return -1 if the frame rate of the input cannot be reliably determined.  | [optional] 
+**aspect_ratio** | **String** | The aspect ratio of the asset in the form of `width:height`, for example `16:9`. | [optional] 
 **playback_ids** | [**Array<PlaybackID>**](PlaybackID.md) |  | [optional] 
 **tracks** | [**Array<Track>**](Track.md) |  | [optional] 
 **errors** | [**AssetErrors**](AssetErrors.md) |  | [optional] 
 **per_title_encode** | **BOOLEAN** |  | [optional] 
-**is_live** | **BOOLEAN** |  | [optional] 
-**passthrough** | **String** |  | [optional] 
-**live_stream_id** | **String** |  | [optional] 
+**is_live** | **BOOLEAN** | Whether the asset is created from a live stream and the live stream is currently `active` and not in `idle` state. | [optional] 
+**passthrough** | **String** | Arbitrary metadata set for the asset. Max 255 characters. | [optional] 
+**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] 
 **master** | [**AssetMaster**](AssetMaster.md) |  | [optional] 
 **master_access** | **String** |  | [optional] [default to 'none']
 **mp4_support** | **String** |  | [optional] [default to 'none']
-**normalize_audio** | **BOOLEAN** |  | [optional] [default to false]
+**source_asset_id** | **String** | Asset Identifier of the video used as the source for creating the clip. | [optional] 
+**normalize_audio** | **BOOLEAN** | Normalize the audio track loudness level. This parameter is only applicable to on-demand (not live) assets. | [optional] [default to false]
 **static_renditions** | [**AssetStaticRenditions**](AssetStaticRenditions.md) |  | [optional] 
 **recording_times** | [**Array<AssetRecordingTimes>**](AssetRecordingTimes.md) | An array of individual live stream recording sessions. A recording session is created on each encoder connection during the live stream | [optional] 
 **non_standard_input_reasons** | [**AssetNonStandardInputReasons**](AssetNonStandardInputReasons.md) |  | [optional] 
-**test** | **BOOLEAN** |  | [optional] 
+**test** | **BOOLEAN** | Indicates this asset is a test asset if the value is `true`. A Test asset can help evaluate the Mux Video APIs without incurring any cost. There is no limit on number of test assets created. Test assets are watermarked with the Mux logo, limited to 10 seconds, and deleted after 24 hrs. | [optional] 
 
 

data/docs/AssetErrors.md

@@ -3,7 +3,7 @@
 ## Properties
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**type** | **String** |  | [optional] 
-**messages** | **Array<String>** |  | [optional] 
+**type** | **String** | The type of error that occurred for this asset. | [optional] 
+**messages** | **Array<String>** | Error messages with more details. | [optional] 
 
 

data/docs/AssetNonStandardInputReasons.md

@@ -3,14 +3,14 @@
 ## Properties
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**video_codec** | **String** | The video codec used on the input file | [optional] 
-**audio_codec** | **String** | The audio codec used on the input file | [optional] 
-**video_gop_size** | **String** | The video key frame Interval (also called as Group of Picture or GOP) of the input file | [optional] 
-**video_frame_rate** | **String** | The video frame rate of the input file | [optional] 
-**video_resolution** | **String** | The video resolution of the input file | [optional] 
-**pixel_aspect_ratio** | **String** | The video pixel aspect ratio of the input file | [optional] 
-**video_edit_list** | **String** | Video Edit List reason indicates that the input file's video track contains a complex Edit Decision List | [optional] 
-**audio_edit_list** | **String** | Audio Edit List reason indicates that the input file's audio track contains a complex Edit Decision List | [optional] 
-**unexpected_media_file_parameters** | **String** | A catch-all reason when the input file in created with non-standard encoding parameters | [optional] 
+**video_codec** | **String** | The video codec used on the input file. | [optional] 
+**audio_codec** | **String** | The audio codec used on the input file. | [optional] 
+**video_gop_size** | **String** | The video key frame Interval (also called as Group of Picture or GOP) of the input file. | [optional] 
+**video_frame_rate** | **String** | The video frame rate of the input file. | [optional] 
+**video_resolution** | **String** | The video resolution of the input file. | [optional] 
+**pixel_aspect_ratio** | **String** | The video pixel aspect ratio of the input file. | [optional] 
+**video_edit_list** | **String** | Video Edit List reason indicates that the input file's video track contains a complex Edit Decision List. | [optional] 
+**audio_edit_list** | **String** | Audio Edit List reason indicates that the input file's audio track contains a complex Edit Decision List. | [optional] 
+**unexpected_media_file_parameters** | **String** | A catch-all reason when the input file in created with non-standard encoding parameters. | [optional] 
 
 

data/docs/AssetRecordingTimes.md

@@ -3,7 +3,7 @@
 ## Properties
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**started_at** | **DateTime** | The time at which the recording for the live stream started. The time value is Unix epoch time represented in ISO 8601 format | [optional] 
-**duration** | **Float** | The duration of the live stream recorded. The time value is in seconds | [optional] 
+**started_at** | **DateTime** | The time at which the recording for the live stream started. The time value is Unix epoch time represented in ISO 8601 format. | [optional] 
+**duration** | **Float** | The duration of the live stream recorded. The time value is in seconds. | [optional] 
 
 

data/docs/AssetStaticRenditions.md

@@ -3,7 +3,7 @@
 ## Properties
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**status** | **String** | * `ready`: All MP4s are downloadable * `preparing`: We are preparing the MP4s * `disabled`: MP4 support was not requested or has been removed * `errored`: There was a Mux internal error that prevented the MP4s from being created  | [optional] [default to 'disabled']
+**status** | **String** | Indicates the status of downloadable MP4 versions of this asset. | [optional] [default to 'disabled']
 **files** | [**Array<AssetStaticRenditionsFiles>**](AssetStaticRenditionsFiles.md) |  | [optional] 
 
 

data/docs/AssetsApi.md

@@ -176,6 +176,8 @@ Name | Type | Description  | Notes
 
 Delete an asset
 
+Deletes a video asset and all its data 
+
 ### Example
 ```ruby
 # load the gem
@@ -477,6 +479,8 @@ Name | Type | Description  | Notes
 
 List assets
 
+List all Mux assets. 
+
 ### Example
 ```ruby
 # load the gem

data/docs/CreateAssetRequest.md

@@ -3,13 +3,13 @@
 ## Properties
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**input** | [**Array<InputSettings>**](InputSettings.md) |  | [optional] 
-**playback_policy** | [**Array<PlaybackPolicy>**](PlaybackPolicy.md) |  | [optional] 
+**input** | [**Array<InputSettings>**](InputSettings.md) | An array of objects that each describe an input file to be used to create the asset. As a shortcut, input can also be a string URL for a file when only one input file is used. See `input[].url` for requirements. | [optional] 
+**playback_policy** | [**Array<PlaybackPolicy>**](PlaybackPolicy.md) | An array of playback policy names that you want applied to this asset and available through `playback_ids`. Options include: `\"public\"` (anyone with the playback URL can stream the asset). And `\"signed\"` (an additional access token is required to play the asset). If no playback_policy is set, the asset will have no playback IDs and will therefore not be playable. For simplicity, a single string name can be used in place of the array in the case of only one playback policy. | [optional] 
 **per_title_encode** | **BOOLEAN** |  | [optional] 
-**passthrough** | **String** |  | [optional] 
-**mp4_support** | **String** |  | [optional] 
+**passthrough** | **String** | Arbitrary metadata that will be included in the asset details and related webhooks. Can be used to store your own ID for a video along with the asset. **Max: 255 characters**. | [optional] 
+**mp4_support** | **String** | Specify what level (if any) of support for mp4 playback. In most cases you should use our default HLS-based streaming playback ({playback_id}.m3u8) which can automatically adjust to viewers' connection speeds, but an mp4 can be useful for some legacy devices or downloading for offline playback. See the [Download your vidoes guide](/guides/video/download-your-videos) for more information. | [optional] 
 **normalize_audio** | **BOOLEAN** | Normalize the audio track loudness level. This parameter is only applicable to on-demand (not live) assets. | [optional] [default to false]
-**master_access** | **String** |  | [optional] 
-**test** | **BOOLEAN** |  | [optional] 
+**master_access** | **String** | Specify what level (if any) of support for master access. Master access can be enabled temporarily for your asset to be downloaded. See the [Download your vidoes guide](/guides/video/download-your-videos) for more information. | [optional] 
+**test** | **BOOLEAN** | Marks the asset as a test asset when the value is set to true. A Test asset can help evaluate the Mux Video APIs without incurring any cost. There is no limit on number of test assets created. Test asset are watermarked with the Mux logo, limited to 10 seconds, deleted after 24 hrs. | [optional] 
 
 

data/docs/CreateTrackRequest.md

@@ -6,9 +6,9 @@ Name | Type | Description | Notes
 **url** | **String** |  | 
 **type** | **String** |  | 
 **text_type** | **String** |  | 
-**language_code** | **String** |  | 
-**name** | **String** |  | [optional] 
-**closed_captions** | **BOOLEAN** |  | [optional] 
-**passthrough** | **String** |  | [optional] 
+**language_code** | **String** | The language code value must be a valid BCP 47 specification compliant value. For example, en for English or en-US for the US version of English. | 
+**name** | **String** | The name of the track containing a human-readable description. This value must be unqiue across all the text type and subtitles text type tracks. HLS manifest will associate subtitle text track with this value. For example, set the value to \"English\" for subtitles text track with language_code as en-US. If this parameter is not included, Mux will auto-populate based on the language_code value. | [optional] 
+**closed_captions** | **BOOLEAN** | Indicates the track provides Subtitles for the Deaf or Hard-of-hearing (SDH). | [optional] 
+**passthrough** | **String** | Arbitrary metadata set for the track either when creating the asset or track. | [optional] 
 
 

data/docs/GetAssetOrLiveStreamIdResponse.md

@@ -0,0 +1,8 @@
+# MuxRuby::GetAssetOrLiveStreamIdResponse
+
+## Properties
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**data** | [**GetAssetOrLiveStreamIdResponseData**](GetAssetOrLiveStreamIdResponseData.md) |  | [optional] 
+
+

data/docs/GetAssetOrLiveStreamIdResponseData.md

@@ -0,0 +1,10 @@
+# MuxRuby::GetAssetOrLiveStreamIdResponseData
+
+## Properties
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**id** | **String** | The Playback ID used to retrieve the corresponding asset or the live stream ID | [optional] 
+**policy** | [**PlaybackPolicy**](PlaybackPolicy.md) |  | [optional] 
+**object** | [**GetAssetOrLiveStreamIdResponseDataObject**](GetAssetOrLiveStreamIdResponseDataObject.md) |  | [optional] 
+
+

data/docs/GetAssetOrLiveStreamIdResponseDataObject.md

@@ -0,0 +1,9 @@
+# MuxRuby::GetAssetOrLiveStreamIdResponseDataObject
+
+## Properties
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**id** | **String** | The identifier of the object. | [optional] 
+**type** | **String** | Identifies the object type associated with the playback ID. | [optional] 
+
+

data/docs/InputSettings.md

@@ -3,13 +3,15 @@
 ## Properties
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**url** | **String** |  | [optional] 
+**url** | **String** | The web address of the file that Mux should download and use. * For subtitles text tracks, the url is the location of subtitle/captions file. Mux supports [SubRip Text (SRT)](https://en.wikipedia.org/wiki/SubRip) and [Web Video Text Tracks](https://www.w3.org/TR/webvtt1/) format for ingesting Subtitles and Closed Captions. * For Watermarking or Overlay, the url is the location of the watermark image. * When creating clips from existing Mux assets, the url is defined with `mux://assets/{asset_id}` template where `asset_id` is the Asset Identifier for creating the clip from.  | [optional] 
 **overlay_settings** | [**InputSettingsOverlaySettings**](InputSettingsOverlaySettings.md) |  | [optional] 
-**type** | **String** |  | [optional] 
-**text_type** | **String** |  | [optional] 
-**language_code** | **String** |  | [optional] 
-**name** | **String** |  | [optional] 
-**closed_captions** | **BOOLEAN** |  | [optional] 
-**passthrough** | **String** |  | [optional] 
+**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. | [optional] 
+**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. | [optional] 
+**type** | **String** | This parameter is required for the `text` track type. | [optional] 
+**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` track type. | [optional] 
+**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] 
+**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 track. If this parameter is not included, Mux will auto-populate based on the `input[].language_code` value. | [optional] 
+**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] 
+**passthrough** | **String** | This optional parameter should be used for `text` type and subtitles `text` type tracks. | [optional] 
 
 

data/docs/InputSettingsOverlaySettings.md

@@ -3,12 +3,12 @@
 ## Properties
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**vertical_align** | **String** |  | [optional] 
-**vertical_margin** | **String** |  | [optional] 
-**horizontal_align** | **String** |  | [optional] 
-**horizontal_margin** | **String** |  | [optional] 
-**width** | **String** |  | [optional] 
-**height** | **String** |  | [optional] 
-**opacity** | **String** |  | [optional] 
+**vertical_align** | **String** | Where the vertical positioning of the overlay/watermark should begin from. Defaults to `\"top\"` | [optional] 
+**vertical_margin** | **String** | The distance from the vertical_align starting point and the image's closest edge. Can be expressed as a percent (\"10%\") or as a pixel value (\"100px\"). Negative values will move the overlay offscreen. In the case of 'middle', a positive value will shift the overlay towards the bottom and and a negative value will shift it towards the top. | [optional] 
+**horizontal_align** | **String** | Where the horizontal positioning of the overlay/watermark should begin from. | [optional] 
+**horizontal_margin** | **String** | The distance from the horizontal_align starting point and the image's closest edge. Can be expressed as a percent (\"10%\") or as a pixel value (\"100px\"). Negative values will move the overlay offscreen. In the case of 'center', a positive value will shift the image towards the right and and a negative value will shift it towards the left. | [optional] 
+**width** | **String** | How wide the overlay should appear. Can be expressed as a percent (\"10%\") or as a pixel value (\"100px\"). If both width and height are left blank the width will be the true pixels of the image, applied as if the video has been scaled to fit a 1920x1080 frame. If height is supplied with no width, the width will scale proportionally to the height. | [optional] 
+**height** | **String** | How tall the overlay should appear. Can be expressed as a percent (\"10%\") or as a pixel value (\"100px\"). If both width and height are left blank the height will be the true pixels of the image, applied as if the video has been scaled to fit a 1920x1080 frame. If width is supplied with no height, the height will scale proportionally to the width. | [optional] 
+**opacity** | **String** | How opaque the overlay should appear, expressed as a percent. (Default 100%) | [optional] 
 
 

data/docs/PlaybackID.md

@@ -3,7 +3,7 @@
 ## Properties
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**id** | **String** |  | [optional] 
+**id** | **String** | Unique identifier for the PlaybackID | [optional] 
 **policy** | [**PlaybackPolicy**](PlaybackPolicy.md) |  | [optional] 
 
 

data/docs/PlaybackIDApi.md

@@ -0,0 +1,60 @@
+# MuxRuby::PlaybackIDApi
+
+All URIs are relative to *https://api.mux.com*
+
+Method | HTTP request | Description
+------------- | ------------- | -------------
+[**get_asset_or_livestream_id**](PlaybackIDApi.md#get_asset_or_livestream_id) | **GET** /video/v1/playback-ids/{PLAYBACK_ID} | Retrieve an Asset or Live Stream ID
+
+
+# **get_asset_or_livestream_id**
+> GetAssetOrLiveStreamIdResponse get_asset_or_livestream_id(playback_id)
+
+Retrieve an Asset or Live Stream ID
+
+Retrieves the Identifier of the Asset or Live Stream associated with the Playback ID. 
+
+### Example
+```ruby
+# load the gem
+require 'mux_ruby'
+# setup authorization
+MuxRuby.configure do |config|
+  # Configure HTTP basic authorization: accessToken
+  config.username = 'YOUR USERNAME'
+  config.password = 'YOUR PASSWORD'
+end
+
+api_instance = MuxRuby::PlaybackIDApi.new
+playback_id = 'playback_id_example' # String | The live stream's playback ID.
+
+begin
+  #Retrieve an Asset or Live Stream ID
+  result = api_instance.get_asset_or_livestream_id(playback_id)
+  p result
+rescue MuxRuby::ApiError => e
+  puts "Exception when calling PlaybackIDApi->get_asset_or_livestream_id: #{e}"
+end
+```
+
+### Parameters
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **playback_id** | **String**| The live stream's playback ID. | 
+
+### Return type
+
+[**GetAssetOrLiveStreamIdResponse**](GetAssetOrLiveStreamIdResponse.md)
+
+### Authorization
+
+[accessToken](../README.md#accessToken)
+
+### HTTP request headers
+
+ - **Content-Type**: Not defined
+ - **Accept**: application/json
+
+
+

data/docs/Track.md

@@ -3,18 +3,18 @@
 ## Properties
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**id** | **String** |  | [optional] 
-**type** | **String** |  | [optional] 
-**duration** | **Float** |  | [optional] 
-**max_width** | **Integer** |  | [optional] 
-**max_height** | **Integer** |  | [optional] 
-**max_frame_rate** | **Float** |  | [optional] 
-**max_channels** | **Integer** |  | [optional] 
-**max_channel_layout** | **String** |  | [optional] 
-**text_type** | **String** |  | [optional] 
-**language_code** | **String** |  | [optional] 
-**name** | **String** |  | [optional] 
-**closed_captions** | **BOOLEAN** |  | [optional] 
-**passthrough** | **String** |  | [optional] 
+**id** | **String** | Unique identifier for the Track | [optional] 
+**type** | **String** | The type of track | [optional] 
+**duration** | **Float** | The duration in seconds of the track media. This parameter is not set for the `text` type track. This field is optional and may not be set. The top level `duration` field of an asset will always be set. | [optional] 
+**max_width** | **Integer** | The maximum width in pixels available for the track. Only set for the `video` type track. | [optional] 
+**max_height** | **Integer** | The maximum height in pixels available for the track. Only set for the `video` type track. | [optional] 
+**max_frame_rate** | **Float** | The maximum frame rate available for the track. Only set for the `video` type track. This field may return `-1` if the frame rate of the input cannot be reliably determined. | [optional] 
+**max_channels** | **Integer** | The maximum number of audio channels the track supports. Only set for the `audio` type track. | [optional] 
+**max_channel_layout** | **String** | Only set for the `audio` type track. | [optional] 
+**text_type** | **String** | This parameter is set only for the `text` type track. | [optional] 
+**language_code** | **String** | The language code value represents [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 set for `text` type and `subtitles` text type track. | [optional] 
+**name** | **String** | The name of the track containing a human-readable description. The hls manifest will associate a subtitle text track with this value. For example, the value is \"English\" for subtitles text track for the `language_code` value of `en-US`. This parameter is set for the `text` type and `subtitles` text type track. | [optional] 
+**closed_captions** | **BOOLEAN** | Indicates the track provides Subtitles for the Deaf or Hard-of-hearing (SDH). This parameter is set for the `text` type and `subtitles` text type track. | [optional] 
+**passthrough** | **String** | Arbitrary metadata set for the track either when creating the asset or track. This parameter is set for `text` type and `subtitles` text type track. Max 255 characters. | [optional] 
 
 

data/examples/video/exercise-assets.rb

@@ -13,6 +13,7 @@ end
 
 # API Client Initialization
 assets_api = MuxRuby::AssetsApi.new
+playback_ids_api = MuxRuby::PlaybackIDApi.new
 
 # ========== create-asset ==========
 car = MuxRuby::CreateAssetRequest.new
@@ -52,6 +53,20 @@ end
 puts "get-asset OK ✅"
 puts "get-asset-input-info OK ✅"
 
+# ========== clipping ==========
+clip_request = MuxRuby::CreateAssetRequest.new
+clip_request.input = [
+  {
+    url: "mux://assets/#{create_response.data.id}",
+    start_time: 0.0,
+    end_time: 5.0
+  }
+]
+create_clip_response = assets_api.create_asset(clip_request)
+assert create_clip_response != nil
+assert create_clip_response.data.id != nil
+puts "clipping OK ✅"
+
 # ========== create-asset-playback-id ==========
 cpbr = MuxRuby::CreatePlaybackIDRequest.new
 cpbr.policy = MuxRuby::PlaybackPolicy::PUBLIC
@@ -67,6 +82,12 @@ assert pb_id.data != nil
 assert pb_id.data.id == pb_id_c.data.id
 puts "get-asset-playback-id OK ✅"
 
+# ========== get-asset-or-livestream-id ==========
+get_playback_id_resp = playback_ids_api.get_asset_or_livestream_id(pb_id.data.id).data
+assert get_playback_id_resp.object.id == create_response.data.id
+assert get_playback_id_resp.object.type == "asset"
+puts "get-asset-or-livestream-id OK ✅"
+
 # ========== update-asset-mp4-support ==========
 mp4_req = MuxRuby::UpdateAssetMP4SupportRequest.new
 mp4_req.mp4_support = 'standard'

data/examples/video/exercise-live-streams.rb

@@ -13,6 +13,7 @@ end
 
 # API Client Initialization
 live_api = MuxRuby::LiveStreamsApi.new
+playback_ids_api = MuxRuby::PlaybackIDApi.new
 
 # ========== create-live-stream ==========
 create_asset_request = MuxRuby::CreateAssetRequest.new
@@ -41,6 +42,13 @@ assert stream_get.data != nil
 assert stream_get.data.id == stream.data.id
 puts "get-live-stream OK ✅"
 
+# ========== get-asset-or-livestream-id ==========
+playback_id = stream.data.playback_ids.first.id
+get_playback_id_resp = playback_ids_api.get_asset_or_livestream_id(playback_id).data
+assert get_playback_id_resp.object.id == stream.data.id
+assert get_playback_id_resp.object.type == "live_stream"
+puts "get-asset-or-livestream-id OK ✅"
+
 # ========== create-live-stream-simulcast-target ==========
 create_simulcast_target = MuxRuby::CreateSimulcastTargetRequest.new
 create_simulcast_target.passthrough = 'foo'

data/lib/mux_ruby.rb

@@ -35,6 +35,9 @@ require 'mux_ruby/models/enable_live_stream_response'
 require 'mux_ruby/models/error'
 require 'mux_ruby/models/filter_value'
 require 'mux_ruby/models/get_asset_input_info_response'
+require 'mux_ruby/models/get_asset_or_live_stream_id_response'
+require 'mux_ruby/models/get_asset_or_live_stream_id_response_data'
+require 'mux_ruby/models/get_asset_or_live_stream_id_response_data_object'
 require 'mux_ruby/models/get_asset_playback_id_response'
 require 'mux_ruby/models/get_metric_timeseries_data_response'
 require 'mux_ruby/models/get_overall_values_response'
@@ -113,6 +116,7 @@ require 'mux_ruby/api/filters_api'
 require 'mux_ruby/api/incidents_api'
 require 'mux_ruby/api/live_streams_api'
 require 'mux_ruby/api/metrics_api'
+require 'mux_ruby/api/playback_id_api'
 require 'mux_ruby/api/real_time_api'
 require 'mux_ruby/api/url_signing_keys_api'
 require 'mux_ruby/api/video_views_api'