IVS Release Notes | Real-Time Streaming

September 11, 2024

Amazon IVS Broadcast SDK: Android 1.22.0, iOS 1.22.0 (Real-Time Streaming)

Platform	Downloads and Changes
Android Broadcast SDK 1.22.0	Reference documentation: https://aws.github.io/amazon-ivs-broadcast-docs/1.22.0/android/ Fixed a bug where certain Android devices show a black frame in the preview after switching camera inputs. Minor bug fixes.
iOS Broadcast SDK 1.22.0	Download for real-time streaming: https://broadcast.live-video.net/1.22.0/AmazonIVSBroadcast-Stages.xcframework.zip Reference documentation: https://aws.github.io/amazon-ivs-broadcast-docs/1.22.0/ios/ Minor bug fixes.

Broadcast SDK Size: Android

Architecture	Compressed Size	Uncompressed Size
arm64-v8a	5.359 MB	13.392 MB
armeabi-v7a	4.636 MB	9.325 MB
x86_64	5.548 MB	14.268 MB
x86	5.754 MB	14.710 MB

Broadcast SDK Size: iOS

Architecture	Compressed Size	Uncompressed Size
arm64	3.488 MB	8.199 MB

September 11, 2024

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

Platform	Downloads and Changes
Web Broadcast SDK 1.16.0	Reference documentation: https://aws.github.io/amazon-ivs-web-broadcast/docs/sdk-reference Minor bug fixes.

September 9, 2024

RTMP Ingest

As an alternative to using the IVS broadcast SDK, you can now publish video to an IVS stage from an RTMP source (in addition to WHIP, which already was supported). For documentation changes, see the Document History (both the User Guide and API Reference tables).

August 19, 2024

In-Console Publish/Subscribe

You can now publish and subscribe from the IVS console. In Getting Started with IVS Real-Time Streaming, see Publish and Subscribe to Video.

August 15, 2024

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

Platform

Downloads and Changes

Web Broadcast SDK 1.15.0

Reference documentation: https://aws.github.io/amazon-ivs-web-broadcast/docs/sdk-reference Fixed a race condition that impacts publisher media quality when join() is called repeatedly. Calling join() in succession no longer re-triggers the STAGE_PARTICIPANT_JOINED event, along with accompanying publish and stream state changes. Fixed a bug that causes issues parsing participant tokens when non-text characters are used in the token attributes field. Added a method to configure a participant's subscribers. Initially, you can configure only the jitter-buffer minimum delay. See the SDK reference documentation, Configuration for Subscribing to Participants in the Web Broadcast SDK Guide, and Changing Subscriber Jitter Buffer MinDelay in Streaming Optimizations.

August 15, 2024

Amazon IVS Broadcast SDK: Android 1.21.0, iOS 1.21.0 (Real-Time Streaming)

Platform	Downloads and Changes
Android Broadcast SDK 1.21.0	Reference documentation: https://aws.github.io/amazon-ivs-broadcast-docs/1.21.0/android/ Fixed a bug impacting devices with MT6765 chipsets, where the subscriber preview renders black frames under some circumstances. Added a method to configure a participant's subscribers. Initially, you can configure only the jitter-buffer minimum delay. See the SDK reference documentation, Configuration for Subscribing to Participants in the Android Broadcast SDK Guide, and Changing Subscriber Jitter Buffer MinDelay in Streaming Optimizations. Minor bug fixes.
iOS Broadcast SDK 1.21.0	Download for real-time streaming: https://broadcast.live-video.net/1.21.0/AmazonIVSBroadcast-Stages.xcframework.zip Reference documentation: https://aws.github.io/amazon-ivs-broadcast-docs/1.21.0/ios/ Added a method to configure a participant's subscribers. Initially, you can configure only the jitter-buffer minimum delay. See the SDK reference documentation, Configuration for Subscribing to Participants in the iOS Broadcast SDK Guide, and Changing Subscriber Jitter Buffer MinDelay in Streaming Optimizations. Minor bug fixes.

Broadcast SDK Size: Android

Architecture	Compressed Size	Uncompressed Size
arm64-v8a	5.350 MB	13.378 MB
armeabi-v7a	4.628 MB	9.312 MB
x86_64	5.538 MB	14.253 MB
x86	5.744 MB	14.694 MB

Broadcast SDK Size: iOS

Architecture	Compressed Size	Uncompressed Size
arm64	3.485 MB	8.199 MB

July 18, 2024

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

Platform	Downloads and Changes
Web Broadcast SDK 1.14.0	Reference documentation: https://aws.github.io/amazon-ivs-web-broadcast/docs/sdk-reference API documentation improvements. Fixed video and audio stats outliers reported during connection resets. Minor dependency updates.

July 18, 2024

Amazon IVS Broadcast SDK: Android 1.20.0, iOS 1.20.0 (Real-Time Streaming)

Platform	Downloads and Changes
Android Broadcast SDK 1.20.0	Reference documentation: https://aws.github.io/amazon-ivs-broadcast-docs/1.20.0/android Fixed a bug that prevented the Broadcast SDK from running on Chromebooks with Intel processors. Minor bug fixes.
iOS Broadcast SDK 1.20.0	Download for real-time streaming: https://broadcast.live-video.net/1.20.0/AmazonIVSBroadcast-Stages.xcframework.zip Reference documentation: https://aws.github.io/amazon-ivs-broadcast-docs/1.20.0/ios Minor bug fixes.

Broadcast SDK Size: Android

Architecture	Compressed Size	Uncompressed Size
arm64-v8a	5.318 MB	13.299 MB
armeabi-v7a	4.605 MB	9.254 MB
x86_64	5.507 MB	14.168 MB
x86	5.715 MB	14.608 MB

Broadcast SDK Size: iOS

Architecture	Compressed Size	Uncompressed Size
arm64	3.465 MB	8.164 MB

June 26, 2024

Generate Participant Tokens with a Key Pair

You can now generate participant tokens on your own server application by using a key pair. This enables you to avoid calling CreateParticipantToken every time you need a participant token. For documentation changes, see the Document History (both the User Guide and API Reference tables).

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:

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

• Using Amazon EventBridge with IVS Real-Time Streaming – We added new metrics.

• Server-Side Composition – This new document includes an overview and setup instructions.

• Service Quotas (Real-Time Streaming) – We added new call-rate limits and other quotas.

• Real-Time Streaming API Reference – We added 8 Composition and EncoderConfiguration endpoints and 11 objects (ChannelDestinationConfiguration, Composition, CompositionSummary, Destination, DestinationConfiguration, DestinationSummary, EncoderConfiguration, EncoderConfigurationSummary, GridConfiguration, LayoutConfiguration, and Video).

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

• Enabling Multiple Hosts on an IVS Stream – We added "Broadcasting a Stage: Client-Side versus Server-Side Composition" and updated "4. Broadcast the Stage."

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.