wv.authorize - API de autorização de usuário do Miniapp - SuperApp: Central de Documentação do Alibaba Cloud

Solicita autorização do usuário para APIs JavaScript relacionadas ao dispositivo listadas na lista de escopos. Exibe um prompt para que o usuário conceda permissão sem invocar a API de destino. Se a autorização já tiver sido concedida, ignora o prompt e chama o callback success diretamente.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição
scope	String	Sim	Escopo de permissão a solicitar.
success	Function	Não	Callback invocado após autorização bem-sucedida.
fail	Function	Não	Callback invocado quando a autorização falha.

Lista de escopos

Escopo	Descrição	APIs
location	Localização geográfica	WVLocation.getLocation, WVLocation.searchLocation
camera	Câmera	WVScan.scan
bluetooth	Bluetooth	Todos os métodos de WVBluetooth
album	Álbum	WVCamera, WVVideo.chooseVideo
contacts	Contatos	Todos os métodos de WVContacts
microphone	Microfone	WVMotion.listenBlow, WVMotion.stopListenBlow
file	Arquivo	Todos os métodos de WVFile, WVImage.saveImage, WVVideo.saveVideoToPhotosAlbum
call	Chamada telefônica	WVCall.dial, WVCall.call
vibrate	Vibração	WVMotion.vibrate
screen	Captura de tela	WVScreenCapture.capture

Parâmetros de resposta

O callback success recebe um object com os seguintes atributos:

Atributo	Tipo	Descrição
successScope	JSONObject	Escopos autorizados pelo usuário.
msg	String	Mensagem de erro em caso de falha.

O callback fail recebe um object com o erro em msg:

Mensagem de erro	Descrição	Solução
You need to configure the authorization switch to apply for authorization	O interruptor de autorização não está ativado.	Verifique se o interruptor de autorização foi configurado durante a inicialização do contêiner.
Parameter parsing exception	Os parâmetros da solicitação não puderam ser analisados.	Valide o formato dos parâmetros da solicitação.
Authorization scope cannot be empty	O parâmetro `scope` é nulo.	Revise o parâmetro `scope`.
User not bound	O `UserId` não está registrado no contêiner.	Confirme se as informações do usuário no contêiner incluem um `UserId`.
User refuses authorization request	O usuário negou a solicitação de autorização.	Apresente ao usuário uma justificativa clara para conceder a autorização.
The authorization you requested does not exist. Please check the parameters	O valor fornecido para `scope` é inválido.	Consulte a lista de escopos para validar o valor de `scope`.

Código de exemplo

window.WindVane.call('wv', 'getSetting', {}, function(res) {
    if (!res.authSetting['location']) {
      	window.WindVane.call('wv', 'authorize', {scope: 'location'}, function(res) {
          	if (res.successScope['location']) {
              	alert('success authorize location');
              	// Call the required JavaScript API.
            }
        }, function(e) {
          	alert('failure:' + JSON.stringify(e));
        })
    } else {
      	alert('success authorize location');
    }
}, function(e) {
    alert('failure:' + JSON.stringify(e));
});