Context.StartForegroundService(Intent) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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.