Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Einrichtung eines SNS Amazon-Plattformendpunkts für mobile Benachrichtigungen

Wenn eine App oder ein Mobilgerät bei einem Push-Benachrichtigungsservice registriert werden, gibt der Push-Benachrichtigungsservice ein Geräte-Token zurück. Amazon SNS verwendet das Geräte-Token, um einen mobilen Endpunkt zu erstellen, an den direkte Push-Benachrichtigungen gesendet werden können. Weitere Informationen erhalten Sie unter Voraussetzungen für SNS Amazon-Benutzerbenachrichtigungen und Push-Benachrichtigungen mit Amazon einrichten SNS.

In diesem Abschnitt wird der empfohlene Ansatz zum Erstellen eines Plattformendpunkts.

Erstellen eines Plattformendpunkts

Um Benachrichtigungen an eine App mit Amazon zu sendenSNS, muss das Geräte-Token dieser App zunächst bei Amazon registriert werden, SNS indem die Aktion Create Platform Endpoint aufgerufen wird. Diese Aktion verwendet den Amazon-Ressourcennamen (ARN) der Plattformanwendung und das Geräte-Token als Parameter und gibt den ARN des erstellten Plattformendpunkts zurück.

Die CreatePlatformEndpointAktion bewirkt Folgendes:

Sie sollten die Aktion nicht direkt bei jedem Start der Anwendung aufrufen. Sie sorgt nicht immer für die Bereitstellung eines funktionierenden Endpunkts. Dies kann zum Beispiel der Fall sein, wenn eine App auf einem Gerät deinstalliert und neu installiert wird und der Endpunkt für diese bereits vorhanden aber deaktiviert ist. Ein erfolgreicher Registrierungsprozess sollte folgendermaßen aussehen:

Pseudo-Code

Der folgende Pseudo-Code beschreibt ein empfohlenes Verfahren für die Erstellung eines funktionierenden, aktuellen, aktivierten Plattformendpunkts in einer Vielzahl von Startbedingungen. Dieser Ansatz funktioniert, wenn die App zum ersten Mal oder erneut registriert wird. Es ist egal, ob der Plattformendpunkt für diese App bereits vorhanden ist, ob der Plattformendpunkt aktiviert ist, ob er das richtige Geräte-Token hat und so weiter. Der Code kann mehrfach hintereinander aufgerufen werden. Er wird keine doppelten Plattformendpunkte erstellen oder einen vorhandenen Plattformendpunkt ändern, der bereits auf dem neuesten Stand und aktiviert ist.

retrieve the latest device token from the mobile operating system
if (the platform endpoint ARN is not stored)
  # this is a first-time registration
  call create platform endpoint
  store the returned platform endpoint ARN
endif

call get endpoint attributes on the platform endpoint ARN 

if (while getting the attributes a not-found exception is thrown)
  # the platform endpoint was deleted 
  call create platform endpoint with the latest device token
  store the returned platform endpoint ARN
else 
  if (the device token in the endpoint does not match the latest one) or 
      (GetEndpointAttributes shows the endpoint as disabled)
    call set endpoint attributes to set the latest device token and then enable the platform endpoint
  endif
endif

Dieser Ansatz kann jederzeit verwendet werden, wenn die App sich registrieren oder erneut registrieren möchte. Es kann auch verwendet werden, um Amazon über eine Änderung SNS des Gerätetokens zu informieren. In diesem Fall können Sie einfach eine Aktion mit dem neuesten Geräte-Token-Wert aufrufen. Es gibt einige wichtige Punkte zu diesem Ansatz:

AWS SDKBeispiel

Der folgende Code zeigt, wie der vorherige Pseudocode mithilfe der SNS Amazon-Clients implementiert wird, die von der AWS SDKs bereitgestellt werden.

Um einen zu verwenden AWS SDK, müssen Sie ihn mit Ihren Anmeldeinformationen konfigurieren. Weitere Informationen finden Sie unter The shared config and credentials files im Referenzhandbuch AWS SDKsund im Tools-Referenzhandbuch.

CLI

AWS CLI

So erstellen Sie ein Plattformanwendungsendpunkt

Im folgenden create-platform-endpoint-Beispiel wird mithilfe des angegebenen Tokens ein Endpunkt für die angegebene Plattformanwendung erstellt.

aws sns create-platform-endpoint \
    --platform-application-arn arn:aws:sns:us-west-2:123456789012:app/GCM/MyApplication \
    --token EXAMPLE12345...

Ausgabe:

{
      "EndpointArn": "arn:aws:sns:us-west-2:1234567890:endpoint/GCM/MyApplication/12345678-abcd-9012-efgh-345678901234"
}

Java

SDKfür Java 2.x

Anmerkung

Es gibt noch mehr dazu. GitHub Sie sehen das vollständige Beispiel und erfahren, wie Sie das AWS -Code-Beispiel-Repository einrichten und ausführen.

import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.sns.SnsClient;
import software.amazon.awssdk.services.sns.model.CreatePlatformEndpointRequest;
import software.amazon.awssdk.services.sns.model.CreatePlatformEndpointResponse;
import software.amazon.awssdk.services.sns.model.SnsException;

