Release Notes (Low-Latency Streaming) - Amazon IVS
July 11, 2024July 11, 2024June 13, 2024June 13, 2024June 6, 2024June 6, 2024May 20, 2024May 16, 2024May 9, 2024May 9, 2024May 6, 2024April 30, 2024April 30, 2024April 22, 2024April 11, 2024April 4, 2024March 21, 2024March 14, 2024March 13, 2024February 29, 2024February 22, 2024February 15, 2024February 1, 2024January 31, 2024January 25, 2024January 18, 2024January 3, 2024December 4, 2023November 21, 2023November 17, 2023November 14, 2023October 16, 2023October 12, 2023October 3, 2023October 2, 2023September 14, 2023August 23, 2023August 23, 2023August 22, 2023August 7, 2023July 17, 2023July 14, 2023July 13, 2023June 28, 2023June 27, 2023June 27, 2023June 16, 2023June 2, 2023June 1, 2023May 23, 2023May 16, 2023May 16, 2023May 11, 2023May 1, 2023April 27, 2023April 4, 2023March 30, 2023March 29, 2023March 28, 2023March 23, 2023March 23, 2023March 2, 2023February 28, 2023February 16, 2023January 31, 2023January 17, 2023December 9, 2022December 6, 2022November 17, 2022November 9, 2022November 1, 2022October 18, 2022October 6, 2022September 22, 2022September 20, 2022September 15, 2022September 12, 2022September 8, 2022September 2, 2022August 30, 2022August 9, 2022July 28, 2022July 21, 2022July 14, 2022June 28, 2022June 22, 2022June 9, 2022May 24, 2022April 28, 2022April 26, 2022April 22, 2022April 19, 2022March 31, 2022March 3, 2022March 1, 2022February 3, 2022January 20, 2022January 18, 2022December 9, 2021November 23, 2021November 18, 2021October 20, 2021September 29, 2021September 28, 2021September 8, 2021August 13, 2021August 10, 2021July 27, 2021June 1, 2021May 19, 2021May 5, 2021April 26, 2021April 13, 2021April 7, 2021January 28, 2021December 16, 2020November 23, 2020November 12, 2020November 9, 2020October 30, 2020October 27, 2020October 9, 2020October 7, 2020September 14, 2020August 19, 2020August 11, 2020August 5, 2020July 15, 2020

Release Notes (Low-Latency Streaming)

July 11, 2024

IVS Player SDK: Android 1.30.0, iOS 1.30.0

Platform Downloads and Changes
Android player 1.30.0

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

  • Minor bug fixes.
iOS Player 1.30.0

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

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

  • Minor bug fixes.

  • The iOS Player SDK now requires iOS 13+ as the native platform.

Mobile SDK Size: Android

Architecture Compressed Size Uncompressed Size
arm64-v8a 1.048 MB 2.857 MB
armeabi-v7a 0.920 MB 1.985 MB
x86_64 1.102 MB 3.000 MB
x86 1.131 MB 2.943 MB

Mobile SDK Size: iOS

Architecture Compressed Size Uncompressed Size
arm64 0.462 MB 1.199 MB

July 11, 2024

IVS Player SDK: Web 1.30.0

Platform Downloads and Changes

Web player 1.30.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.30.0/amazon-ivs-player.min.js

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

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

  • Minor bug fixes.

June 13, 2024

Amazon IVS Broadcast SDK: Android 1.19.0, iOS 1.19.0 (Low-Latency Streaming)

Platform Downloads and Changes
Android Broadcast SDK 1.19.0

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

  • Recent Android versions require an icon in the notification that is displayed when capturing the screen. If desired, you can now customize the icon by calling setSmallIcon on the Notification.Builder returned by Session # createServiceNotificationBuilder.
iOS Broadcast SDK 1.19.0

Download for low-latency streaming: https://broadcast.live-video.net/1.19.0/AmazonIVSBroadcast.xcframework.zip

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

  • The iOS Broadcast SDK now requires iOS 13+ as the native platform.

Broadcast SDK Size: Android

Architecture Compressed Size Uncompressed Size
arm64-v8a 1.696 MB 4.768 MB
armeabi-v7a 1.508 MB 3.390 MB
x86_64 1.840 MB 5.315 MB
x86 1.827 MB 5.038 MB

Broadcast SDK Size: iOS

Architecture Compressed Size Uncompressed Size
arm64 0.834 MB 2.081 MB

June 13, 2024

IVS Broadcast SDK: Web 1.13.0 (Low-Latency Streaming)

Platform Downloads and Changes

Web Broadcast SDK 1.13.0

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

  • Minor bug fixes.

June 6, 2024

IVS Player SDK: Android 1.29.0, iOS 1.29.0

Platform Downloads and Changes
Android player 1.29.0

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

  • Added the getChannelMetadata() method, which returns a list of String values to communicate channel features.
iOS Player 1.29.0

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

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

  • The iOS 12 deprecation that was planned for iOS player 1.29.0 is delayed until version 1.30.0.

  • Added the getChannelMetadata() method, which returns a list of String values to communicate channel features.

  • Improved consistency when deallocating IVSPlayerLayer on a background queue.

Mobile SDK Size: Android

Architecture Compressed Size Uncompressed Size
arm64-v8a 1.044 MB 2.834 MB
armeabi-v7a 0.916 MB 1.969 MB
x86_64 1.127 MB 2.919 MB
x86 1.097 MB 2.976 MB

Mobile SDK Size: iOS

Architecture Compressed Size Uncompressed Size
arm64 0.465 MB 1.183 MB

June 6, 2024

IVS Player SDK: Web 1.29.0

Platform Downloads and Changes

Web player 1.29.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.29.0/amazon-ivs-player.min.js

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

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

  • Minor bug fixes.

May 20, 2024

IVS Broadcast SDK: Web 1.12.0 (Low-Latency Streaming)

Platform Downloads and Changes

Web Broadcast SDK 1.12.0

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

  • No changes.

May 16, 2024

Amazon IVS Broadcast SDK: Android 1.18.0, iOS 1.18.0 (Low-Latency Streaming)

Platform Downloads and Changes
Android Broadcast SDK 1.18.0

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

  • Minor bug fixes.
iOS Broadcast SDK 1.18.0

Download for low-latency streaming: https://broadcast.live-video.net/1.18.0/AmazonIVSBroadcast.xcframework.zip

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

  • Added the IVSCamera setVideoZoomFactor method and the associated IVSCameraDelegate methods.

  • Minor bug fixes.

Broadcast SDK Size: Android

Architecture Compressed Size Uncompressed Size
arm64-v8a 1.692 MB 4.758 MB
armeabi-v7a 1.504 MB 3.382 MB
x86_64 1.834 MB 5.304 MB
x86 1.822 MB 5.026 MB

Broadcast SDK Size: iOS

Architecture Compressed Size Uncompressed Size
arm64 0.834 MB 2.064 MB

May 9, 2024

IVS Player SDK: Web 1.28.0

Platform Downloads and Changes

Web player 1.28.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.28.0/amazon-ivs-player.min.js

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

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

  • Minor bug fixes.

May 9, 2024

IVS Player SDK: Android 1.28.0, iOS 1.28.0

Platform Downloads and Changes
Android player 1.28.0

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

  • No changes.
iOS Player 1.28.0

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

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

Mobile SDK Size: Android

Architecture Compressed Size Uncompressed Size
arm64-v8a 1.045 MB 2.830 MB
armeabi-v7a 0.918 MB 1.967 MB
x86_64 1.127 MB 2.913 MB
x86 1.097 MB 2.971 MB

Mobile SDK Size: iOS

Architecture Compressed Size Uncompressed Size
arm64 0.468 MB 1.199 MB

May 6, 2024

IVS Broadcast SDK: Web 1.11.0 (Low-Latency Streaming)

Platform Downloads and Changes

