Share via

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.

Комментарии

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

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

Для периодической синхронизации не допускается установка значения true для , #SYNC_EXTRAS_DO_NOT_RETRY#SYNC_EXTRAS_IGNORE_BACKOFF#SYNC_EXTRAS_IGNORE_SETTINGS, #SYNC_EXTRAS_INITIALIZE, #SYNC_EXTRAS_FORCE, #SYNC_EXTRAS_EXPEDITED, #SYNC_EXTRAS_SCHEDULE_AS_EXPEDITED_JOB#SYNC_EXTRAS_MANUAL. Если какие-либо из них предоставлены, будет выдано 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 License.

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