Powiadomienia wypychane w Internecie za pomocą usługi Azure Notification Hubs

2025-05-05

W tym artykule opisano sposób wysyłania powiadomień push do pojedynczych użytkowników za pomocą Azure Notification Hubs.

Ogólnie rzecz biorąc, proces wygląda następująco:

Ustaw dane uwierzytelniające:
Tworzenie rejestracji i instalacji.
Wysyłanie powiadomień push:

Przegląd

Powiadomienia push (lub powiadomienia przeglądarkowe) to typ powiadomień, które klienci otrzymują na przeglądarkach desktopowych lub w niektórych przypadkach przeglądarkach mobilnych, dla poszczególnych witryn internetowych.

Usługa Azure Notification Hubs obsługuje teraz powiadomienia push w przeglądarce dla wszystkich głównych przeglądarek, w tym Microsoft Edge, Google Chrome i Mozilla Firefox. Przeglądarka Apple Safari nie jest dołączona. W przypadku przeglądarki Apple Safari możesz użyć istniejącej obsługi usługi APNS zgodnie z opisem w temacie Konfigurowanie powiadomień wypychanych w przeglądarce Safari z uwierzytelnianiem opartym na certyfikatach.

Powiadomienia push w przeglądarkach są obsługiwane na wszystkich platformach urządzeń z następującymi systemami operacyjnymi i przeglądarkami.

Obsługa powiadomień push na laptopach.

System operacyjny	Przeglądarki
System operacyjny Windows	Google Chrome v48+ Microsoft Edge w wersji 17 lub nowszej Mozilla Firefox v44+ Safari w wersji 7 lub nowszej Opera w wersji 42+
macOS	Chrome v48+ Firefox v44+ Safari w wersji 7 lub nowszej Opera w wersji 42+
System operacyjny Linux	Chrome v48+ Firefox v44+ Safari w wersji 7 lub nowszej Opera w wersji 42+

Obsługa powiadomień push przeglądarki na tabletach.

System operacyjny	Przeglądarki
System operacyjny Windows	Chrome v48+ Firefox v44+ Opera w wersji 42+
Ios	Niewspierane.
System operacyjny Android	Chrome v48+ Firefox v44+ Opera w wersji 42+

Obsługa powiadomień push w przeglądarce na urządzeniach mobilnych:

System operacyjny	Przeglądarki
Ios	Niewspierane.
System operacyjny Android	Chrome v48+ Firefox v44+ Opera w wersji 42+

Ustaw poświadczenia

Aby zasubskrybować powiadomienia push przeglądarki na swojej witrynie internetowej, możesz użyć kluczy VAPID. Poświadczenia VAPID można wygenerować przy użyciu usług, takich jak generator kluczy VAPID. Poświadczenia powinny wyglądać podobnie do poniższego przykładu:

{ 
    "location": "South Central US", 
    "properties": { 
        "browserCredential": { 
            "properties": { 
                "subject": "mailto:email@microsoft.com", 
                "vapidPublicKey": "some-vapid-public-key", 
                "vapidPrivateKey":"some-vapid-private-key" 
            } 
        } 
    } 
}

Ustaw poświadczenia w portalu Azure

Aby ustawić poświadczenia powiadomień push dla przeglądarki w portalu Azure, wykonaj następujące kroki:

W portalu Azure otwórz sekcję Przeglądarka (Powiadomienia Push) w centrum powiadomień.
Wprowadź istniejące klucze VAPID lub wygeneruj nową parę kluczy VAPID przy użyciu usługi, takiej jak generator kluczy VAPID.
Wybierz Zapisz.

Ustawianie poświadczeń przy użyciu interfejsu API REST

Możesz również ustawić poświadczenia przeglądarki dla powiadomień push w przeglądarce, korzystając z interfejsu API REST, na przykład używając metody Create or update Hub REST API, interfejsu API Azure Resource Manager lub mechanizmu RP V2.

Wprowadź poświadczenia w tym formacie, podając identyfikator subskrypcji, grupę zasobów, przestrzeń nazw i centrum powiadomień:

https://management.azure.com/subscriptions/{subscription}/resourceGroups/{resource-group}/providers/Microsoft.NotificationHubs/namespaces/{namespace}/notificationHubs/{hub}api-version=2016-03-01

Ustawianie poświadczeń przy użyciu zestawów SDK platformy Azure

Można ustawić poświadczenia dla powiadomień push w przeglądarce przy użyciu zestawów SDK Azure. Oto przykład użycia zestawu .NET SDK:

var browserCreds = new BrowserCredential 
{ 
    Subject = "<subject>", 
    VapidPublicKey = "<vapid public key>", 
    VapidPrivateKey = "<vapid private key>", 
}

await nhManagementClient.NotificationHubs.CreateOrUpdateAsync(config.ResourceGroupName, config.NamespaceName, config.HubName, new NotificationHubCreateOrUpdateParameters(config.Location) 
{ 
   BrowserCredential = browserCreds 
});

Tworzenie rejestracji i instalacji

Wysyłanie zbiorcze wymaga rejestracji lub instalacji. Możesz również użyć rejestracji i instalacji do wysyłania informacji debugowania.

W poniższych przykładach przedstawiono treść żądania rejestracji dla rejestracji natywnej, rejestracji szablonu i instalacji przeglądarki.

Treść żądania rejestracji natywnej