Web Broadcast SDK 1.11.0

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

  • No changes.

April 30, 2024

IVS Broadcast SDK: Web 1.10.1 (Low-Latency Streaming)

Platform Downloads and Changes

Web Broadcast SDK 1.10.1

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

  • Minor bug fixes.

April 30, 2024

Amazon IVS Broadcast SDK: Android 1.15.2, iOS 1.15.2 (Low-Latency Streaming)

Platform Downloads and Changes
Android Broadcast SDK 1.15.2

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

  • Minor bug fixes. Upgrade to this version only if you have a specific reason to do so; otherwise, use the highest version that is released.
iOS Broadcast SDK 1.15.2

Download for low-latency streaming: https://broadcast.live-video.net/1.15.2/AmazonIVSBroadcast.xcframework.zip

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

  • Minor bug fixes. Upgrade to this version only if you have a specific reason to do so; otherwise, use the highest version that is released.

Broadcast SDK Size: Android

Architecture Compressed Size Uncompressed Size
arm64-v8a 1.678 MB 4.723 MB
armeabi-v7a 1.492 MB 3.356 MB
x86_64 1.819 MB 5.267 MB
x86 1.808 MB 4.991 MB

Broadcast SDK Size: iOS

Architecture Compressed Size Uncompressed Size
arm64 0.813 MB 2.001 MB

April 22, 2024

Amazon IVS Broadcast SDK: Android 1.17.0, iOS 1.17.0 (Low-Latency Streaming)

Platform Downloads and Changes
Android Broadcast SDK 1.17.0

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

  • No changes.
iOS Broadcast SDK 1.17.0

Download for low-latency streaming: https://broadcast.live-video.net/1.17.0/AmazonIVSBroadcast.xcframework.zip

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

  • The AmazonIVSBroadcast framework now includes a privacy manifest, as required by Apple.

Broadcast SDK Size: Android

Architecture Compressed Size Uncompressed Size
arm64-v8a 1.692 MB 4.757 MB
armeabi-v7a 1.504 MB 3.381 MB
x86_64 1.834 MB 5.303 MB
x86 1.822 MB 5.025 MB

Broadcast SDK Size: iOS

Architecture Compressed Size Uncompressed Size
arm64 0.831 MB 2.047 MB

April 11, 2024

Amazon IVS Player SDK: Mobile & Web 1.27.0

Platform Downloads and Changes

Web player 1.27.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.27.0/amazon-ivs-player.min.js

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

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

  • No changes.
Android player 1.27.0

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

  • No changes.
iOS Player 1.27.0

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

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

  • The AmazonIVSPlayer framework now includes a privacy manifest, as required by Apple.

  • Fixed key value observation for several properties on the IVSPlayer class.

Mobile SDK Size: Android

Architecture Compressed Size Uncompressed Size
arm64-v8a 1.044 MB 2.826 MB
armeabi-v7a 0.916 MB 1.963 MB
x86_64 1.096 MB 2.965 MB
x86 1.124 MB 2.907 MB

Mobile SDK Size: iOS

Architecture Compressed Size Uncompressed Size
arm64 0.445 MB 1.131 MB

April 4, 2024

Secure Reliable Transport (SRT) Ingest Support

Amazon IVS introduces support for streaming using the SRT protocol. SRT is an open-source transport technology optimized for live audio/video streaming. SRT enables secure and reliable transport of content across unpredictable, noisy networks, like the Internet. SRT offers multiple benefits when transporting live video content over the internet:

  • It helps compensate for jitter and bandwidth fluctuations.

  • It is resilient to packet loss.

  • It supports AES encryption to protect content in transit.

We support H.264-encoded video content using the SRT protocol.

March 21, 2024

Amazon IVS Broadcast SDK: Android 1.16.0, iOS 1.16.0, Web 1.10.0 (Low-Latency Streaming)

Platform Downloads and Changes

Web Broadcast SDK 1.10.0

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

  • No changes.
Android Broadcast SDK 1.16.0

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

  • Fixed a previews freeze on the Exynos variant of Samsung devices with Android 14.
iOS Broadcast SDK 1.16.0

Download for low-latency streaming: https://broadcast.live-video.net/1.16.0/AmazonIVSBroadcast.xcframework.zip

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

  • Minor bug fixes.

Broadcast SDK Size: Android

Architecture Compressed Size Uncompressed Size
arm64-v8a 1.683 MB 4.730 MB
armeabi-v7a 1.498 MB 3.362 MB
x86_64 1.824 MB 4.998 MB
x86 1.813 MB 5.274 MB

Broadcast SDK Size: iOS

Architecture Compressed Size Uncompressed Size
arm64 0.813 MB 2.001 MB

March 14, 2024

Amazon IVS Player SDK 1.26.0

Platform Downloads and Changes

Web player 1.26.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.26.0/amazon-ivs-player.min.js

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

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

  • Added an API to expose the synchronization time.

  • Added an event to indicate when the syncTime has changed.
Android player 1.26.0

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

  • Added an API to expose the synchronization time.

  • Added an event to indicate when the syncTime has changed.
iOS Player 1.26.0

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

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

  • Added an API to expose the synchronization time.

  • Added an event to indicate when the syncTime has changed.

Mobile SDK Size: Android

Architecture Compressed Size Uncompressed Size
arm64-v8a 1.07 MB 2.969 MB
armeabi-v7a 0.943 MB 2.098 MB
x86_64 1.123 MB 3.107 MB
x86 1.151 MB 3.039 MB

Mobile SDK Size: iOS

Architecture Compressed Size Uncompressed Size
arm64 0.44 MB 1.11 MB

March 13, 2024

Amazon IVS Broadcast SDK: Android 1.15.1, iOS 1.15.1 (Low-Latency Streaming)

Platform Downloads and Changes
Android Broadcast SDK 1.15.1

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

  • No changes in this release.
iOS Broadcast SDK 1.15.1

Download for low-latency streaming: https://broadcast.live-video.net/1.15.1/AmazonIVSBroadcast.xcframework.zip

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

  • No changes in this release.

Broadcast SDK Size: Android

Architecture Compressed Size Uncompressed Size
arm64-v8a 1.678 MB 4.723 MB
armeabi-v7a 1.492 MB 3.356 MB
x86_64 1.808 MB 4.991 MB
x86 1.819 MB 5.267 MB

Broadcast SDK Size: iOS

Architecture Compressed Size Uncompressed Size
arm64 0.813 MB 2.001 MB

February 29, 2024

Amazon IVS Player SDK: Web 1.25.0

Platform Downloads and Changes

Web player 1.25.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.25.0/amazon-ivs-player.min.js

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

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

  • Minor bug fixes.

February 22, 2024

Amazon IVS Broadcast SDK: Android 1.15.0, iOS 1.15.0, Web 1.9.0 (Low-Latency Streaming)

Platform Downloads and Changes

Web Broadcast SDK 1.9.0

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

  • No changes.
Android Broadcast SDK 1.15.0

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

  • Minor bug fixes.
iOS Broadcast SDK 1.15.0

Download for low-latency streaming: https://broadcast.live-video.net/1.15.0/AmazonIVSBroadcast.xcframework.zip

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

  • Minor bug fixes.

Broadcast SDK Size: Android

Architecture Compressed Size Uncompressed Size
arm64-v8a 1.678 MB 4.723 MB
armeabi-v7a 1.492 MB 3.356 MB
x86_64 1.808 MB 4.991 MB
x86 1.819 MB 5.267 MB

Broadcast SDK Size: iOS

Architecture Compressed Size Uncompressed Size
arm64 0.813 MB 2.001 MB

February 15, 2024

Amazon IVS Player SDK: Mobile 1.25.0

Platform Downloads and Changes
Android player 1.25.0

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

  • Minor bug fixes.
iOS Player 1.25.0

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

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

  • Minor bug fixes.

