語言

SyncRequest.Builder.SyncPeriodic(Int64, Int64) 方法

定義

命名空間:
Android.Content
組件:
Mono.Android.dll

建立定期同步。這個建構器必須呼叫這個或 syncOnce（） 來執行。 同步依目標 android.provider 及額外套件內容來識別。 在指定週期同步（呼叫此函式）後，無法重複使用同一個建構器來做一次性同步。 如果你這麼做，將會拋出 IllegalArgumentException。 具有正確權限的應用程式可以使用 ContentResolver.getPeriodicSyncs（Account，String） 查詢週期同步的套件，因此不應在此傳輸敏感資料。 範例用法。 每5小時申請一次定期同步，並有20分鐘彈性時間。 SyncRequest.Builder 建構器 = （new SyncRequest.Builder（））.syncPeriodic（5 * HOUR_IN_SECS， 20 * MIN_IN_SECS）;在該小時的任何時間安排一次週期性同步。 SyncRequest.Builder 建構器 = （new SyncRequest.Builder（））.syncPeriodic（1 * HOUR_IN_SECS， 1 * HOUR_IN_SECS）;注意：週期同步不允許將 ContentResolver.SYNC_EXTRAS_DO_NOT_RETRY 、 ContentResolver.SYNC_EXTRAS_IGNORE_BACKOFF、ContentResolver.SYNC_EXTRAS_IGNORE_SETTINGS、ContentResolver.SYNC_EXTRAS_INITIALIZE、ContentResolver.SYNC_EXTRAS_FORCE、ContentResolver.SYNC_EXTRAS_EXPEDITED、ContentResolver.SYNC_EXTRAS_MANUAL、ContentResolver.SYNC_EXTRAS_SCHEDULE_AS_EXPEDITED_JOB 中的任何一個設定為 true。 如果提供任何例外，則會拋出 IllegalArgumentException。

[Android.Runtime.Register("syncPeriodic", "(JJ)Landroid/content/SyncRequest$Builder;", "GetSyncPeriodic_JJHandler")]
public virtual Android.Content.SyncRequest.Builder? SyncPeriodic(long pollFrequency, long beforeSeconds);
[<Android.Runtime.Register("syncPeriodic", "(JJ)Landroid/content/SyncRequest$Builder;", "GetSyncPeriodic_JJHandler")>]
abstract member SyncPeriodic : int64 * int64 -> Android.Content.SyncRequest.Builder
override this.SyncPeriodic : int64 * int64 -> Android.Content.SyncRequest.Builder

參數

pollFrequency
Int64

你希望間隔在週期性同步之間間隔的時間（秒數）。 最低限度執行1小時。

beforeSeconds
Int64

指你允許同步發生的 pollFrequency 前的彈性時間（秒數）。 必須小於pollFrequency且大於MAX（pollFrequency的5%,5分鐘）

傳回

SyncRequest.Builder

建立定期同步。這個建構器必須呼叫這個或 syncOnce（） 來執行。 同步依目標 android.provider 及額外套件內容來識別。 在指定週期同步（呼叫此函式）後，無法重複使用同一個建構器來做一次性同步。 如果你這麼做，將會拋出 IllegalArgumentException。 具有正確權限的應用程式可以使用 ContentResolver.getPeriodicSyncs（Account，String） 查詢週期同步的套件，因此不應在此傳輸敏感資料。 範例用法。 每5小時申請一次定期同步，並有20分鐘彈性時間。 SyncRequest.Builder 建構器 = （new SyncRequest.Builder（））.syncPeriodic（5 * HOUR_IN_SECS， 20 * MIN_IN_SECS）;在該小時的任何時間安排一次週期性同步。 SyncRequest.Builder 建構器 = （new SyncRequest.Builder（））.syncPeriodic（1 * HOUR_IN_SECS， 1 * HOUR_IN_SECS）;注意：週期同步不允許將 ContentResolver.SYNC_EXTRAS_DO_NOT_RETRY 、 ContentResolver.SYNC_EXTRAS_IGNORE_BACKOFF、ContentResolver.SYNC_EXTRAS_IGNORE_SETTINGS、ContentResolver.SYNC_EXTRAS_INITIALIZE、ContentResolver.SYNC_EXTRAS_FORCE、ContentResolver.SYNC_EXTRAS_EXPEDITED、ContentResolver.SYNC_EXTRAS_MANUAL、ContentResolver.SYNC_EXTRAS_SCHEDULE_AS_EXPEDITED_JOB 中的任何一個設定為 true。 如果提供任何例外，則會拋出 IllegalArgumentException。

屬性
RegisterAttribute

備註

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

Java 文件 android.content.SyncRequest.Builder.syncPeriodic(long, long)。

適用於