インスタンスメソッド
evaluatePolicy(_:localizedReason:reply:)
指定されたポリシーを評価します。
iOS 8.0+ iPadOS 8.0+ macOS 10.10+ Mac Catalyst 13.1+
watchOS 3.0+
宣言
パラメータ
policy
評価すべきポリシー。可能な値については、LAPolicy を参照して下さい。
localizedReason
アプリが提供する認証を要求する理由。これは、ユーザーに提示される認証ダイアログに表示されます。
reply
ポリシー評価が終了したときに実行されるクロージャ。これは、不特定のスレッドコンテキストでフレームワークの内部にあるプライベートキューで評価されます。このブロックでcanEvaluatePolicy(_:error:) を呼び出してはいけません。呼び出すと、行き詰まりになる可能性があります。
success
ポリシー評価が成功した場合は true、それ以外の場合は false。
error
ポリシー評価が成功した場合は nil、それ以外の場合はユーザーに提示する必要がある error オブジェクト。考えられるエラーコードについては、LAError.Code を参照してください。
議論
並行処理の注意
このページに示すように、完了ハンドラを使用して同期コードからこのメソッドを呼び出すこともでき、以下の宣言を持つ非同期メソッドとして呼び出すこともできます。
func evaluatePolicy(_ policy: LAPolicy, localizedReason: String) async throws -> Bool
Swift の並行処理と非同期コードについては、Objective-C API の非同期呼び出し (Calling Objective-C APIs Asynchronously) を参照してください。
このメソッドは、認証ポリシーを非同期的に評価します。ポリシーの評価には、さまざまな種類の操作または認証をユーザーに求めることが含まれます。実際の動作は、評価されたポリシーとデバイスの型によって異なります。動作は、インストールされている構成プロファイルによっても影響を受けます。
注意
認証プロンプトをサポートするデバイスでそれを制御するには、このメソッドを呼び出す前に、関連したローカル認証コンテキストを LAAuthenticationView (LAAuthenticationView) インスタンスに付属させます。
認証ダイアログでユーザーに提示するローカライズされた文字列で、認証要求の明確な理由を提供し、結果のアクションを説明します。メッセージを短く明確にし、ユーザーの言語で提供します。認証ダイアログにすでに表示されているアプリ名を含めないでください (macOS ではダイアログのタイトルに、iOS ではサブタイトルに)。
以前に成功したポリシー評価が、将来の評価も成功することを意味すると思わないでください。ポリシーの評価は、ユーザーまたはシステムによるキャンセルなど、さまざまな理由で失敗します。
以下も見よ
認証ポリシーの評価
var evaluatedPolicyDomainState: Data?
評価されたポリシードメインの現在の状態。
var maxBiometryFailures: NSNumber?
コンテキストが別のメカニズムに後退した後の生体測定認証の失敗の数。
廃止