Powiadomienia usług komunikacyjnych
Czat w usługach Azure Communication Services i wywoływanie zestawów SDK tworzą kanał obsługi komunikatów w czasie rzeczywistym, który umożliwia wypychanie komunikatów sygnałowych do połączonych klientów w wydajny, niezawodny sposób. Dzięki temu można tworzyć rozbudowane funkcje komunikacji w czasie rzeczywistym w aplikacjach bez konieczności implementowania skomplikowanej logiki sondowania HTTP. Jednak w aplikacjach mobilnych ten kanał sygnalizacyjny pozostaje połączony tylko wtedy, gdy aplikacja jest aktywna na pierwszym planie. Jeśli chcesz, aby użytkownicy otrzymywali połączenia przychodzące lub wiadomości czatu, gdy aplikacja znajduje się w tle, należy użyć powiadomień wypychanych.
Powiadomienia wypychane umożliwiają wysyłanie informacji z aplikacji do urządzeń przenośnych użytkowników. Powiadomienia wypychane umożliwiają wyświetlanie okna dialogowego, odtwarzanie dźwięku lub wyświetlanie interfejsu użytkownika połączeń przychodzących. Usługi Azure Communication Services zapewniają integrację z usługami Azure Event Grid i Azure Notification Hubs , które umożliwiają dodawanie powiadomień wypychanych do aplikacji.
Wyzwalanie powiadomień wypychanych za pośrednictwem usługi Azure Event Grid
Usługi Azure Communication Services integrują się z usługą Azure Event Grid , aby dostarczać powiadomienia o zdarzeniach w czasie rzeczywistym w niezawodny, skalowalny i bezpieczny sposób. Możesz wykorzystać tę integrację, aby utworzyć usługę powiadomień, która dostarcza użytkownikom powiadomienia wypychane na urządzenia przenośne, tworząc subskrypcję usługi Event Grid, która wyzwala funkcję platformy Azure lub element webhook.
Dowiedz się więcej o obsłudze zdarzeń w usługach Azure Communication Services.
Dostarczanie powiadomień wypychanych za pośrednictwem usługi Azure Notification Hubs
Ważne
Usługa Azure Notification Hubs ogłosiła, że starszy interfejs API firebase Cloud Messaging (FCM) zostanie wycofany w lipcu 2024 r. Będzie to miało wpływ na wszystkie aplikacje rozmów i czatów usług Azure Communiation Services, które wysyłają powiadomienia wypychane systemu Android. Klienci, których to dotyczy, będą musieli przeprowadzić migrację rejestracji ze starszej wersji usługi FCM do usługi FCM w wersji 1 i zacząć to robić w marcu 2024 r. Aby uzyskać więcej informacji, w tym kroki migracji, zobacz dokumentację usługi Notifcation Hub.
Możesz połączyć centrum powiadomień azure z zasobem usług komunikacyjnych, aby automatycznie wysyłać powiadomienia wypychane do urządzenia przenośnego użytkownika po odebraniu połączenia przychodzącego lub powiadomić ich o nieodebranych działaniach czatu. Należy użyć tych powiadomień wypychanych, aby obudzić aplikację z poziomu tła i wyświetlić interfejs użytkownika, który umożliwia użytkownikowi akceptowanie lub odrzucanie połączenia lub odczytywanie nowo odebranej wiadomości na czacie.
Usługi komunikacyjne używają usługi Azure Notification Hub jako usługi przekazywania do komunikowania się z różnymi usługami powiadomień wypychanych specyficznych dla platformy przy użyciu interfejsu API wysyłania bezpośredniego . Umożliwia to ponowne użycie istniejących zasobów i konfiguracji usługi Azure Notification Hub w celu dostarczania małych opóźnień, niezawodnych powiadomień do aplikacji.
Uwaga
Obecnie połączenia i powiadomienia wypychane czatu są obsługiwane zarówno w systemach Android, jak i iOS.
Aprowizowanie centrum powiadomień
Aby dostarczać powiadomienia wypychane do urządzeń klienckich przy użyciu usługi Notification Hubs, utwórz centrum powiadomień w ramach tej samej subskrypcji co zasób usług komunikacyjnych. Musisz skonfigurować usługę Azure Notification Hub dla systemu powiadomień platformy, którego chcesz użyć. Aby dowiedzieć się, jak otrzymywać powiadomienia wypychane w aplikacji klienckiej z usługi Notification Hubs, zobacz Wprowadzenie do usługi Notification Hubs i wybierz docelową platformę klienta z listy rozwijanej w górnej części strony.
Uwaga
Obecnie obsługiwane są platformy APNs i FCM. Platforma APNs musi być skonfigurowana z trybem uwierzytelniania tokenu. Tryb uwierzytelniania certyfikatu nie jest obecnie obsługiwany.
Po skonfigurowaniu centrum powiadomień można skojarzyć go z zasobem usług komunikacyjnych, podając parametry połączenia dla centrum przy użyciu klienta usługi Azure Resource Manager lub witryny Azure Portal. Parametry połączenia powinny zawierać Send uprawnienia. Zalecamy utworzenie innych zasad dostępu z uprawnieniami Send tylko dla Centrum. Dowiedz się więcej o zasadach zabezpieczeń i dostępu usługi Notification Hubs
Łączenie centrum powiadomień przy użyciu klienta usługi Azure Resource Manager
Aby zalogować się do usługi Azure Resource Manager, wykonaj następujące czynności i zaloguj się przy użyciu poświadczeń.
armclient login
Po pomyślnym zalogowaniu wykonaj następujące polecenie, aby aprowizować centrum powiadomień:
armclient POST /subscriptions/<sub_id>/resourceGroups/<resource_group>/providers/Microsoft.Communication/CommunicationServices/<resource_id>/linkNotificationHub?api-version=2020-08-20-preview "{'connectionString': '<connection_string>','resourceId': '<resource_id>'}"
Łączenie centrum powiadomień za pomocą witryny Azure Portal
W portalu przejdź do zasobu usług Azure Communication Services.
W zasobie Usług komunikacyjnych wybierz pozycję Powiadomienia wypychane z menu po lewej stronie usług komunikacyjnych i połącz aprowizowaną wcześniej usługę Notification Hub.
Wybierz pozycję Połącz centrum powiadomień. Zostanie wyświetlona lista centrów powiadomień dostępnych do nawiązania połączenia.
Wybierz centrum powiadomień, którego chcesz użyć dla tego zasobu.
- Jeśli chcesz utworzyć nowe centrum, wybierz pozycję Utwórz nowe centrum powiadomień, aby uzyskać nową aprowizację centrum dla tego zasobu.
Teraz zobaczysz centrum powiadomień połączone ze stanem połączenia.
Jeśli chcesz użyć innego centrum dla zasobu, wybierz pozycję Rozłącz, a następnie powtórz kroki, aby połączyć inne centrum powiadomień.
Uwaga
Każda zmiana sposobu połączenia koncentratora jest odzwierciedlana w płaszczyźnie danych (czyli podczas wysyłania powiadomienia) w ciągu maksymalnie 10 minut. To samo zachowanie ma zastosowanie, gdy centrum jest połączone po raz pierwszy, jeśli powiadomienia zostały wysłane przed zmianą.
Rejestracja urządzenia
Zapoznaj się z przewodnikiem Szybki start dotyczącym połączeń głosowych i przewodnikiem Szybki start do czatu, aby dowiedzieć się, jak zarejestrować dojście do urządzenia za pomocą usług Communication Services.
Przewodnik rozwiązywania problemów z powiadomieniami wypychanych
Gdy na urządzeniu nie widzisz powiadomień wypychanych, istnieją trzy miejsca, w których powiadomienia mogły zostać porzucone:
- Usługa Azure Notification Hubs nie zaakceptowała powiadomienia z usług Azure Communication Services
- System powiadomień platformy (na przykład APNs i FCM) nie zaakceptował powiadomienia z usługi Azure Notification Hubs
- System powiadomień platformy nie dostarczył powiadomienia do urządzenia.
Pierwsze miejsce, w którym można usunąć powiadomienie (usługa Azure Notification Hubs nie zaakceptowała powiadomień z usług Azure Communication Services) została omówiona poniżej. W przypadku pozostałych dwóch miejsc zobacz Diagnozowanie porzuconych powiadomień w usłudze Azure Notification Hubs.
Jednym ze sposobów sprawdzenia, czy zasób usług Communication Services wysyła powiadomienia do usługi Azure Notification Hubs, jest sprawdzenie incoming messages metryki z połączonych metryk usługi Azure Notification Hub.
Poniżej przedstawiono niektóre typowe błędy konfiguracji, które mogą być przyczyną, dla których usługa Azure Notification Hub nie akceptuje powiadomień z zasobu usług Komunikacyjnych.
Usługa Azure Notification Hub nie jest połączona z zasobem usług komunikacyjnych
Może się okazać, że nie połączysz centrum powiadomień platformy Azure z zasobem usług komunikacyjnych. Możesz zapoznać się z sekcją Aprowizacja w usłudze Notification Hub, aby zobaczyć, jak je połączyć.
Połączona usługa Azure Notification Hub nie jest skonfigurowana
Musisz skonfigurować połączone centrum powiadomień przy użyciu poświadczeń systemu powiadomień platformy dla platformy (na przykład systemu iOS lub android), których chcesz użyć. Aby uzyskać więcej informacji na temat tego, jak można to zrobić, zobacz Konfigurowanie powiadomień wypychanych w centrum powiadomień.
Połączona usługa Azure Notification Hub nie istnieje
Usługa Azure Notification Hub połączona z zasobem usług Komunikacyjnych już nie istnieje. Sprawdź, czy połączone centrum powiadomień nadal istnieje.
Platforma APNs usługi Azure Notification Hub jest skonfigurowana z trybem uwierzytelniania certyfikatu
Jeśli chcesz użyć platformy APNs z trybem uwierzytelniania certyfikatu, nie jest ona obecnie obsługiwana. Należy skonfigurować platformę APNs z trybem uwierzytelniania tokenu określonym w temacie Konfigurowanie powiadomień wypychanych w centrum powiadomień.
Połączone parametry połączenia nie mają Send uprawnień
Parametry połączenia użyte do połączenia centrum powiadomień z zasobem usług komunikacyjnych musi mieć Send uprawnienie. Aby uzyskać więcej informacji na temat tworzenia nowego parametry połączenia lub zobacz bieżące parametry połączenia w usłudze Azure Notification Hub, możesz zapoznać się z zasadami zabezpieczeń i dostępu usługi Notification Hubs
Połączone parametry połączenia lub identyfikator resourceId usługi Azure Notification Hub są nieprawidłowe
Upewnij się, że skonfigurowano zasób usług Communication Services z poprawnym identyfikatorem resourceId parametry połączenia i azure Notification Hub
Połączony parametry połączenia jest ponownie wygenerowany
W przypadku ponownego wygenerowania parametry połączenia połączonego centrum powiadomień Platformy Azure należy zaktualizować parametry połączenia przy użyciu nowego w zasobie usług komunikacyjnych, ponownie łącząc Centrum powiadomień.
Następne kroki
- Aby zapoznać się z wprowadzeniem do usługi Azure Event Grid, zobacz Co to jest usługa Event Grid?
- Aby dowiedzieć się więcej na temat pojęć związanych z usługą Azure Notification Hubs, zobacz dokumentację usługi Azure Notification Hubs