Activity.RequestPermissions Método

Definição

Namespace:: Android.App

Assembly:: Mono.Android.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Sobrecargas

Nome	Description
RequestPermissions(String[], Int32)	Solicita permissões a serem concedidas a este aplicativo.
RequestPermissions(String[], Int32, Int32)	Solicita permissões a serem concedidas a este aplicativo.

RequestPermissions(String[], Int32)

Solicita permissões a serem concedidas a este aplicativo.

[Android.Runtime.Register("requestPermissions", "([Ljava/lang/String;I)V", "", ApiSince=23)]
public void RequestPermissions(string[] permissions, int requestCode);

[<Android.Runtime.Register("requestPermissions", "([Ljava/lang/String;I)V", "", ApiSince=23)>]
member this.RequestPermissions : string[] * int -> unit

Parâmetros

permissions: String[]

Cadeia de caracteres: as permissões solicitadas. Deve ser não nulo e não vazio.

requestCode: Int32

int: código de solicitação específico do aplicativo para corresponder a um resultado relatado a onRequestPermissionsResult(int, String, int). Deve ser >= 0.

Atributos: RegisterAttribute

Comentários

Solicita permissões a serem concedidas a este aplicativo. Essas permissões devem ser solicitadas em seu manifesto, elas não devem ser concedidas ao seu aplicativo e devem ter um nível de proteção perigoso, independentemente de serem declaradas pela plataforma ou por um aplicativo de terceiros. As permissões normais PermissionInfo.PROTECTION_NORMAL são concedidas no momento da instalação se solicitadas no manifesto. As permissões de assinatura PermissionInfo.PROTECTION_SIGNATURE são concedidas no momento da instalação se solicitadas no manifesto e a assinatura do aplicativo corresponde à assinatura do aplicativo declarando as permissões.

Chame shouldShowRequestPermissionRationale(String) antes de chamar essa API para verificar se o sistema recomenda mostrar uma interface do usuário racional antes de solicitar uma permissão.

Se o aplicativo não tiver as permissões solicitadas, o usuário será apresentado à interface do usuário para aceitá-las. Depois que o usuário aceitar ou rejeitar as permissões solicitadas, você receberá um retorno de chamada em onRequestPermissionsResult(int, String, int) informando se as permissões foram concedidas ou não.

Observe que solicitar uma permissão não garante que ela será concedida e seu aplicativo deve ser capaz de ser executado sem ter essa permissão.

Esse método pode iniciar uma atividade permitindo que o usuário escolha quais permissões conceder e quais rejeitar. Portanto, você deve estar preparado para que sua atividade possa ser pausada e retomada. Além disso, conceder algumas permissões pode exigir uma reinicialização do aplicativo. Nesse caso, o sistema recriará a pilha de atividades antes de entregar o resultado para onRequestPermissionsResult(int, String, int).

Ao verificar se você tem uma permissão, você deve usar checkSelfPermission(String).

Você não poderá solicitar uma permissão se sua atividade definir noHistory como true porque, nesse caso, a atividade não receberá retornos de chamada de resultado, incluindo onRequestPermissionsResult(int, String, int).

O repositório de exemplos de permissões demonstra como usar esse método para solicitar permissões em tempo de execução.

Consulte também:

Lançamentos: IllegalArgumentException se requestCode for negativo.

Referência do Android para android.app.Activity.requestPermissions.

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.

Aplica-se a

RequestPermissions(String[], Int32, Int32)