Release Notes (Real-Time Streaming) - Amazon IVS

Release Notes (Real-Time Streaming)

June 20, 2024

Individual Participant Recording

Individual participant recording allows IVS real-time streaming customers to record IVS stage publishers individually into S3 buckets. See Recording, Individual Participant Recording, and changes in the Real-Time Streaming API Reference. (For specific documentation changes, see the Document History.)

June 13, 2024

Amazon IVS Broadcast SDK: Android 1.19.0, iOS 1.19.0 (Real-Time 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.

  • Improved connection recovery time on devices transitioning from wifi to cellular connections. This change requires the CHANGE_NETWORK_STATE permission.

iOS Broadcast SDK 1.19.0

Download for real-time streaming: https://broadcast.live-video.net/1.19.0/AmazonIVSBroadcast-Stages.xcframework.zip

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

  • Minor bug fixes.

Broadcast SDK Size: Android

Architecture Compressed Size Uncompressed Size

arm64-v8a

5.304 MB

13.340 MB

armeabi-v7a

4.598 MB

9.299 MB

x86_64

5.495 MB

14.207 MB

x86

5.694 MB

14.625 MB

Broadcast SDK Size: iOS

Architecture Compressed Size Uncompressed Size

arm64

3.393 MB

7.949 MB

June 13, 2024

IVS Broadcast SDK: Web 1.13.0 (Real-Time Streaming)

Platform Downloads and Changes

Web Broadcast SDK 1.13.0

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

  • Updated the duration of event change behavior for StageEvents.STAGE_PARTICIPANT_SUBSCRIBE_STATE_CHANGED and StageEvents.STAGE_PARTICIPANT_PUBLISH_STATE_CHANGED. Participants now remain in the ATTEMPTING_SUBSCRIBE or ATTEMPTING_PUBLISH state for a longer time, until the ERRORED event is fired.

  • Added the StageEvents.ERROR event for listening to errors encountered by the SDK. See Error Handling in the Real-Time Broadcast SDK: Web Guide for more information.

May 20, 2024

IVS Broadcast SDK: Web 1.12.0 (Real-Time Streaming)

Platform Downloads and Changes

Web Broadcast SDK 1.12.0

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

  • Improved retry handling for publish and subscribe operations.

  • Improved analytics, specifically latency and audio-quality measurement.

May 16, 2024

Amazon IVS Broadcast SDK: Android 1.18.0, iOS 1.18.0 (Real-Time 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

  • The SDK now sends specific error codes when a connected Stage is deleted by the AWS control plane, or when the token in use is revoked.

  • Minor bug fixes.

iOS Broadcast SDK 1.18.0

Download for real-time streaming: https://broadcast.live-video.net/1.18.0/AmazonIVSBroadcast-Stages.xcframework.zip

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

  • The SDK now sends specific error codes when a connected Stage is deleted by the AWS control plane, or when the token in use is revoked.

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

Broadcast SDK Size: Android

Architecture Compressed Size Uncompressed Size

arm64-v8a

5.275 MB

13.279 MB

armeabi-v7a

4.573 MB

9.254 MB

x86_64

5.472 MB

14.142 MB

x86

5.664 MB

14.554 MB

Broadcast SDK Size: iOS

Architecture Compressed Size Uncompressed Size

arm64

3.393 MB

7.916 MB

May 6, 2024

IVS Broadcast SDK: Web 1.11.0 (Real-Time Streaming)

Platform Downloads and Changes

Web Broadcast SDK 1.11.0

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

  • Fixed an edge case where the SDK did not attempt to recover on a stage DISCONNECT.

  • Updated the error message for a join() timeout error. Instead of "InitialConnectTimedOut after 10 seconds," the SDK now returns "Operation timed out."

April 30, 2024

IVS Broadcast SDK: Web 1.10.1 (Real-Time 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 (Real-Time 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 real-time streaming: https://broadcast.live-video.net/1.15.2/AmazonIVSBroadcast-Stages.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

5.244 MB

13.198 MB

armeabi-v7a

4.543 MB

9.192 MB

x86_64

5.437 MB

14.051 MB

x86

5.631 MB

14.461 MB

Broadcast SDK Size: iOS

Architecture Compressed Size Uncompressed Size

arm64

3.359 MB

7.836 MB

April 22, 2024

Amazon IVS Broadcast SDK: Android 1.17.0, iOS 1.17.0 (Real-Time 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

  • Fixed a rare crash that can occur while publishing.

iOS Broadcast SDK 1.17.0

Download for real-time streaming: https://broadcast.live-video.net/1.17.0/AmazonIVSBroadcast-Stages.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

5.273 MB

13.275 MB

armeabi-v7a

4.571 MB

9.251 MB

x86_64

5.468 MB

14.137 MB

x86

5.662 MB

14.549 MB

Broadcast SDK Size: iOS

Architecture Compressed Size Uncompressed Size

arm64

3.388 MB

7.916 MB

March 21, 2024

Amazon IVS Broadcast SDK: Android 1.16.0, iOS 1.16.0, Web 1.10.0 (Real-Time Streaming)

Platform Downloads and Changes

Web Broadcast SDK 1.10.0

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

  • Fixed an intermittent error when cleaning up connections after unsubscribing or leaving a stage.

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.

  • Added a function for querying camera zoom capabilities and setting the zoom factor.

iOS Broadcast SDK 1.16.0

Download for real-time streaming: https://broadcast.live-video.net/1.16.0/AmazonIVSBroadcast-Stages.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

5.253 MB

13.21 MB

armeabi-v7a

4.551 MB

9.204 MB

x86_64

5.447 MB

14.070 MB

x86

5.640 MB

14.480 MB

Broadcast SDK Size: iOS

Architecture Compressed Size Uncompressed Size

arm64

3.361 MB

7.836 MB

March 13, 2024

Amazon IVS Broadcast SDK: Android 1.15.1, iOS 1.15.1 (Real-Time 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

  • Fixed a rare crash when subscribing to a remote participant.

iOS Broadcast SDK 1.15.1

Download for real-time streaming: https://broadcast.live-video.net/1.15.1/AmazonIVSBroadcast-Stages.xcframework.zip

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

  • Fixed a rare crash when subscribing to a remote participant.

Broadcast SDK Size: Android

Architecture Compressed Size Uncompressed Size

arm64-v8a

5.243 MB

13.194 MB

armeabi-v7a

4.541 MB

9.188 MB

x86_64

5.628 MB

14.455 MB

x86

5.434 MB

14.046 MB

Broadcast SDK Size: iOS

Architecture Compressed Size Uncompressed Size

arm64

3.358 MB

7.820 MB

March 13, 2024

Server-Side Composition API Updates

We introduced new properties to the GridConfiguration and a new picture-in-picture layout, enhancing the customization options for compositions. For specific documentation changes, see the Document History (see the table of API Reference changes).

Important: Ensure your application does not depend on the specific features of the current layout, such as size and position of tiles. Visual improvements to layouts can be introduced at any time.

March 8, 2024

Server-Side Composition Layout Updates

Today we enabled the changes to the default grid layout that are described in the February 7, 2024 entry.

February 22, 2024

Amazon IVS Broadcast SDK: Android 1.15.0, iOS 1.15.0, Web 1.9.0 (Real-Time Streaming)

Platform Downloads and Changes

Web Broadcast SDK 1.9.0

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

  • Improved internal error handling.

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 real-time streaming: https://broadcast.live-video.net/1.15.0/AmazonIVSBroadcast-Stages.xcframework.zip

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

  • Added an AVPictureInPictureController extension to allow creating a new instance with an IVSImagePreviewView.

  • Added a new API on IVSImageDevice to create an AVSampleBufferDisplayLayer to which the device renders.

  • Fixed a low bitrate issue on devices running iOS 17 and later.

  • Minor bug fixes.

Broadcast SDK Size: Android

Architecture Compressed Size Uncompressed Size

arm64-v8a

5.243 MB

13.194 MB

armeabi-v7a

4.541 MB

9.188 MB

x86_64

5.628 MB

14.455 MB

x86

5.434 MB

14.046 MB

Broadcast SDK Size: iOS

Architecture Compressed Size Uncompressed Size

arm64

3.358 MB

7.820 MB

February 7, 2024

Server-Side Composition Layout Updates

This release introduces visual improvements to the default grid layout. These changes will optimize how video is displayed and reduce blank space. These changes will be enabled on March 7, 2024.

Important: Ensure your application does not depend on the specific features of the current layout, such as size and position of tiles. Visual improvements to layouts can be introduced at any time.

Description of the Change Old New

Automatically selects the optimal placement of participants to maximize video size.

Enhances space utilization by reducing gaps and minimizing black bars.

Adds a new “camera off” indicator for clear visibility of participants not sharing video.

Improves space utilization and proportions for portrait use cases.

Enhances space utilization in portrait use cases by minimizing spacing between participants and reducing letterboxing or pillarboxing.

February 6, 2024

OBS and WHIP Support

IVS can be used with WHIP-compatible encoders like OBS to publish to IVS real-time streaming. WHIP (WebRTC-HTTP Ingestion Protocol) is an IETF draft developed to standardize WebRTC ingestion. See the new page on OBS and WHIP Support.

February 1, 2024

Amazon IVS Broadcast SDK: Android 1.14.1, iOS 1.14.1, Web 1.8.0 (Real-Time Streaming)

Platform Downloads and Changes

Web Broadcast SDK 1.8.0

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

  • Layered encoding with simulcast is now disabled by default.

  • Fixed an issue where a Stage instance would not cleanly disconnect when a Stage was deleted, or when a participant was disconnected from the server. The SDK now emits a STAGE_CONNECTION_STATE_CHANGED event with a state of DISCONNECTED (instead of ERRORED and then CONNECTING).

  • Fixed issue where publishing would fail when updating the strategy with empty audio or video tracks.

Android Broadcast SDK 1.14.1

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

  • Layered encoding with simulcast is now disabled by default.

  • Updated libWebRTC from M108 to M119.

  • Fixed several crashes to improve overall stability.

  • Added support for stereo publishing. This can be enabled through the StageAudioConfiguration object.

  • Fixed a bug causing a black feed from participants after joining a session.

  • Updated internal libWebRTC references to avoid symbol conflicts when other libWebRTC versions are included in the same host application.

iOS Broadcast SDK 1.14.1

Download for real-time streaming: https://broadcast.live-video.net/1.14.1/AmazonIVSBroadcast-Stages.xcframework.zip

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

  • Layered encoding with simulcast is now disabled by default.

  • Updated libWebRTC from M108 to M119.

  • Fixed several crashes to improve overall stability.

  • Added support for stereo publishing. This can be enabled through IVSLocalStageStreamAudioConfiguration.

  • Fixed a crash when enabling audio-only mode for other participants.

  • Improved TTV and reduced binary size.

Broadcast SDK Size: Android

Architecture Compressed Size Uncompressed Size

arm64-v8a

5.223 MB

13.118 MB

armeabi-v7a

4.524 MB

9.134 MB

x86_64

5.418 MB

13.955 MB

x86

5.61 MB

14.369 MB

Broadcast SDK Size: iOS

Architecture Compressed Size Uncompressed Size

arm64

3.350 MB

7.790 MB

January 3, 2024

Amazon IVS Broadcast SDK: Android 1.13.4, iOS 1.13.4, Web 1.7.0 (Real-Time Streaming)

Platform Downloads and Changes

Web Broadcast SDK 1.7.0

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

  • Improved time-to-video for subscribers joining stages.

  • Removed the minAudioBitrateKbps property (it was unused).

  • Improved network recovery during internet outages or changes.

Android Broadcast SDK 1.13.4

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

  • StageAudioConfiguration now supports setting whether echo cancellation should be enabled.

iOS Broadcast SDK 1.13.4

Download for real-time streaming: https://broadcast.live-video.net/1.13.4/AmazonIVSBroadcast-Stages.xcframework.zip

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

  • On iOS, we improved the audio engine for both recording and playback with a focus on stability and recoverability. This enhances support for route changes while in use, improves battery recovery for edge cases, and reduces the amount of main thread blocking.

  • Fixed an issue where the microphone might stay active even after it was detached from a stage, leaving the iOS privacy indicator on. (The SDK was not processing incoming audio at the time.)

Broadcast SDK Size: Android

Architecture Compressed Size Uncompressed Size

arm64-v8a

5.187 MB

13.025 MB

armeabi-v7a

4.491 MB

9.056 MB

x86_64

5.359 MB

13.829 MB

x86

5.553 MB

14.214 MB

Broadcast SDK Size: iOS

Architecture Compressed Size Uncompressed Size

arm64

3.45 MB

7.84 MB

December 7, 2023

New CloudWatch Metrics

We renamed the PacketLoss (Stage) metric to be DownloadPacketLoss (Stage). We also released additional CloudWatch metrics for IVS real-time streaming:

  • DownloadPacketLoss (Stage,Participant)

  • DroppedFrames (Stage,Participant)

  • SubscribeBitrate (Stage,Participant,MediaType)

For details, see Monitoring IVS Real-Time Streaming.

December 4, 2023

Amazon IVS Broadcast SDK: Android 1.13.2 and iOS 1.13.2 (Real-Time Streaming)

Platform Downloads and Changes

All mobile (Android and iOS)

  • Noise-suppression configuration is available for developers to enable/disable for publishing.

Android Broadcast SDK 1.13.2

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

  • Improved the time it takes to load the video (TTV) when joining the first stage in a session.

iOS Broadcast SDK 1.13.2

Download for real-time streaming: https://broadcast.live-video.net/1.13.2/AmazonIVSBroadcast-Stages.xcframework.zip

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

  • No changes in the real-time SDK.

Broadcast SDK Size: Android

Architecture Compressed Size Uncompressed Size

arm64-v8a

5.177 MB

13.01 MB

armeabi-v7a

4.485 MB

9.045 MB

x86_64

5.352 MB

13.808 MB

x86

5.547 MB

14.192 MB

Broadcast SDK Size: iOS

Architecture Compressed Size Uncompressed Size

arm64

3.45 MB

7.82 MB

November 21, 2023

Amazon IVS Broadcast SDK: Android 1.13.1 (Real-Time 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

  • Fixed an issue that caused a crash when quickly leaving, releasing, and rejoining the same stage.

Broadcast SDK Size: Android

Architecture Compressed Size Uncompressed Size

arm64-v8a

5.177 MB

13.102 MB

armeabi-v7a

4.485 MB

9.046 MB

x86_64

5.353 MB

13.809 MB

x86

5.547 MB

14.192 MB

November 17, 2023

Amazon IVS Broadcast SDK: Android 1.13.0 and iOS 1.13.0 (Real-Time Streaming)

Platform Downloads and Changes

All mobile (Android and iOS)

  • Updated Streaming Optimizations. Among other things, the "Adaptive Streaming: Layered Encoding with Simulcast" feature now requires explicit opt-in and is supported only in recent versions of the SDK.

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

  • Improved the time it takes to load the video (TTV) when joining a stage.

  • Improved the experience with Bluetooth devices.

  • Optimized SDK CPU and memory usage, and reduced the library size.

  • Added the StageAudioManager class, which can be used to set audio capture and playback parameters, including presets for voice communication, media playback and more. For details, see the new page, IVS Broadcast SDK: Mobile Audio Modes.

  • Added a new requestQualityStats function to display structured quality events from WebRTC stats.

  • Added a new function to update the audio bitrate. It is set on LocalStageStream objects just like the video configuration, but through a new audio configuration object.

Android Broadcast SDK 1.13.0

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

  • All methods on the StageRenderer interface are now optional.

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

  • Fixed the case where onFrame callback for remote participant is called at the wrong time with the wrong size.

  • SurfaceSource # getInputSurface is now annotated with @Nullable. Your code should check it before using it.

  • Added UserId and attributes to ParticipantInfo. The UserId and attributes properties are embedded in the token and applications can retrieve them via ParticipantInfo whenever a participant joins.

  • Camera capture and preview rendering now defaults to 720 x 1280 or publish resolution (whichever is greater) at 15 fps. You can adjust the resolution and/or the fps using StageVideoConfiguration # setCameraCaptureQuality.

  • IllegalArgumentException thrown when setting configuration properties now includes the provided value in the exception message.

iOS Broadcast SDK 1.13.0

Download for real-time streaming: https://broadcast.live-video.net/1.13.0/AmazonIVSBroadcast-Stages.xcframework.zip

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

  • Fixed the issue where the SDK does not change video configuration if the video configuration is updated before publishing.

  • Incorporated the Google fix for a LibVPX security vulnerability (CVE-2023-5217). (Note that the Android SDK did not require any changes for this issue.)

  • Applications using other libraries that include libWebRTC will no longer have conflicts with the IVS Broadcast SDK.

  • All methods on the IVSStageRenderer protocol are now marked @optional.

  • Microphones and cameras returned by our SDKs now have a guaranteed sorting order, as documented in the SDKs themselves.

  • Multiple cameras can now have a value of true for their isDefault property, one for each position as determined by the operating system.

  • Added IVSStageAudioManager, which allows precise control over the underlying AVAudioSession to enable a wider variety of use cases for Stages functionality.

  • Added UserId to ParticipantInfo.

Broadcast SDK Size: Android

Architecture Compressed Size Uncompressed Size

arm64-v8a

5.17 MB

13.00 MB

armeabi-v7a

4.48 MB

9.04 MB

x86_64

5.35 MB

13.80 MB

x86

5.54 MB

14.18 MB

Broadcast SDK Size: iOS

Architecture Compressed Size Uncompressed Size

arm64

3.45 MB

7.84 MB

November 16, 2023

Composite Recording

This new feature enables recording the composited view of an IVS Stage to an Amazon S3 bucket. For more information, see:

  • Composite Recording – This is a new page.

  • Getting Started with IVS Real-Time Streaming – We added S3 endpoints to the policy in "Set Up IAM Permissions."

  • Service Quotas – We added call-rate quotas for the new endpoints.

  • IVS Real-Time Streaming API Reference – We added 4 StorageConfiguration endpoints and 7 objects (DestinationDetail, RecordingConfiguration, S3DestinationConfiguration, S3Detail, S3StorageConfiguration, StorageConfiguration, StorageConfigurationSummary). We also modified 3 objects (Composition, Destination, DestinationConfiguration); this affects the GetComposition response and the StartComposition request and response.

November 16, 2023

Server-Side Composition

IVS server-side composition enables clients to offload the composition and broadcasting of an IVS stage to an IVS-managed service. Server-side composition and RTMP broadcast to a channel are invoked through IVS control plane endpoints in the stage’s home region. For more information, see:

In the IVS Low-Latency Streaming User Guide, see:

October 16, 2023

Amazon IVS Broadcast SDK: Web 1.6.0 (Real-Time Streaming)

Platform Downloads and Changes

Web Broadcast SDK 1.6.0

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

  • Improved Time-To-Video (TTV).

  • Added maxAudioBitrate configuration, supporting up to 128kbps of mono or stereo audio channels.

October 12, 2023

New CloudWatch Metrics and Participant Data

We released CloudWatch metrics for IVS real-time streaming. For details, see Monitoring IVS Real-Time Streaming.

We also added six fields to the Participant API object: browserName, browserVersion, ispName, osName, osVersion, and sdkVersion. This affects the GetParticipant response. See the IVS Real-Time Streaming API Reference.

October 12, 2023

Amazon IVS Broadcast SDK: Android 1.12.1 (Real-Time 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

5.853 MB

16.375 MB

armeabi-v7a

4.895 MB

10.803 MB

x86_64

6.149 MB

17.318 MB

x86

6.328 MB

17.186 MB

September 14, 2023

Amazon IVS Broadcast SDK: Web 1.5.2 (Real-Time Streaming)

Platform Downloads and Changes

Web Broadcast SDK 1.5.2

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

  • Fixed a bug that prevented republishing with refreshStrategy when the published state enters an ERRORED state.

August 23, 2023

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

Platform Downloads and Changes

Web Broadcast SDK 1.5.1

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

  • Fixed a bug with internal Maybe types on TypeScript 5.

  • Added better detection for Simulcast support.

  • Fixed two race conditions with refreshStrategy when trying to publish.

  • Fixed a race condition with refreshStrategy when trying to update participants to subscribe to.

All mobile (Android and iOS)

  • Fixed a rare issue where publishing action is never completed.

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

  • Improved the stability of stages by resolving race-condition issues caused by rapid join / leave.

  • Added a new setOnFrameCallback method on ImageDevice. This allows observation as frames pass through the device itself, giving insight into the aspect ratio of the latest images. This method also can be used to detect when the first frame is rendered for a remote participant in a stage.

Android Broadcast SDK 1.12.0

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

  • Android 9 is now supported.

  • Improved CPU usage and performance.

iOS Broadcast SDK 1.12.0

Download for real-time streaming: https://broadcast.live-video.net/1.12.0/AmazonIVSBroadcast-Stages.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

5.853 MB

16.375 MB

armeabi-v7a

4.895 MB

10.803 MB

x86_64

6.149 MB

17.318 MB

x86

6.328 MB

17.186 MB

Broadcast SDK Size: iOS

Architecture Compressed Size Uncompressed Size

arm64

5.06 MB

10.92 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

  • Added Simulcast – When enabled, this feature allows the publisher to send high- and low-quality layers of video. Subscribers automatically select their optimal quality based on their network conditions. See Optimizing Media.

All mobile (Android and iOS)

Added Simulcast – When enabled, this feature allows the publisher to send high- and low-quality layers of video. Subscribers automatically select their optimal quality based on their network conditions. See “Enable/Disable Layered Encoding with Simulcast” in the Android and iOS Broadcast SDK Guides.

Android Broadcast SDK 1.11.0

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

  • Fixed an issue where creating many stages eventually results in a crash. (The exact number of stages depends on the device.)

iOS Broadcast SDK 1.11.0

Download for real-time streaming: https://broadcast.live-video.net/1.11.0/AmazonIVSBroadcast-Stages.xcframework.zip

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

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

Broadcast SDK Size: Android

Architecture Compressed Size Uncompressed Size

arm64-v8a

5.811 MB

16.186 MB

armeabi-v7a

4.857 MB

10.646 MB

x86_64

6.108 MB

17.122 MB

x86

6.289 MB

16.994 MB

Broadcast SDK Size: iOS

Architecture Compressed Size Uncompressed Size

arm64

5.030 MB

10.810 MB

August 7, 2023

Real-Time Streaming

Amazon Interactive Video Service (IVS) Real-Time Streaming enables you to deliver live streams with a latency that can be under 300 milliseconds from host to viewer.

Major documentation changes accompany this release. The IVS documentation landing page now has separate sections for real-time streaming and low-latency streaming. Each section has its own User Guide and API Reference. For documentation details, see the Document History (for both real-time and low-latency documentation changes). For real-time streaming, start with the IVS Real-Time Streaming User Guide and IVS Real-Time Streaming API Reference.