Integrasikan dengan pemilih widget

Dalam rilis saat ini, satu-satunya host Widget adalah Papan Widget yang dibangun ke dalam Windows 11. Papan Widget menampilkan widget dan mengelola tata letaknya di papan. Ini juga menyediakan pemilih widget yang memungkinkan pengguna untuk memilih widget mana yang tersedia yang terlihat di papan. Artikel ini menjelaskan aset yang diperlukan agar widget berhasil diintegrasikan ke dalam pemilih widget.

Gambar cuplikan layar widget

Setiap widget harus menyediakan gambar cuplikan layar yang ditampilkan sebagai pratinjau di pemilih widget saat widget memiliki fokus. Cuplikan layar ditentukan oleh penyedia widget dalam manifes paket untuk aplikasi. Untuk informasi teknis tentang cara menentukan file gambar yang akan digunakan untuk cuplikan layar widget, lihat Menerapkan penyedia widget dalam aplikasi win32 dan format XML manifes paket penyedia Widget.

Cuplikan layar berikut mengilustrasikan penempatan gambar cuplikan layar dalam pemilih widget.

Persyaratan gambar cuplikan layar

Untuk memberikan pengalaman pengguna yang konsisten, cuplikan layar widget untuk pemilih widget harus mengikuti panduan berikut.

• Cuplikan layar harus menampilkan versi ukuran sedang widget Anda.
• Gambar harus lebar 300 piksel dan tinggi 304 piksel.
• Gambar harus memiliki sudut transparan dan bulat.

Manifes penyedia widget mencakup tiga elemen Cuplikan Layar berbeda yang dapat Anda atur. Cuplikan layar tingkat atas diperlukan dan akan digunakan sebagai default oleh pemilih widget. Bagian LightMode dan DarkMode dari manifes bersifat opsional dan memungkinkan Anda menentukan cuplikan layar terpisah untuk widget Anda dalam mode terang dan gelap. Jika Anda menyediakan satu atau kedua cuplikan layar opsional ini, pemilih widget akan menggunakan salah satu yang cocok dengan tema perangkat saat ini. Jika Anda tidak menyediakan gambar khusus untuk tema saat ini, pemilih widget akan menggunakan cuplikan layar default tingkat atas sebagai gantinya.

Anda dapat memberikan cuplikan layar widget untuk beberapa lokal. Lokal untuk setiap cuplikan layar ditentukan dengan jalur ke aset relatif terhadap paket aplikasi Anda.

• Buat direktori di proyek pengemasan Anda untuk aset gambar. Misalnya: "Aset".
• Aset netral bahasa atau fallback dapat ditempatkan langsung di folder ini. Misalnya: "Aset/Screenshot.png"
• Aset khusus bahasa dapat ditempatkan dalam subdirektori yang dinamai sesuai dengan lokal tempat aset tersebut diterapkan. Misalnya:
  • Aset "English (Amerika Serikat)" harus ditempatkan di subdirektori bernama "en-us": "Assets/en-us/Screenshot.png"
  • Aset "Prancis (Prancis)" harus ditempatkan dalam subdirektori bernama "fr-fr": "Aset/fr-fr/Screenshot.png"
• Referensikan gambar-gambar ini di appxmanifest menggunakan skema ms-appx: URI. Misalnya: Screenshot="ms-appx:Assets\Screenshot.png"
• Jika Anda tidak menyertakan gambar untuk lokal tertentu, maka gambar fallback di direktori akar akan digunakan.

Pemuat sumber daya akan secara otomatis memilih aset yang sesuai dengan bahasa yang akan ditampilkan. Untuk informasi selengkapnya, lihat: Memuat gambar dan aset yang disesuaikan untuk skala, tema, kontras tinggi, dan lainnya.

Berikut ini adalah contoh gambar cuplikan layar widget.