SuperApp：Deskripsi Otorisasi

Prasyarat

• Selama inisialisasi SDK, pengembang aplikasi harus mengatur properti needAuthFromApp ke 'true' di dalam salah satu kelas EMASMiniAppInitConfig atau MiniAppInitConfig, tergantung pada konteksnya.

Persiapan Akses

• Saat program mini memanggil API terkait informasi perangkat (seperti WVLocation.getLocation, WVVideo.chooseVideo), APP harus menampilkan prompt otorisasi, memungkinkan pengguna memutuskan apakah akan memberikan izin untuk mengakses program mini saat ini. Pengembang program mini dapat memanggil wv.getSetting untuk mengetahui status otorisasi program mini saat ini.

• Saat menggunakan API yang memerlukan otorisasi, pengguna harus menyelesaikan proses otorisasi pada dua tingkat berbeda: 1. Mengotorisasi program mini di dalam APP; 2. Mengaktifkan fungsi yang sesuai di tingkat sistem dan mengotorisasinya kepada APP. Kedua tingkat status otorisasi tersebut independen satu sama lain.

Logika terkait otorisasi program mini

Jika pengguna belum mengotorisasi program mini, untuk memanggil API yang memerlukan izin, Anda perlu memanggil metode wv.authorize terlebih dahulu, yang akan menampilkan prompt otorisasi kepada pengguna:

• Jika pengguna setuju, fungsi utama API akan dieksekusi, dan pemanggilan API ini di masa mendatang tidak akan menampilkan prompt otorisasi lagi. Jika pengguna menolak, itu akan langsung memicu callback gagal, memberi tahu pengguna bahwa mereka telah menolak otorisasi. Saat memanggil API lagi, prompt otorisasi masih akan ditampilkan kepada pengguna.

• Jika pengguna menolak, callback gagal akan langsung terpicu dan memberi tahu pengguna bahwa mereka telah menolak otorisasi. Saat API dipanggil kembali, prompt otorisasi masih akan ditampilkan kepada pengguna.

Untuk API yang memerlukan otorisasi dan belum diotorisasi oleh pengguna untuk program mini, disarankan untuk pertama-tama menggunakan metode wv.getting untuk memeriksa, lalu memanggil metode wv.authorize, dan akhirnya, memanggil API yang memerlukan otorisasi.

Logika terkait izin tingkat sistem

Jika izin spesifik yang diperlukan oleh API tidak diaktifkan di sistem atau belum diotorisasi kepada APP, pemanggilan API tetap akan gagal meskipun pengguna setuju untuk memberikan izin kepada program mini saat ini. Biasanya, pemanggilan pertama API oleh program mini juga akan memicu APP untuk mengajukan izin dari sistem, dan pengguna akan melihat prompt otorisasi atau antarmuka panduan yang sesuai; Setelah pengguna menolak, pemanggilan API berulang mungkin langsung memicu callback gagal. Anda dapat secara aktif memanggil panduan otorisasi dengan memanggil WVUIDialog.showAuthGuide.