ContentResolver.AddPeriodicSync(Account, String, Bundle, Int64) 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
指定應該以指定的帳戶、授權單位和指定頻率要求同步處理。
[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小時。
- 屬性
例外狀況
如果設定了不合法的額外專案，或如果任何參數都是 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 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。