Поделиться через

ContentResolver.AddPeriodicSync(Account, String, Bundle, Int64) Метод

  • Ссылка

Определение

Пространство имен:
Android.Content
Сборка:
Mono.Android.dll

Указывает, что синхронизация должна запрашиваться с указанной учетной записью, центром и дополнительными компонентами с заданной частотой.

[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

Параметры

account
Account

учетная запись, указанная в синхронизации

authority
String

поставщик, указанный в запросе синхронизации

extras
Bundle

дополнительные параметры для выполнения запроса синхронизации

pollFrequency
Int64

как часто следует выполнять синхронизацию в секундах. На уровне API Android 24 и более поздних версий применяется минимальный интервал в 15 минут. В предыдущих версиях минимальный интервал составляет 1 час.

Атрибуты
RegisterAttribute

Исключения

IllegalArgumentException

Значение NULL, если был задан недопустимый дополнительный параметр или какой-либо из параметров имеет значение NULL.

Комментарии

Указывает, что синхронизация должна запрашиваться с указанной учетной записью, центром и дополнительными компонентами с заданной частотой. Если с учетной записью уже запланирована другая периодическая синхронизация, центр и дополнительные компоненты, то новая периодическая синхронизация не будет добавлена, а не частота предыдущего будет обновлена.

Эти периодические синхронизации учитывают параметры syncAutomatically и masterSyncAutomatically. Хотя синхронизация запланирована на указанной частоте, может потребоваться больше времени, чтобы она фактически была запущена, если другие синхронизации опережают ее в очереди операций синхронизации. Это означает, что фактическое время начала может смеять.

Периодические синхронизации не допускаются для любой из #SYNC_EXTRAS_DO_NOT_RETRY, #SYNC_EXTRAS_IGNORE_BACKOFF, #SYNC_EXTRAS_IGNORE_SETTINGS, #SYNC_EXTRAS_FORCE#SYNC_EXTRAS_INITIALIZE, , #SYNC_EXTRAS_MANUAL#SYNC_EXTRAS_EXPEDITED#SYNC_EXTRAS_SCHEDULE_AS_EXPEDITED_JOB имеет значение true. Если какие-либо предоставляются, IllegalArgumentException будет создано исключение.

Для этого метода требуется, чтобы вызывающий объект держал разрешение android.Manifest.permission#WRITE_SYNC_SETTINGS.

Пакет для периодической синхронизации может запрашиваться приложениями с правильными разрешениями, поэтому ContentResolver#getPeriodicSyncs(Account account, String provider)здесь не следует передавать конфиденциальные данные.

Документация по Java для android.content.ContentResolver.addPeriodicSync(android.accounts.Account, java.lang.String, android.os.Bundle, long).

Части этой страницы — это изменения на основе работы, созданной и общей проектом с открытым исходным кодом Android и используемой в соответствии с условиями, описанными в лицензии Creative Commons 2.5 Attribution.

Применяется к