ContentResolver.AddPeriodicSync(Account, String, Bundle, Int64) Metode

Definisi

Ruang nama:: Android.Content

Rakitan:: Mono.Android.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Menentukan bahwa sinkronisasi harus diminta dengan akun, otoritas, dan ekstra yang ditentukan pada frekuensi yang diberikan.

[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

Parameter

account: Account

akun yang akan ditentukan dalam sinkronisasi

authority: String

penyedia yang akan ditentukan dalam permintaan sinkronisasi

extras: Bundle

parameter tambahan untuk mengikuti permintaan sinkronisasi

pollFrequency: Int64

seberapa sering sinkronisasi harus dilakukan, dalam detik. Pada Android API level 24 ke atas, interval minimum 15 menit diberlakukan. Pada versi sebelumnya, interval minimum adalah 1 jam.

Atribut: RegisterAttribute

Pengecualian

IllegalArgumentException

jika ekstra ilegal ditetapkan atau jika salah satu parameter null.

Keterangan

Menentukan bahwa sinkronisasi harus diminta dengan akun, otoritas, dan ekstra yang ditentukan pada frekuensi yang diberikan. Jika sudah ada sinkronisasi berkala lain yang dijadwalkan dengan akun, otoritas, dan ekstra maka sinkronisasi berkala baru tidak akan ditambahkan, sebaliknya frekuensi yang sebelumnya akan diperbarui.

Sinkronisasi berkala ini mematuhi pengaturan "syncAutomatically" dan "masterSyncAutomatically". Meskipun sinkronisasi ini dijadwalkan pada frekuensi yang ditentukan, mungkin perlu waktu lebih lama untuk benar-benar dimulai jika sinkronisasi lain berada di depannya dalam antrean operasi sinkronisasi. Ini berarti bahwa waktu mulai aktual dapat melayang.

Sinkronisasi berkala tidak diizinkan untuk memiliki salah satu dari #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 diatur ke true. Jika ada yang disediakan maka IllegalArgumentException akan dilemparkan.

Metode ini mengharuskan pemanggil untuk menahan izin android.Manifest.permission#WRITE_SYNC_SETTINGS.

Bundel untuk sinkronisasi berkala dapat dikueri oleh aplikasi dengan izin yang benar menggunakan ContentResolver#getPeriodicSyncs(Account account, String provider), sehingga tidak ada data sensitif yang harus ditransfer di sini.

Java dokumentasi untuk android.content.ContentResolver.addPeriodicSync(android.accounts.Account, java.lang.String, android.os.Bundle, long).

Bagian dari halaman ini adalah modifikasi berdasarkan pekerjaan yang dibuat dan dibagikan oleh Android Open Source Project dan digunakan sesuai dengan istilah yang dijelaskan dalam Lisensi Creative Commons 2.5 Lisensi Atribusi.

Berlaku untuk