Activity.RequestPermissions(String[], Int32) メソッド

定義

名前空間:

Android.App

アセンブリ:

Mono.Android.dll

このアプリケーションに付与するアクセス許可を要求します。

[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

パラメーター

permissions

String[]

要求されたアクセス許可。 null 以外で空ではない必要があります。

requestCode

Int32

に報告された #onRequestPermissionsResult(int, String[], int[])結果と一致するアプリケーション固有の要求コード。 = 0 にする >必要があります。

属性

RegisterAttribute

注釈

このアプリケーションに付与するアクセス許可を要求します。 これらのアクセス許可はマニフェストで要求する必要があります。アプリに付与する必要はありません。また、プラットフォームまたはサードパーティ製アプリで宣言されているかどうかに関係なく、保護レベル android.content.pm.PermissionInfo#PROTECTION_DANGEROUS dangerousが必要です。

マニフェストで要求された場合、通常のアクセス許可 android.content.pm.PermissionInfo#PROTECTION_NORMAL はインストール時に付与されます。 マニフェストで要求され、アプリの署名がアクセス許可を宣言するアプリの署名と一致する場合、署名のアクセス許可 android.content.pm.PermissionInfo#PROTECTION_SIGNATURE はインストール時に付与されます。

この API を呼び出す前に を呼び出#shouldShowRequestPermissionRationale(String)して、アクセス許可を要求する前に、システムが根拠 UI を表示することを推奨するかどうかをチェックします。

アプリに要求されたアクセス許可がない場合、ユーザーはそれらを受け入れるための UI が表示されます。 ユーザーが要求されたアクセス許可を受け入れるか拒否した後、アクセス許可が付与されたかどうかの報告に関 #onRequestPermissionsResult(int, String[], int[]) するコールバックを受け取ります。

アクセス許可を要求しても、アクセス許可が付与されるとは限らず、このアクセス許可を持たずにアプリを実行できる必要があることに注意してください。

この方法では、ユーザーが付与するアクセス許可と拒否するアクセス許可を選択できるアクティビティを開始できます。 そのため、アクティビティが一時停止して再開される可能性があることを準備する必要があります。 さらに、一部のアクセス許可を付与するには、アプリケーションの再起動が必要になる場合があります。 このような場合、結果を に配信する前に、システムによってアクティビティ スタックが #onRequestPermissionsResult(int, String[], int[])再作成されます。

アクセス許可があるかどうかを確認するときは、 を使用 #checkSelfPermission(String)する必要があります。

アクティビティが にtrue設定android.R.styleable#AndroidManifestActivity_noHistory noHistoryされている場合は、アクセス許可を要求できません。この場合、アクティビティは を含む#onRequestPermissionsResult(int, String[], int[])結果コールバックを受け取りません。

RuntimePermissions サンプル アプリは、このメソッドを使用して実行時にアクセス許可を要求する方法を示しています。

の android.app.Activity.requestPermissions(java.lang.String[], int)Java ドキュメント。

このページの一部は、によって作成および共有された作業に基づく変更であり、に記載されている条件に従って使用されます。