Amazon Interactive Video Service Release Notes - Amazon Interactive Video Service

Amazon Interactive Video Service Release Notes

July 28, 2022

Amazon IVS iOS Broadcast SDK 1.5.1

Platform Downloads and Changes
iOS Broadcast SDK 1.5.1

Download: https://broadcast.live-video.net/1.5.1/AmazonIVSBroadcast.xcframework.zip

Reference documentation: https://aws.github.io/amazon-ivs-broadcast-docs/1.5.1/ios/

  • Fixed compatibility issues with iOS 16 that prevented audio encoding, causing all broadcasts to fail. This issue impacts all previous versions of the IVS Broadcast SDK for iOS. Version 1.5.1 is required to broadcast on iOS 16.

Broadcast SDK Size: iOS

Architecture Compressed Size Uncompressed Size
arm64 1.36 MB 3.20 MB

July 21, 2022

Amazon IVS Web Broadcast SDK

Platform Downloads and Changes
Web Broadcast SDK

Reference documentation: https://aws.github.io/amazon-ivs-web-broadcast/docs/sdk-reference

July 14, 2022

Amazon IVS iOS Player SDK 1.8.3

Platform Downloads and Changes
iOS Player 1.8.3

Download: https://player.live-video.net/1.8.3/AmazonIVSPlayer.xcframework.zip

Reference documentation: https://aws.github.io/amazon-ivs-player-docs/1.8.3/ios/

  • Fixed an issue where the Player could not play recorded content served via a URL that includes a relative path.

  • Fixed a memory-growth issue that could occur when the main thread is blocked.

Mobile SDK Size: iOS

Architecture Compressed Size Uncompressed Size
arm64 0.46 MB 1.10 MB

June 28, 2022

Amazon IVS Player Web SDK 1.11.0

Platform Downloads and Changes

Web player 1.11.0 & Video.js integration & JW player integration

NPM Package: https://www.npmjs.com/package/amazon-ivs-player

Script asset: https://player.live-video.net/1.11.0/amazon-ivs-player.min.js

Video.js tech asset: https://player.live-video.net/1.11.0/amazon-ivs-videojs-tech.min.js

Reference documentation: https://aws.github.io/amazon-ivs-player-docs/1.11.0/web/

  • Made stability improvements to ABR bandwidth estimation.

  • Fixed an issue when playing recorded content on an iOS mobile browser using the Video.js integration: the replay button now works. The prior workaround (hiding the replay button when initializing Video.js) is no longer required.

June 22, 2022

Amazon IVS Broadcast SDK 1.5.0

Platform Downloads and Changes
All
  • Improved stability by reducing occurrences of rare crashes.

  • Improved stability for high-bitrate streams.

  • Broadcasts experiencing extremely high latency will be ended with error code 20401 and this message: "The broadcast has ended because the network got too far behind. Check that you have a stable connection or reduce the broadcast bitrate." The threshold latency value for this is likely to change over time; currently it is 45 seconds.

Android Broadcast SDK 1.5.0

Reference documentation: https://aws.github.io/amazon-ivs-broadcast-docs/1.5.0/android/

  • Added a new configuration option to Video that enables transparency for the broadcast session: enableTransparency(boolean) and isTransparencyEnabled(). By default, transparency is disabled. Note that you must set Video.enableTransparency to TRUE for individual slot’s fillColor or transparency values to work as expected. Enable transparency only when required, since it is more computationally intensive.

iOS Broadcast SDK 1.5.0

Download: https://broadcast.live-video.net/1.5.0/AmazonIVSBroadcast.xcframework.zip

Reference documentation: https://aws.github.io/amazon-ivs-broadcast-docs/1.5.0/ios/

  • When using IVSReplayKitBroadcastSession for screen share, we recommend that you call IVSReplayKitBroadcastSession::broadcastFinished in RPBroadcastSampleHandler::broadcastFinished to ensure proper shutdown of the stream. Failure to do this might result in the stream staying live until it times out.

  • IVSImagePreviewView is no longer backed by MTKView, but instead a normal UIView that has a AVSampleBufferDisplayLayer based CALayer.

Broadcast SDK Size: Android

Architecture Compressed Size Uncompressed Size
arm64-v8a 1.539 MB 4.355 MB
armeabi-v7a 1.431 MB 3.483 MB
x86_64 1.729 MB 4.868 MB
x86 1.675 MB 4.436 MB

Broadcast SDK Size: iOS

Architecture Compressed Size Uncompressed Size
arm64 1.36 MB 3.20 MB

June 9, 2022

Vertical Video Improvement

This release improves how Amazon IVS processes vertical input; e.g., content broadcast from mobile devices where the height is greater than the width. This change is being rolled out over time, as explained at the end of this post.

There are three changes:

  1. (Affects Standard channels only) Vertical input is scaled based on the content’s width, resulting in less downscaling and visually higher quality output. For example, here is how this change impacts 720x1280 input:

    Name Old Width x Height New Width x Height
    1280p 720 x 1280
    720p 404 x 720 720 x 1280
    480p 268 x 480 480 x 852
    360p 200 x 360 360 x 640
    160p 88 x 160 160 x 284
  2. (Affects Standard channels only) The only renditions that are generated are those with width less than or equal to your input width. For example, if your input is 720x1280, you get 720p, 480p, 360p, and 160p renditions. If your input width is between renditions, you get all renditions with lower widths than your input. For example, here is how this change impacts 540x960 input:

    Name Old Width x Height New Width x Height
    960p 540 x 960
    720p 404 x 720
    480p 268 x 480 480 x 852
    360p 200 x 360 360 x 640
    160p 88 x 160 160 x 284
  3. (Affects Standard and Basic channels) Renditions for vertical input use a more conventional naming scheme based on width instead of height. For example, 360x640 input to a Basic channel has one output rendition named 360p.

    This name appears in video playlists as the NAME attribute and in the user-facing quality selector (example). The name also is used as the Amazon S3 directory name for recorded assets. For example, for 360x640 input, the quality selector and Auto-Record to Amazon S3 directory name is 360p60 (the old value was 640p60).

We are rolling out this improvement over time:

  • Now – Did you broadcast vertical input in the past six months? If not, we are enabling this change for your account now (specifically, over a 1-week period starting today). If yes, you will get a notification about this change in your account events section of the AWS Health Dashboard.

  • September 15, 2022 – We will enable the change on all remaining accounts. If you broadcast vertical input in the past six months and want this change to be enabled on your account sooner, please submit an AWS support ticket.

Important: Make sure you do not have any code (e.g., post-processing of recordings) that depends on the old behavior. For instance, if you have a script with rendition width/height hardcoded, you must edit that or it may break after this change is applied.

May 24, 2022

Amazon IVS Web and Android Player SDK 1.10.0

Platform Downloads and Changes

Web player 1.10.0 & Video.js integration & JW player integration

NPM Package: https://www.npmjs.com/package/amazon-ivs-player

Script asset: https://player.live-video.net/1.10.0/amazon-ivs-player.min.js

Video.js tech asset: https://player.live-video.net/1.10.0/amazon-ivs-videojs-tech.min.js

