Uprawnienia czasu działania powiadomień

Android 13 (poziom API 33) i nowszy obsługuje uprawnienia środowiska wykonawczego do wysyłania niezwolnione powiadomienia (w tym powiadomienia dotyczące usług działających na pierwszym planie) z aplikacji: POST_NOTIFICATIONS Ta zmiana pozwoli użytkownikom skupić się na powiadomieniach, które są dla nich najważniejsze .

Zdecydowanie zalecamy jak najszybsze przejście na Androida 13 lub nowszego jak najlepiej skorzystać z dodatkowej kontroli i elastyczności funkcji. Jeśli nadal będziesz kierować kampanię na wersję 12L (poziom interfejsu API 32) lub niższy, utracisz elastyczność dzięki prośbowi o uprawnienia w kontekście .

Zadeklarowanie uprawnień

Aby poprosić o nowe uprawnienie do wysyłania powiadomień, zaktualizuj aplikację, aby kierowała się na Androida 13, i wykonaj podobny proces, co w przypadku udzielania innych uprawnień w czasie wykonywania, jak pokazano w następnych sekcjach.

Uprawnienie, które musisz zadeklarować w pliku manifestu aplikacji, jest widoczne w tym fragmencie kodu:

<manifest ...>
    <uses-permission android:name="android.permission.POST_NOTIFICATIONS"/>
    <application ...>
        ...
    </application>
</manifest>

Możliwości aplikacji zależą od wyboru użytkownika w oknie uprawnień

W tym oknie użytkownicy mają następujące działania:

• Kliknij zezwól.
• Wybierz Nie zezwalaj.
• Przesuń palcem poza okno bez naciskania żadnego z przycisków

W sekcjach poniżej opisujemy, jak aplikacja ma się zachowywać w zależności od działania użytkownika.

Użytkownik klika „Zezwól”

Jeśli użytkownik wybierze opcję zezwalaj, aplikacja będzie mogła:

• Wysyłaj powiadomienia. Wszystkie kanały powiadomień są dozwolone.
• Publikuj powiadomienia związane z pierwszym planem usługi. Te powiadomienia wyświetlają się w panelu powiadomień.

Użytkownik klika „Nie zezwalaj”.

Jeśli użytkownik wybierze opcję Nie zezwalaj, aplikacja nie będzie mogła wysyłać powiadomień, chyba że kwalifikuje się do wyjątku. Wszystkie kanały powiadomień są zablokowane, oprócz kilku role. Jest to podobne do tego, co dzieje się, gdy użytkownik ręcznie wyłączy wszystkie powiadomienia z aplikacji w ustawieniach systemu.

Użytkownik opuszcza okno

Jeśli użytkownik przesunie palcem poza okno, czyli nie wybierze żadnej z tych opcji. allow (zezwól) lub nie allow (nie zezwalaj) – stan uprawnień do wyświetlania powiadomień nie: .

Wpływ na nowo zainstalowane aplikacje

Jeśli użytkownik zainstaluje Twoją aplikację na urządzeniu z Androidem 13 lub nowszego, powiadomienia są domyślnie wyłączone. Aplikacja musi zaczekać z wysyłaniem powiadomień do momentu, gdy poprosisz o nowe uprawnienia i użytkownik przyzna je aplikacji.

Czas wyświetlenia okna uprawnień zależy od celu aplikacji Wersja pakietu SDK:

• Jeśli Twoja aplikacja jest kierowana na Androida 13 lub nowszego, nad wyświetlaniem okna uprawnień. Wykorzystaj tę możliwość, aby wyjaśnić użytkownikom, dlaczego aplikacja potrzebuje tych uprawnień. i zachęcanie ich do tego.
• Jeśli Twoja aplikacja jest kierowana na wersję 12L (poziom interfejsu API 32) lub niższy, system pokazuje okna z uprawnieniami przy pierwszym uruchomieniu aplikacji po tym, jak utwórz kanał powiadomień lub gdy aplikacja rozpoczyna aktywność, a następnie tworzy swój pierwszy kanał powiadomień. Zwykle jest to uruchomienie aplikacji.