Mobile SDK Size: Android

Architecture Compressed Size Uncompressed Size
arm64-v8a 1.047 MB 2.9 MB
armeabi-v7a 0.921 MB 2.047 MB
x86_64 1.128 MB 2.97 MB
x86 1.1 MB 3.036 MB

Mobile SDK Size: iOS

Architecture Compressed Size Uncompressed Size
arm64 0.42 MB 1.08 MB

February 1, 2024

Amazon IVS Broadcast SDK: Android 1.14.1, iOS 1.14.1, Web 1.8.0 (Low-Latency Streaming)

Platform Downloads and Changes

Web Broadcast SDK 1.8.0

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

  • No changes.
Android Broadcast SDK 1.14.1

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

  • Minor bug fixes and improvements.
iOS Broadcast SDK 1.14.1

Download for low-latency streaming: https://broadcast.live-video.net/1.14.1/AmazonIVSBroadcast.xcframework.zip

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

  • Fixed multiple stability issues on iOS 12.

Broadcast SDK Size: Android

Architecture Compressed Size Uncompressed Size
arm64-v8a 1.663 MB 4.708 MB
armeabi-v7a 1.482 MB 3.350 MB
x86_64 1.804 MB 5.246 MB
x86 1.793 MB 4.973 MB

Broadcast SDK Size: iOS

Architecture Compressed Size Uncompressed Size
arm64 1.640 MB 4.010 MB

January 31, 2024

Tokenless Playback Restrictions

This release enables origin enforcement and geofencing outside of playback authorization. The IVS Low-Latency Streaming User Guide and API Reference were updated; see the Document History for details of the changes.

January 25, 2024

Audio-Only Playback

IVS now fully supports audio-only playback. See Audio-Only Playback in the IVS Player overview and Audio-Only Playback in the IVS Web Player Guide.

January 18, 2024

Amazon IVS Player SDK 1.24.0

Platform Downloads and Changes

Web player 1.24.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.24.0/amazon-ivs-player.min.js

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

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

  • Added support for audio-only playback. Audio-only quality must be selected manually with setQuality(); it will not be selected automatically in auto quality mode. See Audio-Only Playback in the Player Web Guide.

Android player 1.24.0

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

  • No changes
iOS Player 1.24.0

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

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

  • No changes

Mobile SDK Size: Android

Architecture Compressed Size Uncompressed Size
arm64-v8a 1.006 MB 2.846 MB
armeabi-v7a 0.88 MB 1.995 MB
x86_64 1.085 MB 2.916 MB
x86 1.058 MB 2.982 MB

Mobile SDK Size: iOS

Architecture Compressed Size Uncompressed Size
arm64 0.43 MB 1.08 MB

January 3, 2024

Amazon IVS Broadcast SDK: Android 1.13.4, iOS 1.13.4, Web 1.7.0 (Low-Latency Streaming)

Platform Downloads and Changes

Web Broadcast SDK 1.7.0

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

  • No changes to the low-latency SDK.
Android Broadcast SDK 1.13.4

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

  • No changes to the low-latency SDK.
iOS Broadcast SDK 1.13.4

Download for low-latency streaming: https://broadcast.live-video.net/1.13.4/AmazonIVSBroadcast.xcframework.zip

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

  • No changes to the low-latency SDK.

Broadcast SDK Size: Android

Architecture Compressed Size Uncompressed Size
arm64-v8a 1.663 MB 4.704 MB
armeabi-v7a 1.484 MB 3.352 MB
x86_64 1.804 MB 5.243 MB
x86 1.795 MB 4.97 MB

Broadcast SDK Size: iOS

Architecture Compressed Size Uncompressed Size
arm64 1.63 MB 4.01 MB

December 4, 2023

Amazon IVS Broadcast SDK: Android 1.13.2 and iOS 1.13.2 (Low-Latency Streaming)

Platform Downloads and Changes
Android Broadcast SDK 1.13.2

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

  • No changes in the low-latency SDK.
iOS Broadcast SDK 1.13.2

Download for low-latency streaming: https://broadcast.live-video.net/1.13.2/AmazonIVSBroadcast.xcframework.zip

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

  • No changes in the low-latency SDK.

Broadcast SDK Size: Android

Architecture Compressed Size Uncompressed Size
arm64-v8a 1.663 MB 4.704 MB
armeabi-v7a 1.484 MB 3.352 MB
x86_64 1.804 MB 5.243 MB
x86 1.795 MB 4.970 MB

Broadcast SDK Size: iOS

Architecture Compressed Size Uncompressed Size
arm64 1.63 MB 4.01 MB

November 21, 2023

Amazon IVS Broadcast SDK: Android 1.13.1 (Low-Latency Streaming)

Platform Downloads and Changes
Android Broadcast SDK 1.13.1

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

  • No changes in the low-latency SDK.

Broadcast SDK Size: Android

Architecture Compressed Size Uncompressed Size
arm64-v8a 1.663 MB 4.705 MB
armeabi-v7a 1.484MB 3.352 MB
x86_64 1.804 MB 5.243 MB
x86 1.795 MB 4.971 MB

November 17, 2023

Amazon IVS Broadcast SDK: Android 1.13.0 and iOS 1.13.0 (Low-Latency Streaming)

Platform Downloads and Changes
All mobile (Android and iOS)

  • Improved IPv6 support by adopting RFC 6555 "Happy Eyeballs" and adding the BroadcastConfiguration.network.useIPv6 configuration option to enable or disable IPv6 for broadcasting.
Android Broadcast SDK 1.13.0

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

  • Fixed a crash when an AudioSource object is used after releasing it.

  • Added support to Surfaceview-based preview for better performance. The existing getPreview methods in Session and StageStream continue to return a subclass of TextureView, but this may change in a future SDK version.

    • If your application depends on TextureView specifically, you can continue with no changes. You also can switch from getPreview to getPreviewTextureView to prepare for the eventual change of what the default getPreview returns.

    • If your application does not require TextureView specifically, we recommend switching to getPreviewSurfaceView for lower CPU and memory usage.

  • The SDK now implements a new type of preview called ImagePreviewSurfaceTarget which works with the application-provided Android Surface object. It is not a subclass of Android View, which provides better flexibility.
iOS Broadcast SDK 1.13.0

Download for low-latency streaming: https://broadcast.live-video.net/1.13.0/AmazonIVSBroadcast.xcframework.zip

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

  • There were no changes for this release.

Broadcast SDK Size: Android

Architecture Compressed Size Uncompressed Size
arm64-v8a 1.66 MB 4.70 MB
armeabi-v7a 1.48 MB 3.35 MB
x86_64 1.80 MB 5.24 MB
x86 1.79 MB 4.96 MB

Broadcast SDK Size: iOS

Architecture Compressed Size Uncompressed Size
arm64 1.63 MB 4.01 MB

November 14, 2023

Amazon IVS Player SDK 1.23.0

Platform Downloads and Changes

Web player 1.23.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.23.0/amazon-ivs-player.min.js

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

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

  • Added support for low-latency playback in iOS Safari.

Android player 1.23.0

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

  • Updated the reference documentation with a new UI and more details.
iOS Player 1.23.0

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

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

  • No changes.

Mobile SDK Size: Android

Architecture Compressed Size Uncompressed Size
arm64-v8a 0.975 MB 2.744 MB
armeabi-v7a 0.853 MB 1.917 MB
x86_64 1.028 MB 2.873 MB
x86 1.055 MB 2.811 MB

Mobile SDK Size: iOS

Architecture Compressed Size Uncompressed Size
arm64 0.39 MB 0.93 MB

October 16, 2023

Amazon IVS Broadcast SDK: Web 1.6.0 (Low-Latency Streaming)

Platform Downloads and Changes

Web Broadcast SDK 1.6.0

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

  • No changes to the low-latency SDK.

October 12, 2023

