Activity.RequestPermissions メソッド

定義

名前空間:: Android.App

アセンブリ:: Mono.Android.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

オーバーロード

名前	説明
RequestPermissions(String[], Int32)	このアプリケーションに付与するアクセス許可を要求します。
RequestPermissions(String[], Int32, Int32)	このアプリケーションに付与するアクセス許可を要求します。

RequestPermissions(String[], Int32)

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

[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

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

属性: RegisterAttribute

注釈

このアプリケーションに付与するアクセス許可を要求します。これらのアクセス許可は、マニフェストで要求する必要があります。アプリに付与しないでください。また、プラットフォームまたはサードパーティ製アプリによって宣言されているかどうかに関係なく、保護レベルは危険である必要があります。 PermissionInfo.PROTECTION_NORMAL通常のアクセス許可は、マニフェストで要求された場合、インストール時に付与されます。マニフェストで要求され、アプリの署名がアクセス許可を宣言するアプリの署名と一致する場合、PermissionInfo.PROTECTION_SIGNATURE署名アクセス許可はインストール時に付与されます。

この API を呼び出す前に shouldShowRequestPermissionRationale(String) を呼び出して、システムがアクセス許可を要求する前に論理的な UI を表示することを推奨しているかどうかを確認します。

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

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

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

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

アクティビティが noHistory を true に設定した場合、アクセス許可を要求することはできません。この場合、アクティビティは onRequestPermissionsResult(int, String, int) を含む結果コールバックを受け取らないためです。

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

適用対象

RequestPermissions(String[], Int32, Int32)