Android Permissions

• Android_Check_Permissions()

  • Syntax: _Android_Check_Permissions(Warning_Title, Warning_Content, Warning_Button, Function_To_Run)

  • Purpose: Checks if necessary permissions have been granted for your Android app and prompts the user if they haven't.

  • Parameters:

    • Warning_Title, Warning_Content, Warning_Button: Customize the popup dialog.

    • Function_To_Run: A function executed after the popup closes, often used to re-check permissions or take actions depending on their state.

• Android_Is_Permission_Granted()

  • Syntax: _Android_Is_Permission_Granted(Permission_Name)

  • Purpose: Checks if a specific permission is currently granted.

  • Parameters:

    • Permission_Name: The name of the permission. Can use common types (e.g., "Camera") or detailed Android permission names. Accepts commas to check multiple permissions.

  • Returns: True (permission granted) or False (permission not granted).

• Android_Request_Permission()

  • Syntax: _Android_Request_Permission(Permission_Names, Urgency_Level, Request_Title, Request_Description, Function_Permission)

  • Purpose: Initiates an Android permission request.

  • Parameters:

    • Permission_Names: Permissions to request (similar to Android_Is_Permission_Granted).

    • Urgency_Level: "Low", "Normal", or "Critical" – controls how strongly the system prompts for and explains the need for the permission.

    • Request_Title, Request_Description: Customize the rationale dialog presented to the user.

    • Function_Permission: Function called after the request completes, where you should re-check permissions.

Android System UI Control

• Android_System_UI()

  • Syntax: _Android_System_UI(Value)

  • Purpose: Modifies the visibility and behavior of the Android system UI elements (status bar, navigation bars, etc.).

  • Parameters:

    • "immersiveSticky": Hides UI elements, but they reappear temporarily on swipes.

    • "immersive": Hides UI elements and they reappear on swipes, staying visible. This may trigger resize events.

    • "lowProfile": Dims navigation bar icons (on older Android versions).

    • "default": Restores standard UI behavior.

• Get_Android_System_UI()

  • Syntax: _Get_Android_System_UI()

  • Purpose: Retrieves the current state of the Android system UI settings.

  • Returns: A string value indicating the current UI mode.

Important Notes:

• Android Only: These functions are specifically for the Android platform.

• Permissions in Build Settings: Remember to list any required Android permissions in your project's build.settings for these commands to work correctly.

• Asynchronous Behavior: Permission requests are handled asynchronously, meaning your code keeps running while the user interacts with the dialogs. Use the provided callback functions to handle the results and take appropriate actions!