推播通知 push-notifications

向Amazon SNS註冊

1. 記錄您的帳戶ID。 格式應為12位數，不含空格或破折號，即"123456789012"。
2. 請確定您位於「美國東部」或「歐盟」地區，因為稍後的步驟（身份池建立）需要其中一個步驟。
3. 註冊後，登錄管理控制台並選擇 SNS （推播通知服務）。 如果出現「Get Started（開始）」，請按一下。

建立存取金鑰和ID

1. 按一下螢幕右上方的登錄名，然後從菜單中選擇「安全憑據」。
2. 按一下「Access Keys（訪問密鑰）」 ，然後在下面的空格中按一下 建立新訪問密鑰.
3. 按一下 顯示訪問密鑰，並複製並儲存顯示的存取金鑰ID和秘密存取金鑰。 如果您選擇下載索引鍵的選項，您會收到包含這些相同值的csv檔案。
4. 可在此頁面上管理其他安全相關憑證及其他憑證。

對於使用「AWS沙箱」帳戶的組織，步驟非常類似，並概述如下：

1. 按一下螢幕右上方的登錄名，然後從菜單中選擇「我的安全憑據」。
2. 按一下動作左側清單中的使用者，然後選擇您的使用者名稱。
3. 按一下「安全憑據」頁簽。
4. 從這裡，您會看到您的金鑰並建立新金鑰。 儲存金鑰以供稍後使用。

建立主題

1. 按一下 建立主題 並選擇主題名稱。 記錄所有欄位，如「主題ARN」、「主題所有者」、「地區」、「顯示名稱」。
2. 按一下 其他主題動作 > 編輯主題策略. 在 允許這些用戶訂閱此主題，選取 大家。
3. 按一下 更新策略.

建立平台應用程式

1. 按一下「應用程式」，然後按一下「建立平台應用程式」。 選擇名稱並選取平台(iOS適用的APNS、Android適用的GCM)。 根據平台，其他欄位需要填入：

   1. 若為APNS，必須輸入P12檔案、密碼、憑證和私密金鑰。 應在步驟中取得 使用Apple推播通知服務(APNS) 上。
   2. 若為GCM，必須輸入API金鑰。 本應在步驟中取得 使用Google雲端通訊(GCM)服務 上。

2. 對您要支援的每個平台重複上述步驟一次。 若要同時推送至iOS和Android，必須建立兩個平台應用程式。

建立身份池

1. 使用 Cognito 建立身份池，該池將儲存未驗證用戶的基本資料。 請注意，目前只有「美國東部」和「歐盟」地區受Amazon Cognito支援。
2. 請為其命名，並勾選「啟用未驗證身分的存取」方塊。
3. 在下一頁(「您的Cognito身份需要訪問您的資源")按一下「允許」。
4. 在頁面右上方，按一下連結「編輯標識池". 將顯示標識池Id。 保存此文本以備以後使用。
5. 在同一頁上，選擇「未驗證角色」旁邊的下拉清單，並確保它具有Cognito_角色<pool name="">已選取UnauthRole。 儲存您的變更。

設定存取權限

1. 登入 身分與存取管理 (IAM)
2. 選擇角色
3. 按一下在上一步中建立的角色，稱為Cognito_<youridentitypoolname>取消驗證角色。 記錄顯示的「角色ARN」。
4. 如果尚未開啟「內嵌原則」，請開啟它。 您應該會在那裡看到一個名稱類似oneClick_Cognito_的策略<youridentitypoolname>Unauth_Role_1234567890123。
5. 按一下「編輯策略」。 用此JSON片段替換策略文檔的內容：

1. 按一下 應用策略

用Pushwoosh註冊

1. 前往pushwoosh.com並建立新帳戶。

建立API存取權杖

1. 在Pushwoosh網站上，前往API存取功能表項目以產生API存取權杖。 您需要安全地記錄此內容。

建立新的應用程式

1. 若要取得Android支援，您需要提供GCM API金鑰。
2. 設定應用程式時，請選擇Cordova作為架構。
3. 若要取得iOS支援，您必須提供憑證檔案(.cer)、推送憑證(.p12)和私密金鑰密碼；這些內容應可從Apple的APNS網站取得。 對於「框架」，請選擇「Cordova」。
4. Pushwoosh會以「XXXXX-XXXXX」的形式產生該應用程式的應用程式ID，其中每個X都是十六進位值（0到F）。

PhoneGap Build 是PhoneGap提供的服務，可在其伺服器上為您建立應用程式，並可讓您直接下載至裝置。 請參閱 PhoneGap Build檔案 了解如何設定和使用PhoneGap Build。

PhoneGap命令行介面 (CLI)可讓您在命令列上使用一組豐富的PhoneGap命令，來建置、除錯和部署您的應用程式。 請參閱 PhoneGap開發人員檔案 了解如何設定和使用PhoneGap CLI。

建立新通知

• 在AEM Mobile應用程式的控制面板中，尋找「推播通知」方塊。
• 在右上角的功能表中，選擇「建立」。 請注意，此按鈕要等到雲端設定首次設定後才可用。
• 在建立通知精靈中，輸入標題和訊息，然後按一下「建立」按鈕。 您的通知現在已準備好立即或稍後傳送。 可編輯訊息和/或標題，且可變更及儲存。

傳送通知

• 在「應用程式」控制面板中，找到「推播通知」方塊。
• 選取通知，或按一下右下角的詳細資訊按鈕(…)，以顯示通知清單。 此清單也會指出通知是否已準備好傳送、已傳送，或傳送期間是否發生錯誤。
• 選取一個通知的核取方塊（僅限），然後按一下清單上方的「傳送通知」按鈕。 您將有一次機會在顯示的對話方塊上「取消」或「傳送」通知。

處理結果

• 如果推播通知服務(Amazon SNS或Pushwoosh)收到傳送要求，確認其有效，並成功將其傳送至原生提供者（APNS和GCM），則「傳送」對話方塊將會關閉，且不會顯示訊息。 在通知清單中，該通知的狀態將列為已傳送。

• 如果推送傳送失敗，對話方塊將顯示指出問題的訊息。 在通知清單中，該通知的狀態將列為「錯誤」，但如果問題得到糾正，則可以再次發送通知。 發生錯誤時，伺服器錯誤記錄中應會顯示其他錯誤資訊。

• 請注意，iOS和Android推播通知之間有一些平台差異。 其中：

  • 使用CLI建立應用程式會在部署於Android後啟動。 在iOS上，您必須手動啟動。 由於推播註冊步驟會在啟動時進行，因此Android應用程式可以立即收到推播通知（因為它會啟動並註冊），而iOS應用程式則不會。
  • 在Android上，「確定」按鈕文字為全大寫（以及應用程式內通知上新增的任何其他按鈕），而在iOS中則非全大寫。

按一下 管理Cloud Services 方塊。

選取 Pushwoosh連接. 按一下​ 下一步。

輸入屬性的詳細資訊，然後按一下 提交.

提交設定後， 推播通知 圖磚會顯示在控制面板中。

按一下右上角的添加符號 推播通知 圖磚以開啟 建立通知精靈.

按一下連結路徑中的瀏覽圖示，會向使用者呈現應用程式的內容結構。

選取路徑後，按一下核取圖示。

輸入 文字詳細資料 在 建立通知精靈 按一下 建立.

按一下您從 推播通知 方塊。

您可以編輯屬性、傳送通知或刪除通知。