BackgroundAccessStatus Enum
Definisi
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.
Enumerasi ini menentukan kemampuan aplikasi untuk melakukan aktivitas latar belakang.
Aplikasi harus berhasil memanggil BackgroundExecutionManager.RequestAccessAsync sebelum mendaftarkan tugas latar belakang.
public enum class BackgroundAccessStatus
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
enum class BackgroundAccessStatus
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public enum BackgroundAccessStatus
var value = Windows.ApplicationModel.Background.BackgroundAccessStatus.unspecified
Public Enum BackgroundAccessStatus
- Warisan
-
BackgroundAccessStatus
- Atribut
Persyaratan Windows
Rangkaian perangkat |
Windows 10 (diperkenalkan dalam 10.0.10240.0)
|
API contract |
Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)
|
Bidang
AllowedMayUseActiveRealTimeConnectivity | 2 | Aplikasi ini dapat mengatur tugas latar belakang, tetapi tidak dapat menggunakan broker konektivitas real-time (RTC). Ini berarti bahwa aplikasi mungkin tidak berfungsi saat perangkat dalam status siaga yang terhubung. Perhatikan bahwa aplikasi yang tidak menentukan RTC dalam manifesnya akan selalu menunjukkan perilaku ini. Nilai ini tidak digunakan lagi dalam Windows 10, versi 1607. Pada Windows 8 dan Windows 8.1, BackgroundExecutionManager.RequestAccessAsync menampilkan dialog yang bertanya kepada pengguna apakah aplikasi harus berjalan di latar belakang. Nilai ini dikembalikan jika pengguna memilih "izinkan" dalam kotak dialog. Setelah nilai ini dikembalikan, panggilan berikutnya ke metode BackgroundExecutionManager.RequestAccessAsync tidak menyajikan kotak dialog kepada pengguna. |
AllowedSubjectToSystemPolicy | 5 | Pengguna telah memilih Seimbang atau Dikelola Sistem dalam pengaturan penggunaan baterai. Diperkenalkan dalam Windows 10, versi 1607. |
AllowedWithAlwaysOnRealTimeConnectivity | 1 | Aplikasi ini dapat mengatur tugas latar belakang, dan, jika memiliki kemampuan, dapat menggunakan broker konektivitas real-time (RTC). Ini berarti bahwa aplikasi dapat berfungsi saat perangkat berada dalam status siaga yang terhubung. Nilai ini tidak digunakan lagi dalam Windows 10, versi 1607. Pada Windows 8 dan Windows 8.1, BackgroundExecutionManager.RequestAccessAsync menampilkan dialog yang bertanya kepada pengguna apakah aplikasi harus berjalan di latar belakang. Nilai ini dikembalikan jika pengguna memilih "izinkan" dalam kotak dialog. Setelah nilai ini dikembalikan, panggilan berikutnya ke metode BackgroundExecutionManager.RequestAccessAsync tidak menyajikan kotak dialog kepada pengguna. |
AlwaysAllowed | 4 | Pada perangkat yang memiliki baterai, pengguna telah memberikan izin aplikasi di pengaturan penggunaan baterai untuk selalu mengizinkan akses latar belakang. Diperkenalkan dalam Windows 10, versi 1607. |
Denied | 3 | Nilai ini tidak digunakan lagi dalam Windows 10, versi 1607. Pada Windows 8 dan Windows 8.1, BackgroundExecutionManager.RequestAccessAsync menampilkan dialog yang bertanya kepada pengguna apakah aplikasi harus berjalan di latar belakang. Nilai ini dikembalikan jika pengguna memilih "jangan izinkan" dalam kotak dialog. Setelah nilai ini dikembalikan, panggilan berikutnya ke metode BackgroundExecutionManager.RequestAccessAsync tidak menyajikan kotak dialog kepada pengguna. |
DeniedBySystemPolicy | 6 | Pada perangkat yang memiliki baterai, pengguna telah memilih Baterai yang Dioptimalkan dalam pengaturan penggunaan baterai dan sistem telah memilih untuk tidak mengizinkan aplikasi ini berjalan di latar belakang berdasarkan sumber daya sistem. Diperkenalkan dalam Windows 10, versi 1607. |
DeniedByUser | 7 | Pada perangkat yang memiliki baterai, pengguna telah menonaktifkan aplikasi agar tidak berjalan di latar belakang di pengaturan penggunaan baterai. Diperkenalkan dalam Windows 10, versi 1607. |
Unspecified | 0 | Aplikasi tidak dapat melakukan aktivitas latar belakang dalam status ini. Pada Windows 8 dan Windows 8.1, BackgroundExecutionManager.RequestAccessAsync menampilkan dialog yang bertanya kepada pengguna apakah aplikasi harus berjalan di latar belakang. Nilai ini dikembalikan jika pengguna tidak memilih "izinkan" atau "jangan izinkan" dalam kotak dialog, atau menutupnya tanpa membuat pilihan. |
Keterangan
Pada perangkat yang tidak memiliki baterai, pengaturan yang memungkinkan aplikasi untuk menggunakan aktivitas latar belakang ditemukan di pengaturan aplikasi latar belakang. Pada perangkat yang memiliki baterai, pengaturan tugas latar belakang dapat ditemukan di pengaturan penggunaan Baterai.
Deklarasikan kemampuan RTC dalam manifes aplikasi Anda dengan menentukan tugas latar belakang saluran Kontrol di tab Deklarasi . Untuk informasi selengkapnya, lihat Cara mengatur opsi konektivitas latar belakang.
Jika semua slot RTC perangkat keras penuh pada saat aplikasi ditambahkan ke layar kunci, dan jika aplikasi telah menentukan saluran Kontrol dalam manifesnya, bersama dengan Timer atau pemberitahuan Push, aplikasi ditambahkan ke layar kunci, tetapi tanpa kemampuan RTC. Aplikasi kemudian dapat membuat permintaan lebih lanjut untuk ditambahkan ke layar kunci, yang tidak menyajikan UI kepada pengguna. Jika slot perangkat keras terbuka ketika satu permintaan tersebut dibuat, aplikasi akan mengambil slot tersebut.
Riwayat versi
Versi Windows | Versi SDK | Nilai ditambahkan |
---|---|---|
1607 | 14393 | AllowedSubjectToSystemPolicy |
1607 | 14393 | AlwaysAllowed |
1607 | 14393 | DeniedBySystemPolicy |
1607 | 14393 | DeniedByUser |
Berlaku untuk
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk