Proxy-Ereignisse

Proxy-Ereignisse veröffentlichen Ereignisbenachrichtigungen, wenn AWS IoT ein Signal vom Sidewalk-Gerät empfängt. Wenn sich Ihr Sidewalk-Gerät Amazon Sidewalk nähert, werden Beacons, die von Ihrem Gerät gesendet werden, in regelmäßigen Abständen von Amazon Sidewalk gefiltert und AWS IoT Wireless von empfangen. AWS IoT Wireless benachrichtigt Sie dann über diese Ereignisse, wenn ein Beacon empfangen wird.

Wie Nähe-Ereignisse funktionieren

Nähe-Ereignisse benachrichtigen Sie, wenn AWS IoT ein Beacon empfängt. Ihre Sidewalk-Geräte können jederzeit Beacons ausgeben. Wenn sich Ihr Gerät in der Nähe von Amazon Sidewalk befindet, empfängt Sidewalk die Beacons und leitet sie in regelmäßigen Zeitabständen an AWS IoT Wirelessweiter. Amazon Sidewalk hat dieses Zeitintervall auf 10 Minuten konfiguriert. Wenn AWS IoT Wireless das Signal von Sidewalk empfängt, werden Sie über das Ereignis informiert.

Nähe-Ereignisse benachrichtigen Sie, wenn ein Beacon erkannt wird oder verloren geht. Sie können die Intervalle konfigurieren, in denen Sie über das Nähe-Ereignis benachrichtigt werden.

Aktivieren Sie Benachrichtigungen für Nähe-Ereignisse

Bevor Subscriber der reservierten Sidewalk-Nähe-Themen Nachrichten empfangen können, müssen Sie für sie Ereignisbenachrichtigungen über die AWS Management Console oder mithilfe der API oder CLI aktivieren. Sie können diese Ereignisse für alle Sidewalk-Ressourcen in Ihren AWS-Konto oder für ausgewählte Ressourcen aktivieren. Weitere Informationen darüber, wie Sie diese Ereignisse einrichten finden Sie unter Ereignisse für Drahtlos-Ressourcen aktivieren.

Format der MQTT-Themen für Nähe-Ereignisse

Um Sie über Nähe-Ereignisse zu informieren, können Sie reservierte MQTT-Themen abonnieren, die mit einem Dollarzeichen ($) beginnen. Weitere Informationen finden Sie unter MQTT-Themen im AWS IoT-Entwicklerhandbuch.

Reservierte MQTT-Themen für Sidewalk-Nähe-Ereignisse verwenden das folgende Format:

• Für Themen auf Ressourcenebene:

  $aws/iotwireless/events/{eventName}/{eventType}/sidewalk/wireless_devices

• Für Kennungsthemen:

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

Wobei gilt:

{eventName}

{eventName} muss proximity sein.

{eventType}

{eventType} kann beacon_discovered oder beacon_lost sein.

{resourceType}

{resourceType} kann sidewalk_accounts oder wireless_devices sein.

{resourceID}

{resourceID} ist amazon_id für {resourceType} von sidewalk_accounts und wireless_device_id für {resourceType} von wireless_devices.

Sie können auch das Platzhalterzeichen + verwenden, um mehrere Themen gleichzeitig zu abonnieren. Das Platzhalterzeichen + entspricht einer beliebigen Zeichenfolge in der Ebene, die das Zeichen enthält. Wenn Sie beispielsweise über alle möglichen Ereignistypen (beacon_discovered und beacon_lost) und für alle Geräte, die mit einer bestimmten Amazon-ID registriert sind, informiert werden möchten, können Sie den folgenden Themenfilter verwenden:

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

Anmerkung

Sie können das Platzhalterzeichen # nicht verwenden, um die reservierten Themen zu abonnieren. Weitere Informationen zu Themenfiltern finden Sie unter MQTT-Themenfilter im AWS IoT-Entwicklerhandbuch.

Nachrichten-Payload für Nähe-Ereignisse

Nachdem Sie Benachrichtigungen für Nähe-Ereignisse aktiviert haben, werden Ereignisnachrichten über MQTT mit einer JSON-Nutzlast veröffentlicht. Diese Ereignisse enthalten die folgende Beispielnutzlast:

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

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

Die Nutzlast enthält die folgenden Attribute:

eventId

Eine eindeutige Ereignis-ID, bei der es sich um eine Zeichenfolge handelt.

eventType

Die Art des Ereignisses, das eingetreten ist. Kann beacon_discovered oder beacon_lost sein.

WirelessDeviceId

Die Kennung des drahtlosen Geräts.

timestamp

Der Unix-Zeitstempel für den Zeitpunkt, an dem das Ereignis aufgetreten ist.

sidewalk

Die Sidewalk-Amazon-ID oder SidewalkManufacturingSn für die Sie Ereignisbenachrichtigungen erhalten möchten.