Reference documentation: https://aws.github.io/amazon-ivs-player-docs/1.10.0/web/

  • Fixed console errors related to pausing and playing with the Video.js plugin.

  • In the reference documentation, removed from the TypeScript definitions file two types which should not have been exposed, AutoplayOptions and PlayerEventType.STATE_CHANGED.

  • Fixed an issue where not all qualities were considered when using setAutoMaxQuality and setAutoMaxVideoSize.

  • Exposed the setAutoMaxVideoSize method, with corresponding documentation.

  • Clarified in the SDK Reference that setAutoMaxQuality filters qualities based on bitrate.

  • Corrected the end-of-stream behavior for VODs for web platforms.

Android player 1.10.0

Reference documentation: https://aws.github.io/amazon-ivs-player-docs/1.10.0/android/

  • Fixed an issue where not all qualities were considered when using setAutoMaxQuality and setAutoMaxVideoSize.

  • Added getVolume() to the Player class.

  • Clarified in the SDK Reference that setAutoMaxQuality filters qualities based on bitrate.

  • Corrected the end-of-stream behavior for VODs for web platforms.

Mobile SDK Size: Android

Architecture Compressed Size Uncompressed Size
arm64-v8a 0.990 MB 2.805 MB
armeabi-v7a 0.895 MB 2.215 MB
x86_64 1.033 MB 2.643 MB
x86 1.058 MB 2.936 MB

April 28, 2022

Stream Health Updates

There are two updates to Amazon IVS Stream Health, for monitoring the health of your live streams in near real time:

  • Charts of the high-resolution CloudWatch metrics are now available in the stream session details pages on the console.

  • A new dimension (Health) was added to the ConcurrentStreams metric, to filter the results by channel health.

See Monitoring Amazon IVS Live Stream Health and Monitoring Amazon IVS with Amazon CloudWatch.

April 26, 2022

Amazon IVS Chat

This is the initial release of Amazon IVS Chat, a managed, live-chat feature to go alongside live video streams. New documentation is accessible from the Amazon IVS documentation landing page.

As always, documentation changes are described in the Amazon IVS Document History.

April 22, 2022

Amazon IVS iOS Player SDK 1.8.2

Platform Downloads and Changes
iOS Player 1.8.2

Download: https://player.live-video.net/1.8.2/AmazonIVSPlayer.xcframework.zip

Reference documentation: https://aws.github.io/amazon-ivs-player-docs/1.8.2/ios/

  • Added support for Picture in Picture on devices running iOS 15 and later. You can instantiate the AVPictureInPictureController class directly with an instance of IVSPlayerLayer. Refer to the public sample app for an example implementation.

  • Fixed a deadlock issue that can occur while manipulating the IVSPlayer state from inside the completion handler of the -seekTo:completionHandler: method.

  • Fixed an issue introduced by the 1.8.1 release in an attempt to resolve a memory growth issue that can occur when the main thread is blocked.

Mobile SDK Size: iOS

Architecture Compressed Size Uncompressed Size
arm64 0.46 MB 1.10 MB

April 19, 2022

Amazon IVS Broadcast SDK 1.4.0

Platform Downloads and Changes
All
Android Broadcast SDK 1.4.0

Reference documentation: https://aws.github.io/amazon-ivs-broadcast-docs/1.4.0/android/

  • Fixed a bug in createServiceNotificationBuilder to enable targeting Android 12.

  • Fix issue on devices with a buggy main AVC profile by falling back to the baseline AVC profile.

  • Adds some NonNull annotations to several public API method signatures to prevent unexpected exceptions from crashing the application.

iOS Broadcast SDK 1.4.0

Download: https://broadcast.live-video.net/1.4.0/AmazonIVSBroadcast.xcframework.zip

Reference documentation: https://aws.github.io/amazon-ivs-broadcast-docs/1.4.0/ios/

  • Improved performance on iOS throughout the entire SDK by better utilizing GCD and Darwin-optimized locks, and improving buffer reuse.

  • In BroadcastConfiguration, changed the Keyframe interval maximum value from 10 to 5 to be consistent with Android.

  • Added a new method to control the audio encoder quality. On IVSAudioConfiguration, use the setQuality method. Reducing the encoder quality can have a large impact on CPU usage.

Broadcast SDK Size: Android

Architecture Compressed Size Uncompressed Size
arm64-v8a

1.526 MB

4.324 MB
armeabi-v7a 1.416 MB 3.442 MB
x86_64 1.657 MB 4.393 MB
x86 1.712 MB 4.827 MB

Broadcast SDK Size: iOS

Architecture Compressed Size Uncompressed Size
arm64 1.33 MB 3.13 MB

March 31, 2022

Amazon IVS iOS Player SDK 1.8.1

Platform Downloads and Changes
iOS Player 1.8.1

Download: <deprecated>

Reference documentation: https://aws.github.io/amazon-ivs-player-docs/1.8.1/ios/

  • Added support for Picture in Picture on devices running iOS 15 and later. You can instantiate the AVPictureInPictureController class directly with an instance of IVSPlayerLayer. Refer to the public sample app for an example implementation.

  • Fixed a memory-growth issue that can occur when the main thread is blocked.

  • Fixed a deadlock issue that can occur while manipulating the IVSPlayer state from inside the completion handler of the -seekTo:completionHandler: method.

Mobile SDK Size: iOS

Architecture Compressed Size Uncompressed Size
arm64 0.46 MB 1.10 MB

March 3, 2022

Amazon IVS Broadcast SDK 1.3.0

Platform Downloads and Changes
All
  • Improved stability by reducing occurrences of rare crashes.

  • Added support for 32-bit signed integer and 64-bit floating point PCM audio.

Android Broadcast SDK 1.3.0

Reference documentation: https://aws.github.io/amazon-ivs-broadcast-docs/1.3.0/android/

  • Fixed an intermittent issue where disconnecting a Bluetooth headset while streaming would lead to a crash.

  • The BroadcastSession.onBroadcastQuality method now reports low initial broadcast-quality values.

  • Added support for PCM buffers that include multiple AudioBufferLists. This is common for USB microphones.

Incorporates changes from the Android 1.2.1 release: new methods and a bug fix to properly support surface size and rotation changes:

  • Fixed a bug where SurfaceSource.setSize(...) did not set a new size for the SurfaceSource.

  • Added the Device.setRotation(float rotation) method to set the rotation on a device in radians.

  • Added the ImageDevice.rotateOnConfigurationChanges(boolean enable) method to enable/disable automatic rotation of the ImageDevice when the physical handset is rotated.

  • Added the ImageDevice.willRotateOnConfigurationChanges() method to return whether the ImageDevice is configured to automatically rotate when the physical handset rotates.

iOS Broadcast SDK 1.3.0

Download: https://broadcast.live-video.net/1.3.0/AmazonIVSBroadcast.xcframework.zip

Reference documentation: https://aws.github.io/amazon-ivs-broadcast-docs/1.3.0/ios/

  • Fixed some race conditions when using the createAppBackgroundImageSource method, which could have prevented the stream from resuming after the app returns to the foreground.

  • Added support for the arm64 simulator.

Broadcast SDK Size: Android