Amazon IVS Broadcast SDK: Android 1.12.1 (Low-Latency Streaming)

Platform Downloads and Changes
Android Broadcast SDK 1.12.1

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

  • Fixed a bug where calling BroadcastSession.setListener resulted in an error.

Broadcast SDK Size: Android

Architecture Compressed Size Uncompressed Size
arm64-v8a 1.685 MB 5.046 MB
armeabi-v7a 1.503 MB 3.702 MB
x86_64 1.826 MB 5.576 MB
x86 1.822 MB 5.290 MB

October 3, 2023

Amazon IVS Player SDK 1.22.0

Platform Downloads and Changes

Web player 1.22.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.22.0/amazon-ivs-player.min.js

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

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

  • Added a static method to get the SDK version, MediaPlayerPackage.getVersion().

Android player 1.22.0

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

  • Added the setNetworkRecoveryMode function to the Player interface, to set the desired playback behavior after a network interruption.
iOS Player 1.22.0

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

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

  • Added the setNetworkRecoveryMode function to the IVSPlayer interface, to set the desired playback behavior after a network interruption.

  • The copyDisplayedPixelBuffer method on IVSPlayerLayer can now be used when the player is playing. Previously it was callable only when the player was idle.

Mobile SDK Size: Android

Architecture Compressed Size Uncompressed Size
arm64-v8a 0.948 MB 2.676 MB
armeabi-v7a 0.828 MB 1.865 MB
x86_64 1.025 MB 2.741 MB
x86 1.000 MB 2.802 MB

Mobile SDK Size: iOS

Architecture Compressed Size Uncompressed Size
arm64 0.37 MB 0.89 MB

October 2, 2023

In-Console Streaming

You can now stream from the IVS console. In Getting Started with Low-Latency Streaming, see Step 5: Set Up Streaming Software.

September 14, 2023

Amazon IVS Broadcast SDK: Web 1.5.2 (Low-Latency Streaming)

Platform Downloads and Changes

Web Broadcast SDK 1.5.2

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

August 23, 2023

Amazon IVS Broadcast SDK: Web 1.5.1, Android 1.12.0, and iOS 1.12.0 (Low-Latency Streaming)

Platform Downloads and Changes
Web Broadcast SDK 1.5.1

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

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

  • Fixed a rare bug that caused broadcasts to end prematurely with the message "Attempted to recv after receiving shutdown from peer."
iOS Broadcast SDK 1.12.0

Download for low-latency streaming: https://broadcast.live-video.net/1.12.0/AmazonIVSBroadcast.xcframework.zip

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

  • Corrected the signature of IVSDeviceDiscovery.createAudioSourceWithName to return an IVSCustomAudioSource instead of IVSCustomImageSource.

Broadcast SDK Size: Android

Architecture Compressed Size Uncompressed Size
arm64-v8a 1.685 MB 5.046 MB
armeabi-v7a 1.503 MB 3.702 MB
x86_64 1.826 MB 5.576 MB
x86 1.822 MB 5.290 MB

Broadcast SDK Size: iOS

Architecture Compressed Size Uncompressed Size
arm64 1.58 MB 3.88 MB

August 23, 2023

Amazon IVS Broadcast SDK: Android 1.7.6 (Low-Latency Streaming)

Platform Downloads and Changes
Android Broadcast SDK 1.7.6

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

  • Fixed a rare bug that caused broadcasts to end prematurely with the message "Attempted to recv after receiving shutdown from peer."

Broadcast SDK Size: Android

Architecture Compressed Size Uncompressed Size
arm64-v8a 1.630 MB 4.689 MB
armeabi-v7a 1.520 MB 3.792 MB
x86_64 1.761 MB 4.748 MB
x86 1.825 MB 5.219 MB

August 22, 2023

Amazon IVS Player SDK 1.21.0

Platform Downloads and Changes

Web player 1.21.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.21.0/amazon-ivs-player.min.js

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

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

Reference documentation: https://aws.github.io/amazon-ivs-player-docs/1.21.0/android/
iOS Player 1.21.0

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

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

  • Added support for obtaining the most recently displayed video frame, via the new copyDisplayedPixelBuffer method on the IVSPlayerLayer class.

Mobile SDK Size: Android

Architecture Compressed Size Uncompressed Size
arm64-v8a 0.942 MB 2.662 MB
armeabi-v7a 0.823 MB 1.853 MB
x86_64 1.020 MB 2.726 MB
x86 0.993 MB 2.788 MB

Mobile SDK Size: iOS

Architecture Compressed Size Uncompressed Size
arm64 0.36 MB 0.87 MB

August 7, 2023

Amazon IVS Broadcast SDK: Web 1.5.0, Android 1.11.0, and iOS 1.11.0

Platform Downloads and Changes

Web Broadcast SDK 1.5.0

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

  • Fixed an issue in Safari where a race condition periodically causes an error in media-track retrieval

Android Broadcast SDK 1.11.0

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

iOS Broadcast SDK 1.11.0

Download for low-latency streaming: https://broadcast.live-video.net/1.11.0/AmazonIVSBroadcast.xcframework.zip

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

Broadcast SDK Size: Android

Architecture Compressed Size Uncompressed Size

arm64-v8a

1.659 MB

4.918 MB

armeabi-v7a

1.482 MB

3.590 MB

x86_64

1.804 MB

5.444 MB

x86

1.795 MB

5.160 MB

Broadcast SDK Size: iOS

Architecture Compressed Size Uncompressed Size

arm64

0.771 MB

1.879 MB

July 17, 2023

R2S3 Rendition Filtering & Thumbnail Enhancements

IVS customers can now control what renditions are generated for a stream when recording to Amazon S3 and what resolutions are generated for thumbnails. For more information, see:

  • Getting Started with IVS – In "Step 4: Create a Channel" > "Console Instructions," we updated screenshots and instructions.

  • Auto-Record to Amazon S3 – In "JSON Metadata Files," we added latest_thumbnail and updated thumbnail. In "Thumbnails" and "Discovering the Renditions of a Recording," we added rendition-resolution descriptions.

  • Costs – In "Storing Recorded Video," we updated screenshots.

  • IVS API Reference:

    • In ThumbnailConfiguration, we added resolution and storage. This affects the CreateRecordingConfiguration request and response, GetRecordingConfiguration response, and GetStreamSession response.

    • In ThumbnailConfiguration, we changed the targetIntervalSeconds minimum from 5 to 1 and updated the "Important" note to say it applies only to BASIC channels.

    • We added the RenditionConfiguration object.

    • We added renditionConfiguration to the RecordingConfiguration object. This affects three responses: CreateRecordingConfiguration, GetRecordingConfiguration, and GetStreamSession. We also added renditionConfiguration to the CreateRecordingConfiguration request.

July 14, 2023

Amazon IVS Player SDK 1.20.0

Platform Downloads and Changes

Web player 1.20.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.20.0/amazon-ivs-player.min.js

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

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

  • Fixed an issue when playing a live stream or recorded content on an iOS mobile browser, where player.getLiveLatency() calls return 0. (This was fixed starting with Web Player 1.17.0.)

  • Fixed the type definitions of the amazon-ivs-player npm package.

  • In the Web Player SDK Reference, added a new landing page and removed duplicate entries.

  • Added support for Video.js version 8+.
Android player 1.20.0

Reference documentation: https://aws.github.io/amazon-ivs-player-docs/1.20.0/android/
iOS Player 1.20.0

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

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

  • The iOS SDK now requires iOS 12.0 or higher. (iOS 11 is no longer supported.)

Mobile SDK Size: Android

Architecture Compressed Size Uncompressed Size
arm64-v8a 1.039 MB 2.922 MB
armeabi-v7a 0.909 MB 2.043 MB
x86_64 1.094 MB 3.069 MB
x86 1.126 MB 3.006 MB

Mobile SDK Size: iOS

