次の方法で共有


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_EXPEDITED#SYNC_EXTRAS_INITIALIZE#SYNC_EXTRAS_SCHEDULE_AS_EXPEDITED_JOB#SYNC_EXTRAS_MANUAL#SYNC_EXTRAS_FORCE, を true に設定することはできません。#SYNC_EXTRAS_DO_NOT_RETRY#SYNC_EXTRAS_IGNORE_BACKOFF#SYNC_EXTRAS_IGNORE_SETTINGS いずれかが指定された場合は、an 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)

このページの一部は、Android オープンソース プロジェクトによって作成および共有され、クリエイティブ コモンズ 2.5 属性ライセンスに記載されている条件に従って使用される作業に基づく変更です。

適用対象