Architecture Compressed Size Uncompressed Size
arm64-v8a

1.531 MB

4.411 MB
armeabi-v7a 1.420 MB 3.525 MB
x86_64 1.719 MB 4.877 MB
x86 1.659 MB 4.925 MB

Broadcast SDK Size: iOS

Architecture Compressed Size Uncompressed Size
arm64 1.30 MB 3.06 MB

March 1, 2022

Amazon IVS Player SDK 1.8.0

Platform Downloads and Changes
All
  • Reduced occurrences of freezing during quality switches when playing recorded content.

Web player 1.8.0 & Video.js integration & JW player integration

NPM Package: https://www.npmjs.com/package/amazon-ivs-player

Script asset: https://player.live-video.net/1.8.0/amazon-ivs-player.min.js

Video.js tech asset: https://player.live-video.net/1.8.0/amazon-ivs-videojs-tech.min.js

Reference documentation: https://aws.github.io/amazon-ivs-player-docs/1.8.0/web/

  • Fixed an edge case where playback of recorded content could stall in some browsers.

  • Fixed an issue where timed metadata events were not triggered after seeking forward and then backward on recorded video.

  • Removed unnecessary, confusing warnings for the JW Player integration on remove().

  • Enabled stricter type checking for cue types to support correct cue-type filtering.

Android player 1.8.0

Reference documentation: https://aws.github.io/amazon-ivs-player-docs/1.8.0/android/

  • Removed the ViewUtil class, which is internal and was deprecated. Use PlayerView instead.

iOS Player 1.8.0

Download: https://player.live-video.net/1.8.0/AmazonIVSPlayer.xcframework.zip

Reference documentation: https://aws.github.io/amazon-ivs-player-docs/1.8.0/ios/

Mobile SDK Size: Android

Architecture Compressed Size Uncompressed Size
arm64-v8a 0.975 MB 2.761 MB
armeabi-v7a 0.882 MB 2.177 MB
x86_64 1.020 MB 2.603 MB
x86 1.043 MB 2.890 MB

Mobile SDK Size: iOS

Architecture Compressed Size Uncompressed Size
arm64 0.46 MB 1.10 MB

February 3, 2022

Amazon IVS Broadcast SDK: Android 1.2.1

Platform Downloads and Changes
Android Broadcast SDK 1.2.1

Reference documentation: https://aws.github.io/amazon-ivs-broadcast-docs/1.2.1/android/

This release has new methods and a bug fix to properly support surface size and rotation changes. This is needed for use cases involving custom video input.

  • Fixed a bug where SurfaceSource.setSize(...) did not set a new size for the SurfaceSource.

  • Added the Device.setRotation(float rotation) method to set the rotation on a device in radians.

  • Added the ImageDevice.rotateOnConfigurationChanges(boolean enable) method to enable/disable automatic rotation of the ImageDevice when the physical handset is rotated.

  • Added the ImageDevice.willRotateOnConfigurationChanges() method to return whether the ImageDevice is configured to automatically rotate when the physical handset rotates.

Broadcast SDK Size: Android

Architecture Compressed Size Uncompressed Size
arm64-v8a 1.642 MB 4.536 MB
armeabi-v7a 1.468 MB 3.261 MB
x86_64 1.866 MB 5.225 MB
x86 1.809 MB 4.916 MB

January 20, 2022

Amazon IVS Player SDK 1.7.0

Platform Downloads and Changes
All
  • Fixed stuttering when playing a stream from a source media playlist.

Web player 1.7.0 & Video.js integration & JW player integration

NPM Package: https://www.npmjs.com/package/amazon-ivs-player

Script asset: https://player.live-video.net/1.7.0/amazon-ivs-player.min.js

Video.js tech asset: https://player.live-video.net/1.7.0/amazon-ivs-videojs-tech.min.js

Reference documentation: https://aws.github.io/amazon-ivs-player-docs/1.7.0/web/

  • Fixed an issue where timed metadata events were not triggered after replaying an Amazon IVS recorded video.

  • Fixed an issue where the ErrorNotAvailable error was not emitted when a stream’s playback URL is unavailable on iOS mobile web browsers.

  • Fixed a console warning when calling dispose() using the Video.js wrapper.

  • Fixed several null reference errors caused by attempting to access the player instance after it is destroyed.

  • Updated setQuality documentation to more clearly specify that one should listen to the QUALITY_CHANGED to be notified of success.

  • Updated setInitialBufferDuration() documentation to specify that it does not function on iOS mobile browsers.

Known issue: When a viewer skips forward in recorded content, then skips backward, timed metadata within iOS browsers is not re-fired until after the skip-forward time. For example, if a viewer begins watching recorded content, skips forward to 60 seconds, then skips backward to 30 seconds, no timed metadata is triggered between 30 and 60 seconds. We expect to fix this issue in an upcoming release.

Android player 1.7.0

Reference documentation: https://aws.github.io/amazon-ivs-player-docs/1.7.0/android/

  • Deprecated the ViewUtil class, which is internal; use PlayerView instead. This class will be removed completely in the next Amazon IVS Player release (1.8.0, tentatively planned for 2022Q1).

  • Added PlayerView.setResizeMode(mode) to control how the video is displayed in the view, allowing the video to be optionally zoomed in or to fill the view entirely ignoring the video aspect ratio.

iOS Player 1.7.0

Download: https://player.live-video.net/1.7.0/AmazonIVSPlayer.xcframework.zip

Reference documentation: https://aws.github.io/amazon-ivs-player-docs/1.7.0/ios/

  • The iOS SDK now requires iOS 11.0 or higher.

  • The SDK no longer contains an arm64e slice. It will be re-enabled once Apple makes this a standard architecture.

  • Fixed rare crashes that could occur during app termination and media-service reset event.

Mobile SDK Size: Android

Architecture Compressed Size Uncompressed Size
arm64-v8a 1.013 MB 2.820 MB
armeabi-v7a 0.895 MB 2.012 MB
x86_64 1.119 MB 3.099 MB
x86 1.125 MB 2.970 MB

Mobile SDK Size: iOS

Architecture Compressed Size Uncompressed Size
arm64 0.46 MB 1.09 MB

January 18, 2022

R2S3 Thumbnail Configuration

This release allows you to enable/disable the recording of thumbnails for a live session and modify the interval at which thumbnails are generated for the live session. This is the first release of this new functionality. See:

  • Getting Started with Amazon IVS — We updated "Step 3: Create a Channel with Optional Recording."

  • Auto-Record to Amazon S3 — We made several changes:

    • We added a note to "Recording Contents" about modifying the thumbnails folder.

    • We added a new "Thumbnails" section.

    • We changed the information about the thumbnails and path fields in "JSON Metadata Files."

  • Amazon IVS API Reference — We made several changes:

    • New field (thumbnailConfiguration) in the RecordingConfiguration object. This in turn affects the CreateRecordingConfiguration request and response, GetRecordingConfiguration response, and GetStreamSession response.

    • New object: ThumbnailConfiguration.

December 9, 2021

Amazon IVS Broadcast SDK 1.2.0

