Add Android P cutout area support (cocos2d#19286)

* Add Android P cutout area support
Related cocos2d#19285

* coding style fix

* Update AppActivity.java

Fix android build

* suppress lint new api errors

(cherry picked from commit c1acc20)

Author: formatCvt

cocos/platform/android/CCGLViewImpl-android.cpp

@@ -153,6 +153,8 @@ Rect GLViewImpl::getSafeAreaRect() const {
 
     bool isScreenRound = JniHelper::callStaticBooleanMethod("org/cocos2dx/lib/Cocos2dxHelper", "isScreenRound");
     bool hasSoftKeys = JniHelper::callStaticBooleanMethod("org/cocos2dx/lib/Cocos2dxHelper", "hasSoftKeys");
+    bool isCutoutEnabled = JniHelper::callStaticBooleanMethod("org/cocos2dx/lib/Cocos2dxHelper", "isCutoutEnabled");
+
     if(isScreenRound) {
         // edge screen (ex. Samsung Galaxy s7, s9, s9+, Note 9, Nokia 8 Sirocco, Sony Xperia XZ3, Oppo Find X...)
         if(safeAreaRect.size.width < safeAreaRect.size.height) {
@@ -193,6 +195,33 @@ Rect GLViewImpl::getSafeAreaRect() const {
         }
     }
 
+    if (isCutoutEnabled) {
+        // screen with enabled cutout area (ex. Google Pixel 3 XL, Huawei P20, Asus ZenFone 5, etc)
+        static int* safeInsets = JniHelper::callStaticIntArrayMethod("org/cocos2dx/lib/Cocos2dxHelper", "getSafeInsets");
+        if (safeInsets != nullptr) {
+            float safeInsetBottom = safeInsets[0] / _scaleY;
+            float safeInsetLeft = safeInsets[1] / _scaleX;
+            float safeInsetRight = safeInsets[2] / _scaleX;
+            float safeInsetTop = safeInsets[3] / _scaleY;
+
+            // fit safe area rect with safe insets
+            if (safeInsetBottom > 0) {
+                safeAreaRect.origin.y += safeInsetBottom;
+                safeAreaRect.size.height -= safeInsetBottom;
+            }
+            if (safeInsetLeft > 0) {
+                safeAreaRect.origin.x += safeInsetLeft;
+                safeAreaRect.size.width -= safeInsetLeft;
+            }
+            if (safeInsetRight > 0) {
+                safeAreaRect.size.width -= safeInsetRight;
+            }
+            if (safeInsetTop > 0) {
+                safeAreaRect.size.height -= safeInsetTop;
+            }
+        }
+    }
+
     return safeAreaRect;
 }
 

cocos/platform/android/java/src/org/cocos2dx/lib/Cocos2dxHelper.java

@@ -24,7 +24,9 @@ of this software and associated documentation files (the "Software"), to deal
  ****************************************************************************/
 package org.cocos2dx.lib;
 
+import android.annotation.SuppressLint;
 import android.content.pm.PackageManager;
+import android.graphics.Rect;
 import android.media.AudioManager;
 import android.app.Activity;
 import android.content.ComponentName;
@@ -46,9 +48,11 @@ of this software and associated documentation files (the "Software"), to deal
 import android.util.DisplayMetrics;
 import android.util.Log;
 import android.view.Display;
+import android.view.DisplayCutout;
 import android.view.KeyCharacterMap;
 import android.view.KeyEvent;
 import android.view.ViewConfiguration;
+import android.view.Window;
 import android.view.WindowManager;
 import android.hardware.SensorManager;
 
@@ -63,6 +67,7 @@ of this software and associated documentation files (the "Software"), to deal
 import java.lang.reflect.InvocationTargetException;
 import java.lang.reflect.Method;
 import java.util.LinkedHashSet;
+import java.util.List;
 import java.util.Locale;
 import java.util.Map;
 import java.util.Set;
@@ -863,6 +868,48 @@ public static boolean isScreenRound() {
         return false;
     }
 
+    /**
+     * Returns whether the window is always allowed to extend into the DisplayCutout areas on the short edges of the screen.
+     *
+     * @return true if the window in display cutout mode on the short edges of the screen, false otherwise
+     */
+    @SuppressLint("InlinedApi")
+    public static boolean isCutoutEnabled() {
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.P) {
+            WindowManager.LayoutParams lp = sActivity.getWindow().getAttributes();
+            return lp.layoutInDisplayCutoutMode == WindowManager.LayoutParams.LAYOUT_IN_DISPLAY_CUTOUT_MODE_SHORT_EDGES;
+        }
+
+        return false;
+    }
+
+    /**
+     * Returns safe insets array.
+     *
+     * @return array of int with safe insets values
+     */
+    @SuppressLint("NewApi") 
+    public static int[] getSafeInsets() {
+        final int[] safeInsets = new int[]{0, 0, 0, 0};
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.P) {
+            Window cocosWindow = sActivity.getWindow();
+            DisplayCutout displayCutout = cocosWindow.getDecorView().getRootWindowInsets().getDisplayCutout();
+            // Judge whether it is cutouts (aka notch) screen phone by judge cutout equle to null
+            if (displayCutout != null) {
+                List<Rect> rects = displayCutout.getBoundingRects();
+                // Judge whether it is cutouts (aka notch) screen phone by judge cutout rects is null or zero size
+                if (rects != null && rects.size() != 0) {
+                    safeInsets[0] = displayCutout.getSafeInsetBottom();
+                    safeInsets[1] = displayCutout.getSafeInsetLeft();
+                    safeInsets[2] = displayCutout.getSafeInsetRight();
+                    safeInsets[3] = displayCutout.getSafeInsetTop();
+                }
+            }
+        }
+
+        return safeInsets;
+    }
+
     /**
      * Queries about whether any physical keys exist on the
      * any keyboard attached to the device and returns <code>true</code>

cocos/platform/android/jni/JniHelper.h

@@ -186,6 +186,37 @@ class CC_DLL JniHelper
         return nullptr;
     }
 
+    @brief Call of Java static int* method
+    @return address of JniMethodInfo if there are proper JniMethodInfo; otherwise nullptr.
+    */
+    template <typename... Ts>
+    static int* callStaticIntArrayMethod(const std::string& className, 
+                                       const std::string& methodName, 
+                                       Ts... xs) {
+        static int ret[32];
+        cocos2d::JniMethodInfo t;
+        std::string signature = "(" + std::string(getJNISignature(xs...)) + ")[I";
+        if (cocos2d::JniHelper::getStaticMethodInfo(t, className.c_str(), methodName.c_str(), signature.c_str())) {
+            LocalRefMapType localRefs;
+            jintArray array = (jintArray) t.env->CallStaticObjectMethod(t.classID, t.methodID, convert(localRefs, t, xs)...);
+            jsize len = t.env->GetArrayLength(array);
+            if (len <= 32) {
+                jint* elems = t.env->GetIntArrayElements(array, 0);
+                if (elems) {
+                    memcpy(ret, elems, sizeof(int) * len);
+                    t.env->ReleaseIntArrayElements(array, elems, 0);
+                };
+            }
+            t.env->DeleteLocalRef(t.classID);
+            deleteLocalRefs(t.env, localRefs);
+            return &ret[0];
+        } else {
+            reportError(className, methodName, signature);
+        }
+        return nullptr;
+    }
+
+    /**
     template <typename... Ts>
     static Vec3 callStaticVec3Method(const std::string& className, 
                                        const std::string& methodName, 

tests/game-controller-test/proj.android/src/org/cocos2dx/game_controller_test/AppActivity.java

@@ -27,12 +27,22 @@ of this software and associated documentation files (the "Software"), to deal
 //import org.cocos2dx.lib.GameControllerHelper.ControllerListener;
 
 import android.os.Bundle;
+import android.os.Build;
+import android.view.WindowManager;
+import android.view.WindowManager.LayoutParams;
 
 public class AppActivity extends GameControllerActivity {
 
     @Override
     protected void onCreate(Bundle savedInstanceState) {
         super.onCreate(savedInstanceState);
+        }
+        // Make sure we're running on Pie or higher to change cutout mode
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.P) {
+            // Enable rendering into the cutout area
+            WindowManager.LayoutParams lp = getWindow().getAttributes();
+            lp.layoutInDisplayCutoutMode = WindowManager.LayoutParams.LAYOUT_IN_DISPLAY_CUTOUT_MODE_SHORT_EDGES;
+            getWindow().setAttributes(lp);
 
         //The standard controller,without doing anything special. e.g: Amazon Fire TV