IVS Release Notes | Low-Latency Streaming

Bug fixes and stability improvements.

Bug fixes and stability improvements.

Bug fixes and stability improvements.

Increased ability to recover from decode errors.

Additional bug fixes and stability improvements.

Bug fixes and stability improvements.

Bug fixes and stability improvements.

Added a new section, “Using Auto-Reconnect,” to the Android Broadcast SDK Guide.

Bug fixes and stability improvements.

Added a new section, “Using Auto-Reconnect,” to the iOS Broadcast SDK Guide.

Bug fixes and stability improvements.

Bug fixes and stability improvements.

Minor bug fixes.

Minor bug fixes.

Minor bug fixes.

Minor bug fixes.

With this release we also began publishing a version of the Android broadcast SDK which includes debug symbols. See Using the SDK with Debug Symbols.

Minor bug fixes.

Minor bug fixes.

Fixed an infinite buffering issue that occurred during MP4 playback.

Fixed a bug where the player would sometimes skip content.

Fixed an infinite buffering issue that occurred during MP4 playback.

Fixed a bug where the player would sometimes skip content.

Minor bug fixes.

Minor bug fixes.

Minor bug fixes.

Minor bug fixes.

Minor bug fixes.

Minor bug fixes.

Minor bug fixes.

Minor bug fixes.

Minor bug fixes.

Minor bug fixes.

Minor bug fixes.

Minor bug fixes.

Updated the SDK reference documentation to clarify that calling the IVSPlayerLayer.copyDisplayedPixelBuffer method at high frequencies (e.g., the video framerate) is not supported and may result in undefined behavior.

Minor bug fixes.

Minor bug fixes.

Fixed some microphone issues that occur when detaching devices.

Minor bug fixes.

Minor bug fixes.

Minor bug fixes.

Minor bug fixes.

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

Minor bug fixes.

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.

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

Minor bug fixes.

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

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.

Minor bug fixes.

No changes.

Minor bug fixes.

Added the IVSCamera setVideoZoomFactor method and the associated IVSCameraDelegate methods.

Minor bug fixes.

Minor bug fixes.

No changes.

Added the CF_RETURNS_RETAINED annotation to the IVSPlayerLayer.copyDisplayedPixelBuffer method for automatic memory management when using Swift.

No changes.

Minor bug fixes.

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.

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.

No changes.

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

No changes.

No changes.

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

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

No changes.

Fixed a previews freeze on the Exynos variant of Samsung devices with Android 14.

Minor bug fixes.

Added an API to expose the synchronization time.

Added an event to indicate when the syncTime has changed.

Added an API to expose the synchronization time.

Added an event to indicate when the syncTime has changed.

Added an API to expose the synchronization time.

Added an event to indicate when the syncTime has changed.

No changes in this release.

No changes in this release.

Minor bug fixes.

No changes.

Minor bug fixes.

Minor bug fixes.

Minor bug fixes.

Minor bug fixes.

No changes.

Minor bug fixes and improvements.

Fixed multiple stability issues on iOS 12.

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.

No changes

No changes

No changes to the low-latency SDK.

No changes to the low-latency SDK.

No changes to the low-latency SDK.

No changes in the low-latency SDK.

No changes in the low-latency SDK.

No changes in the low-latency SDK.

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

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.

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.

There were no changes for this release.

Added support for low-latency playback in iOS Safari.

Updated the reference documentation with a new UI and more details.

No changes.

No changes to the low-latency SDK.

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

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

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

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.

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

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

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

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

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

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

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

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.

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.

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.

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.

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.

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.

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

Improved stability of stages by reducing occurrences of rare crashes.

Enhanced automated recovery from recurrent network disruptions.

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.

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

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.

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.

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.

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.

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

Fixed an issue with video playback when the playback rate is greater than 1x.

There were no customer-facing changes in this release.

Added stage support. See Support for Multiple Hosts on a Stream (Stage Resource).

In the Broadcast SDK overview, added stage platform requirements.

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

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.

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

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

Implemented support for the getLiveLatency method for mobile Safari.

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.

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.

Updated SDK documentation to note which methods are not supported on iOS mobile browsers.

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.

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.

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.

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

Improved player stability by reducing occurrences of rare crashes.

Added the getErrorCode() method to the ErrorType class.

Made public the IVS Player setQuality:adaptive: method.

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

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.

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

Added support for the VideoJS seeking() function.

Removed unused types (CaptureEventTypes) which caused development issues.

Fixed intermittent MediaSource errors on network recovery.

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

Made stability improvements to ABR bandwidth estimation.

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.

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.

Fixed bundle type definitions when the npm pack is run.

Added a preset configuration to support 1080 BASIC channels.

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

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

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

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.

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.

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.

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.

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.

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.

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.

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.

Improved stability by reducing occurrences of rare crashes.

Added a new page on Broadcast SDK: Custom Image Sources.

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.

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.

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.

Improved stability by reducing occurrences of rare crashes.

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

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.

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.

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.

Reduced occurrences of freezing during quality switches when playing recorded content.

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.

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

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.

Fixed stuttering when playing a stream from a source media playlist.

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.

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.

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.

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:

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

Improved the connection stability of Bluetooth and wired headsets.

Added support to IVSCustomImageSource for the following pixel formats:

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

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.

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.

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

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.

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.

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.

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.