Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Publication de notifications Amazon SNS avec des charges utiles spécifiques à la plate-forme

Vous pouvez utiliser Amazon SNS AWS Management Console ou Amazon APIs pour envoyer des messages personnalisés avec des charges utiles spécifiques à la plate-forme vers des appareils mobiles. Pour plus d'informations sur l'utilisation d'Amazon SNS APIs, consultez la section Actions d'API push mobile et le SNSMobilePush.java fichier dans. snsmobilepush.zip

Envoi de messages au format JSON

Lors de l'envoi de charges utiles propres à une plateforme, les données doivent être formatées en tant que chaînes de paire valeur clé JSON, avec les guillemets dans une séquence d'échappement.

Les exemples suivants montrent un message personnalisé pour la plateforme FCM.

{
"GCM": "{\"fcmV1Message\": {\"message\": {\"notification\": {\"title\": \"Hello\", \"body\": \"This is a test.\"}, \"data\": {\"dataKey\": \"example\"}}}}"
}

Envoi de messages propres à une plateforme

En plus d'envoyer des données personnalisées en tant que paires valeur clé, vous pouvez envoyer des paires valeur clé propres à une plateforme.

L'exemple suivant illustre l'inclusion des paramètres FCM time_to_live et collapse_key après les paires valeur clé de données personnalisées dans le paramètre FCM data.

{
"GCM": "{\"fcmV1Message\": {\"message\": {\"notification\": {\"title\": \"TitleTest\", \"body\": \"Sample message for Android or iOS endpoints.\"}, \"data\":{\"time_to_live\": 3600,\"collapse_key\":\"deals\"}}}}"
}                    

Pour une liste des paires valeur clé prises en charge dans chacun des services de notification push pris en charge dans Amazon SNS, consultez les liens suivants :

Envoi de messages à une application sur plusieurs plateformes

Pour envoyer un message à une application installée sur des appareils pour plusieurs plateformes, telles que FCM APNs, vous devez d'abord abonner les points de terminaison mobiles à une rubrique sur Amazon SNS, puis publier le message dans cette rubrique.

L'exemple suivant montre un message à envoyer aux terminaux mobiles abonnés sur APNs, FCM et ADM :

{ 
  "default": "This is the default message which must be present when publishing a message to a topic. The default message will only be used if a message is not present for 
one of the notification platforms.",     
  "APNS": "{\"aps\":{\"alert\": \"Check out these awesome deals!\",\"url\":\"www.amazon.com\"} }",
  "GCM": "{\"data\":{\"message\":\"Check out these awesome deals!\",\"url\":\"www.amazon.com\"}}",
  "ADM": "{\"data\":{\"message\":\"Check out these awesome deals!\",\"url\":\"www.amazon.com\"}}" 
}            

Envoi de messages APNs sous forme d'alerte ou de notifications en arrière-plan

Amazon SNS peut envoyer des messages alert ou des background notifications (pour plus d'informations, consultez la section Envoyer des mises à jour en arrière-plan à votre application dans la APNs documentation). APNs

Spécification de valeurs APNs d'en-tête personnalisées

Nous vous recommandons de spécifier des valeurs personnalisées pour l'attribut de message AWS.SNS.MOBILE.APNS.PUSH_TYPE réservé à l'aide de l'action d'PublishAPI Amazon SNS AWS SDKs, ou du. AWS CLI L'exemple DE CLI suivant définit content-available pour 1 et apns-push-type background pour la rubrique spécifiée.

aws sns publish \
--endpoint-url https://sns.us-east-1.amazonaws.com \
--target-arn arn:aws:sns:us-east-1:123456789012:endpoint/APNS_PLATFORM/MYAPP/1234a567-bc89-012d-3e45-6fg7h890123i \
--message '{"APNS_PLATFORM":"{\"aps\":{\"content-available\":1}}"}' \
--message-attributes '{ \
  "AWS.SNS.MOBILE.APNS.TOPIC":{"DataType":"String","StringValue":"com.amazon.mobile.messaging.myapp"}, \
  "AWS.SNS.MOBILE.APNS.PUSH_TYPE":{"DataType":"String","StringValue":"background"}, \
  "AWS.SNS.MOBILE.APNS.PRIORITY":{"DataType":"String","StringValue":"5"}}' \
--message-structure json

Déduire l'en-tête de type APNs push à partir de la charge utile

Si vous ne définissez pas l'apns-push-type APNs en-tête, Amazon SNS définit l'en-tête background selon alert ou selon la content-available clé du aps dictionnaire de votre configuration de charge utile au format JSON APNs .

Voici un exemple d'objet de configuration brut.

{
  "APNS": "{\"aps\":{\"content-available\":1},\"Foo1\":\"Bar\",\"Foo2\":123}"
}

Dans cet exemple, Amazon SNS définit l'apns-push-type APNs en-tête du message sur. background Lorsqu'Amazon SNS détecte que le dictionnaire apn contient la clé content-available définie sur 1 et ne contient aucune autre clé pouvant déclencher des interactions utilisateur, il définit l'en-tête sur background.