Video API v1.4 Release Notes

Release Name: Altair Date of Release: August 28, 2019

EnableX Video API v1.4 provides several new features, improvements to existing features, and bug fixes.

New Features

Auto Reconnection

In case, the internet disconnects momentarily or switches from one network to another (for example, from 4G to WiFi), the SDKs will attempt to automatically restore the connection without user or programmed intervention.

Application developers can enable or disable the auto reconnection feature or set the reconnection delay in seconds when a connection is disconnected. When the auto reconnection feature is enabled, no additional APIs are called in response to the event changes.

Auto Bandwidth Management

In order to provide the best user experience within the available bandwidth, EnableX tries to optimize the picture resolution, frame rate, and the number of streams that can be shown to end users. Note that the streams carrying screen sharing and canvas data are not considered for optimization. The SDK provides event notifications in the event of changes in link bandwidth conditions that affect the quality of the call so that application developers can display this information to end users if desired. New players display the updates made by the SDKs on the panel.

Stream Statistics

The SDKs player now contains detailed analytical data about the streams including bandwidth, packet loss, and other vital information that the Auto Bandwidth Management system uses for optimization purposes. The stream data is useful for debugging purposes.

Resolution Change Alert

The SDK notifies the application in case of a change in picture resolution. For example, when a high-definition call is downgraded to a standard-definition call due to available bandwidth.

User Role Switch

A moderator can now assign the moderator role to any participant in the Group mode. This is typically useful for controlling the recording feature if the original moderator plans to leave the meeting.

Critical Bug Fixes

• When a participant, P2, joins a room where the existing video has been muted by participant P1, P2 cannot see P1 after P1 has unmuted the video.
• Screen sharing and canvas streaming are meant for presentation. You are restricted to use them at the same time.
• The recording issue when it randomly stopped at the start of a presentation is fixed.
• The server crashes that occurred in random scenarios are fixed.
• App-ID and Conference ID are added in all events that are meant for logging.
• The issue with Client-Id and Username in canvas-started events is fixed.
• API support for setting video layers is added.
• Error response for invalid frame rate is added.
• Android Toolkit: The following issues are fixed:
  • Newly joined participants receive screen sharing in a room that has an ongoing screen sharing.
  • Upon disconnection, all peer connections are closed and socket event handlers are removed.
  • Mirror property is no longer supported for EnxPlayerView.
  • The response structure for delegates has changed. For example, on start recording, on release floor, on deny floor, and so on.
• iOS Toolkit: The following issues are fixed:
  • Newly joined participants receive screen sharing in a room that has an ongoing screen sharing.
  • Upon disconnection, all peer connections are closed and socket event handlers are removed.
  • The Active Talker media type issues are fixed.
  • Metadata of a room can be retrieved from the room-connected events.
  • The response structure for delegates has changed. For example, on start recording, on release floor, on deny floor, and so on.

Known Issues

The following known issues for v1.4.1 are currently being researched and planned to be fixed in the subsequent releases. These issues are not serious in nature, but may impact some workflows.

• You may experience random disconnections during a recording in case of repeated connect and disconnect events from the participants.
• The current version of Safari does not support VP8. Therefore, participants connecting to a VP8 room through Safari cannot send or receive video and are forced to switch to an audio-only call. This issue does not occur if participants use Safari with H264 support to join the room.
• Firefox browsers shows green patches in live conferences in an H264-enabled room. To work around this issue, disable hardware acceleration in browser preference.
• Calls from iOS mobile browsers are not supported and are disallowed to join a call.

Breaking Changes

There are no known breaking changes in this release. Your application will continue to work without changes if you have downloaded the SDKs shipped this release. We strongly recommend that you upgrade to the latest SDK toolkits.