Context.StartForegroundService(Intent) Método

Definición

Similar a #startService(Intent), pero con una promesa implícita de que el servicio llamará android.app.Service#startForeground(int, android.app.Notification) startForeground(int, android.app.Notification) una vez que comience a ejecutarse.

[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.ComponentName

Parámetros

service
Intent

Identifica el servicio que se va a iniciar. La intención debe ser totalmente explícita (proporcionando un nombre de componente). Los valores adicionales se pueden incluir en los extras de intención para proporcionar argumentos junto con esta llamada de inicio específica.

Devoluciones

Si el servicio se está iniciando o ya está en ejecución, se devuelve el ComponentName del servicio real que se inició; de lo contrario, si el servicio no existe null se devuelve.

Atributos

Comentarios

Similar a #startService(Intent), pero con una promesa implícita de que el servicio llamará android.app.Service#startForeground(int, android.app.Notification) startForeground(int, android.app.Notification) una vez que comience a ejecutarse. El servicio recibe una cantidad de tiempo comparable al intervalo de ANR para hacerlo; de lo contrario, el sistema bloqueará automáticamente el proceso, en cuyo caso se registra una excepción ForegroundServiceDidNotStartInTimeException interna en logcat en dispositivos que ejecutan la versión android.os.Build.VERSION_CODES#S del SDK o posterior. En versiones anteriores de Android, se registra una excepción RemoteServiceException interna en su lugar, con un mensaje correspondiente.

A diferencia de lo normal #startService(Intent), este método se puede usar en cualquier momento, independientemente de si la aplicación que hospeda el servicio está en un estado en primer plano.

<div class="caution">

<nota fuerte>:</strong> A partir de la versión del android.os.Build.VERSION_CODES#SSDK, las aplicaciones destinadas a la versión android.os.Build.VERSION_CODES#S del SDK o superior no pueden iniciar servicios en primer plano desde segundo plano. Vea

Cambios de comportamiento: aplicaciones destinadas a Android 12

para obtener más información. </div>

Java documentación para android.content.Context.startForegroundService(android.content.Intent).

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.

Se aplica a