Architecture Compressed Size Uncompressed Size
arm64 0.41 MB 0.99 MB

July 13, 2023

Amazon IVS Broadcast SDK: Web 1.4.0, Android 1.10.0, and iOS 1.10.0

Platform Downloads and Changes
Web Broadcast SDK 1.4.0

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

  • Fixed a bug where the SDK provided insufficient typing information for consumption by host applications.

  • Fixed a bug where a combination of leave() and subsequent refreshStrategy() could republish media even though we’ve left.

  • Fixed a bug where stageStreamsToPublish returning a single track (audio or video) can prevent clean updates when the strategy is refreshed.

  • Added a faster disconnect flow when the browser tab is closed.
All mobile (Android and iOS)

  • Improved the stability of stages by reducing occurrences of rare crashes.

  • Added a new sendTimedMetadata method to BroadcastSession, which allows sending a string through the same socket connection as the current broadcast. This string has timing information attached and can be received by the IVS Player SDK.

  • When a participant leaves a stage, the participant now has its published state updated to unpublished before onParticipantLeft is called on Android or participantDidLeave is called on iOS.
Android Broadcast SDK 1.10.0

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

  • Fixed a bug where rotating while reconnecting to a stage caused other participants to appear badly cropped.

  • Fixed an issue where the AudioStageStream device could not be cast to AudioDevice.

  • Fixed an issue where rapid background-to-foreground app switch caused subscribed video streams to be muted.
iOS Broadcast SDK 1.10.0

Download without stages: https://broadcast.live-video.net/1.10.0/AmazonIVSBroadcast.xcframework.zip

Download with stages: https://broadcast.live-video.net/1.10.0/AmazonIVSBroadcast-Stages.xcframework.zip

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

  • Fixed an issue where viewers could lose audio after a broadcast session is interrupted by a phone call. The workaround (restarting the broadcast session after a phone-call interruption) is no longer needed.

  • Fixes an issue that prevented multiple stages from existing and all being able to play audio.

  • When network loss happens suddenly, an ongoing Broadcast will now be stopped immediately instead of waiting for the connection to time out.

Broadcast SDK Size: Android

Architecture Compressed Size without Stage Functionality Uncompressed Size without Stage Functionality Compressed Size with Stage Functionality Uncompressed Size with Stage Functionality
arm64-v8a 1.517 MB 4.761 MB 5.324 MB 15.028 MB
armeabi-v7a 1.340 MB 3.433 MB 4.370 MB 9.489 MB
x86_64 1.653 MB 5.003 MB 5.802 MB 15.837 MB
x86 1.662 MB 5.287 MB 5.621 MB 15.964 MB

Broadcast SDK Size: iOS

Architecture Compressed Size without Stage Functionality Uncompressed Size without Stage Functionality Compressed Size with Stage Functionality Uncompressed Size with Stage Functionality
arm64 1.56 MB 3.84 MB 5.04 MB 10.85 MB

June 28, 2023

Viewer Session Revocation for Private Channels

IVS customers can now revoke the viewer session associated with an auth token, to prevent and stop playback using that token. For more information, see:

  • Setting Up Private Channels – We changed the "Token Schema" section and added "Revoke Viewer Sessions."

  • IVS API Reference – We added two endpoints (StartViewerSessionRevocation and BatchStartViewerSessionRevocation) and two objects (BatchStartViewerSessionRevocationError and BatchStartViewerSessionRevocationViewerSession).

June 27, 2023

Amazon IVS Broadcast SDK: iOS 1.9.1

Platform Downloads and Changes
iOS Broadcast SDK 1.9.1

Download without stages: https://broadcast.live-video.net/1.9.1/AmazonIVSBroadcast.xcframework.zip

Download with stages: https://broadcast.live-video.net/1.9.1/AmazonIVSBroadcast-Stages.xcframework.zip

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

  • Resolved an issue on iOS 16.5 and above where video bitrate gradually degrades after either: (1) approximately 20 minutes if not using auto-bitrate with b-frames turned off, or (2) approximately 20 minutes from reaching IVSVideoConfiguration.maxBitrate and the network connection has remained stable, with b-frames turned off.

Known issue: Viewers may lose audio after a broadcast session is interrupted by a phone call. The workaround is to restart the broadcast session after a phone-call interruption.

Broadcast SDK Size: iOS

Architecture Compressed Size without Stage Functionality Uncompressed Size without Stage Functionality Compressed Size with Stage Functionality Uncompressed Size with Stage Functionality
arm64 1.55 MB 3.77 MB 5.01 MB 10.77 MB

June 27, 2023

Amazon IVS Broadcast SDK 1.7.5

Platform Downloads and Changes
iOS Broadcast SDK 1.7.5

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

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

  • Resolved an issue on iOS 16.5 and above where video bitrate gradually degrades after either: (1) approximately 20 minutes if not using auto-bitrate with b-frames turned off, or (2) approximately 20 minutes from reaching IVSVideoConfiguration.maxBitrate and the network connection has remained stable, with b-frames turned off.

Broadcast SDK Size: iOS

Architecture Compressed Size Uncompressed Size
arm64 1.48 MB 3.43 MB

June 16, 2023

Amazon IVS Broadcast SDK: Web 1.3.3

Platform Downloads and Changes

Web Broadcast SDK 1.3.3

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

  • Fixed regressions in internal analytics used to support IVS multiple-hosts health.

June 2, 2023

Advanced Channel Types

This release introduces two new channel types – ADVANCED_SD and ADVANCED_HD – in addition to the existing BASIC and STANDARD types. Channel type determines the allowable playback and recording resolution and bitrate.

  • ADVANCED_SD: Video is transcoded; multiple qualities are generated from the original input, to automatically give viewers the best experience for their devices and network conditions. Input resolution can be up to 1080p and bitrate can be up to 8.5 Mbps; output is capped at SD quality (480p). You can select an optional transcode preset (see below). Audio for all renditions is transcoded, and an audio-only rendition is available.

  • ADVANCED_HD: Video is transcoded; multiple qualities are generated from the original input, to automatically give viewers the best experience for their devices and network conditions. Input resolution can be up to 1080p and bitrate can be up to 8.5 Mbps; output is capped at HD quality (720p). You can select an optional transcode preset (see below). Audio for all renditions is transcoded, and an audio-only rendition is available.

Optional transcode presets for the new channel types allow you to trade off available download bandwidth and video quality, to optimize the viewing experience. There are two presets:

  • Constrained bandwidth delivery uses a lower bitrate for each quality level. Use it if you have low download bandwidth and/or simple video content (e.g., talking heads).

  • Higher bandwidth delivery uses a higher bitrate for each quality level. Use it if you have high download bandwidth and/or complex video content (e.g., flashes and quick scene changes).

The Document History page lists related changes to the IVS User Guide and IVS API Reference.

June 1, 2023

Amazon IVS Broadcast SDK: Android 1.9.0 and iOS 1.9.0

Platform Downloads and Changes
All

  • Improved stability of stages by reducing occurrences of rare crashes.

  • Enhanced automated recovery from recurrent network disruptions.
Android Broadcast SDK 1.9.0

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

  • Fixed a bug where disconnecting wired headphones would result in an error when the user tried to switch to a non-default microphone on some devices.

  • Fixed a bug on some devices where an incorrect microphone is attached when switching microphones during a broadcasting session.

  • Fixed a crash when calling Presets methods before creating a BroadcastSession, Stage, or DeviceDiscovery object.

iOS Broadcast SDK 1.9.0

Download without stages: https://broadcast.live-video.net/1.9.0/AmazonIVSBroadcast.xcframework.zip

