ApsaraVideo Live:SDK download and integration

Prerequisites

Requirements:

• Android Studio 2020.3.1 or later.

• A test device running Android 5.0 (SDK API level 21) or later with network connectivity.

Step 1: Import the SDK

Step 2: Configure CPU architectures

In app/build.gradle, specify supported CPU architectures in the defaultConfig block. Available architectures: armeabi-v7a, arm64-v8a, x86, and x86_64.

android {
    defaultConfig {
        // ...other default configurations
        // Support armeabi-v7a and arm64-v8a architectures.
        ndk {
             abiFilters "armeabi-v7a", "arm64-v8a"
        }
    }
}

Step 3: Configure permissions

In AndroidManifest.xml (app/src/main), add the required permissions:

<uses-feature android:name="android.hardware.camera" android:required="false" />
<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<!-- Request legacy Bluetooth permissions on older devices. -->
<uses-permission
  android:name="android.permission.BLUETOOTH"
  android:maxSdkVersion="30" />
<uses-permission
  android:name="android.permission.BLUETOOTH_ADMIN"
  android:maxSdkVersion="30" />

<!-- Needed only if your app communicates with already-paired Bluetooth devices. -->
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
<uses-permission android:name="android.permission.CHANGE_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.WRITE_SETTINGS"
  tools:ignore="ProtectedPermissions" />
<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />

<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.BLUETOOTH" />
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />

<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" tools:node="remove"/>

<!-- Declare Bluetooth permission. -->
<uses-permission android:name="android.permission.BLUETOOTH" />
<!-- Override removal of high-version API 31+ permission. -->
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" tools:node="remove" />

<!-- Declare Bluetooth permission with android:maxSdkVersion set to 30 for backward compatibility. -->
<uses-permission android:name="android.permission.BLUETOOTH"/>
<!-- Declare high-version API 31+ Bluetooth permission. -->
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT"/>
<!-- Other Bluetooth permissions. -->

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
    String[] permissions = {
        android.Manifest.permission.BLUETOOTH_CONNECT
    };
    ActivityCompat.requestPermissions(activity, permissions, REQUEST_BLUETOOTH);
}

<!-- Override and remove built-in Bluetooth permission declarations from the ARTC SDK. -->
<uses-permission android:name="android.permission.BLUETOOTH" tools:node="remove" />
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" tools:node="remove" />

Step 4: Prevent code obfuscation (optional)

Add the following rules to app/proguard-rules.pro to prevent SDK code obfuscation:

-keep class com.aliyun.allinone.** {
*;
}

-keep class com.aliyun.rts.network.AliHttpTool {
*;
}

-keep class com.aliyun.common.AlivcBase {
*;
}

-keep class com.huawei.multimedia.alivc.** {
*;
}

-keep class com.alivc.rtc.** {
*;
}

-keep class com.alivc.component.** {
*;
}

-keep class org.webrtc.** {
*;
}

Prerequisites

Requirements:

• Xcode 14.0 or later (latest stable version recommended).

• CocoaPods 1.9.3 or later.

• A physical device running iOS 9.0 or later.

Step 1: Import the SDK

Step 2: Configure permissions

• Add camera and microphone permissions to Info.plist: Privacy - Camera Usage Description and Privacy - Microphone Usage Description.

• (Optional) Enable background audio. In project capabilities, select Audio, AirPlay, and Picture in Picture.

Prerequisites

Requirements:

• Visual Studio 2015 or later.

• Windows 7 or later.

Step 1: Integrate the SDK

1. Download the latest ARTC SDK from the SDK download section.

2. Extract the SDK and copy all files to your project directory.

3. Configure project properties:

   1. In the Solution Explorer, right-click the project and select Properties.

   2. Add include directories: select Configuration Properties > C/C++ > General, and add the header file path under Additional Include Directories.

   3. Add library directories: select Linker > General, and add the library file (.lib) path, for example, .../x64/Release, under Additional Library Directories.

   4. Specify linked library files: select Linker > Input, and add AliRTCSdk.lib under Additional Dependencies.

Troubleshooting

Common issues and solutions:

Prerequisites

Requirements:

• Xcode 14.0 or later (latest stable version recommended).

• macOS 10.13 or later.

• A stable network connection.

Step 1: Integrate the SDK

The ARTC SDK for Mac is delivered as .framework dynamic library bundles (for example, AliRTCSdk.framework). This differs from the .so shared libraries used on Linux. Download the Mac SDK package and do not use .so files from the Linux package.

1. Download and extract the latest ARTC SDK from the SDK download section.

2. Copy the .framework bundles from the SDK package to your project directory. Skip PluginAAC.framework if you do not use AAC audio encoding.

3. In Xcode, add the dynamic libraries and set Embed to Embed & Sign.

Troubleshooting

Common issues and solutions:

Does the ARTC SDK introduce additional Android permissions?

The ARTC SDK automatically declares these Android permissions (the exact list may vary by version; check the AndroidManifest.xml in the .aar file):

<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.BLUETOOTH" />
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />

These permissions support network monitoring, Wi-Fi detection, Bluetooth connectivity, and audio routing.

How do I handle permission compatibility or conflicts with existing code?

The ARTC SDK handles permission compatibility (for example, runtime BLUETOOTH_CONNECT on Android 12+), but issues may occur:

• Runtime behavior anomalies, such as manifest merge failures.

• Google Play review risk: declaring unused permissions (for example, Bluetooth) may violate the principle of least privilege and cause rejection.

To resolve these issues:

1. Assess necessity. Remove unused permissions. For example, if targetSdk is 30 or lower, remove the BLUETOOTH_CONNECT declaration.

2. Resolve manifest merge conflicts. If modules declare conflicting attributes (for example, inconsistent maxSdkVersion values), use the tools namespace in AndroidManifest.xml to override:

   <manifest xmlns:android="http://schemas.android.com/apk/res/android"
       xmlns:tools="http://schemas.android.com/tools">
   
       <!-- Example: Remove a permission declared by the SDK that the app does not need. -->
       <uses-permission
           android:name="android.permission.BLUETOOTH_CONNECT"
           tools:node="remove" />
   
       <!-- Example: Override a permission attribute. -->
       <uses-permission
           android:name="android.permission.BLUETOOTH"
           android:maxSdkVersion="30"
           tools:replace="android:maxSdkVersion" />
   </manifest>

Which audio codecs does the ARTC SDK support?

The ARTC SDK uses Opus as its default audio codec, inherited from the WebRTC audio processing pipeline.

Opus is an open, royalty-free codec (RFC 6716) that delivers high audio quality at 6–510 kbps with low latency. The ARTC SDK uses Opus for:

• Real-time audio encoding and decoding for one-on-one and multi-party calls.

• Adaptive bitrate based on network conditions.

• Built-in noise suppression and automatic gain control (AGC).