SuperApp:Autorização

Pré-requisitos

• Ao inicializar o SDK, defina needAuthFromApp como true na classe EMASMiniAppInitConfig ou MiniAppInitConfig.

Antes de começar

• Quando um miniapp chama uma API que requer informações do dispositivo, como WVLocation.getLocation ou WVVideo.chooseVideo, o aplicativo host deve exibir um prompt de autorização para o usuário conceder a permissão. Desenvolvedores podem chamar wv.getSetting para verificar o status atual de autorização do miniapp.

• Para usar APIs que exigem autorização, o usuário deve conceder permissão em dois níveis: ao miniapp dentro do aplicativo host e ao aplicativo host no nível do sistema operacional.

• Esses dois níveis de autorização são independentes. Se o usuário tiver concedido permissão ao miniapp, mas o aplicativo host não tiver obtido a permissão de sistema correspondente, o container acionará automaticamente um prompt do sistema ao chamar a API. O miniapp também pode chamar a API WVUIDialog.showAuthGuide para orientar o usuário até a página de configurações do sistema e conceder a permissão ao aplicativo host.

Lógica de autorização do miniapp

Se o usuário ainda não tiver autorizado o miniapp, chame wv.authorize antes de invocar uma API que exija permissão. O aplicativo host exibirá então um prompt de autorização ao usuário:

• Se o usuário concordar, o miniapp poderá chamar a API de informações do dispositivo. Chamadas subsequentes não acionarão outro prompt de autorização.

• Se o usuário recusar, o callback fail será acionado imediatamente, indicando negação da autorização. Chamadas subsequentes à API exibirão o prompt de autorização novamente.

Chame primeiro wv.getSetting para verificar o status de autorização do usuário antes de chamar uma API que a exija. Caso a permissão não tenha sido concedida, chame wv.authorize para solicitá-la e, em seguida, invoque a API desejada.

Lógica de permissão no nível do sistema

Se uma permissão necessária estiver desativada no sistema operacional ou não tiver sido concedida ao aplicativo host, a chamada da API falhará, mesmo que o usuário tenha concedido permissão ao miniapp. Normalmente, na primeira vez que o miniapp chama a API, o aplicativo host também solicita a permissão ao sistema e exibe um prompt. Se o usuário negar a solicitação e selecionar "Não perguntar novamente", chamadas subsequentes poderão acionar diretamente o callback fail. Nesse cenário, chame WVUIDialog.showAuthGuide para abrir a página de configurações de permissão do sistema e orientar o usuário a ativar a permissão manualmente.