Xamarin.Agora.Full.Android 2.3.0

This package has no dependencies.

v2.3.0 (Released Aug 31st, 2018)
Before Reading
To support scenarios with video rotation and enable better quality for custom video source, this release deprecates the setVideoProfile interface and uses setVideoEncoderConfiguration instead to set the video encoding configurations. You can still use setVideoProfile, but Agora recommends using setVideoEncoderConfiguration to set the video profile because:

During a live broadcast, users can set the video orientation mode as adaptive, under which the SDK can transfer rotated video frames without cropping them, thus avoiding the “big headshot” or blurry images at the Player.
In scenarios involving external video source, the SDK adjusts the width and height of the output video frames on basis of the inputting video frames, avoiding unnecessary cropping and thereby renderering more image frames at the Player.
From v2.3.0, the LiveTranscoding Class was relocated from the io.agora.live Package to the io.agora.rtc.live package.

A spelling mistake was corrected in API constants.java in v2.3.0.

Before:
public static final int SOFEWARE_ENCODER = 1;
After:
public static final int SOFTWARE_ENCODER = 1;
The security keys are improved and updated in v2.1.0. If you are using an Agora SDK version below v2.1.0 and wish to migrate to the latest version, see Token Migration Guide.

New Features
1. Fallback options for a live broadcast under unreliable network conditions
The audio and video quality of a live broadcast will deteriorate under unreliable network conditions. To improve the efficiency of a live broadcast, the setLocalPublishFallbackOption and setRemoteSubscribeFallbackOption interfaces are added. These interfaces allow the SDK to automatically disable the video stream when the network condition cannot support both audio and video, and enable the video when the network conditions improve. onLocalPublishFallbackToAudioOnly or onRemoteSubscribeFallbackToAudioOnly is triggered when the stream falls back to audio-only or when the stream switches back to the video.

2. Notifies the user that the Token will expire in 30 seconds
The SDK returns the onTokenPrivilegeWillExpire callback 30 seconds before a Token expires to notify the app to renew it. When this callback is received, you need to generate a new Token on your server and call renewToken to pass the newly-generated Token to the SDK.

3. Returns user-specific upstream and downstream statistics, including the bitrate, frame rate, packet loss rate and time delay
The onRemoteAudioTransportStats and onRemoteVideoTransportStats callbacks are added to provide user-specific upstream and downstream statistics, including the bitrate, frame rate, and packet loss rate. During a call or a live broadcast, these callbacks are triggered every two seconds after the user receives audio/video packets from a remote user. The callbacks include the user ID, audio bitrate at the receiver, packet loss rate, and time delay (ms).

4. Sets the video encoder configurations
To support scenarios with video rotation and enable better quality for custom video source, this release deprecates the setVideoProfile interface and uses setVideoEncoderConfiguration instead to set the video encoding configurations. You can still use setVideoProfile, but Agora recommends using setVideoEncoderConfiguration to set the video profile because:

During a live broadcast, users can set the video orientation mode as adaptive, under which the SDK can transfer rotated video frames without cropping them, thus avoiding the “big headshot” or blurry images at the Player.
In scenarios involving external video source, the SDK adjusts the width and height of the output video frames on basis of the inputting video frames, avoiding unnecessary cropping and thereby renderering more image frames at the Player.
The VideoEncoderConfiguration class provides a set of configurable video parameters, including the dimension, frame rate, bitrate, and orientation. For more information on the API, see descriptions in Set the Video Encoder Configuration.

6. Adds support for background image settings in setLiveTranscoding
The backgroundImage parameter is added to the setLiveTranscoding method allowing you to set the background image in the combined video of a live broadcast.

