Compartilhar via


ContentResolver.AddPeriodicSync(Account, String, Bundle, Int64) Método

Definição

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_MANUALdefinido #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.

Documentação Java para android.content.ContentResolver.addPeriodicSync(android.accounts.Account, java.lang.String, android.os.Bundle, long).

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.

Aplica-se a