SuperApp:Otorisasi

Prasyarat

• Saat menginisialisasi SDK, developer aplikasi harus mengatur needAuthFromApp ke true dalam kelas EMASMiniAppInitConfig atau MiniAppInitConfig.

Sebelum memulai

• Saat miniapp memanggil API yang memerlukan informasi perangkat, seperti WVLocation.getLocation atau WVVideo.chooseVideo, aplikasi host harus menampilkan prompt otorisasi agar pengguna memberikan izin. Developer miniapp dapat memanggil wv.getSetting untuk memeriksa status otorisasi miniapp saat ini.

• Untuk menggunakan API yang memerlukan otorisasi, pengguna harus memberikan izin pada dua tingkat: kepada miniapp di dalam aplikasi host dan kepada aplikasi host di tingkat sistem operasi.

• Kedua tingkat otorisasi ini bersifat independen. Jika pengguna telah memberikan izin kepada program mini tetapi aplikasi Host belum memperoleh izin sistem yang sesuai, Kontainer akan secara otomatis memicu prompt sistem saat API dipanggil. Program mini juga dapat memanggil API WVUIDialog.showAuthGuide untuk memandu pengguna ke halaman pengaturan sistem guna memberikan izin kepada aplikasi Host.

Logika otorisasi miniapp

Jika pengguna belum memberikan otorisasi kepada miniapp, Anda harus terlebih dahulu memanggil wv.authorize sebelum memanggil API yang memerlukan izin. Aplikasi host kemudian akan menampilkan prompt otorisasi kepada pengguna:

• Jika pengguna menyetujui, miniapp dapat memanggil API informasi perangkat tersebut. Pemanggilan berikutnya tidak akan memicu prompt otorisasi lagi.

• Jika pengguna menolak, callback fail segera dipicu, menandakan bahwa otorisasi ditolak. Pemanggilan API berikutnya akan kembali menampilkan prompt otorisasi.

Developer miniapp sebaiknya terlebih dahulu memanggil wv.getSetting untuk memeriksa status otorisasi pengguna sebelum memanggil API yang memerlukannya. Jika izin belum diberikan, panggil wv.authorize untuk memintanya, lalu panggil API target.

Logika izin tingkat sistem

Jika izin yang diperlukan dinonaktifkan di sistem operasi atau belum diberikan kepada aplikasi host, pemanggilan API akan gagal meskipun pengguna telah memberikan izin kepada miniapp. Biasanya, saat pertama kali miniapp memanggil API tersebut, aplikasi host juga meminta izin dari sistem dan menampilkan prompt. Jika pengguna menolak permintaan tersebut dan memilih 'Don’t ask again', pemanggilan berikutnya mungkin langsung memicu callback fail. Dalam kasus ini, developer miniapp dapat memanggil WVUIDialog.showAuthGuide untuk membuka halaman pengaturan izin sistem dan mengarahkan pengguna agar mengaktifkan izin tersebut secara manual.