Release Notes for LiveSwitch Server v1.15
1.15.1.17173
Release date: May 27, 2022
Media Server
Bug Fixes
- [LS1-996] Forcibly unregister a Media Server if it fails to respond to three consecutive requests from the Gateway instead of removing it after the first failure.
1.15.0.16640
Release date: May 20, 2022
Client SDK
New Features
- [LS1-358] New
EnableHiddenObserverMode
property has been added in theChannelClaim
class. When a client with this property enabled joins or leaves a channel, the server does not notify the other clients in that channel. This property also prevents that client from performing actions (for example, sending media, messages, or kicking users) that would make other clients in the channel aware of that client.
Bug Fixes
- [LS1-316] Fixed a bug where the Differentiated Services Code Point (DSCP) flag would fail to be set properly for applications running in some Windows environments.
- [LS1-596] Fixed an error message displaying invalid information when creating a custom ImageConverter that extends VideoPipe when this class didn't correctly inherit from ImageScalePipe. Previously, the error displayed “Error initializing local media”.
- [LS1-681] The first client in a channel would get into a bad state if they updated the connection configuration prior to a second client joining. Improved the Signal Direction caching logic and the first client’s state is no longer affected.
- [LS1-813] Fixed a bug where
ConnectionInfo
didn't includeRemoteVideoMuted
andRemoteAudioMuted
properties. - [LS1-814] Fixed a bug that caused an exception to be thrown after nine failed attempts to reregister a client.
Breaking Changes
- [LS1-871] Android CameraSource deprecated for Camera2Source.
Gateway
New Features
- [LS1-281] Added new configuration options to set the maximum length of time a session can remain active. These configuration options are:
sessionLimit
inDeploymentConfig
sessionLimitOverride
inApplicationConfig
andChannelConfig
- [LS1-691] Added new endpoint
/ChannelConfigs({id})/AllowedChannelUpdate
to allow toggling any of theAllowedChannelUpdateOverride
properties on or off on a channel.
Media Server
New Features
- [LS-5891, LS1-186] Secured Media Server cluster connections with TLS encryption. To enable, select the Enable Encryption toggle in the Clustering section on the Server Dashboard.
- [LS1-246] You can now add custom audio codecs for media processing.
Improvements
- [LS1-387] The timestamps used for RTP/RTCP synchronization are now roughly aligned with the local wall clock to make debugging and remote track inspection easier.
Bug Fixes
- [LS1-712] In certain cases, Media Servers couldn’t terminate gracefully leaving behind their records, while Gateways tried to send traffic to them. Cleaned up Media Servers that couldn’t be reached through signaling so that Gateways can send traffic to Media Servers that are known to exist.
- [LS1-746] Clients connecting to remote clients with poor-performing networks have had their audio/video bitrates reduced, causing remote clients on suitable networks to receive low-quality audio/video. Now the bitrates won't be reduced, and remote clients on good-performing networks will receive the appropriate quality audio/video.
Dashboard
New Features
- [LS1-14] Added a new search function in the toolbar for easy documentation access.
- [LS1-184] Added a banner to the Deployment Configuration page informing users that changes to deployment configuration take effect when the service is next restarted.
- [LS1-184] Added a banner to the Channel Configuration page informing users that a change to channel configuration takes effect when the channel next becomes active.
- [LS1-702] Added a new clustering allocation strategy on the channel-level configuration to allow overriding the allocation strategy set at the deployment level.
Bug Fixes
- [LS1-163] Fixed a bug by removing the irrelevant “Can Terminate?” checkbox from SIP Configuration on the Server Dashboard. The feature was never supported and the toggle did nothing. It has been removed to avoid confusion.
- [LS1-514] Fixed a bug in the channel webhook configuration modal where column spacing would sometimes result in text overlap.
RTMP
New Features
- [LS1-234] LiveSwitch supports sending Real-Time Messenger Protocol (RTMP) streams to other servers that allow RTMP ingest for your application or channel. RTMP is an online streaming protocol that was created to distribute media. Originally designed for streaming with Adobe’s Flash player, RTMP is still used as an ingest protocol for some streaming services. For example, RTMP can be used to deliver LiveSwitch media to online streaming platforms like Twitch, Facebook Live, or YouTube Live.
- Media Server: Media Server supports streaming through RTMP with AAC audio and H.264 video.
- Gateway: RTMP can be configured on Channels through API. RTMP can be configured to start automatically on Channel activation.
- Gateway: Added
RtmpEnabled
toChannelUpdate
message to allow starting and stopping RTMP through the SDK. - Dashboard: Added new RTMP options to Channel configuration.
- Dashboard: RTMP started and RTMP stopped webhooks can now be enabled in Channel configuration.
Recording
Bug Fixes
- [LS1-384] Updated the lsmux dependency to version 0.4.1-ci.137.
- [LS1-467] Improved logging for certain exceptions seen when muxing and ensured recordings that cause an exception are not continuously queued again for muxing.
SIP
Bug Fixes
- [LS1-738] Some SIP providers' messages couldn't be read, which led to SIP calls not connecting. SIP calls from these providers should now connect.
Examples
Improvements
- [LS1-485, LS1-486] Updated Android and Java examples to build using Java 1.17 and Gradle 7.3. Updated source and target compatibility for Android example to Java 1.11.
Bug Fixes
- [LS1-438] Updated the branding on the Web Demo.
- [LS1-903] Fixed an exception seen when starting the Android chat example on Android 12 and up.
- [LS1-911] When a client connected through SFU disables a media stream and if they muted and unmuted the same stream, then it used to get re-enabled. Updated Mute and Disable functions in the Web Chat example project to use the state sent by the UI.
- [LS1-914] A user connecting to a P2P connection with the receive-only mode enabled used to get stuck in a loop of connecting and disconnecting. This bug has been fixed and the user is successfully able to establish a P2P connection.
Other
Improvements
- [LS1-653] Reduced noise from certain log events which under the right conditions could cause excessive logging in LiveSwitch Server.
- [LS1-720] Added configurable logic to group duplicate log messages within a window on LiveSwitch Server to reduce noise in some cases.