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, autoridade e extras especificados na frequência 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 -> unit
Parâ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 e superior da API do Android, 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, autoridade e extras especificados na frequência especificada. Se já houver outra sincronização periódica agendada com a conta, autoridade e 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 sejam 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 se desviar.
As sincronizações periódicas não podem ter nenhum dos , , , , #SYNC_EXTRAS_INITIALIZE
#SYNC_EXTRAS_FORCE
, , #SYNC_EXTRAS_EXPEDITED
, #SYNC_EXTRAS_MANUAL
definido #SYNC_EXTRAS_SCHEDULE_AS_EXPEDITED_JOB
como true. #SYNC_EXTRAS_IGNORE_SETTINGS
#SYNC_EXTRAS_IGNORE_BACKOFF
#SYNC_EXTRAS_DO_NOT_RETRY
Se algum for fornecido, então 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)
o , portanto, nenhum dado confidencial deve ser transferido aqui.
Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Android Open Source Project e usado de acordo com os termos descritos na Creative Commons 2.5 Attribution License.