Download with stages: https://broadcast.live-video.net/1.9.0/AmazonIVSBroadcast-Stages.xcframework.zip

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

  • When you have joined a Stage and have not attached a microphone to the Stage, the new default behavior when entering the background is to stay in the Stage instead of leaving automatically. This enables the use case of listening to a Stage as a viewer-only participant while in the background.

  • Improved the handling of a stage’s Bluetooth device connect/disconnect.

  • Fixed an issue where audio is much lower when using setGain to mute and unmute.

  • When attaching a camera to a IVSBroadcastSession, the camera now configures itself based on the size and targetFramerate on the IVSVideoConfiguration.

  • The iOS SDK now requires iOS 12.0 or higher. (iOS 11 is no longer supported.)

Known issue: Viewers may lose audio after a broadcast session is interrupted by a phone call. The workaround is to restart the broadcast session after a phone-call interruption.

Broadcast SDK Size: Android

Architecture Compressed Size without Stage Functionality Uncompressed Size without Stage Functionality Compressed Size with Stage Functionality Uncompressed Size with Stage Functionality
arm64-v8a 1.638 MB 4.846 MB 5.451 MB 14.778 MB
armeabi-v7a 1.461 MB 3.532 MB 4.506 MB 9.475 MB
x86_64 1.770 MB 5.082 MB 5.753 MB 15.904 MB
x86 1.781 MB 5.366 MB 5.919 MB 15.708 MB

Broadcast SDK Size: iOS

Architectur9 Compressed Size without Stage Functionality Uncompressed Size without Stage Functionality Compressed Size with Stage Functionality Uncompressed Size with Stage Functionality
arm64 1.55 MB 3.77 MB 5.00 MB 10.77 MB

May 23, 2023

Amazon IVS Player SDK 1.19.0

Platform Downloads and Changes

Web player 1.19.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.19.0/amazon-ivs-player.min.js

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

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

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

  • Fixed an issue in auto quality mode, where the player stayed in the lowest quality after rebuffering, even when there was enough bandwidth to switch up.
iOS Player 1.19.0

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

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

Mobile SDK Size: Android

Architecture Compressed Size Uncompressed Size
arm64-v8a 1.013 MB 2.866 MB
armeabi-v7a 0.919 MB 2.272 MB
x86_64 1.084 MB 3.001 MB
x86 1.058 MB 2.702 MB

Mobile SDK Size: iOS

Architecture Compressed Size Uncompressed Size
arm64 0.41 MB 0.99 MB

May 16, 2023

Amazon IVS Broadcast SDK: iOS 1.8.1

Platform Downloads and Changes
iOS Broadcast SDK 1.8.1

Download without stages: https://broadcast.live-video.net/1.8.1/AmazonIVSBroadcast.xcframework.zip

Download with stages: https://broadcast.live-video.net/1.8.1/AmazonIVSBroadcast-Stages.xcframework.zip

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

  • Fixed a bitrate degradation issue on iOS 16.4. I, for both RTMP (without stages) and WebRTC (with stages). If you had implemented a workaround on your app (by enabling b frame), you can remove it after installing this update.

Broadcast SDK Size: iOS

Architecture Compressed Size without Stage Functionality Uncompressed Size without Stage Functionality Compressed Size with Stage Functionality Uncompressed Size with Stage Functionality
arm64 1.53 MB 3.73 MB 5.00 MB 10.73 MB

May 16, 2023

Amazon IVS Broadcast SDK 1.7.4

Platform Downloads and Changes
iOS Broadcast SDK 1.7.4

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

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

  • Fixed a bitrate degradation issue on iOS 16.4. If you had implemented a workaround on your app (by enabling b frame), you can remove it after installing this update.

Broadcast SDK Size: iOS

Architecture Compressed Size Uncompressed Size
arm64 1.48 MB 3.40 MB

May 11, 2023

Multiple Hosts Health

Now you can monitor the health of your IVS stages with multiple hosts. See:

May 1, 2023

Amazon IVS Web Broadcast SDK 1.3.2

Platform Downloads and Changes

Web Broadcast SDK 1.3.2

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

  • Fixed an issue where broadcasting a screenshare sometimes resulted in a black screen for live channels.

  • Fixed an issue where broadcasting a stage participant sometimes resulted in a black screen for live channels.

  • Fixed an analytics issue where duplicate unpublish and publish events were reported.

  • Fixed an issue where getStats was not always updated for RemoteStageStream objects.

  • Fixed an OverconstrainedError when trying to broadcast stage participants.

  • Added an enhancement: subscribe-only participants are ignored when the stage strategy shouldPublishParticipant is set to true.

April 27, 2023

Stage Participant Increase

The maximum number of participants who can be connected to a stage at once was increased from 12 to 1,000. At most 12 participants can be publishing to a stage at once and at most 1,000 can be subscribing at once. For more information see Enabling Multiple Hosts on an Amazon IVS Stream and Amazon IVS Service Quotas.

April 4, 2023

Amazon IVS Player SDK 1.18.0

Platform Downloads and Changes

Web player 1.18.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.18.0/amazon-ivs-player.min.js

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

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

  • Fixed a Safari issue where after refresh, in the console tab, "HTTP Response Error" – "Load failed" was displayed.
Android player 1.18.0

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

  • Fixed an issue with video playback when the playback rate is greater than 1x.
iOS Player 1.18.0

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

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

Mobile SDK Size: Android

Architecture Compressed Size Uncompressed Size
arm64-v8a 1.011 MB 2.854 MB
armeabi-v7a 0.916 MB 2.261 MB
x86_64 1.082 MB 2.990 MB
x86 1.055 MB 2.691 MB

Mobile SDK Size: iOS

Architecture Compressed Size Uncompressed Size
arm64 0.41 MB 0.99 MB

March 30, 2023

RTMP Support

Amazon IVS now supports RTMP (Real-Time Messaging Protocol) streaming, in addition to RTMPS. RTMPS is the secure version of RTMP. We recommend using RTMPS for secure ingest, unless you have specific and verified use cases that require RTMP.

RTMP streaming can be set up via:

  • IVS console – Use the Custom configuration button during initial channel setup or the Enable RTMP ingest toggle when modifying an existing channel.

  • API – Use the new insecureIngest field in CreateChannel or UpdateChannel requests. See the IVS API Reference.

For information on RTMP ingest endpoints, see Set Up Streaming Software, Broadcast Android SDK Guide, and Broadcast iOS SDK Guide.

April 29, 2023 correction: We changed Broadcast Android SDK Guide and Broadcast iOS SDK Guide to indicate that these SDKs support only RTMPS ingest (not insecure RTMP ingest).

March 29, 2023

Single-Use Tokens for Private Channels

In Generate and Sign Playback Tokens, we added to the payload an optional field, single-use-uuid, for generating a single-use token.

March 28, 2023

Amazon IVS Web Broadcast SDK 1.3.1

Platform Downloads and Changes

Web Broadcast SDK 1.3.1

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

  • There were no customer-facing changes in this release.

March 23, 2023

Support for Multiple Hosts on a Stream (Stage Resource)

This is the first release of new functionality: you can now combine video from multiple participants into one live stream. A stage is a virtual space where participants can exchange audio and video in real time. You can then broadcast a stage to channels to reach a larger audience, and you can build applications where audience members can be brought "on stage" to contribute to the live conversation. For details, see:

March 23, 2023

Amazon IVS Broadcast SDK: Android 1.8.0, iOS 1.8.0, Web 1.3.0

In conjunction with adding support for multiple hosts on a stream, the Android and iOS Broadcast SDKs were updated to support the new stage functionality.

Platform Downloads and Changes
All
Android Broadcast SDK 1.8.0

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

  • Depending on how your gradle file is configured (using classifier), you can download the SDK without or without stage support. The SDK without stage support is smaller. For details, see Broadcast SDK: Android Guide.

  • In Broadcast SDK: Android Guide, added "Add Multiple Hosts with the Stage SDK" and stage-related "Known Issues and Workarounds."

iOS Broadcast SDK 1.8.0