Platform Downloads and Changes
All
  • Improved stability by reducing occurrences of rare crashes.

  • Added a new method, onNetworkHealthChanged (Android) and broadcastSession:networkHealthChanged (iOS). This provides updates when the instantaneous quality of the network changes. It can be used to provide feedback about when the broadcast might have temporary disruptions.

  • Added methods to get/set BroadcastConfiguration.mixer.canvasAspectMode. This is used as the default aspect mode for slots when the slot's aspect mode is not set explicitly.

  • Changed the Mixer (Android) and IVSBroadcastMixer (iOS) APIs:

    • Added getSlots() which returns all added slots.

    • Added unbind, which unbinds a device from a mixer slot.

    • Updated bind, unbind, and transition to return a bool indicating success or failure.

Android Broadcast SDK 1.2.0

Reference documentation: https://aws.github.io/amazon-ivs-broadcast-docs/1.2.0/android/

  • Fixed a bug where, even if transparency was enabled, a slot’s video or image was not blended with other slots beneath it (using zIndex values).

iOS Broadcast SDK 1.2.0

Download: https://broadcast.live-video.net/1.2.0/AmazonIVSBroadcast.xcframework.zip

Reference documentation: https://aws.github.io/amazon-ivs-broadcast-docs/1.2 .0/ios/

  • Improved the connection stability of Bluetooth and wired headsets.

  • Added support to IVSCustomImageSource for the following pixel formats:

    • kCVPixelFormatType_Lossless_420YpCbCr8BiPlanarFullRange

    • kCVPixelFormatType_Lossy_420YpCbCr8BiPlanarFullRange

    • kCVPixelFormatType_Lossless_420YpCbCr8BiPlanarVideoRange

    • kCVPixelFormatType_Lossy_420YpCbCr8BiPlanarVideoRange

    • kCVPixelFormatType_Lossless_32BGRA

    • kCVPixelFormatType_Lossy_32BGRA

  • Fixed two race conditions when using the createAppBackgroundImageSource method, which could have prevented the stream from resuming after the app returns to the foreground.

Broadcast SDK Size: Android

Architecture Compressed Size Uncompressed Size
arm64-v8a 1.639 MB 4.530 MB
armeabi-v7a 1.466 MB 3.255 MB
x86_64 1.863 MB 5.219 MB
x86 1.806 MB 4.910 MB

Broadcast SDK Size: iOS

Architecture Compressed Size Uncompressed Size
arm64 1.42 MB 3.30 MB

November 23, 2021

Amazon IVS Player SDK 1.6

Platform Downloads and Changes
All
  • Added a new player function, setInitialBufferDuration(), which allows customers to set the initial buffer duration. This duration determines when playback can start. The allowable range is 0.1 to 5 seconds. This method has no effect on iOS browser platforms.

  • Fixed a bug where a loaded stream could play without the play method being called, during a network reconnect.

  • Fixed an issue where stale closed caption data was not cleared.

  • Improved player stability by reducing occurrences of rare crashes.

Web player 1.6.1 & Video.js integration & JW player integration

NPM Package: https://www.npmjs.com/package/amazon-ivs-player

Script asset: https://player.live-video.net/1.6.1/amazon-ivs-player.min.js

Video.js tech asset: https://player.live-video.net/1.6.1/amazon-ivs-videojs-tech.min.js

Reference documentation: https://aws.github.io/amazon-ivs-player-docs/1.6.1/web/

  • Added a note to setQuality documentation about how the video element's controls attribute impacts invocation.

  • Improved how the player recovers from video decode and playlist network errors.

  • Changed the default log level for the player from warning to error, to match other platforms.

Android player 1.6.0

Reference documentation: https://aws.github.io/amazon-ivs-player-docs/1.6.0/android/

iOS Player 1.6.0

Download: https://player.live-video.net/1.6.0/AmazonIVSPlayer.xcframework.zip

Reference documentation: https://aws.github.io/amazon-ivs-player-docs/1.6.0/ios/

  • iOS 10 support will be deprecated starting with the next IVS Player release (1.7.0, tentatively planned for 2022Q1).

Mobile SDK Size: Android

Architecture Compressed Size Uncompressed Size
arm64-v8a 1.01 MB 2.82 MB
armeabi-v7a 0.84 MB 2.16 MB
x86_64 1.13 MB 2.97 MB
x86 1.12 MB 3.09 MB

Mobile SDK Size: iOS

Architecture Compressed Size Uncompressed Size
universal 0.94 MB 2.02 MB
arm64 0.47 MB 1.11 MB
armv7 0.46 MB 0.89 MB

November 18, 2021

Stream Health

Amazon IVS Stream Health lets you monitor the health of your live streams in near real time thanks to new high resolution CloudWatch metrics. You also can gain insights into your stream’s events and input configuration through two new API endpoints. This is the first release of this new functionality. See:

  • Monitoring Amazon IVS Live Stream Health — This is a new Amazon IVS User Guide page.

  • Getting Started with Amazon IVS — We updated the IAM policy in “Step 2: Set up IAM Permissions” with three more IVS permissions (GetStream, GetStreamSession, ListStreamSessions) and cloudwatch:GetMetricData.

  • Monitoring Amazon IVS with Amazon CloudWatch — We added four new, high-resolution metrics (IngestAudioBitrate, IngestFramerate, IngestVideoBitrate, and KeyframeInterval).

  • Using Amazon EventBridge with Amazon IVS — We added two events, Session Created and Session Ended.

  • Amazon IVS API Reference — Many changes:

    • Two new endpoints: GetStreamSession and ListStreamSessions.

    • Seven new objects: AudioConfiguration, IngestConfiguration, StreamEvent, StreamFilters, StreamSession, StreamSessionSummary, and VideoConfiguration.

    • New field (streamID) in the Stream and StreamSummary objects. This in turn affects the GetStream and ListStreams responses.

    • New field (filtersBy) in the ListStreams request.

October 20, 2021

Amazon IVS Broadcast SDK 1.1.0: Android and iOS

Platform Downloads and Changes
All
  • Fixed a bug that could leave a mixer-slot configuration in an unexpected state when the slot configuration provided to the transition method had a name that did not match the target-slot name parameter.

  • Improved stability by reducing occurrences of rare crashes.

  • Rebalanced preset bitrates to better reflect the expected user experience. These are documented in the Broadcast SDK reference documentation.

    • Standard (portrait/landscape) — Initial: 2.1 Mbps. Maximum: 6 Mbps.

    • Basic (portrait/landscape) — Initial: 1.2 Mbps. Maximum: 1.5 Mbps.

    • Gaming (portrait/landscape) (Android only) — Initial: 2.1 Mbps. Maximum 6 Mbps.

  • Added support for mono audio. A broadcast session can now be configured with 1 or 2 audio channels (mono or stereo, respectively). Also, custom audio sources can be configured with 1 or 2 audio channels.

  • Changed the Mixer canvas and slot origins to be top-left. This should be more natural for developers and provide more consistent usability. If you are using custom Mixer slots, you must update your code; see Broadcast SDK Mixer: Migrating from 1.0.0 to 1.1.0 below.

  • Added a new documentation page, Broadcasting to Amazon IVS: Mixer Guide.

Android Broadcast SDK 1.1.0

