Classe GNSStrategy
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
La strategia da utilizzare per rilevare i dispositivi nelle vicinanze.
Eredita NSObject.
|
| (instancetype) | + strategy |
| | Restituisce la strategia predefinita, che utilizza i valori predefiniti per tutte le proprietà. Altro...
|
| |
| (instancetype) | + strategyWithParamsBlock: |
| | Restituisce una strategia personalizzata. Puoi impostare qualsiasi proprietà opzionale in paramsBlock. Altro...
|
| |
|
| GNSDiscoveryMode | discoveryMode |
| | Per consentire il rilevamento di dispositivi nelle vicinanze, un dispositivo deve trasmettere un codice di accoppiamento e l'altro deve cercare i codici di accoppiamento. Altro...
|
| |
| GNSDiscoveryMediums | discoveryMediums |
| | Consente di stabilire quali mezzi utilizzare per trasmettere e scansionare i codici di accoppiamento quando vengono rilevati dispositivi nelle vicinanze. Altro...
|
| |
| BOOL | allowInBackground |
| | Prova a usare la strategia di scoperta quando l'app è in background. Altro...
|
| |
| + (instancetype) strategy |
|
|
|
Restituisce la strategia predefinita, che utilizza i valori predefiniti per tutte le proprietà.
Restituisce una strategia personalizzata. Puoi impostare qualsiasi proprietà opzionale in paramsBlock.
| - (GNSDiscoveryMode) discoveryMode |
|
readnonatomicassign |
Per consentire il rilevamento di dispositivi nelle vicinanze, un dispositivo deve trasmettere un codice di accoppiamento e l'altro deve cercare i codici di accoppiamento.
Poiché non c'è modo di negoziare in anticipo, l'impostazione predefinita è che tutti i dispositivi possano trasmettere e scansionare.
Questa proprietà ti consente di personalizzare questo comportamento, limitando la tua app alla trasmissione o alla scansione. Ad esempio, considera un'app mobile che comunica con un decoder. Se il decoder è programmato per trasmettere un codice di accoppiamento, l'app mobile potrebbe essere impostata per la sola scansione, per migliorare la latenza.
Il valore predefinito è kGNSDiscoveryModeDefault.
| - (GNSDiscoveryMediums) discoveryMediums |
|
readnonatomicassign |
Consente di stabilire quali mezzi utilizzare per trasmettere e scansionare i codici di accoppiamento quando vengono rilevati dispositivi nelle vicinanze.
Visita la pagina discoveryMode per avere ulteriori informazioni sul rilevamento dei dispositivi.
Il valore predefinito è kGNSDiscoveryMediumsDefault.
| - (BOOL) allowInBackground |
|
readnonatomicassign |
Prova a usare la strategia di scoperta quando l'app è in background.
Tieni presente che non tutte le strategie potranno essere eseguite in background. Puoi richiederlo qui e, a seconda di altre impostazioni e circostanze, la strategia potrebbe essere autorizzata a continuare in background. Al momento sono supportate solo le scansioni/trasmissioni BLE.
Il valore predefinito è NO.
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\u003eThe \u003ccode\u003eGNSStrategy\u003c/code\u003e class defines the approach for discovering nearby devices, encompassing discovery mode, mediums, and background operation.\u003c/p\u003e\n"],["\u003cp\u003eYou can obtain a default strategy with preset configurations or customize a strategy by specifying properties using a params block.\u003c/p\u003e\n"],["\u003cp\u003eFor device discovery, one device broadcasts a pairing code, and the other scans; you can customize this behavior by setting the \u003ccode\u003ediscoveryMode\u003c/code\u003e property.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003ediscoveryMediums\u003c/code\u003e property allows controlling the communication channels (e.g., Bluetooth, ultrasound) used for discovering nearby devices.\u003c/p\u003e\n"],["\u003cp\u003eWhile the default setting disallows background operation, you can request background execution for the discovery strategy using \u003ccode\u003eallowInBackground\u003c/code\u003e, although it's not always guaranteed.\u003c/p\u003e\n"]]],[],null,["# GNSStrategy Class\n\n[Class Methods](#pub-static-methods) \\| [Properties](#properties) \nGNSStrategy Class Reference \n\nOverview\n--------\n\nThe strategy to use to detect nearby devices.\n\nInherits NSObject.\n\n|----------------|---------------------------------------------------------------------------------------------------------------------------------------|\n| Class Method Summary -------------------- ||\n| (instancetype) | + [strategy](/nearby/messages/ios/reference/interface_g_n_s_strategy#afc67e9c07852a35945a13998bac050ed) |\n| | Returns the default strategy, which uses the default values for all properties. [More...](#afc67e9c07852a35945a13998bac050ed) |\n| ||\n| (instancetype) | + [strategyWithParamsBlock:](/nearby/messages/ios/reference/interface_g_n_s_strategy#af97d06481398cf1e5d7f2f8b54026966) |\n| | Returns a custom strategy. You can set any of the optional properties in `paramsBlock`. [More...](#af97d06481398cf1e5d7f2f8b54026966) |\n| ||\n\n|---------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Property Summary ---------------- ||\n| GNSDiscoveryMode | [discoveryMode](/nearby/messages/ios/reference/interface_g_n_s_strategy#ad10088af20c44daa2d29f9099b9d6422) |\n| | For nearby device discovery, one device must broadcast a pairing code and the other device must scan for pairing codes. [More...](#ad10088af20c44daa2d29f9099b9d6422) |\n| ||\n| GNSDiscoveryMediums | [discoveryMediums](/nearby/messages/ios/reference/interface_g_n_s_strategy#ad9b6ae317c7ba8ba3ca9da28f831ae0a) |\n| | Controls which mediums to use to broadcast and scan pairing codes when discovering nearby devices. [More...](#ad9b6ae317c7ba8ba3ca9da28f831ae0a) |\n| ||\n| BOOL | [allowInBackground](/nearby/messages/ios/reference/interface_g_n_s_strategy#a4794a869b9225cca308c30e40905f39c) |\n| | Try to use the discovery strategy when the app is in the background. [More...](#a4794a869b9225cca308c30e40905f39c) |\n| ||\n\nMethod Detail\n-------------\n\n|---------------------------|---|---|---|\n| + (instancetype) strategy | | | |\n\nReturns the default strategy, which uses the default values for all properties. \n\n|-------------------------------------------|---|----------------------------------------------------------------------------------------------------|---------------|---|\n| + (instancetype) strategyWithParamsBlock: | | (void(\\^)([GNSStrategyParams](/nearby/messages/ios/reference/interface_g_n_s_strategy_params) \\*)) | *paramsBlock* | |\n\nReturns a custom strategy. You can set any of the optional properties in `paramsBlock`.\n\nProperty Detail\n---------------\n\n|-------------------------------------------------------------------------------|---------------------|\n| |------------------------------------| | - (GNSDiscoveryMode) discoveryMode | | readnonatomicassign |\n\nFor nearby device discovery, one device must broadcast a pairing code and the other device must scan for pairing codes.\n\nBecause there is no way to negotiate beforehand, the default is for all devices to both broadcast and scan.\n\nThis property lets you customize this behavior, restricting your app to either broadcast or scan. For example, consider a mobile app that communicates with a set-top box. If the set-top box is programmed to broadcast a pairing code, the mobile app could be set to scan only, to improve latency.\n\nThe default is `kGNSDiscoveryModeDefault`. \n\n|-------------------------------------------------------------------------------------------|---------------------|\n| |------------------------------------------| | - (GNSDiscoveryMediums) discoveryMediums | | readnonatomicassign |\n\nControls which mediums to use to broadcast and scan pairing codes when discovering nearby devices.\n\nSee `discoveryMode` for more details about device discovery.\n\nThe default is `kGNSDiscoveryMediumsDefault`. \n\n|---------------------------------------------------------------|---------------------|\n| |----------------------------| | - (BOOL) allowInBackground | | readnonatomicassign |\n\nTry to use the discovery strategy when the app is in the background.\n\nNote that not all strategies will be permitted to run in the background. You can request this here, and depending on other settings and circumstances, the strategy might be allowed to continue in the background. Currently only BLE scans/broadcasts are supported.\n\nThe default is `NO`."]]
