ContentResolver.AddPeriodicSync(Account, String, Bundle, Int64) 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.
Especifica que uma sincronização deve ser solicitada com a conta, a autoridade e os extras especificados na frequência fornecida.
[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
a conta a ser especificada na sincronização
- authority
- String
o provedor a ser especificado na solicitação de sincronização
- extras
- Bundle
parâmetros extras para acompanhar a solicitação de sincronização
- pollFrequency
- Int64
com que frequência a sincronização deve ser executada, em segundos. No nível 24 da API do Android e superior, um intervalo mínimo de 15 minutos é imposto. Nas versões anteriores, o intervalo mínimo é de 1 hora.
- Atributos
Exceções
se um extra ilegal foi definido ou se qualquer um dos parâmetros for nulo.
Comentários
Especifica que uma sincronização deve ser solicitada com a conta, a autoridade e os extras especificados na frequência fornecida. Se já houver outra sincronização periódica agendada com a conta, a autoridade e os extras, uma nova sincronização periódica não será adicionada, em vez disso, a frequência da anterior será atualizada.
Essas sincronizações periódicas respeitam as configurações "syncAutomatically" e "masterSyncAutomatically". Embora essas sincronizações estejam agendadas na frequência especificada, pode levar mais tempo para que ela seja realmente iniciada se outras sincronizações estiverem à frente dela na fila de operações de sincronização. Isso significa que a hora de início real pode descompassar.
Sincronizações periódicas não têm permissão para ter nenhuma de #SYNC_EXTRAS_DO_NOT_RETRY, , #SYNC_EXTRAS_IGNORE_BACKOFF, #SYNC_EXTRAS_IGNORE_SETTINGS, #SYNC_EXTRAS_INITIALIZE, #SYNC_EXTRAS_FORCE, #SYNC_EXTRAS_EXPEDITED, , #SYNC_EXTRAS_MANUAL#SYNC_EXTRAS_SCHEDULE_AS_EXPEDITED_JOB definida como true. Se algum for fornecido, um IllegalArgumentException será lançado.
Esse método requer que o chamador mantenha a permissão android.Manifest.permission#WRITE_SYNC_SETTINGS.
O pacote para uma sincronização periódica pode ser consultado por aplicativos com as permissões corretas usando ContentResolver#getPeriodicSyncs(Account account, String provider), portanto, nenhum dado confidencial deve ser transferido aqui.
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.