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

同步的执行频率（以秒为单位）。 在 Android API 级别 24 及更高版本上，强制实施最小间隔 15 分钟。 在以前的版本中，最小间隔为 1 小时。

属性

RegisterAttribute

例外

IllegalArgumentException

如果设置了非法的额外值，或者任何参数为 null，则为 null。

注解

指定应使用指定帐户、颁发机构以及给定频率的额外项请求同步。 如果已使用帐户、颁发机构和额外同步计划了另一个定期同步，则不会添加新的定期同步，而是更新上一次同步的频率。

这些定期同步遵循“syncAutomatically”和“masterSyncAutomatically”设置。 尽管这些同步按指定的频率进行计划，但如果其他同步在同步操作队列中领先于同步操作队列，则实际启动同步可能需要更长的时间。 这意味着实际开始时间可能会偏移。

不允许定期同步设置为 true 的任何#SYNC_EXTRAS_DO_NOT_RETRY值、#SYNC_EXTRAS_IGNORE_BACKOFF、、#SYNC_EXTRAS_IGNORE_SETTINGS、#SYNC_EXTRAS_FORCE#SYNC_EXTRAS_INITIALIZE#SYNC_EXTRAS_EXPEDITED、、#SYNC_EXTRAS_MANUAL#SYNC_EXTRAS_SCHEDULE_AS_EXPEDITED_JOB。 如果提供任何值，则会引发一个 IllegalArgumentException 。

此方法要求调用方持有权限 android.Manifest.permission#WRITE_SYNC_SETTINGS。

使用正确权限 ContentResolver#getPeriodicSyncs(Account account, String provider)的应用程序可以查询定期同步的捆绑包，因此不应在此处传输敏感数据。

适用于 . 的 android.content.ContentResolver.addPeriodicSync(android.accounts.Account, java.lang.String, android.os.Bundle, long)Java 文档

本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改，并根据 Creative Commons 2.5 属性许可证中所述的术语使用。