classref: Sync with current master branch (bdf625b)

This commit is contained in:
Godot Organization
2025-01-04 03:20:59 +00:00
parent cb6eb02112
commit eab235f772
37 changed files with 496 additions and 345 deletions

View File

@@ -1717,9 +1717,17 @@ Reads a user input as a UTF-8 encoded string from the standard input. This opera
:ref:`bool<class_bool>` **request_permission**\ (\ name\: :ref:`String<class_String>`\ ) :ref:`🔗<class_OS_method_request_permission>`
Requests permission from the OS for the given ``name``. Returns ``true`` if the permission has been successfully granted.
Requests permission from the OS for the given ``name``. Returns ``true`` if the permission has already been granted. See also :ref:`MainLoop.on_request_permissions_result<class_MainLoop_signal_on_request_permissions_result>`.
\ **Note:** This method is currently only implemented on Android, to specifically request permission for ``"RECORD_AUDIO"`` by ``AudioDriverOpenSL``.
The ``name`` must be the full permission name. For example:
- ``OS.request_permission("android.permission.READ_EXTERNAL_STORAGE")``\
- ``OS.request_permission("android.permission.POST_NOTIFICATIONS")``\
\ **Note:** Permission must be checked during export.
\ **Note:** This method is only implemented on Android.
.. rst-class:: classref-item-separator
@@ -1731,7 +1739,9 @@ Requests permission from the OS for the given ``name``. Returns ``true`` if the
:ref:`bool<class_bool>` **request_permissions**\ (\ ) :ref:`🔗<class_OS_method_request_permissions>`
Requests *dangerous* permissions from the OS. Returns ``true`` if permissions have been successfully granted.
Requests *dangerous* permissions from the OS. Returns ``true`` if permissions have already been granted. See also :ref:`MainLoop.on_request_permissions_result<class_MainLoop_signal_on_request_permissions_result>`.
\ **Note:** Permissions must be checked during export.
\ **Note:** This method is only implemented on Android. Normal permissions are automatically granted at install time in Android applications.