Download without stages: https://broadcast.live-video.net/1.8.0/AmazonIVSBroadcast.xcframework.zip

Download with stages: https://broadcast.live-video.net/1.8.0/AmazonIVSBroadcast-Stages.xcframework.zip

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

  • Depending on how your pod file is configured, you can download the SDK with or without stage support The SDK without stage support is smaller. For installation details, see Broadcast SDK: iOS Guide.

  • In Broadcast SDK: iOS Guide, added "Add Multiple Hosts with the Stage SDK" and stage-related "Known Issues and Workarounds."

  • Deprecated bitcode support from the SDK, as Apple has officially deprecated bitcode and no longer accepts it for App Store submissions. For more information, see the Xcode 14 release notes.
Web Broadcast SDK 1.3.0

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

  • In Broadcast SDK: Web Guide, added "Add Multiple Hosts with the Stage SDK" and stage-related "Known Issues and Workarounds."

Broadcast SDK Size: Android

Architecture Compressed Size without Stage Functionality Uncompressed Size without Stage Functionality Compressed Size with Stage Functionality Uncompressed Size with Stage Functionality
arm64-v8a 1.767 MB 5.192 MB 5.886 MB 16.398 MB
armeabi-v7a 1.656 MB 4.263 MB 4.946 MB 10.924 MB
x86_64 1.967 MB 5.735 MB 6.316 MB 17.376 MB
x86 1.894 MB 5.196 MB 6.387 MB 16.730 MB

Broadcast SDK Size: iOS

Architecture Compressed Size without Stage Functionality Uncompressed Size without Stage Functionality Compressed Size with Stage Functionality Uncompressed Size with Stage Functionality
arm64 1.53 MB 3.73 MB 5.03 MB 10.67 MB

March 2, 2023

Amazon IVS Broadcast SDK: Android 1.7.3

Platform Downloads and Changes
Android Broadcast SDK 1.7.3

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

  • Fixed an issue where custom image sources failed to work properly on devices with the MediaTek Dimensity 700 SoC.

Broadcast SDK Size: Android

Architecture Compressed Size Uncompressed Size
arm64-v8a 1.629 MB 4.688 MB
armeabi-v7a 1.520 MB 3.792 MB
x86_64 1.825 MB 5.218 MB
x86 1.629 MB 4.688 MB

February 28, 2023

Amazon IVS Player SDK 1.17.0

Platform Downloads and Changes

Web player 1.17.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.17.0/amazon-ivs-player.min.js

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

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

  • Implemented support for the getLiveLatency method for mobile Safari.
Android player 1.17.0

Reference documentation: https://aws.github.io/amazon-ivs-player-docs/1.17.0/android/
iOS Player 1.17.0

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

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

  • Deprecated bitcode support from the SDK, as Apple has officially deprecated bitcode and no longer accepts it for App Store submissions. For more information, see the Xcode 14 release notes.

Mobile SDK Size: Android

Architecture Compressed Size Uncompressed Size
arm64-v8a 1.009 MB 2.853 MB
armeabi-v7a 0.915 MB 2.260 MB
x86_64 1.081 MB 2.988 MB
x86 1.054 MB 2.690 MB

Mobile SDK Size: iOS

Architecture Compressed Size Uncompressed Size
arm64 0.41 MB 0.99 MB

February 16, 2023

Byte-Range Tags and Manifest Files for Auto-Record to S3

The auto-record-to-S3 feature now supports byte-range playlist generation, in addition to standard HLS playlists. For more information, see Auto-Record to Amazon S3 ("Recording Contents," "Byte-Range Playlists," and new byte_range_playlist fields in JSON examples for recording_started and recording_ended).

January 31, 2023

Amazon IVS Chat Client Messaging SDK: Android 1.1.0

Platform Downloads and Changes
Android Chat Client Messaging SDK 1.1.0

Reference documentation: https://aws.github.io/amazon-ivs-chat-messaging-sdk-android/1.1.0/

  • To support Kotlin Coroutines, we added new IVS Chat Messaging APIs in the com.amazonaws.ivs.chat.messaging.coroutines package. Also see the new Kotlin Coroutines tutorial; part 1 (of 2) is Chat Rooms.

Chat Client Messaging SDK Size: Android

Architecture Compressed Size Uncompressed Size
All architectures (bytecode) 89 KB 92 KB

January 17, 2023

Amazon IVS Player SDK 1.16.0

Platform Downloads and Changes

Web player 1.16.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.16.0/amazon-ivs-player.min.js

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

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

  • Updated SDK documentation to note which methods are not supported on iOS mobile browsers.
Android player 1.16.0

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

  • Added the setOrigin method to enable inclusion of an Origin request header with playback requests. Also see in Token Schema for the new strict-origin-enforcement field.
iOS Player 1.16.0

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

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

  • Added the setOrigin method to enable inclusion of an Origin request header with playback requests. Also see in Token Schema for the new strict-origin-enforcement field.

Mobile SDK Size: Android

Architecture Compressed Size Uncompressed Size
arm64-v8a 1.009 MB 2.852 MB
armeabi-v7a 0.914 MB 2.258 MB
x86_64 1.054 MB 2.689 MB
x86 1.080 MB 2.987 MB

Mobile SDK Size: iOS

Architecture Compressed Size Uncompressed Size
arm64 0.41 MB 0.99 MB

December 9, 2022

Timestamp Added to Auto-Record to S3 Manifest Files

When Auto-Record to Amazon S3 is enabled, HLS manifest files are created. Those files now contain HLS Program-Date-Time (PDT) tags indicating the wall-clock time for every HLS segment when produced, using the UTC ISO-8601 format.

December 6, 2022

Amazon IVS Broadcast SDK: Android 1.7.2

Platform Downloads and Changes
Android Broadcast SDK 1.7.2

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

  • Fixed a bug where the Device.Descriptior returned by a non-Camera device subclassing SurfaceSource would provide a unique deviceId and urn on each call, making those properties unreliable for identifying devices.

  • Fixed a bug where the preferredAudioInput property on a BroadcastConfiguration.Mixer.Slot was null when queried by Mixer.getSlots(), if the associated slot had a preferredAudioInput value of Device.Descriptor.DeviceType.MICROPHONE when it was added.

Broadcast SDK Size: Android

Architecture Compressed Size Uncompressed Size
arm64-v8a

1.628 MB

 4.682 MB
armeabi-v7a 1.519 MB 3.786 MB
x86_64 1.701 MB 5.075 MB
x86 1.637 MB 4.605 MB

November 17, 2022

Chat Logging

This is the first release of new functionality. You can now create logging configurations to enable storage of messages sent to your chat rooms. For more information, see:

November 9, 2022

Amazon IVS Chat Client Messaging SDK: JavaScript 1.0.2

Platform Downloads and Changes
JavaScript Chat Client Messaging SDK 1.0.2

Reference documentation: https://aws.github.io/amazon-ivs-chat-messaging-sdk-js/1.0.2/

  • Fixed an issue that affected Firefox: clients erroneously received a socket error when they were disconnected from a chat room using the DisconnectUser endpoint.

November 1, 2022

Amazon IVS Player SDK 1.14.0

Platform Downloads and Changes

All

  • Improved player stability by reducing occurrences of rare crashes.

Web player 1.14.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.14.0/amazon-ivs-player.min.js

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

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

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

  • Added the getErrorCode() method to the ErrorType class.
iOS Player 1.14.0

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

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

  • Made public the IVS Player setQuality:adaptive: method.

Mobile SDK Size: Android

Architecture Compressed Size Uncompressed Size
arm64-v8a 1.004 MB 2.840 MB
armeabi-v7a 0.909 MB 2.248 MB
x86_64 1.049 MB 2.678 MB
x86 1.075 MB 2.975 MB

Mobile SDK Size: iOS

Architecture Compressed Size Uncompressed Size
arm64 0.41 MB 0.99 MB