Reference documentation: https://aws.github.io/amazon-ivs-broadcast-docs/1.1.0/android/

  • Fixed a bug where device-orientation changes could crash the SDK.

  • Fixed a bug where getPreviewView() worked only the first time it was called. Now getPreviewView() returns a new ImagePreviewView every time it is called, so you can add multiple ImagePreviewViews of the same device or session to your view hierarchy at the same time. Note that using many ImagePreviewViews simultaneously can degrade performance.

  • Added stopSystemCapture() to stop the system-capture service without releasing the entire broadcast session.

  • Added an attachDevice override, to ignore mixer-slot preferred devices when attaching a device.

iOS Broadcast SDK 1.1.0

Download: https://broadcast.live-video.net/1.1.0/AmazonIVSBroadcast.xcframework.zip

Reference documentation: https://aws.github.io/amazon-ivs-broadcast-docs/1.1.0/ios/

  • Setting size on an IVSMixerSlotConfiguration object now sets matchCanvasSize to false. Similarly, setting aspect on an IVSMixerSlotConfiguration object sets matchCanvasAspectMode to false.

  • Added support for background audio with pre-encoded video. A new method, createAppBackgroundImageSourceOnComplete, changes the default behavior when backgrounding an app. Previously, the entire stream stopped because the SDK no longer had access to the camera or the GPU (which means no video input compositing or video encoding could be done).

    The new method returns a subclass of IVSCustomVideoSource. Normally, IVSCustomVideoSource allows you to submit image samples to be broadcast. The subclass allows you to submit image samples to be pre-encoded for broadcast later, when your app is in the background.

Broadcast SDK Mixer: Migrating from 1.0.0 to 1.1.0

Version 1.1.0 of the Broadcast SDK changes how the mixer coordinate system works. In 1.0.0, the mixer used inconsistent origin points. In 1.1.0, the origin is the top-left corner. See the new Amazon IVS Broadcast SDK Mixer Guide.

Canvas Changes: Horizontal (X-axis) positions are unchanged. Vertical positioning is inverted, compared to 1.0.0. A Y-axis value of 0 places the slot at the top of the canvas (rather than the bottom, as with 1.0.0). To keep a slot at the same position as in 1.0.0, subtract its current Y value from the height of the canvas; e.g., config.video.size.height - y

Slot Changes: Slots also have a top-left origin in 1.1.0. The orientation is unchanged from 1.0.0, but the origin has shifted from the center to the top-left. A slot aligned with the top left will be (0, 0), a slot aligned with the bottom right is:

(canvas_width - slot_width, canvas_height - slot_height)

To keep a slot in the same position as 1.0.0, subtract half its width from the X position and half its height from the Y position. Also, the slot’s size is relative to the top-left corner. Therefore, to expand a slot from the center, you must change the position at the same time as the size; otherwise, the slot will appear to grow down and to the right.

Broadcast SDK Size: Android

Architecture Compressed Size Uncompressed Size
arm64-v8a 2.23 MB 5.75 MB
armeabi-v7a 2.07 MB 4.99 MB
x86_64 2.35 MB 5.78 MB
x86 2.55 MB 6.78 MB

Broadcast SDK Size: iOS

Architecture Compressed Size Uncompressed Size
arm64 3.11 MB 6.74 MB

September 29, 2021

Amazon IVS Player SDK: Android 1.5.1

Platform Downloads and Changes
Android player 1.5.1

Reference documentation: https://aws.github.io/amazon-ivs-player-docs/1.5.1/android/

  • Fixed getVersion(), which now returns the correct version number.

Mobile SDK Size: Android

Architecture Compressed Size Uncompressed Size
arm64-v8a 1.00 MB 2.80 MB
armeabi-v7a 0.83 MB 2.15 MB
x86_64 1.11 MB 3.07 MB
x86 1.12 MB 2.94 MB

September 28, 2021

Amazon IVS Player SDK 1.5.0

Platform Downloads and Changes
All
  • Fixed an issue where a loaded stream could play without the play method being called during a network reconnect.

  • Fixed an issue where the player stayed in the PLAYING state after a stream disconnect, instead of moving to the ENDED state.

  • Updated CEA-608 captions parsing to support more encoders.

  • Improved the player's ability to play pass-through content; i.e., content from BASIC channels and the highest quality from STANDARD channels.

Web player 1.5.0 & Video.js integration & JW player integration

NPM Package: https://www.npmjs.com/package/amazon-ivs-player

Script asset: https://player.live-video.net/1.5.0/amazon-ivs-player.min.js

Video.js tech asset: https://player.live-video.net/1.5.0/amazon-ivs-videojs-tech.min.js

Reference documentation: https://aws.github.io/amazon-ivs-player-docs/1.5.0/web/

  • Improved how the player recovers from video-decode and playlist-network errors.

  • Fixed a bug where live streams did not resume (or resumed after a delay) when native HTML5 controls are enabled.

  • Fixed an issue where the getBuffered() method returned undefined instead of the expected { start: 0, end: 0 } when no content is loaded.

  • Added support for picture-in-picture mode in Video.js.

  • Changed the default log level for the player to error instead of warning.

Android player 1.5.0

Reference documentation: https://aws.github.io/amazon-ivs-player-docs/1.5.0/android/

  • Fixed zoom-in bug that happens on the Android SDK 30 emulator.

  • Improved the performance of PlayerView view layouts.

  • getVersion() returns 1.5.0-ivs.rc.2 instead of 1.5.0.

iOS Player 1.5.0

Download: https://player.live-video.net/1.5.0/AmazonIVSPlayer.xcframework.zip

Reference documentation: https://aws.github.io/amazon-ivs-player-docs/1.5.0/ios/

  • Added support for the iOS Simulator on Apple Silicon Macs.

  • Fixed an issue in which the memory heap size of the player continues to increase during playback until the player is deallocated.

  • Improved playback behavior when there is bad data in the video by ignoring it and continuing playback rather than stopping playback.

Mobile SDK Size: Android

Architecture Compressed Size Uncompressed Size
arm64-v8a 1.00 MB 2.80 MB
armeabi-v7a 0.83 MB 2.15 MB
x86_64 1.11 MB 3.07 MB
x86 1.12 MB 2.94 MB

Mobile SDK Size: iOS

Architecture Compressed Size Uncompressed Size
universal 0.92 MB 1.99 MB
arm64 0.47 MB 1.09 MB
armv7 0.46 MB 0.87 MB

September 8, 2021

Amazon IVS Player SDK 1.4.1

Mobile SDK Size: Android

Architecture Compressed Size Uncompressed Size
arm64-v8a 1.00 MB 2.79 MB
armeabi-v7a 0.83 MB 2.15 MB
x86_64 1.11 MB 3.06 MB
x86 1.11 MB 2.94 MB

Mobile SDK Size: iOS

Architecture Compressed Size Uncompressed Size
universal 0.89 MB 1.91 MB
arm64 0.45 MB 1.05 MB
armv7 0.44 MB 0.84 MB

August 13, 2021

ListTagsForResource API Endpoint

We removed support for pagination in this endpoint; i.e., the maxResults request field and nextToken request/response field. (Pagination did not work correctly.)

