GNSPermission-Klasse
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Mit dieser Klasse können Sie den Nearby-Berechtigungsstatus für die App auf dem aktuellen Gerät verwalten.
Der Nutzer muss die entsprechende Berechtigung erteilen, bevor Publikationen und Abos funktionieren. Wenn die App zum ersten Mal eine Publikation oder ein Abo erstellt, wird automatisch das Nearby-Berechtigungsdialogfeld angezeigt, über das der Nutzer zustimmen kann. Lehnt der Nutzer dies ab, wird jedes Mal, wenn eine Publikation oder ein Abo erstellt wird, eine Benachrichtigung angezeigt. So hat der Nutzer noch einmal die Möglichkeit, der Teilnahme zuzustimmen.
Es wird empfohlen, dem Nutzer in Ihrer App eine Methode zum Aktivieren oder Deaktivieren der Berechtigung anzubieten, z. B. über einen Umschalter auf einer Einstellungsseite. Wenn der Nutzer die Option ein-/ausschaltet, sollte die App die unten aufgeführten Methoden isGranted und setGranted aufrufen, um den Berechtigungsstatus umzuschalten.
Erstellen Sie ein GNSPermission-Objekt und übergeben Sie einen geänderten Handler, um den Berechtigungsstatus zu erfassen. Der Handler wird immer dann aufgerufen, wenn sich der Berechtigungsstatus ändert. So bleibt die Benutzeroberfläche Ihrer App mit dem aktuellen Status synchron.
Übernimmt NSObject.
|
| (instancetype) | - initWithChangedHandler: |
| | Initialisiert das Berechtigungsobjekt mit einem Handler, der aufgerufen wird, wenn sich der Berechtigungsstatus ändert. Mehr...
|
| |
|
| (BOOL) | + isGranted |
| | Gibt an, ob der App auf diesem Gerät derzeit die Nearby-Berechtigung gewährt wird. Mehr...
|
| |
| (void) | + setGranted: |
| | Ändert den Nearby-Berechtigungsstatus. Mehr...
|
| |
| - (instancetype) initWithChangedHandler: |
|
(GNSPermissionHandler) |
changedHandler |
|
Initialisiert das Berechtigungsobjekt mit einem Handler, der aufgerufen wird, wenn sich der Berechtigungsstatus ändert.
Der Handler ermöglicht der App, ihre Benutzeroberfläche mit dem Berechtigungsstatus synchron zu halten. Der Handler wird erst aufgerufen, wenn der Nutzer die Berechtigung genehmigt oder verweigert hat.
- Parameters
-
| handler | The permission granted handler |
Gibt an, ob der App auf diesem Gerät derzeit die Nearby-Berechtigung gewährt wird.
JA bedeutet, dass der Nutzer die Nearby-Berechtigung erteilt hat, und NEIN bedeutet, dass der Nutzer die Berechtigung verweigert hat. Ohne die entsprechende Berechtigung funktionieren Publikationen und Abos nicht.
| + (void) setGranted: |
|
(BOOL) |
granted |
|
Ändert den Nearby-Berechtigungsstatus.
Dieser sollte nur als Reaktion auf die Nutzeraktion zum Ändern des Berechtigungsstatus aufgerufen werden.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-08-13 (UTC).
[null,null,["Zuletzt aktualisiert: 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."]]
