Context.StartForegroundService(Intent) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Semelhante a #startService(Intent), mas com uma promessa implícita que o Serviço chamará android.app.Service#startForeground(int, android.app.Notification)
startForeground(int, android.app.Notification) quando começar a ser executado.
[Android.Runtime.Register("startForegroundService", "(Landroid/content/Intent;)Landroid/content/ComponentName;", "GetStartForegroundService_Landroid_content_Intent_Handler", ApiSince=26)]
public abstract Android.Content.ComponentName? StartForegroundService(Android.Content.Intent? service);[<Android.Runtime.Register("startForegroundService", "(Landroid/content/Intent;)Landroid/content/ComponentName;", "GetStartForegroundService_Landroid_content_Intent_Handler", ApiSince=26)>]
abstract member StartForegroundService : Android.Content.Intent -> Android.Content.ComponentNameParâmetros
- service
- Intent
Identifica o serviço a ser iniciado. A Intenção deve ser totalmente explícita (fornecendo um nome de componente). Valores adicionais podem ser incluídos nos extras de Intenção para fornecer argumentos junto com essa chamada inicial específica.
Retornos
Se o serviço estiver sendo iniciado ou já estiver em execução, o ComponentName serviço real iniciado será retornado; caso contrário, se o serviço não existir nulo será retornado.
- Atributos
Comentários
Semelhante a #startService(Intent), mas com uma promessa implícita que o Serviço chamará android.app.Service#startForeground(int, android.app.Notification) startForeground(int, android.app.Notification) quando começar a ser executado. O serviço recebe uma quantidade de tempo comparável ao intervalo ANR para fazer isso, caso contrário, o sistema falhará automaticamente no processo, caso em que uma exceção ForegroundServiceDidNotStartInTimeException interna é registrada no logcat em dispositivos que executam a Versão android.os.Build.VERSION_CODES#S do SDK ou posterior. Em versões mais antigas do Android, uma exceção RemoteServiceException interna é registrada em log, com uma mensagem correspondente.
Ao contrário do comum #startService(Intent), esse método pode ser usado a qualquer momento, independentemente de o aplicativo que hospeda o serviço estar em primeiro plano.
<classe div="cuidado">
<Observação forte>:/forte> Começando com a versão android.os.Build.VERSION_CODES#Sdo SDK, os aplicativos direcionados à versão android.os.Build.VERSION_CODES#S do SDK ou superior não têm permissão para iniciar serviços em primeiro plano< em segundo plano. Veja
Alterações de comportamento: aplicativos direcionados ao Android 12
para obter mais detalhes. </div>
Java documentação para android.content.Context.startForegroundService(android.content.Intent).
Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.