# Eventi di prossimità
<a name="iot-sidewalk-proximity-events"></a>

Gli eventi di prossimità pubblicano notifiche degli eventi quando AWS IoT riceve un beacon dal dispositivo Sidewalk. Quando il dispositivo Sidewalk si avvicina ad Amazon Sidewalk, i beacon inviati dal dispositivo vengono filtrati da Amazon Sidewalk a intervalli regolari e ricevuti da Wireless AWS IoT. Wireless AWS IoT quindi ti notifica questi eventi quando viene ricevuto un beacon.

## Come funzionano gli eventi di prossimità
<a name="iot-sidewalk-proximity-events-work"></a>

Gli eventi di prossimità ti segnalano quando AWS IoT riceve un beacon, i dispositivi Sidewalk possono emettere beacon in qualsiasi momento. Quando il tuo dispositivo è vicino ad Amazon Sidewalk, Sidewalk riceve i beacon e li inoltra a Wireless AWS IoT a intervalli di tempo regolari. Amazon Sidewalk ha impostato questo intervallo di tempo a 10 minuti. Quando Wireless AWS IoT riceve il beacon da Sidewalk, riceverai una notifica dell'evento.

Gli eventi di prossimità ti avviseranno quando un beacon viene scoperto o perso. È possibile configurare gli intervalli con cui viene notificato l'evento di prossimità.

## Abilita le notifiche per eventi di prossimità
<a name="iot-sidewalk-proximity-events-enable"></a>

Prima che i sottoscrittori degli argomenti riservati di prossimità Sidewalk possano ricevere i messaggi, è necessario abilitare le notifiche di eventi, dalla Console di gestione AWS o utilizzando l'API o l'interfaccia a riga di comando. Puoi abilitare questi eventi per tutte le risorse Sidewalk nel tuo Account AWS o per risorse selezionate. Per ulteriori informazioni su come abilitare gli eventi, consulta [Abilitazione degli eventi per le risorse wireless](iot-wireless-control-events.md). 

## Formato degli argomenti MQTT per eventi di prossimità
<a name="iot-sidewalk-proximity-events-mqtt"></a>

Per ricevere avvisi sugli eventi di prossimità, puoi sottoscrivere gli argomenti riservati MQTT che iniziano con un simbolo del dollaro (\$1). Per ulteriori informazioni, consultare [Argomenti MQTT](https://docs.aws.amazon.com/iot/latest/developerguide/topics.html) nella *Guida per gli sviluppatori di AWS IoT*.

Gli argomenti MQTT riservati per gli eventi di prossimità Sidewalk utilizzano il formato:
+ Per argomenti a livello di risorsa:

  `$aws/iotwireless/events/{eventName}/{eventType}/sidewalk/wireless_devices`
+ Per argomenti identificatore:

  `$aws/iotwireless/events/{eventName}/{eventType}/sidewalk/{resourceType}/{resourceID}/{id}`

Dove:

**\$1eventName\$1**  
\$1eventName\$1 deve essere `proximity`.

**\$1eventType\$1**  
\$1eventType\$1 può essere `beacon_discovered` o `beacon_lost`.

**\$1resourceType\$1**  
\$1resourceType\$1 può essere `sidewalk_accounts` o `wireless_devices`.

**\$1resourceID\$1**  
\$1resourceID\$1 è `amazon_id` per \$1resourceType\$1 di `sidewalk_accounts` e `wireless_device_id` per \$1resourceType\$1 di`wireless_devices`.

È possibile utilizzare anche il carattere jolly `+` per sottoscrivere più argomenti contemporaneamente. Il carattere jolly `+` corrisponde a qualsiasi stringa nel livello che contiene il carattere. Ad esempio, se vuoi ricevere notifiche su tutti i tipi di evento possibili (`beacon_discovered` e `beacon_lost`) e per tutti i dispositivi registrati su un particolare ID Amazon, puoi utilizzare il filtro di argomenti che segue:

`$aws/iotwireless/events/proximity/+/sidewalk/sidewalk_accounts/amazon_id/+`

**Nota**  
Non è possibile utilizzare il carattere jolly `#` per sottoscrivere argomenti riservati. Per ulteriori informazioni sui filtri per argomento, consulta [MQTT topic filters](https://docs.aws.amazon.com/iot/latest/developerguide/topicfilters.html) nella *Guida per gli sviluppatori di AWS IoT*.

## Payload dei messaggi per eventi di prossimità
<a name="iot-sidewalk-proximity-events-json"></a>

Dopo aver abilitato le notifiche per eventi di prossimità, i messaggi di evento vengono pubblicati su MQTT con un payload JSON. Questi eventi contengono il payload di esempio seguente:

```
{    
    "eventId": "string", 
    "eventType": "beacon_discovered|beacon_lost",
    "WirelessDeviceId": "string",
    "timestamp": "1234567890123",

    // Event-specific fields
    "Sidewalk": {
        "AmazonId": "string",
        "SidewalkManufacturingSn": "string"        
    }
}
```

Il payload contiene gli attributi seguenti:

**eventId**  
Un ID evento univoco, rappresentato da una stringa.

**eventType**  
Il tipo di evento che si è verificato. Può essere `beacon_discovered` o `beacon_lost`.

**WirelessDeviceId**  
Identificatore del dispositivo wireless.

**timestamp**  
Timestamp Unix del momento in cui si è verificato l'evento.

**sidewalk**  
L'ID Amazon Sidewalk o `SidewalkManufacturingSn` per cui vuoi ricevere le notifiche di evento.