As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Publicar notificações do Amazon SNS com cargas úteis específicas da plataforma

Você pode usar o AWS Management Console Amazon SNS APIs para enviar mensagens personalizadas com cargas específicas da plataforma para dispositivos móveis. Para obter informações sobre o uso do Amazon SNS APIs, consulte Ações da API de push para dispositivos móveis e o SNSMobilePush.java arquivo em. snsmobilepush.zip

Enviar mensagens formatadas em JSON

Ao enviar cargas específicas à plataforma, os dados devem estar formatados como strings de par de chave/valor JSON, com aspas em sequência de escape.

Os exemplos a seguir mostram uma mensagem personalizada para a plataforma do FCM.

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

Enviar mensagens específicas à plataforma

Além de enviar dados personalizados como pares de chave/valor, é possível enviar pares de chave/valor específicos à plataforma.

O exemplo a seguir mostra a inclusão dos parâmetros time_to_live e collapse_key do FCM depois dos pares de chave/valor de dados personalizados no parâmetro data do FCM.

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

Para obter uma lista dos pares de chave/valor compatíveis em cada um dos serviços de notificação push compatíveis com o Amazon SNS, consulte o seguinte:

Enviar mensagens para um aplicativo em várias plataformas

Para enviar uma mensagem para um aplicativo instalado em dispositivos de várias plataformas, como o FCM e APNs, você deve primeiro inscrever os endpoints móveis em um tópico no Amazon SNS e depois publicar a mensagem no tópico.

O exemplo a seguir mostra uma mensagem para enviar aos endpoints móveis inscritos no FCM APNs e no 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\"}}" 
}            

Envio de mensagens APNs como alerta ou notificações em segundo plano

O Amazon SNS pode enviar mensagens para APNs as alert ou background notificações (para obter mais informações, consulte Enviando atualizações em segundo plano para seu aplicativo na APNs documentação).

Especificando valores de APNs cabeçalho personalizados

Recomendamos especificar valores personalizados para o atributo de mensagem AWS.SNS.MOBILE.APNS.PUSH_TYPE reservada usando a ação AWS SDKs da API do Amazon Publish SNS ou o. AWS CLI O exemplo da CLI a seguir define content-available como 1 e apns-push-type como background para o tópico especificado.

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

Inferindo o cabeçalho do tipo APNs push a partir da carga

Se você não definir o apns-push-type APNs cabeçalho, o Amazon SNS define o cabeçalho como alert ou background dependendo da content-available chave no aps dicionário da sua configuração de carga em formato JSON APNs .

Veja a seguir um exemplo de objeto de configuração bruto.

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

Neste exemplo, o Amazon SNS define o apns-push-type APNs cabeçalho da mensagem como. background Quando o Amazon SNS detecta que o dicionário apn contém a chave content-available definida como 1 e não contém nenhuma outra chave que possa acionar interações do usuário, ele define o cabeçalho como background.