Classe GNSSubscriptionParams
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Parametri facoltativi per un abbonamento.
Consulta le dichiarazioni della proprietà di seguito per le spiegazioni di ciascun parametro.
Eredita NSObject.
| - (GNSDeviceTypes) deviceTypesToDiscover |
|
readwritenonatomicassign |
I tipi di dispositivi da scoprire.
Il valore predefinito è kGNSDeviceUsingNearby.
| - (NSString*) messageNamespace |
|
readwritenonatomicassign |
Lo spazio dei nomi del messaggio da trovare.
La stringa vuota è lo spazio dei nomi predefinito ed è privata per ogni app (o per le app che condividono un progetto Google Developer Console).
Il tipo di messaggio da associare. Non deve essere nullo. La stringa vuota è il tipo predefinito.
La strategia da utilizzare per rilevare dispositivi nelle vicinanze (non beacon).
La strategia da utilizzare per la scansione dei beacon.
| - (GNSOperationStatusHandler) statusHandler |
|
readwritenonatomiccopy |
Un gestore per lo stato delle iscrizioni.
Può essere utilizzato per monitorare lo stato di un abbonamento appena creato.
| - (GNSPermissionRequestHandler) permissionRequestHandler |
|
readwritenonatomiccopy |
Un gestore per la richiesta dell'autorizzazione utente per utilizzare Qui vicino.
Questo gestore sostituisce la finestra di dialogo predefinita utilizzata dalla funzione Qui vicino; se fornisci questo gestore, la funzione non mostrerà la finestra di dialogo delle autorizzazioni.
Nel gestore delle richieste, devi richiedere l'autorizzazione dell'utente a eseguire l'attività che richiede l'utilizzo della funzionalità Qui vicino, spiegando perché viene usata. Quando l'utente ha dato o negato il consenso, devi chiamare il blocco trasmesso al gestore delle richieste. Se inserisci YES nel blocco, significa che l'utente ha acconsentito al funzionamento di Qui vicino. Se superi NO, significa che l'utente non ha dato il consenso. Le tue pubblicazioni e i tuoi abbonamenti non funzioneranno fino a quando non verrà dato il consenso.
Il gestore può essere utilizzato anche come metodo di "preflight" per le finestre di dialogo delle autorizzazioni iOS. Puoi usarla per spiegare perché l'utente deve acconsentire alle autorizzazioni iOS prima che la tua app possa eseguire le funzioni correlate alla funzionalità Nelle vicinanze.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-08-13 UTC.
[null,null,["Ultimo aggiornamento 2025-08-13 UTC."],[[["\u003cp\u003e\u003ccode\u003eGNSSubscriptionParams\u003c/code\u003e provides optional parameters for customizing Nearby Messages subscriptions.\u003c/p\u003e\n"],["\u003cp\u003eParameters include device types, message namespace and type, discovery strategies, and handlers for status and permissions.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003estrategy\u003c/code\u003e property controls discovery of Nearby devices, while \u003ccode\u003ebeaconStrategy\u003c/code\u003e is for beacon scanning.\u003c/p\u003e\n"],["\u003cp\u003eYou can define handlers to monitor subscription status and manage user permission requests for Nearby.\u003c/p\u003e\n"],["\u003cp\u003eDefault values are provided for most parameters, simplifying basic subscription setup.\u003c/p\u003e\n"]]],[],null,["# GNSSubscriptionParams Class\n\n[Properties](#properties) \nGNSSubscriptionParams Class Reference \n\nOverview\n--------\n\nOptional parameters for a subscription.\n\nSee the property declarations below for explanations of each parameter.\n\nInherits NSObject.\n\n|----------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------|\n| Property Summary ---------------- ||\n| GNSDeviceTypes | [deviceTypesToDiscover](/nearby/messages/ios/reference/interface_g_n_s_subscription_params#aa972c219c7211e4a7c5fa785d0b11274) |\n| | The types of devices to discover. [More...](#aa972c219c7211e4a7c5fa785d0b11274) |\n| ||\n| NSString \\* | [messageNamespace](/nearby/messages/ios/reference/interface_g_n_s_subscription_params#a70e97d712c8bc53a7f9076055a91256a) |\n| | The message namespace to match. [More...](#a70e97d712c8bc53a7f9076055a91256a) |\n| ||\n| NSString \\* | [type](/nearby/messages/ios/reference/interface_g_n_s_subscription_params#a86a3f486660ee32e5824b03fcef62533) |\n| | The message type to match. Must not be nil. The empty string is the default type. [More...](#a86a3f486660ee32e5824b03fcef62533) |\n| ||\n| [GNSStrategy](/nearby/messages/ios/reference/interface_g_n_s_strategy) \\* | [strategy](/nearby/messages/ios/reference/interface_g_n_s_subscription_params#a20f64cb0cfd8890f640536dfb586e814) |\n| | The strategy to use for discovering Nearby devices (non-beacons). [More...](#a20f64cb0cfd8890f640536dfb586e814) |\n| ||\n| [GNSBeaconStrategy](/nearby/messages/ios/reference/interface_g_n_s_beacon_strategy) \\* | [beaconStrategy](/nearby/messages/ios/reference/interface_g_n_s_subscription_params#a2a2c2aecb81fef6ff47fc4204110f6da) |\n| | The strategy to use for beacon scanning. [More...](#a2a2c2aecb81fef6ff47fc4204110f6da) |\n| ||\n| GNSOperationStatusHandler | [statusHandler](/nearby/messages/ios/reference/interface_g_n_s_subscription_params#afb1a6c67329810c58745f2f4625240cc) |\n| | A handler for subscription status. [More...](#afb1a6c67329810c58745f2f4625240cc) |\n| ||\n| GNSPermissionRequestHandler | [permissionRequestHandler](/nearby/messages/ios/reference/interface_g_n_s_subscription_params#ac037a18632caddcdb730bdb2a0f9c1b1) |\n| | A handler for requesting user permission to use Nearby. [More...](#ac037a18632caddcdb730bdb2a0f9c1b1) |\n| ||\n\nProperty Detail\n---------------\n\n|-------------------------------------------------------------------------------------------|--------------------------|\n| |------------------------------------------| | - (GNSDeviceTypes) deviceTypesToDiscover | | readwritenonatomicassign |\n\nThe types of devices to discover.\n\nThe default is `kGNSDeviceUsingNearby`. \n\n|-------------------------------------------------------------------------|--------------------------|\n| |---------------------------------| | - (NSString\\*) messageNamespace | | readwritenonatomicassign |\n\nThe message namespace to match.\n\nThe empty string is the default namespace, and is private to each app (or apps sharing a Google Developer Console project). \n\n|-------------------------------------------------|--------------------------|\n| |---------------------| | - (NSString\\*) type | | readwritenonatomicassign |\n\nThe message type to match. Must not be nil. The empty string is the default type. \n\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------|\n| |---------------------------------------------------------------------------------------| | - ([GNSStrategy](/nearby/messages/ios/reference/interface_g_n_s_strategy)\\*) strategy | | readwritenonatomicassign |\n\nThe strategy to use for discovering Nearby devices (non-beacons). \n\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------|\n| |----------------------------------------------------------------------------------------------------------| | - ([GNSBeaconStrategy](/nearby/messages/ios/reference/interface_g_n_s_beacon_strategy)\\*) beaconStrategy | | readwritenonatomicassign |\n\nThe strategy to use for beacon scanning. \n\n|-------------------------------------------------------------------------------------------------|------------------------|\n| |---------------------------------------------| | - (GNSOperationStatusHandler) statusHandler | | readwritenonatomiccopy |\n\nA handler for subscription status.\n\nIt can be used for tracking the status of a newly created subscription. \n\n|---------------------------------------------------------------------------------------------------------------------------|------------------------|\n| |----------------------------------------------------------| | - (GNSPermissionRequestHandler) permissionRequestHandler | | readwritenonatomiccopy |\n\nA handler for requesting user permission to use Nearby.\n\nThis handler overrides the default dialog used by Nearby; if you supply this handler, Nearby will not show its permission dialog.\n\nIn your request handler, you should request the user's permission to perform the task that requires the use of Nearby, explaining why it's being used. When the user has given or denied consent, you must call the block that's passed into your request handler. If you pass `YES` into the block, it means the user has consented to allow Nearby to function. If you pass `NO`, it means the user has not consented; your publications and subscriptions will not work until consent has been given.\n\nThe handler can also be used as a method of \"preflighting\" for the iOS permission dialogs. You can use it to explain why the user is expected to consent to the iOS permissions before your app can perform its Nearby related functions."]]
