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，則為 。

備註

指定應該以指定的帳戶、授權單位和指定頻率要求同步處理。 如果帳戶已排程另一個定期同步處理，授權單位和額外專案，則不會新增新的定期同步處理，而是更新前一個同步的頻率。

這些定期同步處理會接受 「syncAutomatically」 和 「masterSyncAutomatically」 設定。 雖然這些同步會排程在指定的頻率上，但如果其他同步處理在同步作業佇列中領先，它可能需要更長的時間才能實際啟動。 這表示實際的開始時間可能會漂移。

不允許定期同步處理任何 #SYNC_EXTRAS_DO_NOT_RETRY、、、、#SYNC_EXTRAS_IGNORE_SETTINGS、#SYNC_EXTRAS_INITIALIZE#SYNC_EXTRAS_EXPEDITED#SYNC_EXTRAS_FORCE、 #SYNC_EXTRAS_SCHEDULE_AS_EXPEDITED_JOB #SYNC_EXTRAS_MANUAL設定為 true。 #SYNC_EXTRAS_IGNORE_BACKOFF 如果提供任何， 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 屬性授權中所述的詞彙使用。