Wpływ na aktualizacje dotychczasowych aplikacji

Aby zminimalizować zakłócenia związane z uprawnieniami do wyświetlania powiadomień, system automatycznie wstępnie przyznaje uprawnienia wszystkim użytkownikom, odpowiednich aplikacji, gdy użytkownik przejdzie na Androida w wersji 13 lub nowszej. Oznacza to, że te aplikacje mogą nadal wysyłać powiadomienia do użytkowników, a użytkownicy nie widzą prośby o uprawnienia w czasie działania.

Kryteria kwalifikacji do wstępnego przyznania uprawnień

Aby aplikacja kwalifikowała się do automatycznego wstępnego przyznania uprawnień, musi mieć istniejący kanał powiadomień, a powiadomienia nie mogą być wyłączone przez użytkownika na urządzeniu z Androidem w wersji 12L lub starszej.

Jeśli użytkownik wyłączył powiadomienia w aplikacji na urządzeniu, które działa 12L lub mniej, odmowa dostępu utrzymuje się, gdy urządzenie uaktualnienia do Androida 13 lub nowszego.

Zwolnienia

Ta sekcja zawiera zestaw powiadomień i aplikacji, które nie są objęte zmianą zachowania uprawnień powiadomień. Na urządzeniu z Androidem 13 (poziom interfejsu API 33) lub nowszym jeśli użytkownik odmówi zgody na wyświetlanie powiadomień, nadal będzie widzieć powiadomienia związane do usług działających na pierwszym planie w Menedżer zadań ale nie widzę ich w panelu powiadomień.

Sesje multimediów

Powiadomienia dotyczące: sesji multimedialnych są wykluczeni z tej zmiany w działaniu.

Aplikacje skonfigurowane do samodzielnego zarządzania połączeniami telefonicznymi

Jeśli Twoja aplikacja samodzielnie zarządza połączeniami telefonicznymi, nie potrzebują uprawnień POST_NOTIFICATIONS, aby aplikacja mogła wysyłać wiadomości powiadomienia korzystające z Notification.CallStyle. stylu powiadomień.

System uznaje, że aplikacja została skonfigurowana pod kątem samodzielnego zarządzania telefonem jeśli wykona każdą z tych czynności:

1. Deklaruje MANAGE_OWN_CALLS uprawnienia.
2. Implementuje funkcję ConnectionService za pomocą prostego interfejsu online.
3. Rejestruje się u dostawcy usług telekomunikacyjnych urządzenia, dzwoniąc na numer registerPhoneAccount().

Testowanie aplikacji

Możesz ocenić, jak uprawnienia do powiadomień wpływają na aplikację, gdy po raz pierwszy na urządzeniu z Androidem 13 lub nowszym. obserwujesz zestawy poleceń Android Debug Bridge (ADB)pozwalają na symulację najczęstszych wyborów użytkownika i uaktualnień urządzeń. bez konieczności resetowania urządzenia testowego:

• Aplikacja została niedawno zainstalowana na urządzeniu z Androidem w wersji 13 lub nowszej:

  adb shell pm revoke PACKAGE_NAME android.permission.POST_NOTIFICATIONS
  adb shell pm clear-permission-flags PACKAGE_NAME \
    android.permission.POST_NOTIFICATIONS user-set
  adb shell pm clear-permission-flags PACKAGE_NAME \
    android.permission.POST_NOTIFICATIONS user-fixed

• Użytkownik pozostawia włączone powiadomienia, gdy aplikacja jest zainstalowana na urządzenia o pojemności 12L lub niższej, uaktualnienia do Androida 13 lub nowszego:

  adb shell pm grant PACKAGE_NAME android.permission.POST_NOTIFICATIONS
  adb shell pm set-permission-flags PACKAGE_NAME \
    android.permission.POST_NOTIFICATIONS user-set
  adb shell pm clear-permission-flags PACKAGE_NAME \
    android.permission.POST_NOTIFICATIONS user-fixed

