InitialRotationPreference (skema ekstensi untuk Windows 8.1)

Artikel
07/20/2023

Menjelaskan orientasi di mana aplikasi lebih suka ditampilkan untuk pengalaman pengguna terbaik. Pada perangkat yang dapat diputar, seperti tablet, aplikasi tidak akan digambar ulang untuk orientasi yang tidak ditentukan di sini. Misalnya, jika aplikasi hanya menentukan orientasi Lanskap dan LanskapFlip, dan perangkat diputar ke orientasi Potret, aplikasi tidak akan berputar.

Perhatikan bahwa pada perangkat yang tidak dapat diputar, aplikasi mungkin ditampilkan dalam orientasi default perangkat tersebut dan orientasi pilihan aplikasi akan diabaikan. Namun, pada perangkat dengan kunci rotasi diaktifkan, rotasi pilihan aplikasi Anda akan tetap dihormati.

Pilihan preferensi orientasi ini berlaku untuk layar splash dan UI aplikasi saat sesi baru diluncurkan untuk aplikasi Anda. Preferensi dapat diubah selama durasi melalui properti AutoRotationPreferences .

Hierarki elemen

<VisualElements>: <InitialRotationPreference>

Sintaks

<InitialRotationPreference>

  <!-- Child elements -->
  Rotation{1,4}

</InitialRotationPreference>

Kunci

{} rentang kemunculan tertentu

Atribut dan Elemen

Atribut

Tidak ada.

Elemen Anak

Elemen Anak	Deskripsi
Rotasi	Menentukan orientasi rotasi tunggal tempat aplikasi akan ditampilkan.

Elemen Induk

Elemen Induk	Deskripsi
VisualElements	Menjelaskan aspek visual aplikasi UWP: petak peta default, gambar logo, warna teks dan latar belakang, orientasi layar awal, layar percikan, dan tampilan petak peta layar kunci.

Keterangan

Elemen ini adalah bagian dari file manifes aplikasi Anda (package.appxmanifest). Di editor manifes Microsoft Visual Studio, pengaturan ini ditemukan di bawah tab UI Aplikasi sebagai "Rotasi Awal yang Didukung". Secara default, tidak ada opsi yang dipilih. Ini berarti bahwa semua orientasi rotasi didukung. Memilih rotasi atau semua rotasi tidak memberikan hasil yang sama.

Karena aplikasi Anda dapat dijalankan pada berbagai jenis perangkat—PC desktop, tablet, laptop, atau ponsel—Anda tidak dapat dijamin pengetahuan lanjutan tentang orientasi perangkat pada saat aplikasi Anda diluncurkan, atau perangkat tidak akan diputar saat aplikasi aktif. Oleh karena itu, kami sarankan Anda mengembangkan aplikasi dengan kemampuan untuk ditampilkan dalam orientasi apa pun. Meskipun demikian, aplikasi Anda dapat menggunakan elemen ini untuk meminta Windows membatasi tampilan aplikasi Anda ke rotasi idealnya. Namun, Windows tidak selalu dapat mematuhi permintaan tersebut. Karena tidak semua perangkat dapat diputar atau mendeteksi rotasi, preferensi orientasi tidak selalu dapat dihormati oleh Windows. Misalnya, jika Anda menyatakan bahwa aplikasi Anda harus ditampilkan di Potret tetapi aplikasi dijalankan pada monitor desktop berorientasi lanskap standar atau di televisi, preferensi akan diabaikan karena menampilkan aplikasi di sisinya akan menjadi pengalaman pengguna yang buruk. Untuk alasan ini, Anda harus mempertimbangkan untuk mendukung semua orientasi sehingga aplikasi Anda terlihat baik terlepas dari rotasi perangkat.

Catatan Karena pada saat ini PC desktop dan notebook tetap menjadi perangkat yang dominan secara statistik yang kemungkinan akan dijalankan aplikasi Anda, dan karena perangkat tersebut hampir semuanya diperbaiki dalam orientasi lanskap dan tidak mendeteksi rotasi, diperlukan agar aplikasi mendukung setidaknya rotasi Lanskap. Namun, meskipun harus didukung, Anda tidak diharuskan untuk mendeklarasikan Lanskap sebagai rotasi pilihan.

Elemen ini berisi hingga 4 elemen Rotasi , yang masing-masing menentukan orientasi di mana aplikasi lebih suka dilihat. Jika Anda tidak menyertakan elemen Rotasi , elemen tersebut memiliki efek yang sama seperti termasuk keempatnya.