/**
 * Before running this Java V2 code example, set up your development
 * environment, including your credentials.
 *
 * For more information, see the following documentation topic:
 *
 * https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/get-started.html
 *
 * In addition, create a platform application using the AWS Management Console.
 * See this doc topic:
 *
 * https://docs.aws.amazon.com/sns/latest/dg/mobile-push-send-register.html
 *
 * Without the values created by following the previous link, this code examples
 * does not work.
 */

public class RegistrationExample {
    public static void main(String[] args) {
        final String usage = """

            Usage:     <token> <platformApplicationArn>

            Where:
               token - The device token or registration ID of the mobile device. This is a unique 
               identifier provided by the device platform (e.g., Apple Push Notification Service (APNS) for iOS devices, Firebase Cloud Messaging (FCM) 
               for Android devices) when the mobile app is registered to receive push notifications.

               platformApplicationArn - The ARN value of platform application. You can get this value from the AWS Management Console.\s

            """;

        if (args.length != 2) {
            System.out.println(usage);
            return;
        }

        String token = args[0];
        String platformApplicationArn = args[1];
        SnsClient snsClient = SnsClient.builder()
            .region(Region.US_EAST_1)
            .build();

        createEndpoint(snsClient, token, platformApplicationArn);
    }
    public static void createEndpoint(SnsClient snsClient, String token, String platformApplicationArn) {
        System.out.println("Creating platform endpoint with token " + token);
        try {
            CreatePlatformEndpointRequest endpointRequest = CreatePlatformEndpointRequest.builder()
                .token(token)
                .platformApplicationArn(platformApplicationArn)
                .build();

            CreatePlatformEndpointResponse response = snsClient.createPlatformEndpoint(endpointRequest);
            System.out.println("The ARN of the endpoint is " + response.endpointArn());

        } catch (SnsException e) {
            System.err.println(e.awsErrorDetails().errorMessage());
        }
    }
}

Weitere Informationen finden Sie unter APIPush-Aktionen auf Mobilgeräten.

Fehlerbehebung

Wiederholtes Aufrufen von „Create Platform Endpoint“ mit einem veralteten Geräte-Token

Insbesondere bei FCM Endgeräten halten Sie es vielleicht für das Beste, das erste Geräte-Token zu speichern, das für die Anwendung ausgestellt wurde, und dann bei jedem Start der Anwendung den Create Platform-Endpunkt mit diesem Geräte-Token aufzurufen. Dies mag richtig erscheinen, da die App dadurch den Status des Gerätetokens nicht verwalten muss und Amazon das Geräte-Token SNS automatisch auf seinen neuesten Wert aktualisiert. Diese Lösung hat jedoch mehrere ernsthafte Probleme:

Weitere Informationen zur Verwaltung von FCM Endpunkten finden Sie unter. SNSAmazon-Verwaltung von Firebase Cloud Messaging-Endpunkten

Erneutes Aktivieren eines Plattformendpunktes mit einem ungültigen Geräte-Token

Wenn eine mobile Plattform (wie APNs oderFCM) Amazon darüber informiertSNS, dass das in der Veröffentlichungsanfrage verwendete Geräte-Token ungültig war, SNS deaktiviert Amazon den mit diesem Geräte-Token verknüpften Plattformendpunkt. Amazon lehnt SNS dann nachfolgende Veröffentlichungen mit diesem Geräte-Token ab. Möglicherweise glauben Sie, Sie könnten einfach den Plattformendpunkt neu aktivieren und so weiter veröffentlichen, doch wird dies in den meisten Fällen nicht funktionieren. Die veröffentlichten Nachrichten werden nicht zugestellt und der Plattformendpunkt wird bald wieder deaktiviert.

Der Grund hierfür ist, dass das Geräte-Token des Plattformendpunkts wirklich ungültig ist. Zustellungen können nicht abgeschlossen werden, da es nicht mehr mit einer installierten App übereinstimmt. Bei der nächsten Veröffentlichung auf informiert die mobile Plattform Amazon erneut darüber, SNS dass das Geräte-Token ungültig ist, und Amazon SNS wird den Plattformendpunkt erneut deaktivieren.

Um einen deaktivierten Plattformendpunkt zu reaktivieren, muss dieser einem gültigen Geräte-Token zugeordnet (über einen „set endpoint attributes“-Aktionsaufruf) sein und dann aktiviert werden. Nur dann werden Zustellungen an den Plattformendpunkt erfolgreich sein. Das erneute Aktivieren eines Plattformendpunkts ohne Aktualisierung des Geräte-Tokens funktioniert nur, wenn ein dem Endpunkt zugeordnetes Geräte-Token ungültig ist und wieder gültig wird. Dies kann zum Beispiel der Fall sein, wenn eine App deinstalliert und dann auf demselben Mobilgerät neu installiert wurde und dasselbe Geräte-Token erhält. Der oben gezeigte Ansatz geht so vor. Er stellt sicher, dass der Plattformendpunkt erst dann neu aktiviert wird, wenn überprüft wurde, dass das ihm zugeordnete Geräte-Token im Moment verfügbar ist.