Amazon Simple Notification Service

开发人员指南

AWS 文档 » Amazon SNS » 开发人员指南 » 使用 Amazon SNS 发送用户通知 » 使用 Amazon SNS 向作为订阅者的移动应用程序发送用户通知（移动推送） » 使用 Amazon SNS 移动推送 » 添加设备令牌或注册 ID

添加设备令牌或注册 ID

当您首次向通知服务（如 Apple Push Notification Service (APNS) 和 Firebase Cloud Messaging (FCM)）注册应用程序或移动设备时，会从通知服务返回设备令牌或注册 ID。向 Amazon SNS 添加设备令牌或注册 ID 时，会将它们与 PlatformApplicationArn API 一起使用来为应用或设备创建终端节点。当 Amazon SNS 创建终端节点时，会返回一个 EndpointArn。Amazon SNS 就是通过 EndpointArn 知道要向哪个应用或移动设备发送通知消息的。

您可以通过以下方法将设备令牌和注册 ID 添加到 Amazon SNS：

手动添加设备令牌或注册 ID

1. 登录 Amazon SNS 控制台。

2. 选择 Apps (应用程序)，再选择您的应用程序，然后选择 Add Endpoints (添加终端节点)。

3. 在 Endpoint Token (终端节点令牌) 框中，根据通知服务输入令牌 ID 或注册 ID。例如，对于 ADM 和 FCM，则输入注册 ID。

4. （可选）在 User Data (用户数据) 中，输入要与终端节点关联的任意信息。Amazon SNS 不会使用此数据。此数据必须采用 UTF-8 格式，并且必须小于 2KB。

5. 最后，选择 Add Endpoints (添加终端节点)。

   现在已经创建了终端节点，您可以直接向移动设备发送消息，也可以向订阅了某一主题的移动设备发送消息。

从 CSV 文件将现有令牌迁移到 AWS

您可以迁移 CSV 文件中包含的现有令牌。这类 CSV 文件不能大于 2MB。迁移多个令牌时，建议您使用 CreatePlatformEndpoint API。CSV 文件中的每个令牌后都必须换行。举例来说，您的 CSV 文件看起来应如下所示：

amzn1.adm-registration.v1.XpvSSUk0Rc3hTVVV--TOKEN--KMTlmMWxwRkxMaDNST2luZz01,"User data with spaces requires quotes"
amzn1.adm-registration.v1.XpvSSUk0Rc3hTVVV--TOKEN--KMTlmMWxwRkxMaDNST2luZz04,"Data,with,commas,requires,quotes"
amzn1.adm-registration.v1.XpvSSUk0Rc3hTVVV--TOKEN--KMTlmMWxwRkxMaDNST2luZz02,"Quoted data requires ""escaped"" quotes"
amzn1.adm-registration.v1.XpvSSUk0Rc3hTVVV--TOKEN--KMTlmMWxwRkxMaDNST2luZz03,"{""key"": ""json is allowed"", ""value"":""endpoint"", ""number"": 1}"
amzn1.adm-registration.v1.XpvSSUk0Rc3hTVVV--TOKEN--KMTlmMWxwRkxMaDNST2luZz05,SimpleDataNoQuotes
amzn1.adm-registration.v1.XpvSSUk0Rc3hTVVV--TOKEN--KMTlmMWxwRkxMaDNST2luZz06,"The following line has no user data"
amzn1.adm-registration.v1.XpvSSUk0Rc3hTVVV--TOKEN--KMTlmMWxwRkxMaDNST2luZz07
APBTKzPGlCyT6E6oOfpdwLpcRNxQp5vCPFiFeru9oZylc22HvZSwQTDgmmw9WdNlXMerUPxmpX0w1,"Different token style"    

1. 登录 Amazon SNS 控制台。

2. 选择 Apps (应用程序)，再选择您的应用程序，然后选择 Add Endpoints (添加终端节点)。

3. 依次选择 Migrate existing tokens over to AWS (将现有令牌迁移到 AWS) 和 Choose File (选择文件)，选择您的 CSV 文件，然后选择 Add Endpoints (添加终端节点)。

使用 CreatePlatformEndpoint API 上传多个令牌

以下步骤演示如何使用 AWS 提供的示例 Java 应用程序（bulkupload 软件包）将多个令牌（设备令牌或注册 ID）上传至 Amazon SNS。您可以使用本示例应用帮助您开始上传现有令牌。

1. 下载并解压缩 snsmobilepush.zip 文件。

2. 在 Eclipse 中创建一个新的 Java 项目。

3. 将 SNSSamples 文件夹导入到新建的 Java 项目的顶级目录中。在 Eclipse 中，右键选择 Java 项目的名称，然后选择 Import (导入)，展开 General (常规)，依次选择 File System (文件系统)、Next (下一步)，浏览到 SNSSamples 文件夹，选择 OK (确定)，然后选择 Finish (完成)。

4. 下载 OpenCSV 库的副本，并添加到 bulkupload 包的生成路径中。

5. 打开 bulkupload 包中包含的 BulkUpload.properties 文件。

6. 将以下内容添加到 BulkUpload.properties 中：

   • 要向其添加终端节点的 ApplicationArn。

   • 包含令牌的 CSV 文件位置的绝对路径。

   • 要为记录 Amazon SNS 正确解析或解析失败的令牌创建的 CSV 文件的名称（如 goodTokens.csv 和 badTokens.csv）。

   • （可选）用于指定包含令牌的 CSV 文件中的分隔符和引号的字符。

   • （可选）用于同时创建终端节点的线程数量。默认值为 1 个线程。

   完成后的 BulkUpload.properties 与下文类似：

   applicationarn:arn:aws:sns:us-west-2:111122223333:app/FCM/fcmpushapp
   csvfilename:C:\\mytokendirectory\\mytokens.csv
   goodfilename:C:\\mylogfiles\\goodtokens.csv
   badfilename:C:\\mylogfiles\\badtokens.csv
   delimiterchar:' 
   quotechar:"
   numofthreads:5             

7. 运行 BatchCreatePlatformEndpointSample.java 应用程序，将令牌上传至 Amazon SNS。

   在本例中，为成功上传至 Amazon SNS 的令牌创建的终端节点将记录到 goodTokens.csv 中，格式不正确的令牌将记录到 badTokens.csv 中。此外，您还应看到写入 Eclipse 控制台的 STD OUT 日志包含与下面类似的内容：

   <1>[SUCCESS] The endpoint was created with Arn arn:aws:sns:us-west-2:111122223333:app/FCM/fcmpushapp/165j2214-051z-3176-b586-138o3d420071
   <2>[ERROR: MALFORMED CSV FILE] Null token found in /mytokendirectory/mytokens.csv