Agora Native SDK Release Notes

Overview

Agora Native SDK can be used in two scenarios: Communication and Live Broadcast, and you can find the detailed functions included in each scenario according to the following:

The applications using the Agora Native SDK link it directly into the application when they are built.

Note

Live Broadcast is available starting from v1.7.

Obtain the SDK

You can download the latest SDKs at downloads or contact sales-us@agora.io.

Known Issue and Limitation

Agora Native SDK for Android

To use the startAudioMixing API, ensure that the Android device is >=4.2, and API Level>=16.

Agora Native SDK for iOS

To use the startAudioMixing API, ensure that the iOS device is >=8.0.

Agora Native SDK for Windows

If you use a camera driver which is not Microsoft official program, the video image may display with random errors, for example,

../../_images/native-release-1.png

Encryption

Currently, encryption does not interoperate with the Web SDK (based on Web RTC).

Screen Sharing

Users can employ the Screen Sharing function on Agora-supported platforms for Web, Mac and Windows. On iOS and Android, users have view-only permission.

Others

In most cases, Agora SDK helps select the correct audio recording and playback devices, but you still have to select the device as the Windows default device by yourself under one of the following circumstances and then join channel:

  • You use Windows XP;
  • You installed Windows system in a macOS;

v1.12 (Released July 25, 2017)

New Function:

  • Android/iOS

    • Added a new method injectStream to inject a RTMP stream into the current channel in live broadcast scenario. For details, refer to each platform API documentation. This is a beta function
    • Added a new encryption mode aes-128-ecb in the API method setEncryptionMode . For details, refer to each platform API documentation
    • Added a new parameter quality in the API method startAudioRecording to set the recording audio quality. For details, refer to each platform API documentation
    • Added a set of APIs to manage the audio effect. For details, refer to each platform API document
  • Mac:

    • Added a new method injectStream to inject a RTMP stream into the current channel in live broadcast scenario. For details, refer to each platform API documentation. This is a beta function
    • Added a new encryption mode aes-128-ecb in the API method setEncryptionMode . For details, refer to each platform API documentation
    • Added a new parameter quality in the API method startAudioRecording to set the recording audio quality. For details, refer to each platform API documentation
    • Added a set of APIs to manage the audio effect. For details, refer to each platform API document
    • Added a new API ActiveSpeaker to indicate who is the active speaker in the current channel
    • Removed the original API method setScreenCaptureWindow() and updated the API method startScreenCapture() to share the whole screen, specified window or specified region in the Communication scenario.
    • Added a function of displaying the mouse when the screen sharing function is enabled in the Communication scenario.
  • Windows:

    • Added a new method injectStream to inject a RTMP stream into the current channel in live broadcast scenario. For details, refer to the API documentation. This is a beta function
    • Added a new encryption mode aes-128-ecb in the API method setEncryptionMode . For details, refer to the API documentation.
    • Added a new API onActiveSpeaker to indicate who is the active speaker in the current channel
    • Removed the original API method setScreenCaptureWindow() and updated the API method startScreenCapture() to share the whole screen, specified window or specified region in the Communication scenario.
    • Added a function of displaying the mouse when the screen sharing function is enabled in the Communication scenario.
  • Web: Added and updated a series of APIs to enable interoperability between Web browser and Native clients for communication or live broadcast. For details, refer to Agora Web SDK Release Notes

  • Recording: Added real-time video mixing, web recording, callback functions.For details, refer to Recording SDK Release Notes

Improvement:

Android/iOS/Mac/Windows: In the communication scenario, we provided a improvement for 320 x 180(only) resolution profile:

  • Keep video smoothess under bad network and equipment condition
  • Enhance image quality even better than 180P under good network and equipment condition.

Contact sales-us@agora.io for details if required.

Bug Fix:

  • Android: Fixed the main bluetooth issues related to Audio Routing on certain devices
  • Android/iOS/Mac/Windows: Fixed the occasional crashes on some devices