August 10, 2021

Amazon IVS Player SDK 1.4.0

Platform Downloads and Changes
All
  • Fixed a rare issue in which VOD playback could stall if a seek happens right after a DURATION_CHANGED event or READY state update.

  • Fixed a memory leak when playing streams with ID3 metadata.

  • Fixed an edge case in which injected captions could be rendered incorrectly.

  • Improved the performance of the player's adaptive bitrate streaming algorithm.

  • Improved player stability by reducing occurrences of rare crashes.

  • Added a log warning message when the player is accessed from a different thread than it was created on.

  • Updated getLiveLatency() documentation to be more specific about how latency is calculated, from the server to the player.

Web player 1.4.0 & Video.js integration & JW player integration

NPM Package: https://www.npmjs.com/package/amazon-ivs-player

Script asset: https://player.live-video.net/1.4.0/amazon-ivs-player.min.js

Video.js tech asset: https://player.live-video.net/1.4.0/amazon-ivs-videojs-tech.min.js

Reference documentation: https://aws.github.io/amazon-ivs-player-docs/1.4.0/web/

  • Fixed an edge case in which the TIMED_METADATA event did not fire on iOS Safari.

  • Improved performance of the player’s adaptive bitrate streaming algorithm when playing low-latency streams on Firefox.

  • Fixed documentation for getDuration(), which always returns Infinity for live streams.

  • Fixed a bug in which autoplaying on desktop Safari sometimes failed.

  • Fixed an error in which "Cannot read property 'collectLogs' of undefined" is reported in the developer console.

  • Video.js: Added support for picture-in-picture mode.

  • Web: Added a new method, setRequestCredentials. This controls whether the player makes credentialed requests to cross-origin endpoints. The remote endpoint needs to respond with the appropriate CORS response headers (like Access-Control-Allow-Origin, matching the request's Origin) and Access-Control-Allow-Credentials must be true.

    This setting persists throughout the player instance’s lifecycle. Therefore, all subsequent player.load() calls with URL endpoints should respond with appropriate CORS headers.

    This method has no effect on iOS browser platforms. To allow credentialed cross-origin requests on iOS platforms, users must explicitly allow Cross-site Tracking and allow Cookies; these are in the settings for the device and the respective browser app.

Android player 1.4.0

Reference documentation: https://aws.github.io/amazon-ivs-player-docs/1.4.0/android/

  • Fixed an issue in which high-resolution portrait video was considered as not supported video, even though the device can support it.

  • Fixed an issue in which changing the playback rate failed on certain Android devices.

  • Updated background-video handling to not decode content if the output surface is not set.

  • Implemented additional checks to ignore SDK calls after the player.release() method is called. This improves player stability.

  • Reduced Android library file size through optimization.

iOS Player 1.4.0

Download: https://player.live-video.net/1.4.0/AmazonIVSPlayer.xcframework.zip

Reference documentation: https://aws.github.io/amazon-ivs-player-docs/1.4.0/ios/

  • Fixed an issue in which the memory heap size of the player continues to increase during playback until the player is deallocated.

  • Fixed a potential deadlock when there is animation on top of video playback (e.g., a UI animation or GIF image).

  • Fixed a potential crash during media-services reset events.

  • Resolved a memory leak of CMFormatDescriptionRef that could occur during quality switches.

  • Added an error message that is logged if IVS-specific properties of the IVSPlayerView and IVSPlayerLayer classes are accessed on a thread other than the main thread.

  • Updated background-video handling to not decode content if the output surface is not set.

  • Improved documentation coverage in the IOS SDK Reference.

  • Reduced iOS library file size through optimization.

Mobile SDK Size: Android

Architecture Compressed Size Uncompressed Size
arm64-v8a 1.00 MB 2.79 MB
armeabi-v7a 0.83 MB 2.15 MB
x86_64 1.11 MB 3.06 MB
x86 1.11 MB 2.93 MB

Mobile SDK Size: iOS

Architecture Compressed Size Uncompressed Size
universal 0.89 MB 1.91 MB
arm64 0.45 MB 1.05 MB
armv7 0.44 MB 0.84 MB

July 27, 2021

Amazon IVS Broadcast SDK: Android 1.0.0 and iOS 1.0.0

June 1, 2021

Amazon IVS Player SDK: Android 1.3.3 and iOS 1.3.3

Platform Downloads and Changes
Android and iOS Fixed an issue where high-resolution portrait video was considered as not supported, although the device could support it.
Android player 1.3.3

Reference documentation: https://aws.github.io/amazon-ivs-player-docs/1.3.3/android/

iOS Player 1.3.3

Download: https://player.live-video.net/1.3.3/AmazonIVSPlayer.xcframework.zip

Reference documentation: https://aws.github.io/amazon-ivs-player-docs/1.3.3/ios/

  • Fixed a potential deadlock when there is animation on top of video playback (e.g., a UI animation or GIF image).

  • Fixed a potential crash during media-services reset events.

May 19, 2021

Amazon IVS Player SDK: Android 1.3.2

Reference documentation: https://aws.github.io/amazon-ivs-player-docs/1.3.2/android/

To improve player stability, additional checks were implemented to ignore API calls after the player.release() method is called.

May 5, 2021

Amazon IVS Player SDK 1.3

Platform Downloads and Changes
All
  • Updated SDK documentation for using TextCue usage documentation. See the latest the Player SDK References on the Amazon IVS documentation landing page.

  • Fixed an issue with audio playback of malformed mono input streams.

  • Fixed a rare playback error that could occur when playing content outside of the live HLS window.

  • Improved the player's ability to play standard HLS live and recorded streams.

  • Improved the accuracy of getLiveLatency, notably ensuring it is reset to zero when loading a new stream.

  • Improved the ABR (adaptive bitrate streaming) algorithm to increase video quality more quickly when network connections improve.

  • Improved player stability by reducing occurrences of rare crashes.

Web player 1.3.1 & Video.js integration & JW player integration

NPM Package: https://www.npmjs.com/package/amazon-ivs-player

Script asset: https://player.live-video.net/1.3.1/amazon-ivs-player.min.js

Video.js tech asset: https://player.live-video.net/1.3.1/amazon-ivs-videojs-tech.min.js

Reference documentation: https://aws.github.io/amazon-ivs-player-docs/1.3.1/web/

  • Fixed an issue where seek calls executed immediately after load were sometimes ignored, causing the player to begin at the wrong position.

  • Fixed several issues with seeking within recorded content (also known as VOD).

  • Fixed an issue where playback could fail in suboptimal network conditions.

  • Added support for IVS Timed Metadata on iOS mobile web browsers.

  • Fixed a bug where autoplaying in desktop Safari sometimes failed.

  • The Web SDK getVersion function no longer appends a hash to the player version.

  • Fixed an issue where seeking to the exact start of a buffered range may result in another seek forward.

  • Enabled low-latency ABR (adaptive bitrate streaming) in macOS Safari 14 and later.

  • Fixed an issue with loading the player in a server context, by removing an unsafe import side effect.

  • Changed the amazon-ivs-player NPM package so it exports the LogLevel enum, which is used by setLogLevel.

Note: The Web Player 1.3.0 NPM package exists but does not work. It is marked as deprecated on NPM. Use Web Player 1.3.1 or newer, as documented.

Android player 1.3.0

Reference documentation: https://aws.github.io/amazon-ivs-player-docs/1.3.0/android/

  • Fixed an issue where the player SDK crashed if the app targeted Android 11 (API level 30) and the user was running Android 11 on a cellular network.

  • Fixed a network recovery issue. Playback is now automatically paused when the network connection is lost, and it is resumed when the connection is restored. Use the onNetworkUnavailable callback in Player.Listener to observe network state changes.

  • Fixed an issue where player controls could not be hidden with setControlsEnabled(false) while playing VODs.

  • Fixed an issue where the SDK could crash if the client app uses an old (pre-4.0) version of OkHttp.

  • The Amazon IVS Android player library moved from a JCenter repository to Maven Central.

  • Removed BuildConfig version properties from the library.

iOS Player 1.3.0

Download: https://player.live-video.net/1.3.0/AmazonIVSPlayer.xcframework.zip

Reference documentation: https://aws.github.io/amazon-ivs-player-docs/1.3.0/ios/

  • Fixed an issue where if there was an audio sample-rate change within a single HLS media segment, the iOS SDK could not handle it properly. This could result in an unexpected memory increase and playback failure or a crash, due to bad media.

  • Fixed a network-recovery issue. Playback is now automatically paused when the network connection is lost, and it is resumed when the connection is restored. Use the playerNetworkDidBecomeUnavailable delegate method to observe network state changes.

  • Fixed an issue which caused an iOS memory increase that could happen over time.

  • Added graceful handling of audio hardware problems. Playback is now automatically paused in the event of a media-services reset notification (AVAudioSessionMediaServicesWereResetNotification). Note that a playback error may still occur if media is playing when the reset occurs.

  • Added audio-session interruption handling. Playback is now automatically paused when an audio-session interruption begins. When the interruption ends, playback automatically resumes if the player was previously playing and the interruption options indicate that the app should resume playback.

April 26, 2021

Service Quotas Integration with CloudWatch Usage Metrics

You can use CloudWatch to proactively manage your service quotas, via CloudWatch usage metrics. See Amazon IVS Service Quotas.

April 13, 2021

New CloudWatch Metrics

CloudWatch metrics were added for concurrent views and concurrent streams. See Monitoring Amazon IVS with Amazon CloudWatch.

The names of related service quotas were updated to match the new metrics. See Amazon IVS Service Quotas.

For a full definition of "view," see the Amazon IVS Glossary.

April 7, 2021

Auto-Record to S3 (R2S3)

Amazon IVS now enables you to save your live video content to Amazon S3. Saved video is available later for actions like editing or replaying as a VOD.

When you enable recording for a channel, all live broadcasts of the channel are stored to an S3 bucket of your choice. All available quality renditions and thumbnails images are saved. Your recording configuration also is saved, so it can be easily re-used for additional channels.

You can set up a recording configuration and enable/disable recording through the Amazon IVS console or API. For details, see Getting Started with Amazon IVS and the Amazon IVS API Reference.

January 28, 2021

Amazon IVS Player SDK: JW Player Integration 1.2.0

The Amazon IVS player now integrates with JW Player. See Player SDK: JW Player Integration.

Known Issue: In some cases, the duration of the video appears to be 00:00 and the playhead does not seek if dragged on the seekbar. This happens only when watching an ad-free playlist with a mixture of Amazon IVS live streams and VODs, using Safari on an iPhone.

December 16, 2020

Amazon IVS Player: SDK for Android 1.2.1

Reference documentation: https://aws.github.io/amazon-ivs-player-docs/1.2.1/android/

This release includes an Android Player patch which fixes an issue: in prior Android player SDK releases, the SDK crashes if the app targets Android 11 (API level 30) and the user is running Android 11 on a cellular network.

November 23, 2020

Amazon IVS Player SDK 1.2.0

Platform Downloads and Changes
All Improved detection of Amazon IVS streams, so metrics are more accurate.

Web player 1.2.0 & Video.js integration

NPM Package: https://www.npmjs.com/package/amazon-ivs-player

Script asset: https://player.live-video.net/1.2.0/amazon-ivs-player.min.js

Video.js tech asset: https://player.live-video.net/1.2.0/amazon-ivs-videojs-tech.min.js

Reference documentation: https://aws.github.io/amazon-ivs-player-docs/1.2.0/web/

  • If the master playlist for a stream is unavailable, we now emit ErrorNotAvailable for all web playback sources.

  • Updated reference documentation with respect to errors related to reaching the concurrent-viewers (CCV) limit.

Android player 1.2.0

Reference documentation: https://aws.github.io/amazon-ivs-player-docs/1.2.0/android/

  • Fixed an issue where the getSessionId function crashed on Android.

  • Updated reference documentation with respect to errors related to reaching the concurrent-viewers (CCV) limit.

Known Issue: The player SDK will crash if the app targets Android 11 (API level 30) and the user is running Android 11 on a cellular network. This will be fixed in the next release. In the meantime, we recommend targeting a previous Android API level (29 or lower).

iOS Player 1.2.0

Download: https://player.live-video.net/1.2.0/AmazonIVSPlayer.xcframework.zip

Reference documentation: https://aws.github.io/amazon-ivs-player-docs/1.2.0/ios/

  • Fixes a potential source of memory corruption when switching the stream URL or closing the player.

  • Resolves an issue that could cause playback to fail when the best audio pitch correction could not be enabled before starting playback. Pitch correction improves audio quality at playback speeds faster or slower than normal. If pitch correction cannot be enabled or the highest quality correction algorithm is unavailable, a message is logged but playback continues.

Known Issue: If there is an audio sample-rate change within a single HLS media segment, the iOS SDK cannot handle it properly. This can result in an unexpected memory increase and playback failure or a crash, due to bad media. This will be fixed in the next major iOS player release.

November 12, 2020

New Event Field, stream_id

The stream_id field was added to several events. See Using Amazon EventBridge with Amazon IVS.

November 9, 2020

Add Metadata Viewing to Console

Timed metadata can now be viewed from the Amazon IVS console. In the Amazon IVS User Guide, see the new section on Viewing Timed Metadata in Embedding Metadata within a Video Stream.

October 30, 2020

CloudFormation Support

Amazon IVS now supports AWS CloudFormation. This enables Amazon IVS customers to create and manage channels, stream keys, and playback key pairs with AWS CloudFormation.

Amazon IVS support for CloudFormation is available in all AWS regions where Amazon IVS is available. To get started, see the Amazon IVS product page or the Amazon IVS information in the AWS CloudFormation User Guide.

October 27, 2020

Higher Limits for Channels, CCV, and CCB

We increased three service-quota limits:

  • The maximum number of channels that users can create, per AWS region, increased from 500 to 5,000.

  • The maximum number of concurrent viewers allowed to play back a live channel, across all channels in an AWS region, increased from 3,000 to 15,000.

  • The maximum number of concurrent broadcasts (channels that can be streamed simultaneously), per AWS region, increased from 30 to 100.

These increases are available in all regions where Amazon IVS is available. To learn more, see Amazon IVS Service Quotas in the Amazon IVS User Guide.

October 9, 2020

New Service Quotas and EventBridge Event

There are now service quotas and EventBridge events related to ingest resolution. See Amazon IVS Service Quotas and Using Amazon EventBridge with Amazon IVS.

Amazon IVS Player: SDK for Web 1.1.2

NPM Package: https://www.npmjs.com/package/amazon-ivs-player

Script asset: https://player.live-video.net/1.1.2/amazon-ivs-player.min.js

Video.js tech asset: https://player.live-video.net/1.1.2/amazon-ivs-videojs-tech.min.js

Reference documentation: https://aws.github.io/amazon-ivs-player-docs/1.1.2/web/

This release includes a Web Player patch which fixes an issue that affected viewers using Microsoft Edge. For those viewers, if auto-quality mode is turned on for the stream (i.e., ABR is in effect), low-latency playback does not work; under these circumstances, streams played back with higher latency.

October 7, 2020

Amazon IVS Player SDK 1.1.0

The Amazon Interactive Video Service (IVS) Player SDKs use semantic versioning.

Platform Downloads and Changes
All
  • Fixed an issue where the player's adaptive bitrate algorithm could incorrectly drop quality to 160p.

  • The player now throws an error if there are no playable video qualities.

  • Updated VOD seek behavior: when attempting to seek beyond the end, the player seeks to the end instead of returning an error.

  • The player now throws a fatal error after exhausting all available qualities during error recovery.

Web Player 1.1.0

NPM Package: https://www.npmjs.com/package/amazon-ivs-player

Script asset: https://player.live-video.net/1.1.0/amazon-ivs-player.min.js

Video.js tech asset: https://player.live-video.net/1.1.0/amazon-ivs-videojs-tech.min.js

Reference documentation: https://aws.github.io/amazon-ivs-player-docs/1.1.0/web/

Known Issues:

  • If Video.js is not available, registerIVSQualityPlugin now throws an exception instead of writing to console.error.

  • If registerIVSTech or registerIVSQualityPlugin is called more than once, calls after the first one now do nothing (instead of attempting to re-register).

  • The type of the first parameter to registerIVSQualityPlugin has changed from VideoJS to any.

  • Removed dependencies on browser context to enable server-side rendering.

  • If the browser autopauses in response to unmuting, the player now fires the AUDIO_BLOCKED event and resumes muted playback.

  • Added network connectivity recovery. A network timeout will not result in an error state being sent to the client app. Instead, when network connectivity is lost:

    • If the app is playing, the player library sends the NETWORK_UNAVAILABLE event to the app and the player enters the IDLE state. When connectivity is restored, the player library resumes playing and the app receives a PLAYING event.

    • If the app is paused, the NETWORK_UNAVAILABLE event is not sent to the app and the player library remains in the IDLE state. When connectivity is restored, the player library stays in the IDLE state.

    • At any time, if the app tries to play, the player library attempts a normal play. The NETWORK_UNAVAILABLE event is sent to the app and the player enters the IDLE state.

Android Player 1.1.0

Reference documentation: https://aws.github.io/amazon-ivs-player-docs/1.1.0/android/

Known Issue: The player SDK will crash if the app targets Android 11 (API level 30) and the user is running Android 11 on a cellular network. This will be fixed in the next release. In the meantime, we recommend targeting a previous Android API level (29 or lower).

iOS Player 1.1.0

Download: https://player.live-video.net/1.1.0/AmazonIVSPlayer.xcframework.zip

Reference documentation: https://aws.github.io/amazon-ivs-player-docs/1.1.0/ios/

  • Fixed an issue that could cause crashes, with this message from UIKit: "Modifications to the layout engine must not be performed from a background thread after it has been accessed from the main thread." This could occur when backgrounding and foregrounding the application.

September 14, 2020

New Event Field, channel_name

The channel_name field was added to several events. See Using Amazon EventBridge with Amazon IVS.

August 19, 2020

Playback Authorization (Private Channels)

Amazon IVS now offers customers the ability to create private channels, allowing customers to restrict which vieres can watch their streams. Customers control access to video playback by enabling playback authorization on channels and generating signed JSON Web Tokens (JWTs) for authorized playback requests. For details, see Setting Up Private Channels.

A new authorized field in the Channel object indicates whether the channel is private. See the Amazon IVS API Reference.

August 11, 2020

Amazon IVS Player: SDK for iOS 1.0.6

Download: <deprecated>

Reference documentation: https://aws.github.io/amazon-ivs-player-docs/1.0.6/ios/

This release includes an iOS Player patch which fixes an issue that had prevented some iOS Player apps from being added to the Apple App Store. Specifically, apps built with bitcode enabled would fail App Store Connect validation after uploading.

August 5, 2020

Using Amazon EventBridge with Amazon IVS

Amazon IVS EventBridge events are now available through the Amazon EventBridge console. See the section on Creating Amazon EventBridge Rules for Amazon IVS in Using Amazon EventBridge with Amazon IVS, in the Amazon IVS User Guide.

July 15, 2020

Player Version 1.0

The Amazon Interactive Video Service (IVS) Player SDKs use semantic versioning.

Platform Downloads and Changes
All

Known Issue: For the setAutoMaxQuality and setQuality functions, the quality you provide is applied correctly to the current stream but is not applied correctly if you load a new stream. To avoid this, If you load a new stream, call this with a quality for the new stream after PlayerState.READY.

Web Player 1.0.0

NPM Package: https://www.npmjs.com/package/amazon-ivs-player

Script asset: https://player.live-video.net/1.0.0/amazon-ivs-player.min.js

Video.js tech asset: https://player.live-video.net/1.0.0/amazon-ivs-videojs-tech.min.js

Reference documentation: https://aws.github.io/amazon-ivs-player-docs/1.0.0/web/

Known Issues:

  • When playing a VOD on an iOS mobile browser (e.g. Safari or Chrome), seeking backwards will mute the player. To avoid this, call player.setMuted(false) after seeking.

  • When playing a VOD on an iOS mobile browser, seeking backwards works intermittently when directly selecting the desired position. To avoid this, drag the seek bar to the desired position.

  • When playing a VOD on an iOS mobile browser using the Video.js integration, the replay button does not work properly. To avoid this, hide the replay button when initializing Video.js: https://docs.videojs.com/tutorial-components.html#play-toggle.

Android Player 1.0.0

Reference documentation: https://aws.github.io/amazon-ivs-player-docs/1.0.0/android/

Known Issue: Backgrounding and foregrounding can cause audio/video de-synchronization for VOD playback on Android.

iOS Player 1.0.0

Download: <deprecated>

Reference documentation: https://aws.github.io/amazon-ivs-player-docs/1.0.0/ios/

Known Issues:

  • Backgrounding and foregrounding cause live and VOD playback failure. To avoid this, pause the stream when the UIApplicationDidEnterBackgroundNotification is received and resume play on the UIApplicationDidBecomeActiveNotification.

  • iOS 10 devices may experience a crash when returning from background. To avoid this, set the layer’s player property to nil before entering the background.