Dev/4.3.0

.githooks/pre-commit

@@ -0,0 +1,38 @@
+#!/bin/sh
+#
+# An example hook script to verify what is about to be committed.
+# Called by "git commit" with no arguments.  The hook should
+# exit with non-zero status after issuing an appropriate message if
+# it wants to stop the commit.
+#
+# To enable this hook, rename this file to "pre-commit".
+
+if git rev-parse --verify HEAD >/dev/null 2>&1
+then
+	against=HEAD
+else
+	# Initial commit: diff against an empty tree object
+	against=$(git hash-object -t tree /dev/null)
+fi
+
+SCRIPT_DIR=$(dirname "$0")
+SCRIPT_ABS_PATH=`cd "$SCRIPT_DIR"; pwd`
+
+
+ANDROID_DIFF_FILES=`git diff --cached --name-only --diff-filter=ACM -- '*' | grep 'Android'`
+if [[ "$ANDROID_DIFF_FILES" != "" ]] 
+then
+	cd Android/APIExample
+	echo "precommit >> current paht = $(pwd), diff files = $ANDROID_DIFF_FILES"
+	./gradlew -Dorg.gradle.project.commit_diff_files="$ANDROID_DIFF_FILES" checkstyle detekt
+	if [ $? -eq 0 ]; then
+		echo "precommit >> checkstyle detekt OK."
+	else
+		echo "precommit >> checkstyle detekt Failed."
+		exit 1
+	fi
+else
+	echo "precommit >> No changing android files."
+fi
+
+

.github/workflows/gitee-sync.yml

@@ -25,4 +25,4 @@ jobs:
           dst_token: ${{ secrets.GITEE_PRIVATE_TOKEN }}
           force_update: true
           account_type: org
-          shell_path: ./.github/workflows/gitee-sync-shell.sh
+          shell_path: ./.github/workflows/gitee-sync-shell.sh

Android/APIExample-Audio/app/build.gradle