October 18, 2022

Amazon IVS Chat Client Messaging SDK: JavaScript 1.0.1

Platform Downloads and Changes
JavaScript Chat Client Messaging SDK 1.0.1

Reference documentation: https://aws.github.io/amazon-ivs-chat-messaging-sdk-js/1.0.1/

October 6, 2022

Amazon IVS Broadcast SDK 1.7.1

Platform Downloads and Changes
iOS Broadcast SDK 1.7.1

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

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

  • Fixed a linker error when directly linking against a few classes.

  • Removed init and new functions on classes that should never be instantiated by the host application.

  • Slots using the camera provided by the SDK and configured to a 9:16 portrait aspect ratio now correctly use the matching 9:16 camera ratio. (Previously they used a 3:4 camera ratio.) Slots using the FIT aspect mode now use the entire space. (Previously they were letterboxed.)

Broadcast SDK Size: iOS

Architecture Compressed Size Uncompressed Size
arm64 1.48 MB 3.40 MB

September 22, 2022

Amazon IVS Broadcast SDK 1.7.0

Note: There was no 1.6.0 release.

Platform Downloads and Changes
All

  • Improved stability by reducing occurrences of rare crashes.

  • Added an AutomaticBitrateProfile enum on VideoConfiguration. This controls the rate at which the ABR algorithm adjusts the video bitrate.

  • Added the onTransmissionStatsChanged method. It contains more detailed transmission statistics than onBroadcastQualityChanged and onNetworkHealthChanged. We deprecated the latter two methods and we recommend you use onTransmissionStatsChanged instead.
Android Broadcast SDK 1.7.0

Reference documentation: https://aws.github.io/amazon-ivs-broadcast-docs/1.7.0/android/
iOS Broadcast SDK 1.7.0

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

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

  • Added IVSBroadcastSessionAudioSessionStrategy.PlayAndRecordDefaultToSpeaker, which allows developers to specify whether devices with handsets (e.g., iPhones) prefer the speaker over the headset.

Broadcast SDK Size: Android

Architecture Compressed Size Uncompressed Size
arm64-v8a 1.628 MB 4.682 MB
armeabi-v7a 1.519 MB 3.786 MB
x86_64 1.824 MB 5.212 MB
x86 1.760 MB 4.742 MB

Broadcast SDK Size: iOS

Architecture Compressed Size Uncompressed Size
arm64 1.47 MB 3.40 MB

September 20, 2022

Amazon IVS Player SDK 1.13.0

Platform Downloads and Changes

Web player 1.13.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.13.0/amazon-ivs-player.min.js

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

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

  • Added support for the VideoJS seeking() function.

  • Removed unused types (CaptureEventTypes) which caused development issues.

  • Fixed intermittent MediaSource errors on network recovery.

Known issue: The Sawmill Enabled log may appear when you open the console. This internal log is meant to be hidden, as it does not affect customers. If you see it, ignore it.

Android player 1.13.0

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

  • Added additional guards to prevent playback crashes related to race conditions.

  • Made stability improvements to ABR bandwidth estimation.
iOS Player 1.13.0

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

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

  • Fixed a bug where audio-only playback could stop while playing in the background.

  • Added additional guards to prevent playback crashes related to race conditions.

  • Made stability improvements to ABR bandwidth estimation.

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

  • Changed the setQuality: method of the IVSPlayer class so it ignores invalid values.

Mobile SDK Size: Android

Architecture Compressed Size Uncompressed Size
arm64-v8a 1.000 MB 2.829 MB
armeabi-v7a 0.904 MB 2.237 MB
x86_64 1.070 MB 2.962 MB
x86 1.045 MB 2.665 MB

Mobile SDK Size: iOS

Architecture Compressed Size Uncompressed Size
arm64 0.44 MB 1.06 MB

September 15, 2022

Vertical Video Improvement (Final Release)

Today we began rolling out the changes documented in Vertical Video Improvement for all Amazon IVS customers. It will take 2-3 days for the changes to propagate across all accounts.

September 12, 2022

Amazon IVS Broadcast SDK 1.5.2: iOS

Platform Downloads and Changes

iOS Broadcast SDK 1.5.2

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

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

  • Fixed a rare crash when the network connection is lost very soon after a broadcast is stopped but before the broadcast shutdown has completed.

  • Fixed a memory-growth issue when a retry loop repeatedly tries to restart a broadcast after a fatal error.

Broadcast SDK Size: iOS

Architecture Compressed Size Uncompressed Size
arm64 1.39 MB 3.20 MB

September 8, 2022

Amazon IVS Chat Client Messaging SDK: Android 1.0.0 and iOS 1.0.0

Platform Downloads and Changes
Android Chat Client Messaging SDK 1.0.0

Reference documentation: https://aws.github.io/amazon-ivs-chat-messaging-sdk-android/1.0.0/
iOS Chat Client Messaging SDK 1.0.0

Reference documentation: https://aws.github.io/amazon-ivs-chat-messaging-sdk-ios/1.0.0/

Chat Client Messaging SDK Size: Android

Architecture Compressed Size Uncompressed Size
All architectures (bytecode) 53 KB 58 KB

Chat Client Messaging SDK Size: iOS

Architecture Compressed Size Uncompressed Size
ios-arm64_x86_64-simulator (bitcode) 484 KB 2.4 MB
ios-arm64_x86_64-simulator 484 KB 2.4 MB
ios-arm64 (bitcode) 1.1 MB 3.1 MB
ios-arm64 233 KB 1.2 MB

September 2, 2022

Amazon IVS Web Broadcast SDK 1.2.0

Platform Downloads and Changes

Web Broadcast SDK

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

  • Fixed bundle type definitions when the npm pack is run.

  • Added a preset configuration to support 1080 BASIC channels.

August 30, 2022

Merge Fragmented Streams

This is the first release of new functionality. If your stream is configured for Auto-Record to Amazon S3, you can now specify a window of time during which, if your stream is interrupted and a new stream is started, Amazon IVS tries to record to the same S3 prefix as the previous stream. In other words, if a broadcast disconnects and then reconnects within the specified interval, the multiple streams are considered a single broadcast and merged. For more information, see:

August 9, 2022

Amazon IVS Web Player SDK 1.12.0

Platform Downloads and Changes

Web player 1.12.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.12.0/amazon-ivs-player.min.js

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

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

  • Added additional guards to prevent playback crashes related to race conditions.

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.

  • Fixed a memory leak when providing a delegate directly to the IVSBroadcastSession's initializer. (A workaround was to set the delegate property afterwards.)

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

  • This is the initial release of the Amazon IVS Web Broadcast SDK.

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.

Oct 12, 2023 update: These documents were combined into Monitoring IVS Low-Latency Streaming.

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).

    Oct 12, 2023 update: This CloudWatch document was deleted and the content was moved to Monitoring IVS Low-Latency Streaming.

  • 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

Platform Downloads and Changes
All

Fixed the closed-caption decoder to handle captions that are inserted out of order.

Web player 1.4.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.4.1/amazon-ivs-player.min.js

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

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

Reference documentation: https://aws.github.io/amazon-ivs-player-docs/1.4.1/android/
iOS Player 1.4.1

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

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

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

Platform Downloads and Changes
Android Broadcast SDK 1.0.0

Reference documentation: https://aws.github.io/amazon-ivs-broadcast-docs/1.0.0/android/
iOS Broadcast SDK 1.0.0

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

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

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.

Oct 12, 2023 update: This CloudWatch document was deleted and the content was moved to Monitoring IVS Low-Latency Streaming.

The names of related service quotas were updated to match the new metrics. See Service Quotas (Low-Latency Streaming).

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 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 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 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 Service Quotas (Low-Latency Streaming) 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 Service Quotas (Low-Latency Streaming) and Using Amazon EventBridge with 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 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.