Improvements
Improved the quality for one-on-one voice/video scenarios with optimized latency and smoothness, especially for areas like Southeast Asia, South America, Africa and Middle East.
Improved the audio encoder efficiency in a live broadcast to reduce user traffic while ensuring the call quality.
Improved the audio quality during a call or a live broadcast using the deep-learning algorithm.
Issues Fixed
Increased memory usage when multiple delegated hosts broadcast in the channel.
Occasional crashes on some Android devices.
The remote view does not display on some devices.
The local video cannot be enabled on some Android devices.
Occasional ghost images.
Occasional green line at the bottom of the video when a user switches from low stream to high stream in the communication mode.
Occassional crashes after interoperating with devices of other platforms from some Android devices.
Excessive increase in memory usage associated with a host when he/she frequently joins and leaves a channel of multiple delegated hosts.
Occasional black screens on some Android devices.
Occasional issue that the remote user cannot hear the host when the host swithces to AUDIENCE and then back to BROADCASTER.
Occasional issue that settings to the background image of live transcoding do not take effect.
Occasional issue that some devices have video height and width swapped in communication mode.
Occasional failure to respond to the destroy method after a user enables video and joins a channel.
Occasional crashes on the Android devices when the remote users frequently join and leave the channel.
Black screen due to failure to render the remote video on some Android devices.
The audience cannot adjust the channel volume on some special occasions.
Occasional issue that applications do not respond on some Android devices.
Occasional crashes on some Android devices when switching video resolution in a live broadcast.
A delegated host cannot see the video of the other hosts in the channel on some Android devices.
The bitrates cannot reach the target values on some Android devices when a user frequently joins and leaves the communication channel with different video profiles.
Occasional failure to capture video of the delegated host when the hosts and the audience frequently change roles.
Occasional failure to capture videos or publish streams on some Android devices when a user frequently joins and leaves a communication channel with different video profiles.
Occasional crashes when calling the setCameraFocusPositionInPreview method on some devices.
Occasional failure to enable the camera during communication on some Android devices.
Video freezes and stream publishing hangs on some Android devices a while after a user joins a communication or live broadcast channel.
Occasional crashes when one of the two broadcasters mutes or disables the local audio while playing the background music.
A user cannot join a communication channel after frequently changing his/her video encoder profiles.
Occasional crashes on some devices when preloading the sound effects.
Failure to render videos of lower resolutions on some Android devices.
Occasional issue that an Android client can still interoperate in a communication channel when removed from the dashboard.
Video resolution inconsistency between the encoder end and the decoder end in the live broadcast mode.
Failure to enable the hardware encoder on some Android devices.
Occasional video freeze in the communication or live broadcast mode.
Occasional crashes when calling the muteRemoteVideoStream method after joinning the channel.
Fixed occasional video freeze on some Android devices when switching from the communication mode to the live broadcast mode.
Occasional crashes on some Android devices when frequently turning on and off the flashlight during a live broadcast.
The host cannot receive the A/V stream of the delegated host on some Android devices.
Occasional crashes on some Android devices when setting the video encoder profile of an external video source during a live broadcast.
Incorrect video orientation on some Android devices when setting the video profile of an external video source during a live broadcast.
Occasional issue on some Android devices that the video fallback option does not take effect in the case of weak network.
Occasional crashes on some Android devices when a user frequently changes the Token.
Occasional failure to split the screen on some Android devices.
The CDN audience on some Android devices cannot see the video of the host.
Occasional video freezes when tswitching from multiple hosts to one single host.
Occasional interoperability failures between the SIP devices and the SDK.
Occasional issue on Mi 8 that the local video cannot be seen locally or remotely.
Occasional issue on some Android devices that the users cannot see each other.
Occasional echoes when using a specific audio card.
Occasional video delay on some Android devices.
Occaional crashes on some Android devices when transmitting the video streams.
API Changes
To improve user experience, Agora has cleaned up and made the following changes to its APIs:

To avoid adding too many users with the same UID into the CDN publishing channel, the following API is deleted in v2.3.0, and the type of the return value of addUser is changed from void to int.

setUser
The following APIs are deleted and no longer supported in v2.3.0. Agora provides the Recording SDK for better recording services. For more information on the Recoding SDK, see Release Notes for Agora Recording SDK.

startRecordingService
stopRecordingService
refreshRecordingServiceStatus
The following deprecated APIs are deleted and no longer supported from v2.3.0:

monitorConnectionEvent
monitorBluetoothHeadsetEvent
monitorHeadsetEvent
setPreferHeadset
switchView
setSpeakerphoneVolume
Backwards Compatibility Breaking Changes
None.

Known Issues
None.

origin: https://docs.agora.io/en/2.4/product/Video/Product%20Overview/release_android_video