@@ -48,7 +48,7 @@ dependencies {
         implementation fileTree(dir: "${localSdkPath}", include: ['*.jar', '*.aar'])
     }
     else{
-        def agora_sdk_version = "4.2.6"
+        def agora_sdk_version = "4.3.0"
         // case 1: full single lib with voice only
         implementation "io.agora.rtc:voice-sdk:${agora_sdk_version}"
         // case 2: partial libs with voice only

Android/APIExample-Audio/app/src/main/AndroidManifest.xml

@@ -13,6 +13,9 @@
 
     <permission-group android:name="io.agora.api.example.audio.andpermission"/>
 
+    <uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
+<!--    <uses-permission android:name="android.permission.POST_NOTIFICATIONS" />-->
+
     <application
         android:name=".MainApplication"
         android:allowBackup="true"
@@ -43,6 +46,9 @@
             android:windowSoftInputMode="stateAlwaysHidden"
             android:screenOrientation="portrait" />
 
+        <service android:name=".examples.basic.JoinChannelAudio$LocalRecordingService"
+            android:foregroundServiceType="microphone"/>
+
     </application>
 
 </manifest>

Android/APIExample-Audio/app/src/main/java/io/agora/api/example/common/BaseFragment.java

@@ -4,78 +4,147 @@
 import android.os.Bundle;
 import android.os.Handler;
 import android.os.Looper;
-import android.view.Menu;
+import android.text.TextUtils;
+import android.view.View;
 import android.widget.Toast;
 
+import androidx.activity.OnBackPressedCallback;
 import androidx.annotation.NonNull;
 import androidx.annotation.Nullable;
 import androidx.appcompat.app.AlertDialog;
 import androidx.fragment.app.Fragment;
+import androidx.navigation.Navigation;
 
-import io.agora.api.example.R;
-
-public class BaseFragment extends Fragment
-{
+/**
+ * The type Base fragment.
+ */
+public class BaseFragment extends Fragment {
+    /**
+     * The Handler.
+     */
     protected Handler handler;
     private AlertDialog mAlertDialog;
+    private String mAlertMessage;
+    private final OnBackPressedCallback onBackPressedCallback = new OnBackPressedCallback(false) {
+        @Override
+        public void handleOnBackPressed() {
+            onBackPressed();
+        }
+    };
 
     @Override
-    public void onCreate(@Nullable Bundle savedInstanceState)
-    {
+    public void onCreate(@Nullable Bundle savedInstanceState) {
         super.onCreate(savedInstanceState);
         handler = new Handler(Looper.getMainLooper());
+        requireActivity().getOnBackPressedDispatcher().addCallback(onBackPressedCallback);
+    }
+
+    @Override
+    public void onAttach(@NonNull Context context) {
+        super.onAttach(context);
+        onBackPressedCallback.setEnabled(true);
+    }
+
+    @Override
+    public void onDetach() {
+        super.onDetach();
+        onBackPressedCallback.setEnabled(false);
     }
 
+    /**
+     * Show alert.
+     *
+     * @param message the message
+     */
     protected void showAlert(String message) {
+        this.showAlert(message, true);
+    }
 
+    /**
+     * Show alert.
+     *
+     * @param message       the message
+     * @param showRepeatMsg the show repeat msg
+     */
+    protected void showAlert(String message, boolean showRepeatMsg) {
         runOnUIThread(() -> {
             Context context = getContext();
-            if(context == null){
+            if (context == null) {
                 return;
             }
             if (mAlertDialog == null) {
                 mAlertDialog = new AlertDialog.Builder(context).setTitle("Tips")
                         .setPositiveButton("OK", (dialog, which) -> dialog.dismiss())
                         .create();
             }
+            if (!showRepeatMsg && !TextUtils.isEmpty(mAlertMessage) && mAlertMessage.equals(message)) {
+                return;
+            }
+            mAlertMessage = message;
             mAlertDialog.setMessage(message);
             mAlertDialog.show();
         });
     }
 
-    protected final void showLongToast(final String msg)
-    {
+    /**
+     * Reset alert.
+     */
+    protected void resetAlert() {
+        runOnUIThread(() -> mAlertMessage = "");
+    }
+
+    /**
+     * Show long toast.
+     *
+     * @param msg the msg
+     */
+    protected final void showLongToast(final String msg) {
         runOnUIThread(() -> {
             Context context = getContext();
-            if(context == null){
+            if (context == null) {
                 return;
             }
             Toast.makeText(context, msg, Toast.LENGTH_LONG).show();
         });
     }
 
-    protected final void showShortToast(final String msg)
-    {
+    /**
+     * Show short toast.
+     *
+     * @param msg the msg
+     */
+    protected final void showShortToast(final String msg) {
         runOnUIThread(() -> {
             Context context = getContext();
-            if(context == null){
+            if (context == null) {
                 return;
             }
             Toast.makeText(context, msg, Toast.LENGTH_SHORT).show();
         });
     }
 
-    protected final void runOnUIThread(Runnable runnable){
+    /**
+     * Run on ui thread.
+     *
+     * @param runnable the runnable
+     */
+    protected final void runOnUIThread(Runnable runnable) {
         this.runOnUIThread(runnable, 0);
     }
 
-    protected final void runOnUIThread(Runnable runnable, long delay){
-        if(handler != null && runnable != null && getContext() != null){
+    /**
+     * Run on ui thread.
+     *
+     * @param runnable the runnable
+     * @param delay    the delay
+     */
+    protected final void runOnUIThread(Runnable runnable, long delay) {
+        if (handler != null && runnable != null && getContext() != null) {
             if (delay <= 0 && handler.getLooper().getThread() == Thread.currentThread()) {
                 runnable.run();
-            }else{
+            } else {
                 handler.postDelayed(() -> {
-                    if(getContext() != null){
+                    if (getContext() != null) {
                         runnable.run();
                     }
                 }, delay);
@@ -87,15 +156,19 @@ protected final void runOnUIThread(Runnable runnable, long delay){
     public void onDestroy() {
         super.onDestroy();
         handler.removeCallbacksAndMessages(null);
-        if(mAlertDialog != null){
+        if (mAlertDialog != null) {
             mAlertDialog.dismiss();
             mAlertDialog = null;
         }
     }
 
-    @Override
-    public void onPrepareOptionsMenu(@NonNull Menu menu) {
-        super.onPrepareOptionsMenu(menu);
-        menu.setGroupVisible(R.id.main_setting_group, false);
+    /**
+     * On back pressed.
+     */
+    protected void onBackPressed() {
+        View view = getView();
+        if (view != null) {
+            Navigation.findNavController(view).navigateUp();
+        }
     }
 }

Android/APIExample-Audio/app/src/main/java/io/agora/api/example/common/model/StatisticsInfo.java

@@ -1,26 +1,24 @@
 package io.agora.api.example.common.model;
 
-import io.agora.rtc2.IRtcEngineEventHandler.LastmileProbeResult;
-import io.agora.rtc2.IRtcEngineEventHandler.LocalAudioStats;
+import io.agora.rtc2.IRtcEngineEventHandler;
 import io.agora.rtc2.IRtcEngineEventHandler.LocalVideoStats;
 import io.agora.rtc2.IRtcEngineEventHandler.RemoteAudioStats;
 import io.agora.rtc2.IRtcEngineEventHandler.RemoteVideoStats;
-import io.agora.rtc2.IRtcEngineEventHandler.RtcStats;
 
 public class StatisticsInfo {
     private LocalVideoStats localVideoStats = new LocalVideoStats();
-    private LocalAudioStats localAudioStats = new LocalAudioStats();
+    private IRtcEngineEventHandler.LocalAudioStats localAudioStats = new IRtcEngineEventHandler.LocalAudioStats();
     private RemoteVideoStats remoteVideoStats = new RemoteVideoStats();
     private RemoteAudioStats remoteAudioStats = new RemoteAudioStats();
-    private RtcStats rtcStats = new RtcStats();
+    private IRtcEngineEventHandler.RtcStats rtcStats = new IRtcEngineEventHandler.RtcStats();
     private int quality;
-    private LastmileProbeResult lastMileProbeResult;
+    private IRtcEngineEventHandler.LastmileProbeResult lastMileProbeResult;
 
     public void setLocalVideoStats(LocalVideoStats localVideoStats) {
         this.localVideoStats = localVideoStats;
     }
 
-    public void setLocalAudioStats(LocalAudioStats localAudioStats) {
+    public void setLocalAudioStats(IRtcEngineEventHandler.LocalAudioStats localAudioStats) {
         this.localAudioStats = localAudioStats;
     }
 
@@ -32,7 +30,7 @@ public void setRemoteAudioStats(RemoteAudioStats remoteAudioStats) {
         this.remoteAudioStats = remoteAudioStats;
     }
 
-    public void setRtcStats(RtcStats rtcStats) {
+    public void setRtcStats(IRtcEngineEventHandler.RtcStats rtcStats) {
         this.rtcStats = rtcStats;
     }
 
@@ -162,7 +160,7 @@ public String getLastMileResult() {
         return stringBuilder.toString();
     }
 
-    public void setLastMileProbeResult(LastmileProbeResult lastmileProbeResult) {
+    public void setLastMileProbeResult(IRtcEngineEventHandler.LastmileProbeResult lastmileProbeResult) {
         this.lastMileProbeResult = lastmileProbeResult;
     }