Clase GNSPermission
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Esta clase te permite administrar el estado del permiso de Nearby para la app en el dispositivo actual.
El usuario debe otorgar permiso antes de que funcionen las publicaciones y suscripciones. La primera vez que la aplicación crea una publicación o una suscripción, se muestra automáticamente el diálogo del permiso de Nearby y permite que el usuario acepte esta opción. Si el usuario la rechaza, se mostrará una alerta cada vez que se cree una publicación o suscripción, lo que le dará otra oportunidad de aceptar la política.
Se recomienda que tu app proporcione al usuario un método para activar o desactivar el permiso, por ejemplo, mediante un interruptor de activación en una página de configuración. Cuando el usuario lo active, la app debe llamar a los métodos isGranted y setGranted que aparecen a continuación para activar o desactivar el estado del permiso.
Para hacer un seguimiento del estado del permiso, crea un objeto GNSPermission y pasa un controlador modificado. Se llamará al controlador cada vez que se cambie el estado del permiso, lo que permitirá que la IU de tu app se mantenga sincronizada con el estado actual.
Hereda NSObject.
|
| (instancetype) | - initWithChangedHandler: |
| | Inicializa el objeto de permiso con un controlador al que se llama cada vez que cambia el estado del permiso. Más...
|
| |
|
| (BOOL) | + isGranted |
| | Indica si actualmente se otorga permiso de Nearby para la app en este dispositivo. Más...
|
| |
| (void) | + setGranted: |
| | Cambia el estado del permiso de Nearby. Más...
|
| |
| - (instancetype) initWithChangedHandler: |
|
(GNSPermissionHandler) |
changedHandler |
|
Inicializa el objeto de permiso con un controlador al que se llama cada vez que cambia el estado del permiso.
El controlador permite que la app mantenga su IU sincronizada con el estado del permiso. No se llama al controlador hasta que el usuario haya aprobado o denegado el permiso.
- Parameters
-
| handler | The permission granted handler |
Indica si actualmente se otorga permiso de Nearby para la app en este dispositivo.
SÍ significa que el usuario le otorgó permiso a Nearby, mientras que NO significa que el usuario rechazó el permiso. Si no se otorgó el permiso, las publicaciones y suscripciones no funcionarán.
| + (void) setGranted: |
|
(BOOL) |
granted |
|
Cambia el estado del permiso de Nearby.
Solo se debe llamar en respuesta a la acción del usuario de cambiar el estado del permiso.
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-08-13 (UTC)
[null,null,["Última actualización: 2025-08-13 (UTC)"],[[["\u003cp\u003eThe \u003ccode\u003eGNSPermission\u003c/code\u003e class manages the Nearby permission state for your app, enabling features like publications and subscriptions.\u003c/p\u003e\n"],["\u003cp\u003eUsers must grant Nearby permission for these features to function; the system automatically requests this permission when needed.\u003c/p\u003e\n"],["\u003cp\u003eYou can track and react to permission state changes using a \u003ccode\u003eGNSPermission\u003c/code\u003e object with a change handler.\u003c/p\u003e\n"],["\u003cp\u003eProvide a UI element, like a toggle switch, allowing users to control the Nearby permission and update the state using \u003ccode\u003eisGranted\u003c/code\u003e and \u003ccode\u003esetGranted\u003c/code\u003e methods.\u003c/p\u003e\n"],["\u003cp\u003eThe initial permission request is automatic, but subsequent requests depend on the user's previous choice and your app's UI for toggling the permission.\u003c/p\u003e\n"]]],[],null,["# GNSPermission Class\n\n[Instance Methods](#pub-methods) \\| [Class Methods](#pub-static-methods) \nGNSPermission Class Reference \n\nOverview\n--------\n\nThis class lets you manage the Nearby permission state for the app on the current device.\n\nThe user must grant permission before publications and subscriptions will work. The first time the application creates a publication or subscription, the Nearby permission dialog is automatically displayed, giving the user the opportunity to opt in. If the user denies, an alert will be displayed each time a publication or subscription is subsequently created, giving them another chance to opt in.\n\nIt is recommended that your app provide the user a method for switching the permission on or off; for instance, by using a toggle switch in a settings page. When the user toggles it, the app should call the `isGranted` and `setGranted` methods below to toggle the permission state.\n\nTo track the permission state, create a [GNSPermission](/nearby/messages/ios/reference/interface_g_n_s_permission \"This class lets you manage the Nearby permission state for the app on the current device...\") object and pass in a changed handler. The handler will be called whenever the permission state is changed, allowing your app's UI to be kept in sync with the current state.\n\nInherits NSObject.\n\n|----------------|------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Instance Method Summary ----------------------- ||\n| (instancetype) | - [initWithChangedHandler:](/nearby/messages/ios/reference/interface_g_n_s_permission#a28317128a0274fd2f24c8e21456f2276) |\n| | Initializes the permission object with a handler that is called whenever the permission state changes. [More...](#a28317128a0274fd2f24c8e21456f2276) |\n| ||\n\n|--------|--------------------------------------------------------------------------------------------------------------------------|\n| Class Method Summary -------------------- ||\n| (BOOL) | + [isGranted](/nearby/messages/ios/reference/interface_g_n_s_permission#aef0ec5cb0489597c5e90a7af81b4b574) |\n| | Whether Nearby permission is currently granted for the app on this device. [More...](#aef0ec5cb0489597c5e90a7af81b4b574) |\n| ||\n| (void) | + [setGranted:](/nearby/messages/ios/reference/interface_g_n_s_permission#a115c4964d2f1b5317bf888cb40b6e0bf) |\n| | Changes the Nearby permission state. [More...](#a115c4964d2f1b5317bf888cb40b6e0bf) |\n| ||\n\nMethod Detail\n-------------\n\n|------------------------------------------|---|------------------------|------------------|---|\n| - (instancetype) initWithChangedHandler: | | (GNSPermissionHandler) | *changedHandler* | |\n\nInitializes the permission object with a handler that is called whenever the permission state changes.\n\nThe handler lets the app keep its UI in sync with the permission state. The handler is not called until the user has approved or denied permission.\n\nParameters\n:\n\n |---------|--------------------------------|\n | handler | The permission granted handler |\n\n\n|--------------------|---|---|---|\n| + (BOOL) isGranted | | | |\n\nWhether Nearby permission is currently granted for the app on this device.\n\nYES means the user has granted Nearby permission, and NO means the user has denied permission. If permission has not been granted, publications and subscriptions will not work. \n\n|----------------------|---|--------|-----------|---|\n| + (void) setGranted: | | (BOOL) | *granted* | |\n\nChanges the Nearby permission state.\n\nThis should be called only in response to the user action of changing the permission state."]]