• użytkownik ręcznie wyłącza powiadomienia, gdy aplikacja jest zainstalowana na urządzenia o pojemności 12L lub niższej, uaktualnienia do Androida 13 lub nowszego:

  adb shell pm revoke PACKAGE_NAME android.permission.POST_NOTIFICATIONS
  adb shell pm set-permission-flags PACKAGE_NAME \
    android.permission.POST_NOTIFICATIONS user-set
  adb shell pm clear-permission-flags PACKAGE_NAME \
    android.permission.POST_NOTIFICATIONS user-fixed

Sprawdzone metody

W tej sekcji opisano kilka sposobów korzystania z nowego powiadomienia i uzyskać więcej uprawnień w aplikacji.

Zaktualizuj docelową wersję pakietu SDK aplikacji

Aby zapewnić aplikacji większą elastyczność w zakresie wyświetlania okna uprawnień, zaktualizuj aplikację, tak aby była kierowana na Androida 13 lub nowszego.

Poczekaj na wyświetlenie prośby o zgodę na wyświetlanie powiadomień

Zanim poprosisz użytkowników o przyznanie uprawnień, pozwól im zapoznać się z aplikacją.

Nowi użytkownicy mogą chcieć zapoznać się z aplikacją i sprawdzić, jakie korzyści daje każde powiadomienie. Dostępne opcje wyświetlenie prośby o uprawnienia w wyniku działania użytkownika. Poniższa lista zawiera kilka przykładów tego, kiedy to dobry moment na wyświetlenie prośby o zgodę na wyświetlanie powiadomień:

• Użytkownik klika „dzwonek alertu”. Przycisk
• Użytkownik decyduje się śledzić konto mediów społecznościowych innej osoby.
• Użytkownik przesyła zamówienie z dostawą jedzenia.

Ilustracja 1 przedstawia zalecany proces wysyłania żądania powiadomienia uprawnienia. Jeśli funkcja shouldShowRequestPermissionRationale() nie zwraca wartości true, aplikacja nie musi wyświetlać środkowego ekranu, czyli ekranu z tytułem „Otrzymuj powiadomienia”.

Możesz też ustawić prośbę o ocenę po tym, jak użytkownicy zapoznają się z Twoją aplikacją. Możesz na przykład poczekać, aż użytkownik uruchomi aplikację po raz trzeci lub czwarty.

Uzyskiwanie uprawnień w kontekście

Gdy prosisz o zgodę na wyświetlanie powiadomień w aplikacji, zrób to we właściwym kontekst, by było jasne, do czego służą powiadomienia dlaczego użytkownik powinien się włączyć. Aplikacja do poczty e-mail może na przykład zawierać opcje wysyłania powiadomień o wszystkich nowych e-mailach lub tylko tych e-mailach, w których użytkownik jest tylko adresatem.

Wykorzystaj tę okazję, by jasno powiedzieć o swoich zamiarach, a użytkownicy aplikacji z dużym prawdopodobieństwem, że przyznają jej zgodę na wyświetlanie powiadomień.

Sprawdzanie, czy aplikacja może wysyłać powiadomienia

Zanim aplikacja wyśle powiadomienie, sprawdź, czy użytkownik włączył tę funkcję powiadomienia z aplikacji. W tym celu zadzwoń pod numer areNotificationsEnabled()

Odpowiedzialne korzystanie z uprawnień

Gdy otrzymasz zgodę na wysyłanie powiadomień, pamiętaj o użyciu uprawnień odpowiedzialnie. Użytkownicy mogą zobaczyć liczbę dziennych powiadomień wysyłanych przez Twoją aplikację wysyła i może on anulować to uprawnienie w dowolnym momencie.