ContentResolver.AddPeriodicSync(Account, String, Bundle, Int64) 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í.
Especifica que se debe solicitar una sincronización con la cuenta, autoridad y extras especificados con la frecuencia especificada.
[Android.Runtime.Register("addPeriodicSync", "(Landroid/accounts/Account;Ljava/lang/String;Landroid/os/Bundle;J)V", "")]
public static void AddPeriodicSync (Android.Accounts.Account? account, string? authority, Android.OS.Bundle? extras, long pollFrequency);[<Android.Runtime.Register("addPeriodicSync", "(Landroid/accounts/Account;Ljava/lang/String;Landroid/os/Bundle;J)V", "")>]
static member AddPeriodicSync : Android.Accounts.Account * string * Android.OS.Bundle * int64 -> unitParámetros
- account
- Account
la cuenta que se va a especificar en la sincronización
- authority
- String
el proveedor que se va a especificar en la solicitud de sincronización
- extras
- Bundle
parámetros adicionales para ir junto con la solicitud de sincronización
- pollFrequency
- Int64
frecuencia con la que se debe realizar la sincronización, en segundos. En el nivel 24 y posteriores de la API de Android, se aplica un intervalo mínimo de 15 minutos. En versiones anteriores, el intervalo mínimo es de 1 hora.
- Atributos
Excepciones
si se estableció un extra no válido o si alguno de los parámetros es NULL.
Comentarios
Especifica que se debe solicitar una sincronización con la cuenta, autoridad y extras especificados con la frecuencia especificada. Si ya hay otra sincronización periódica programada con la cuenta, autoridad y extras, no se agregará una nueva sincronización periódica, en lugar de la frecuencia del anterior se actualizará.
Estas sincronizaciones periódicas respetan la configuración "syncAutomatically" y "masterSyncAutomatically". Aunque esta sincronización está programada con la frecuencia especificada, puede tardar más tiempo en iniciarse si otras sincronizaciones están por delante de ella en la cola de operaciones de sincronización. Esto significa que la hora de inicio real puede desfase.
No se permite que las sincronizaciones periódicas tengan ninguno de #SYNC_EXTRAS_DO_NOT_RETRYlos valores , #SYNC_EXTRAS_IGNORE_BACKOFF, #SYNC_EXTRAS_FORCE#SYNC_EXTRAS_INITIALIZE#SYNC_EXTRAS_EXPEDITED#SYNC_EXTRAS_IGNORE_SETTINGS, #SYNC_EXTRAS_MANUALy #SYNC_EXTRAS_SCHEDULE_AS_EXPEDITED_JOB true. Si se proporciona alguno, se producirá una IllegalArgumentException excepción .
Este método requiere que el autor de la llamada contenga el permiso android.Manifest.permission#WRITE_SYNC_SETTINGS.
Las aplicaciones pueden consultar la agrupación de una sincronización periódica con los permisos correctos mediante ContentResolver#getPeriodicSyncs(Account account, String provider), por lo que no se debe transferir aquí ningún dato confidencial.
Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el proyecto de código abierto de Android y se usan según los términos descritos en la licencia de atribución de Creative Commons 2.5.