<?xml version="1.0" encoding="utf-8"?><entry xmlns="http://www.w3.org/2005/Atom"><content type="application/xml"><BrowserRegistrationDescription xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.microsoft.com/netservices/2010/10/servicebus/connect"><Endpoint></Endpoint><P256DH></P256DH><Auth></Auth></BrowserRegistrationDescription></content></entry>

Treść żądania rejestracji szablonu przeglądarki

<?xml version="1.0" encoding="utf-8"?> 
<entry xmlns="http://www.w3.org/2005/Atom"> 
    <content type="application/xml"> 
        <BrowserTemplateRegistrationDescription xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.microsoft.com/netservices/2010/10/servicebus/connect"> 
            <Endpoint></Endpoint> 
            <P256DH></P256DH> 
            <Auth></Auth> 
            <BodyTemplate><![CDATA[{"title":"asdf","message":"xts"}]]></BodyTemplate> 
        </BrowserTemplateRegistrationDescription> 
    </content> 
</entry>

Treść żądania instalacji

{  
    "installationId": "installation-id", 
    "platform": "browser", 
    "pushChannel": { 
            "endpoint": "", 
            "p256dh": "", 
            "auth": "" 
        } 
}

Tworzenie rejestracji natywnych (SDK)

await notificationHubClient.CreateBrowserNativeRegistrationAsync(subscriptionInfo, tagSet);

Tworzenie rejestracji szablonów (SDK)

await notificationHubClient.CreateBrowserTemplateRegistrationAsync(subscriptionInfo, template, tagSet);

Tworzenie instalacji przeglądarki (SDK)

var browserPushSubscription = new BrowserPushSubscription 
            { 
                Endpoint = "", 
                P256DH = "", 
                Auth = "", 
            }; 

var browserInstallation = new BrowserInstallation 
            { 
                InstallationId = installationId, 
                Tags = tags, 
                Subscription = browserPushSubscription, 
                UserId = userId, 
                ExpirationTime = DateTime.UtcNow.AddDays(1), 
            }; 

await notificationHubClient.CreateOrUpdateInstallationAsync(browserInstallation);

Wysyłanie powiadomień push

Po ustawieniu poświadczeń dla powiadomień przeglądarkowych i tworzeniu rejestracji i instalacji dla urządzeń możesz przystąpić do tworzenia powiadomień push. W tej sekcji opisano sposób tworzenia powiadomienia dla bezpośredniego wysyłania|, wysyłki do odbiorców i wysyłki debugowania (testowej).

Utwórz bezpośrednie wysyłki

W przypadku bezpośredniego wysyłania potrzebujesz identyfikatora URI punktu końcowego, klucza p25DH i tajnych danych uwierzytelniania z subskrypcji przeglądarki. Aby uzyskać więcej informacji o powiadomieniach bezpośrednich, zobacz Wysyłanie bezpośrednie.

Aby utworzyć bezpośrednie powiadomienie o wysyłaniu, wykonaj następujące kroki:

Ustaw następujące nagłówki dla powiadomień push dla przeglądarki.
- ServiceBusNotification-Format - browser
- ServiceBusNotification-DeviceHandle - endpoint endpoint: pole z subskrypcji
- P256DH p256dh: pole z subskrypcji
- Auth auth: pole z subskrypcji
Utwórz treść wiadomości. Treść komunikatu jest zwykle w tym formacie:
```
{ 
  "title": "Some Title", 
  "body": "Some body of a message" 
} 
```
Możesz określić inne pola w treści, na przykład icon, aby zmienić ikonę dla każdego komunikatu.
Wyślij powiadomienie.

Możesz również użyć zestawu SDK platformy .NET do utworzenia bezpośredniego wysyłania:

var browserSubscriptionEndpoint = ""; 
var browserPushHeaders = new Dictionary<string, string> 
            { 
               { "P256DH", "" }, 
               { "Auth", "" }, 
            }; 

var directSendOutcome = await notificationHubClient.SendDirectNotificationAsync(new BrowserNotification("payload", browserPushHeaders), browserSubscriptionEndpoint);

Tworzenie wysyłek do odbiorców

Aby wysłać wiadomość do odbiorców, użyj tego samego nagłówka ServiceBus Notification-Format co w przypadku bezpośredniego wysyłania i zmodyfikuj ładunek komunikatu zgodnie z potrzebami. Opcjonalnie określ wyrażenie tagu przy użyciu nagłówka ServiceBusNotification-Tags . Aby uzyskać więcej informacji na temat przygotowania wysyłki do odbiorców, zapoznaj się z Wysyłanie powiadomienia natywnego usługi APNS.

Aby utworzyć wysyłkę do odbiorców przy użyciu pakietu SDK, użyj następującej instrukcji:

var outcome = await notificationHubClient.SendNotificationAsync(new BrowserNotification(payload, tagExpression);

Tworzenie wysyłek debugowania/testowania

Wysyłanie debugowania jest tworzone w witrynie Azure Portal i wymaga rejestracji i instalacji.

Po utworzeniu rejestracji dla urządzeń wykonaj następujące kroki, aby utworzyć powiadomienie dotyczące wysyłania debugowania:

W witrynie Azure Portal otwórz blok Wysyłanie testowe w centrum powiadomień.
W polu Platforma wybierz pozycję Przeglądarka.
Określ wartość Wyślij do wyrażenia tagu.
Zmodyfikuj zawartość do żądanego komunikatu.
Wybierz Wyślij.