Contoh berikut menunjukkan aplikasi yang akan ditampilkan di Lanskap dan LanskapFlip, tetapi tidak akan mengubah orientasinya untuk perangkat yang disimpan di Portrait atau PortraitFlipped.

                        
<InitialRotationPreference>
    <Rotation Preference="landscape"/>
    <Rotation Preference="landscapeFlipped"/>
</InitialRotationPreference>

Saat aplikasi Anda awalnya diluncurkan, Windows menerima preferensi rotasinya. Preferensi ini tetap diberlakukan hingga aplikasi tersebut dihentikan, dengan satu pengecualian penting: jika panggilan dilakukan ke Windows.Graphics.Display.DisplayInformation.autoRotationPreferences untuk mengubah preferensi tersebut. API tersebut digunakan untuk memberi tahu Windows tentang perubahan preferensi rotasi aplikasi Anda, dan dapat dipanggil kapan saja. Perhatikan bahwa panggilan API ini tidak memengaruhi konten elemen InitialRotationPreference dalam file manifes aplikasi, yang tetap ada saat Anda mengaturnya di editor manifes. Oleh karena itu, setiap kali Anda meluncurkan ulang aplikasi, dibutuhkan preferensi rotasi yang awalnya Anda tentukan dalam manifes aplikasi Anda.

Misalnya, pertimbangkan aplikasi game yang paling baik dilihat di Lanskap, tetapi memiliki halaman tertentu yang menampilkan peta yang lebih mudah dibaca di Potret. Rangkaian peristiwa berikut dapat terjadi pada perangkat yang mendukung rotasi. Pemahaman tentang istilah siklus hidup aplikasi akan sangat membantu Anda di sini.

Pengembang menentukan preferensi rotasi Lanskap dan/atau LanskapFlip untuk aplikasi di editor manifes.
Game ini diinstal dan diluncurkan. Preferensi yang ditentukan dalam editor manifes berlaku dan permainan tidak akan berputar ke Potret.
Game mendeteksi bahwa pengguna mengakses peta. Ini memanggil AutoRotationPreferences untuk memberi tahu Windows untuk mengubah preferensi rotasi aplikasi menjadi Portrait dan/atau PortraitFlipped.
Windows memutar aplikasi ke orientasi pilihan baru.
Pengguna beralih ke aplikasi lain untuk memeriksa email mereka.
Pengguna beralih kembali ke aplikasi game untuk melanjutkan di tempat yang mereka tinggalkan. Windows tahu bahwa preferensi terakhir aplikasi yang dinyatakan adalah untuk Potret dan membawa aplikasi di layar dalam orientasi tersebut. Perhatikan bahwa ini tidak merujuk ke pengaturan InitialRotationPreference karena sesi saat ini masih aktif.
Game mendeteksi bahwa pengguna menutup halaman peta. Ini memanggil AutoRotationPreferences untuk mengubah preferensi rotasinya kembali ke pengaturan Lanskap aslinya untuk melanjutkan permainan.
Pengguna menyelesaikan permainan dan aplikasi ditangguhkan setelah pengguna menavigasi pergi untuk beberapa periode waktu.
Pengguna melanjutkan aplikasi untuk memainkan game lain. Karena aplikasi belum diluncurkan kembali, preferensi terakhir yang dideklarasikan oleh API AutoRotationPreferences masih berlaku.
Permainan ditutup (dihentikan).
Permainan dimulai ulang. Karena dimulai lagi dari peluncuran awal, pengaturan InitialRotationPreference sekali lagi berlaku.

Poin penting yang perlu diperhatikan adalah bahwa setelah Anda memanggil AutoRotationPreferences, Anda bertanggung jawab untuk menangani preferensi rotasi melalui API tersebut sampai permainan dihentikan (tidak hanya ditangguhkan).

Saat aplikasi berputar, Windows berputar dengannya. Jika Anda menutup aplikasi di Potret, layar Mulai ditampilkan di Potret. Jika aplikasi telah menyatakan preferensi rotasi untuk rotasi yang berbeda dari yang ditampilkan perangkat saat ini, rotasi sistem terjadi saat layar splash aplikasi ditampilkan. UI aplikasi utama tidak akan ditampilkan sampai rotasi sistem selesai di belakangnya.

Lihat juga

VisualElements

Mulai cepat: Membuat petak peta default menggunakan editor manifes Visual Studio

Windows.Graphics.Display.DisplayInformation.AutoRotationPreferences

Persyaratan

	Nilai
Ruang nama	`http://schemas.microsoft.com/appx/2010/manifest`