Począwszy od Androida 14 (poziom interfejsu API 34), musisz zadeklarować odpowiedni typ usługi dla każdej usługi na pierwszym planie. Oprócz uprawnienia FOREGROUND_SERVICE musisz zadeklarować typ usługi w pliku manifestu aplikacji i poprosić o odpowiednie uprawnienia usługi na pierwszym planie dla tego typu. W zależności od typu usługi na pierwszym planie przed jej uruchomieniem może być konieczne poproszenie o uprawnienia w czasie działania.
Aparat
- Typ usługi na pierwszym planie do zadeklarowania w pliku manifestu w sekcji
android:foregroundServiceType camera- Uprawnienia do zadeklarowania w pliku manifestu
FOREGROUND_SERVICE_CAMERA- Stała do przekazania do
startForeground() FOREGROUND_SERVICE_TYPE_CAMERA- Wymagania wstępne dotyczące środowiska wykonawczego
poprosić o przyznanie uprawnień w czasie działania
CAMERA,- Opis
Dalsze korzystanie w tle z aparatu, np. w aplikacjach do obsługi czatu wideo, które umożliwiają wielozadaniowość.
Połączone urządzenie
- Typ usługi na pierwszym planie do zadeklarowania w pliku manifestu w sekcji
android:foregroundServiceTypeconnectedDevice- Uprawnienia do zadeklarowania w pliku manifestu
FOREGROUND_SERVICE_CONNECTED_DEVICE- stała wartość przekazywana do
startForeground(), FOREGROUND_SERVICE_TYPE_CONNECTED_DEVICE- Wymagania wstępne środowiska wykonawczego
Musi być spełniony co najmniej 1 z tych warunków:
Zadeklaruj w pliku manifestu co najmniej 1 z tych uprawnień:
Wymagane jest co najmniej 1 z tych uprawnień:
Zadzwoń pod numer
UsbManager.requestPermission()
- Opis
Dotyczy to interakcji z urządzeniami zewnętrznymi, które wymagają łączności Bluetooth, NFC, podczerwieni, USB lub połączenia sieciowego.
- Alternatywy
Jeśli aplikacja musi ciągle przesyłać dane na urządzenie zewnętrzne, rozważ użycie menedżera urządzenia towarzyszącego. Użyj interfejsu API obecności urządzenia towarzyszącego, aby aplikacja działała, gdy urządzenie towarzyszące znajduje się w zasięgu.
Jeśli Twoja aplikacja musi skanować urządzenia Bluetooth, rozważ użycie interfejsu API skanowania Bluetooth.
Synchronizuj dane
- Typ usługi na pierwszym planie do zadeklarowania w pliku manifestu w sekcji
android:foregroundServiceTypedataSync- Uprawnienia do zadeklarowania w pliku manifestu
FOREGROUND_SERVICE_DATA_SYNC- Stała do przekazania do
startForeground() FOREGROUND_SERVICE_TYPE_DATA_SYNC- Wymagania wstępne dotyczące środowiska wykonawczego
- Brak
- Opis
Operacje przesyłania danych, takie jak:
- przesyłanie lub pobieranie danych,
- Operacje tworzenia i przywracania kopii zapasowych
- Operacje importu lub eksportu
- Pobierz dane
- Przetwarzanie plików lokalnych
- Przesyłanie danych między urządzeniem a chmurą przez sieć
- Alternatywy
Szczegółowe informacje znajdziesz w artykule Alternatywy dla usług działających na pierwszym planie do synchronizacji danych.
Zdrowie
- Typ usługi na pierwszym planie do zadeklarowania w pliku manifestu w sekcji
android:foregroundServiceTypehealth- Uprawnienia do zadeklarowania w pliku manifestu
FOREGROUND_SERVICE_HEALTH- Stała wartość przekazywana do funkcji
startForeground() FOREGROUND_SERVICE_TYPE_HEALTH- Wymagania wstępne środowiska wykonawczego
Musi być spełniony co najmniej 1 z tych warunków:
Zadeklaruj uprawnienie
HIGH_SAMPLING_RATE_SENSORSw pliku manifestu.Wymagane jest co najmniej 1 z tych uprawnień:
BODY_SENSORSw interfejsie API 35 lub starszymREAD_HEART_RATEREAD_SKIN_TEMPERATUREREAD_OXYGEN_SATURATIONACTIVITY_RECOGNITION
- Opis
Wszystkie długotrwałe przypadki użycia, które obsługują aplikacje z kategorii fitness, np. monitory aktywności.
Lokalizacja
- 要在清单中的以下位置声明的前台服务类型
android:foregroundServiceTypelocation- 在清单中声明的权限
FOREGROUND_SERVICE_LOCATION- 要传递给
startForeground()的常量 FOREGROUND_SERVICE_TYPE_LOCATION- 运行时前提条件
用户必须已启用位置信息服务,并且应用必须至少获得以下一项运行时权限:
- 说明
需要位置信息使用权的长时间运行的用例,例如导航和位置信息分享。
- 替代方案
如果您的应用需要在用户到达特定位置时触发,请考虑改用 Geofence API。
Multimedia
- Typ usługi na pierwszym planie do zadeklarowania w pliku manifestu w sekcji
android:foregroundServiceTypemediaPlayback- Uprawnienia do zadeklarowania w pliku manifestu
FOREGROUND_SERVICE_MEDIA_PLAYBACK- Stała do przekazania do
startForeground() FOREGROUND_SERVICE_TYPE_MEDIA_PLAYBACK- Wymagania wstępne dotyczące środowiska wykonawczego
- Brak
- Opis
Dotyczy to ciągłego odtwarzania dźwięku lub wideo w tle. Obsługa funkcji cyfrowego nagrywania wideo (DVR) na Androidzie TV.
- Alternatywy
Jeśli wyświetlasz film w trybie obrazu w obrazie, użyj trybu obrazu w obrazie.
Przetwarzane materiały
- Typ usługi na pierwszym planie do zadeklarowania w pliku manifestu w sekcji
android:foregroundServiceTypemediaProcessing- Uprawnienia do zadeklarowania w pliku manifestu
FOREGROUND_SERVICE_MEDIA_PROCESSING- stała wartość przekazywana do
startForeground(), FOREGROUND_SERVICE_TYPE_MEDIA_PROCESSING- Wymagania wstępne środowiska wykonawczego
- Brak
- Opis
Usługa do wykonywania czasochłonnych operacji na zasobach multimedialnych, takich jak konwertowanie multimediów na różne formaty. System zezwala tej usłudze na ograniczony czas działania. W normalnych okolicznościach limit czasu wynosi 6 godzin na 24 godziny. Ten limit jest wspólny dla wszystkich
mediaProcessingusług na pierwszym planie w aplikacji.Aplikacja powinna ręcznie zatrzymać usługę przetwarzania multimediów w takich sytuacjach:
- Gdy operacja transkodowania zostanie zakończona lub osiągnie stan błędu, usługa powinna wywołać
Service.stopForeground()iService.stopSelf(), aby całkowicie zatrzymać usługę.
- Gdy operacja transkodowania zostanie zakończona lub osiągnie stan błędu, usługa powinna wywołać
Po upływie limitu czasu system wywołuje metodę
Service.onTimeout(int, int)usługi. W tym momencie usługa ma kilka sekund na wywołanie funkcjiService.stopSelf(). Jeśli usługa nie wywołuje funkcjiService.stopSelf(), wystąpi ANR z komunikatem o błędzie: „Usługa na pierwszym planie <fgs_type> nie zatrzymała się w czasie swojego limitu czasu: <component_name>”.Uwaga: funkcja
Service.onTimeout(int, int)jest niedostępna na Androidzie 14 lub starszym. Na urządzeniach z tymi wersjami, jeśli usługa przetwarzania multimediów osiągnie limit czasu, system natychmiast przeniesie aplikację do pamięci podręcznej. Z tego powodu aplikacja nie powinna czekać na powiadomienie o przekroczeniu limitu czasu. Zamiast tego należy zakończyć usługę na pierwszym planie lub jak najszybciej zmienić ją na usługę działającą w tle.
Wyświetlanie multimediów
- Typ usługi na pierwszym planie do zadeklarowania w pliku manifestu w sekcji
android:foregroundServiceTypemediaProjection- Uprawnienia do zadeklarowania w pliku manifestu
FOREGROUND_SERVICE_MEDIA_PROJECTION- Stała do przekazania do
startForeground() FOREGROUND_SERVICE_TYPE_MEDIA_PROJECTION- Wymagania wstępne dotyczące środowiska wykonawczego
Wywołaj metodę
createScreenCaptureIntent()przed uruchomieniem usługi na pierwszym planie. Spowoduje to wyświetlenie użytkownikowi powiadomienia o uprawnieniach. Użytkownik musi przyznać uprawnienia, zanim będzie można utworzyć usługę.Po utworzeniu usługi działającej na pierwszym planie możesz wywołać
MediaProjectionManager.getMediaProjection().- Opis
Dotyczy to wyświetlania treści na wyświetlaczu innym niż główny lub urządzeniu zewnętrznym przy użyciu interfejsów API
MediaProjection. Nie muszą to być wyłącznie treści multimedialne.- Alternatywy
Aby przesyłać strumieniowo multimedia na inne urządzenie, użyj pakietu SDK Google Cast.
Mikrofon
- 在清单中声明的前台服务类型
android:foregroundServiceTypemicrophone- 要在清单中声明的权限
FOREGROUND_SERVICE_MICROPHONE- 要传递给
startForeground()的常量 FOREGROUND_SERVICE_TYPE_MICROPHONE- 运行时前提条件
请求并获得
RECORD_AUDIO运行时权限。- 说明
在后台继续捕获麦克风内容,例如录音器或通信应用。
Połączenie telefoniczne
- Typ usługi na pierwszym planie do zadeklarowania w pliku manifestu w sekcji
android:foregroundServiceTypephoneCall- Uprawnienia do zadeklarowania w pliku manifestu
FOREGROUND_SERVICE_PHONE_CALL- Stała do przekazania do
startForeground() FOREGROUND_SERVICE_TYPE_PHONE_CALL- Wymagania wstępne dotyczące środowiska wykonawczego
Musi być spełniony co najmniej jeden z tych warunków:
- Aplikacja zadeklarowała uprawnienie
MANAGE_OWN_CALLSw pliku manifestu.
- Aplikacja zadeklarowała uprawnienie
- Aplikacja jest domyślną aplikacją do wybierania numerów dzięki roli
ROLE_DIALER.
- Aplikacja jest domyślną aplikacją do wybierania numerów dzięki roli
- Opis
Kontynuowanie trwającego połączenia za pomocą interfejsów API
ConnectionService.- Alternatywy
Jeśli chcesz wykonywać połączenia telefoniczne, wideo lub VoIP, rozważ użycie biblioteki
android.telecom.Rozważ użycie funkcji
CallScreeningServicedo filtrowania połączeń.
Zdalne przesyłanie wiadomości
- Typ usługi na pierwszym planie do zadeklarowania w pliku manifestu w sekcji
android:foregroundServiceTyperemoteMessaging- Uprawnienia do zadeklarowania w pliku manifestu
FOREGROUND_SERVICE_REMOTE_MESSAGING- stała wartość przekazywana do
startForeground(), FOREGROUND_SERVICE_TYPE_REMOTE_MESSAGING- Wymagania wstępne środowiska wykonawczego
- Brak
- Opis
- Przenoszenie wiadomości tekstowych z jednego urządzenia na drugie. Dotyczy to pomocy w ciągłości wykonywania przez użytkownika zadań związanych z wiadomościami przy przełączaniu się na inne urządzenie.
Krótkie nabożeństwo
- 要在清单中的以下位置声明的前台服务类型
android:foregroundServiceTypeshortService- 在清单中声明的权限
- 无
- 要传递给
startForeground()的常量 FOREGROUND_SERVICE_TYPE_SHORT_SERVICE- 运行时前提条件
- 无
- 说明
快速完成不可中断或推迟的关键工作。
这种类型有一些独特的特征:
- 只能持续运行一小段时间(大约 3 分钟)。
- 不支持粘性前台服务。
- 无法启动其他前台服务。
- 不需要类型专用权限,不过它仍需要
FOREGROUND_SERVICE权限。 - 只有当应用当前符合启动新前台服务的条件时,
shortService才能更改为其他服务类型。 - 前台服务可以随时将其类型更改为
shortService,届时超时期限将开始。
shortService 的超时时间从调用
Service.startForeground()开始算起。应用应在发生超时之前调用Service.stopSelf()或Service.stopForeground()。否则,系统会调用新的Service.onTimeout(),让应用有机会调用stopSelf()或stopForeground()来停止其服务。调用
Service.onTimeout()后的短时间内,应用会进入缓存状态,并且不再被视为处于前台,除非用户正在主动与应用互动。应用缓存一小段时间后,服务还未停止,该应用会收到 ANR 消息。ANR 消息提及FOREGROUND_SERVICE_TYPE_SHORT_SERVICE。出于这些原因,实现Service.onTimeout()回调被视为一种最佳实践。Android 13 及更低版本中不存在
Service.onTimeout()回调。如果同一服务在此类设备上运行,则不会出现超时,也不会发生 ANR。确保您的服务在完成处理任务后立即停止,即使它尚未收到Service.onTimeout()回调也是如此。请务必注意,如果未遵循
shortService的超时设置,即使应用还有其他有效的前台服务或其他应用生命周期进程,应用也会遇到 ANR。如果应用对用户可见,或满足允许从后台启动前台服务的某一豁免条件,则使用
FOREGROUND_SERVICE_TYPE_SHORT_SERVICE参数再次调用Service.StartForeground()会将超时时间再延长 3 分钟。如果应用对用户不可见且不满足其中一个豁免条件,则尝试启动其他前台服务(无论其类型如何)都会导致ForegroundServiceStartNotAllowedException。即使用户为您的应用停用电池优化功能,仍然会受到 shortService FGS 的影响。
如果您启动包含
shortService类型和另一个前台服务类型的前台服务,系统会忽略shortService类型声明。不过,该服务仍必须遵守其他声明类型的先决条件。如需了解详情,请参阅前台服务文档。
Specjalne zastosowanie
- Typ usługi na pierwszym planie do zadeklarowania w pliku manifestu w sekcji
android:foregroundServiceTypespecialUse- Uprawnienia do zadeklarowania w pliku manifestu
FOREGROUND_SERVICE_SPECIAL_USE- stała wartość przekazywana do
startForeground(), FOREGROUND_SERVICE_TYPE_SPECIAL_USE- Wymagania wstępne środowiska wykonawczego
- Brak
- Opis
Obejmuje wszystkie prawidłowe przypadki użycia usługi na pierwszym planie, które nie są objęte innymi typami usług na pierwszym planie.
Oprócz zadeklarowania
FOREGROUND_SERVICE_TYPE_SPECIAL_USEtypu usługi na pierwszym planie deweloperzy powinni zadeklarować przypadki użycia w pliku manifestu. W tym celu określają element<property>w elemencie<service>. Te wartości i odpowiednie przypadki użycia są sprawdzane podczas przesyłania aplikacji w Konsoli Google Play. Podane przez Ciebie przypadki użycia są niesformalne. Pamiętaj, aby podać wystarczającą ilość informacji, aby zweryfikować, dlaczego musisz używać typuspecialUse.<service android:name="fooService" android:foregroundServiceType="specialUse"> <property android:name="android.app.PROPERTY_SPECIAL_USE_FGS_SUBTYPE" android:value="explanation_for_special_use"/> </service>
Zwolnienie przez system
- 要在其清单中声明的前台服务类型
android:foregroundServiceTypesystemExempted- 在清单中声明的权限
FOREGROUND_SERVICE_SYSTEM_EXEMPTED- 要传递给
startForeground()的常量 FOREGROUND_SERVICE_TYPE_SYSTEM_EXEMPTED- 运行时前提条件
- 无
- 说明
为系统应用和特定系统集成预留,以便继续使用前台服务。
如需使用此类型,应用必须至少满足以下条件之一:
- 设备处于演示模式状态
- 应用是设备所有者
- 应用是性能分析器所有者
- 属于具有
ROLE_EMERGENCY角色的安全应用 - 属于设备管理应用
- 具有
SCHEDULE_EXACT_ALARM或USE_EXACT_ALARM权限的应用 VPN 应用(通过设置 > 网络和互联网 > VPN 进行配置)
否则,声明此类型会导致系统抛出
ForegroundServiceTypeNotAllowedException。
Egzekwowanie zasad Google Play dotyczących korzystania z typów usług na pierwszym planie
Jeśli Twoja aplikacja jest kierowana na Androida 14 lub nowszego, musisz zadeklarować typy usług na pierwszym planie w Konsoli Play na stronie „Zawartość aplikacji” (Zasady > Zawartość aplikacji). Więcej informacji o deklarowaniu typów usług na pierwszym planie w Konsoli Play znajdziesz w artykule Omówienie wymagań dotyczących usług działających na pierwszym planie i intencji pełnoekranowych.