Amazon Interactive Video Service Release Notes - Amazon Interactive Video Service

Amazon Interactive Video Service Release Notes

July 27, 2021

Amazon IVS Broadcast SDK: Android 1.0.0 and iOS 1.0.0

June 1, 2021

Amazon IVS Player SDK: Android 1.3.3 and iOS 1.3.3

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

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

iOS Player 1.3.3

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

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

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

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

May 19, 2021

Amazon IVS Player SDK: Android 1.3.2

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

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

May 5, 2021

Amazon IVS Player SDK 1.3

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

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

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

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

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

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

  • Improved player stability by reducing occurrences of rare crashes.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Android player 1.3.0

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

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

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

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

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

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

  • Removed BuildConfig version properties from the library.

iOS Player 1.3.0

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

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

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

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

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

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

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

April 26, 2021

Service Quotas Integration with CloudWatch Usage Metrics

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

April 13, 2021

New CloudWatch Metrics

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

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

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

April 7, 2021

Auto-Record to S3 (R2S3)

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

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

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

January 28, 2021

Amazon IVS Player SDK: JW Player Integration 1.2.0

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

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

December 16, 2020

Amazon IVS Player: SDK for Android 1.2.1

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

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

November 23, 2020

Amazon IVS Player SDK 1.2.0

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

Web player 1.2.0 & Video.js integration

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

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

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

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

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

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

Android player 1.2.0

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

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

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

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

iOS Player 1.2.0

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

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

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

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

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

November 12, 2020

New Event Field, stream_id

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

November 9, 2020

Add Metadata Viewing to Console

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

October 30, 2020

CloudFormation Support

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

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

October 27, 2020

Higher Limits for Channels, CCV, and CCB

We increased three service-quota limits:

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

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

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

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

October 9, 2020

New Service Quotas and EventBridge Event

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

Amazon IVS Player: SDK for Web 1.1.2

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

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

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

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

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

October 7, 2020

Amazon IVS Player SDK 1.1.0

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

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

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

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

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

Web Player 1.1.0

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

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

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

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

Known Issues:

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

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

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

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

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

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

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

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

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

Android Player 1.1.0

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

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

iOS Player 1.1.0

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

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

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

September 14, 2020

New Event Field, channel_name

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

August 19, 2020

Playback Authorization (Private Channels)

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

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

August 11, 2020

Amazon IVS Player: SDK for iOS 1.0.6

Download: <deprecated>

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

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

August 5, 2020

Using Amazon EventBridge with Amazon IVS

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

July 15, 2020

Player Version 1.0

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

Platform Downloads and Changes
All

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

Web Player 1.0.0

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

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

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

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

Known Issues:

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

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

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

Android Player 1.0.0

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

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

iOS Player 1.0.0

Download: <deprecated>

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

Known Issues:

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

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