讓用戶訂閱推播通知

取得權限後，您的網站必須啟動使用者訂閱推播通知的程序。這項操作是透過 JavaScript 使用 Push API 完成。您必須在訂閱過程中提供公開驗證金鑰，詳情請參閱後續說明。啟動訂閱程序後，瀏覽器會向網路服務 (稱為推播服務) 提出網路要求，您稍後也會進一步瞭解這項服務。

假設訂閱成功，瀏覽器會傳回 PushSubscription 物件。您需要長期儲存這些資料。通常是將資訊傳送至您控制的伺服器，然後讓伺服器將資訊儲存在資料庫中。

傳送推送訊息

您的伺服器實際上並不會直接將推播訊息傳送至用戶端。 推播服務 可執行這項操作。推播服務是一種由使用者瀏覽器供應商控管的網路服務。如要向用戶端傳送推播通知，您必須向推播服務提出 Web 服務要求。您傳送至推送服務的網路服務要求稱為 網路推送通訊協定要求 。網路推送通訊協定要求應包含：

通常，您會透過自己控管的伺服器提出網路推播通訊協定要求。當然，您的伺服器不必自行建構原始的網路服務要求。有程式庫可以為您處理這項作業，例如 web-push-libs 。但底層機制是透過 HTTP 的網路服務要求。

推播服務會接收您的要求、驗證要求，然後將推播訊息轉送至適當的用戶端。如果用戶端的瀏覽器處於離線狀態，推播服務會將推播訊息排入佇列，直到瀏覽器上線為止。

每個瀏覽器都會使用所需的推播服務。網站開發人員無法控制這項設定。這不是問題，因為網路推播通訊協定要求已 標準化 。換句話說，您不必關心瀏覽器供應商使用哪種推播服務。您只需要確保網路推播通訊協定要求符合規格。規格中指出，要求必須包含特定標頭，且資料必須以位元組串流傳送。

不過，您必須確保將網頁推播通訊協定要求傳送至正確的推播服務。瀏覽器在訂閱程序中傳回的 PushSubscription 資料會提供這項資訊。 PushSubscription 物件如下所示：

endpoint 的網域基本上是推播服務。 endpoint 的路徑是用戶端 ID 資訊，可協助推播服務精確判斷要將訊息推送至哪個用戶端。

keys 用於加密，我們會在下文說明。

加密推送訊息

您傳送至推播服務的資料必須加密。這樣做可避免推播服務查看您傳送至用戶端的資料。請注意，瀏覽器供應商會決定要使用哪種推播服務，而推播服務在理論上可能不安全。您的伺服器必須使用 PushSubscription 中提供的 keys 來加密網路推播通訊協定要求。

簽署網路推播通訊協定要求

推送服務可讓您防止其他人傳送訊息給使用者。從技術層面來說，您不必這麼做，但在 Chrome 上實作最簡單的方法就是這樣。在 Firefox 上為選用。其他瀏覽器日後可能也會需要這項功能。

這個工作流程涉及應用程式專屬的私密金鑰和公開金鑰。驗證程序大致如下：

自訂推播訊息的傳送方式

網路推播通訊協定要求規格也定義了參數，讓您自訂推播服務嘗試將推播訊息傳送至用戶端的方式。舉例來說，您可以自訂下列項目：

接收並顯示推播訊息做為通知

將網路推播通訊協定要求傳送至推播服務後，推播服務會將要求排入佇列，直到發生下列其中一項事件為止：

當用戶端瀏覽器收到推送訊息時，會解密推送訊息資料，並將 push 事件派送至您的 服務 worker 。Service Worker 基本上是 JavaScript 程式碼，可在背景執行，即使網站未開啟或瀏覽器已關閉也一樣。在服務工作站的 push 事件處理常式中，您可以呼叫 ServiceWorkerRegistration.showNotification() ，將資訊顯示為通知。

程式碼研究室

除非另有註明，否則本頁面中的內容是採用 創用 CC 姓名標示 4.0 授權 ，程式碼範例則為 阿帕契 2.0 授權 。詳情請參閱《 Google Developers 網站政策 》。Java 是 Oracle 和/或其關聯企業的註冊商標。

上次更新時間：2020-11-10 (世界標準時間)。