ContentResolver.AddPeriodicSync(Account, String, Bundle, Int64) メソッド

定義

指定された頻度で、アカウント、機関、および追加を指定して同期を要求する必要があることを指定します。

[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_IGNORE_SETTINGS#SYNC_EXTRAS_SCHEDULE_AS_EXPEDITED_JOB#SYNC_EXTRAS_FORCE#SYNC_EXTRAS_MANUAL#SYNC_EXTRAS_INITIALIZE#SYNC_EXTRAS_EXPEDITEDを true に設定することはできません。#SYNC_EXTRAS_DO_NOT_RETRY#SYNC_EXTRAS_IGNORE_BACKOFF が指定されている 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)

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

適用対象