Added fallbackToSettings option to public API

Also added public comments to new promptForPushNotifications method.
Cleaned up NotificationPermissionController permission string by moving
it from a param to internal.
Added Android API level to notification permission prompt check.

Author: jkasten2

Examples/OneSignalDemo/app/src/main/java/com/onesignal/sdktest/model/MainActivityViewModel.java

@@ -561,7 +561,7 @@ private void setupSubscriptionSwitch() {
         subscriptionSwitch.setOnClickListener(v -> {
             OneSignal.disablePush(!subscriptionSwitch.isChecked());
             if (subscriptionSwitch.isChecked())
-                OneSignal.promptForPushNotifications();
+                OneSignal.promptForPushNotifications(true);
         });
     }
 

OneSignalSDK/onesignal/src/main/java/com/onesignal/NotificationPermissionController.kt

@@ -1,20 +1,24 @@
 package com.onesignal
 
+import android.os.Build
+
 object NotificationPermissionController : PermissionsActivity.PermissionCallback {
     private const val PERMISSION_TYPE = "NOTIFICATION"
+    private const val ANDROID_PERMISSION_STRING = "android.permission.POST_NOTIFICATIONS"
 
     init {
         PermissionsActivity.registerAsCallback(PERMISSION_TYPE, this)
     }
 
-    fun prompt(
-        fallbackToSettings: Boolean,
-        androidPermissionString: String,
-    ) {
+    fun prompt(fallbackToSettings: Boolean) {
+        // TODO: Android 13 Beta 1 reports as 32 instead of 33, update to 33 once Google fixes this
+        if (Build.VERSION.SDK_INT < 32)
+            return
+
         PermissionsActivity.startPrompt(
             fallbackToSettings,
             PERMISSION_TYPE,
-            androidPermissionString,
+            ANDROID_PERMISSION_STRING,
             this::class.java
         )
     }

OneSignalSDK/onesignal/src/main/java/com/onesignal/OneSignal.java

@@ -2838,8 +2838,25 @@ void onAnswered(OneSignal.PromptActionResult result) {
       LocationController.getLocation(appContext, true, fallbackToSettings, locationHandler);
    }
 
+   /**
+    * On Android 13 shows the system notification permission prompt to enable displaying
+    * notifications. This is required for apps that target Android API level 33 / "Tiramisu"
+    * to subscribe the device for push notifications.
+    */
    public static void promptForPushNotifications() {
-      NotificationPermissionController.INSTANCE.prompt(true, "android.permission.POST_NOTIFICATIONS");
+      promptForPushNotifications(false);
+   }
+
+   /**
+    * On Android 13 shows the system notification permission prompt to enable displaying
+    * notifications. This is required for apps that target Android API level 33 / "Tiramisu"
+    * to subscribe the device for push notifications.
+    *
+    * @param fallbackToSettings whether to show a Dialog to direct users to the App's notification
+    *                           settings if they have declined before.
+    */
+   public static void promptForPushNotifications(boolean fallbackToSettings) {
+      NotificationPermissionController.INSTANCE.prompt(fallbackToSettings);
    }
 
    /**