語言

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

如果設定了非法額外內容或任何參數為空。

備註

規定應在指定頻率下請求與指定的帳號、權限及額外服務同步。 如果帳號、權限和額外項目已經排定了另一個週期性同步，則不會新增新的週期性同步，而是會更新前一次的頻率。

這些週期性同步會遵循「同步自動」和「主同步自動」的設定。 雖然這些同步會依指定頻率排程，但若同步操作隊列中其他同步先於它，實際啟動時間可能會更長。 這表示實際的起始時間可能會有所偏移。

週期性同步不允許將 #SYNC_EXTRAS_DO_NOT_RETRY， #SYNC_EXTRAS_IGNORE_BACKOFF， #SYNC_EXTRAS_IGNORE_SETTINGS， #SYNC_EXTRAS_INITIALIZE#SYNC_EXTRAS_FORCE#SYNC_EXTRAS_EXPEDITED#SYNC_EXTRAS_MANUAL設#SYNC_EXTRAS_SCHEDULE_AS_EXPEDITED_JOB為 true。 如果有提供，則會擲出一個 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)。

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

適用於