Android 7.1.1 memperkenalkan dukungan tingkat sistem untuk mode demo retail sehingga pelanggan dapat memeriksa cara kerja perangkat di toko retail. Perangkat disiapkan untuk demo retail menggunakan aplikasi pemilik perangkat untuk memastikan bahwa penggunaan perangkat hanya dibatasi untuk aplikasi mode demo tertentu. Pengguna akhir tidak boleh dapat menambahkan akun pribadi di perangkat demo retail. Android 8.1 merevisi dukungan ini untuk membuat pengguna demo melalui DevicePolicyManager createAndManageUser API. Hal ini memungkinkan penyesuaian OEM yang jauh lebih besar ke mode retail standar dalam hal pengelolaan pengguna dan pengelolaan kebijakan perangkat di perangkat demo.
Meskipun API DevicePolicyManager
dapat digunakan pada versi sebelum Android 8.1,
pengguna jenis demo (DevicePolicyManager.MAKE_USER_DEMO) tidak dapat dibuat
dengan API createAndManageUser
di versi 8.0 dan yang lebih lama.
Implementasi di Android 8.1 dan yang lebih baru
Bagian ini menyoroti peningkatan platform dan menjelaskan aplikasi demo retail di Android 8.1 dan yang lebih baru.
Perubahan platform
Setel DEVICE_DEMO_MODE
Perangkat yang menerapkan mode demo retail berbasis pemilik perangkat harus menetapkan Settings.Global.DEVICE_DEMO_MODE ke 1 sebelum penyediaan untuk menunjukkan bahwa perangkat sedang disediakan untuk mode demo retail.
SystemServer
menggunakan flag ini untuk mengelola aspek mode retail, seperti profil daya dan
SystemUI.
Mengaktifkan RetailDemoModeService
Dalam perangkat yang menerapkan mode demo retail, wizard penyiapan menetapkan setelan global Global.DEVICE_DEMO_MODE ke true untuk menunjukkan bahwa perangkat telah memasuki mode retail. Setelah melihat setelan ini, RetailDemoModeService membuat pengguna demo dan beralih ke pengguna tersebut saat pengguna 0 dimulai, mengaktifkan peluncur kustom yang ditentukan dalam resource overlay, serta menonaktifkan SUW. Server
Sistem dan SystemUI juga menggunakan flag ini untuk mengelola aspek mode retail.
Menyetel peluncur khusus atau pemutar video
Produsen perangkat dapat menentukan peluncur kustom dengan mengganti resource
framework config_demoModeLauncherComponent yang ditentukan dalam file
config.xml sebagai berikut.
<!-- Component that is the default launcher when Retail Mode is enabled. -->
<string name="config_demoModeLauncherComponent">com.android.retaildemo/.DemoPlayer</string>
Aplikasi demoPlayer retail yang berada di /packages/apps/RetailDemo merupakan peluncur kustom default di Proyek Open Source Android (AOSP). Aplikasi akan mencari video di partisi perangkat seperti /data/preloads/demo/retail_demo.mp4 dan memutarnya dalam loop. Saat pengguna menyentuh layar, peluncur kustom akan menonaktifkan komponen aktivitasnya, yang menyebabkan peluncur sistem default dimulai.
Peluncur kustom harus memiliki komponen kustom yang ditandai sebagai dinonaktifkan secara default
agar tidak muncul dalam skenario non-demo. Dalam skenario demo, Server
Sistem mengaktifkan config_demoModeLauncherComponent yang ditentukan saat memulai
sesi demo baru.
Wizard penyiapan juga mencari video yang disebutkan sebelumnya untuk memberikan kemampuan masuk ke mode retail. SUW dapat dimodifikasi untuk mencari beberapa tanda khusus OEM lainnya bahwa mode retail didukung jika video bukan merupakan bagian dari demo. Jika ada partisi A/B sistem, partisi sistem B harus berisi video demo di /previews/demo. Data ini akan disalin ke /data/previews/demo saat booting pertama.
Menyesuaikan aplikasi yang dimuat sebelumnya untuk mode demo promo
Aplikasi yang dimuat sebelumnya dapat menyesuaikan pengalamannya untuk mode demo retail dengan memanggil
API UserManager.isDemoUser()
untuk melihat apakah aplikasi diluncurkan di lingkungan demo.
Batasan tertentu ditetapkan di pengguna demo, mirip dengan kebijakan perangkat atau
profil terkelola yang mencegah aplikasi dan pengguna melakukan operasi tertentu.
Salah satu batasan tersebut adalah DISALLOW_MODIFY_ACCOUNTS. Dengan batasan ini, AccountManager
dan Settings
tidak mengizinkan penambahan akun. Beberapa aplikasi Google bereaksi terhadap pembatasan ini dan menampilkan pesan error. Beberapa aplikasi lainnya tidak akan meminta akun (seperti YouTube dan Foto). Sebaiknya aplikasi OEM juga memeriksa apakah
DISALLOW_MODIFY_ACCOUNTS ditetapkan dan menangani skenario yang sesuai.
Update sistem
Secara default, saat mode retail diaktifkan, kebijakan perangkat disetel ke update over the air (OTA) secara otomatis. Perangkat retail akan mendownload, memulai ulang, dan menginstal update (mengikuti nilai minimum baterai) tanpa interaksi pengguna.
Aplikasi demo promo
Penerapan mode demo retail berbasis pemilik perangkat mengharuskan aplikasi Pengontrol Kebijakan Perangkat ditetapkan sebagai pemilik perangkat. AOSP berisi implementasi aplikasi RetailDemo referensi dalam /packages/apps/RetailDemo.
Aplikasi pemilik perangkat tidak memerlukan hak istimewa yang ditingkatkan atau pra-penginstalan pada image sistem dan dapat didownload selama proses penyiapan atau penyediaan. Sebagian besarnya diterapkan seperti aplikasi tradisional, dengan perbedaan berikut:
Semua aplikasi pemilik perangkat harus memperluas komponen DeviceAdminReceiver, yang berfungsi sebagai token otorisasi untuk semua Device disusupi API. Komponen harus memiliki izin
android.permission.BIND_DEVICE_ADMIN, menyertakan kebijakan khusus yang diminta sebagai metadata, serta memfilter intentandroid.app.action.PROFILE_PROVISIONING_COMPLETEdanandroid.app.action.DEVICE_ADMIN_ENABLED.Flag DeviceDone#MAKE_USER_DEMO, yang disetel untuk membuat pengguna jenis demo khusus, adalah API tersembunyi. Flag ini memiliki nilai konstanta 0x4.
Kepemilikan perangkat hanya boleh ditetapkan melalui pemegang peran pengelolaan perangkat atau aplikasi ManagedProvisioning.
API di class DevicePolicyManager memungkinkan Pemilik Perangkat (DO) dan Pemilik Profil (PO) untuk menerapkan berbagai kebijakan perangkat. Beberapa fungsi DevicePolicyManager yang berlaku untuk mode demo retail tercantum sebagai berikut.
Membuat dan mengelola pengguna.
Boot ulang perangkat.
Menyetel paket yang diizinkan LockTask.
Instal paket melalui PackageInstaller.
Memblokir paket agar tidak di-uninstal.
Aktifkan update sistem otomatis. Perangkat akan otomatis mendownload dan menerapkan update OTA.
Nonaktifkan keyguard.
Cegah setelan sandi atau sidik jari.
Tetapkan kumpulan setelan Settings.Global, Settings.Secure, dan Settings.System yang diizinkan.
Tetapkan kebijakan izin ke
PERMISSION_POLICY_AUTO_GRANT, yang otomatis memberikan semua izin runtime. Izin juga dapat diberikan dengan lebih spesifik: satu izin untuk satu aplikasi. Hal ini tidak berlaku untuk izin app-ops, yang masih harus diberikan pengguna berdasarkan per pengguna, per aplikasi.Tetapkan batasan pengguna yang relevan dengan mode retail seperti yang ditentukan dalam UserManager sebagai berikut.
DISALLOW_MODIFY_ACCOUNTSDISALLOW_USB_FILE_TRANSFERDISALLOW_DEBUGGING_FEATURESDISALLOW_CONFIG_WIFIDISALLOW_CONFIG_BLUETOOTHDISALLOW_INSTALL_UNKNOWN_SOURCESDISALLOW_CONFIG_MOBILE_NETWORKS
Perbarui video demo menggunakan web
Aplikasi RetailDemo di /packages/apps/RetailDemo memiliki kemampuan untuk mengupdate video demo jika ada konektivitas jaringan. URL untuk mendownload video dapat dikonfigurasi dengan mengganti nilai string berikut di aplikasi RetailDemo.
<!-- URL where the retail demo video can be downloaded from. -->
<string name="retail_demo_video_download_url"></string>
Jika video yang berbeda perlu digunakan di wilayah berbeda, URL download yang berbeda dapat dikonfigurasi menggunakan resource string khusus lokalitas di res/values-*/strings.xml. Misalnya, jika video yang berbeda perlu digunakan di Amerika Serikat dan Inggris Raya, URL download terkait dapat ditempatkan masing-masing di res/values-en-rUS/strings.xml dan res/values-en-rGB/strings.xml, yang ditampilkan sebagai berikut.
Di res/values-en-rUS/strings.xml:
<string name="retail_demo_video_download_url">download URL for US video goes here</string>Di res/values-en-rGB/strings.xml:
<string name="retail_demo_video_download_url">download URL for UK video goes here</string>
Video ini didownload maksimal sekali untuk setiap reboot perangkat. Saat video di perangkat diputar, aplikasi RetailDemo akan memeriksa di latar belakang apakah URL download disediakan dan video di URL lebih baru dari yang diputar.
Jika ya, aplikasi RetailDemo akan mendownload dan mulai memutar video. Setelah didownload, video akan digunakan untuk diputar di semua sesi demo ke depannya. Tidak ada pemeriksaan yang terjadi lagi hingga setelah mulai ulang berikutnya.
Panduan video demo
Video demonstrasi harus dalam tata letak potret atau, jika tablet, dalam orientasi alam perangkat, dan dapat berdurasi lebih dari lima detik. Konten tidak boleh mengakibatkan burn-in (layar berbayang) karena akan diputar terus-menerus saat ditampilkan.
Lihat definisi Developer Android pengguna, profil, dan akun, dokumentasi Device Policy Manager API dan Contoh aplikasi Pemilik Perangkat untuk mengetahui informasi selengkapnya.
Validasi
CTS tidak mencakup mode demo promo karena merupakan fitur opsional. Pengujian harus dilakukan secara manual atau dengan pengujian unit untuk aplikasi demo.
Sesi demo
Penyiapan sesi demo
Perangkat demo promo dapat melakukan booting ke mode demo promo jika dikonfigurasi untuk mode demo dari pabrik. Atau, karyawan retail dapat mengaktifkan mode retail langsung dari wizard penyiapan.
Gambar 2. Mode demonstrasi retail
Tampilkan sesi demo
Saat memasuki mode retail, perangkat akan beralih ke pengguna demo baru dan otomatis memulai peluncur kustom yang ditentukan dalam resource overlay seperti yang dijelaskan dalam Implementasi. Secara default, peluncur kustom ini akan memutar video demo secara berulang hingga pengguna menyentuh layar untuk memulai sesi pengguna demo. Pada saat itu, peluncur kustom akan memulai peluncur sistem, lalu keluar. OEM dapat mengubah peluncur kustom untuk juga meluncurkan layanan atau aktivitas lain saat keluar.
Untuk menjaga integritas mode retail, keyguard dinonaktifkan dan tindakan tertentu dari Setelan Cepat yang dapat berpengaruh buruk terhadap mode retail juga tidak diizinkan, termasuk hal berikut.
- Tombol mode pesawat.
- Menghapus atau mengubah titik akses Wi-Fi (Setelan).
- Mengubah operator (Setelan).
- Mengonfigurasi hotspot (Setelan).
- Peralihan pengguna.
Selain itu, akses juga diblokir ke beberapa setelan global yang dapat memengaruhi mode retail dengan menonaktifkan hal berikut:
- Setelan Wi-Fi.
- Opsi konfigurasi jaringan seluler, terutama hotspot.
- Konfigurasi Bluetooth.
- Pencadangan & Reset, Tanggal & Waktu, serta Jaringan Seluler (tidak muncul sama sekali).
Jika pengguna tidak ada aktivitas selama beberapa waktu (90 detik secara default), mode retail akan menampilkan dialog sistem untuk meminta pengguna keluar dari sesi atau melanjutkan. Jika pengguna memilih untuk keluar atau jika tidak ada respons selama lima detik, mode retail akan menghapus pengguna demo saat ini, beralih ke pengguna demo baru, dan melakukan loop melalui video asli lagi. Jika layar dimatikan menggunakan tombol daya, layar akan otomatis aktif setelah beberapa detik.
Setelah keluar dari sesi demo, perangkat akan membisukan sendiri dan mereset beberapa setelan global, termasuk hal berikut:
- Kecerahan
- Rotasi otomatis
- Senter
- Bahasa
- Aksesibilitas
Keluar dari mode demo promo
Untuk keluar dari mode retail, karyawan retail harus memastikan bahwa perangkat demo tidak terdaftar dalam pengelolaan perangkat dan mereset perangkat ke setelan pabrik dari bootloader.