Spec-Zone .ru
спецификации, руководства, описания, API

Библиотека Разработчика iOS

Разработчик

Ссылка платформы LocalAuthentication ссылка класса LAContext

Опции
Развертывание Target:

На этой странице
Язык:

LAContext

Наследование


Соответствует


Оператор импорта


Swift

import LocalAuthentication

Objective C

@import LocalAuthentication;

Доступность


Доступный в iOS 8.0 и позже.

Представляет контекст аутентификации.

Контексты аутентификации используются для оценки политики аутентификации, позволяя приложениям запросить пользователя аутентифицировать себя с помощью персональных данных, таких как цифровой отпечаток, зарегистрированный в Касании ID.

  • Предварительные рейсы политика аутентификации, чтобы видеть, возможно ли для аутентификации успешно выполниться.

    Объявление

    Swift

    func canEvaluatePolicy(_ policy: LAPolicy, error error: NSErrorPointer) -> Bool

    Objective C

    - (BOOL)canEvaluatePolicy:(LAPolicy)policy error:(NSError **)error

    Параметры

    policy

    Политика оценить.

    error

    На вводе, указателе на ошибочный объект. Если ошибка происходит, этот указатель установлен в фактический ошибочный объект, содержащий информацию об ошибке. Можно указать nil для этого параметра, если Вы не хотите информации об ошибке.

    Возвращаемое значение

    YEStrue если политика может быть оценена, NOfalse иначе.

    Обсуждение

    Политики могут иметь требования, которые должны быть удовлетворены, чтобы иметь любую возможность успешной аутентификации. Например, политика, требующая биометрики, потребовала бы, чтобы Касание ID был включен и зарегистрировал цифровые отпечатки.

    Возвращаемое значение этого метода может изменяться в течение долгого времени, таким образом, Вы не должны хранить это значение для будущего использования в Вашем приложении. Значение, как гарантируют, останется непротиворечивым, пока Ваше приложение не введет фон.

    Специальные замечания

    Этот метод не должен быть призван reply блок evaluatePolicy:localizedReason:reply:, потому что выполнение так могло вести для заведения в тупик.

    Оператор импорта

    Objective C

    @import LocalAuthentication;

    Swift

    import LocalAuthentication

    Доступность

    Доступный в iOS 8.0 и позже.

  • Оценивает указанную политику.

    Объявление

    Swift

    func evaluatePolicy(_ policy: LAPolicy, localizedReason localizedReason: String!, reply reply: ((Bool, NSError!) -> Void)!)

    Objective C

    - (void)evaluatePolicy:(LAPolicy)policy localizedReason:(NSString *)localizedReason reply:(void (^)(BOOL success, NSError *error))reply

    Параметры

    policy

    Политика оценить.

    localizedReason

    Предоставленная приложением причина запроса аутентификации. Эта строка должна быть предоставлена на текущем языке пользователя и должна быть коротка и ясна. Это будет выведено на экран в подзаголовке диалога аутентификации. Имя приложения появится в заголовке диалога аутентификации, таким образом, Вы не должны будете копировать свое имя приложения здесь.

    reply

    Блок ответа, выполняющийся, когда заканчивается оценка политики. Этот блок оценен на частной очереди, внутренней к платформе в неуказанном контексте поточной обработки. Вы не должны вызывать canEvaluatePolicy:error: в этом блоке, потому что выполнение так могло вести для заведения в тупик.

    success

    YEStrue если оценка политики успешно выполнилась, NOfalse иначе.

    error

    nil если оценка политики успешно выполнилась, ошибочный объект, который должен быть представлен пользователю иначе. Посмотрите LAError для возможных ошибочных значений

    Обсуждение

    Этот метод асинхронно оценивает политику аутентификации. reply блок используется для предоставления результатов оценки. Оценка политики может включить запрос пользователя для различных видов взаимодействия или аутентификации. Фактическое поведение зависит от оцененной политики и типа устройства. Это может также быть затронуто установленными профилями конфигурации.

    Вы не должны предполагать, что предыдущая успешная оценка политики обязательно приведет к последующей успешной оценке. Оценка политики может перестать работать по различным причинам, включая пользовательскую отмену или системную отмену. Посмотрите LAError для возможных ошибочных значений.

    Оператор импорта

    Objective C

    @import LocalAuthentication;

    Swift

    import LocalAuthentication

    Доступность

    Доступный в iOS 8.0 и позже.

  • Полицейские аутентификации.

    Объявление

    Swift

    enum LAPolicy : Int { case DeviceOwnerAuthenticationWithBiometrics }

    Objective C

    typedef NS_ENUM (NSInteger, LAPolicy ) { LAPolicyDeviceOwnerAuthenticationWithBiometrics = kLAPolicyDeviceOwnerAuthen ticationWithBiometrics };

    Константы

    • DeviceOwnerAuthenticationWithBiometrics

      LAPolicyDeviceOwnerAuthenticationWithBiometrics

      Владелец устройства аутентифицировал использование биометрического метода. Биометрика (Касание ID) требуется. Если Касание ID не включено, сбои оценки политики.

      Доступный в iOS 8.0 и позже.

    Оператор импорта

    Objective C

    @import LocalAuthentication;

    Swift

    import LocalAuthentication

    Доступность

    Доступный в iOS 8.0 и позже.

  • Коды ошибки, которые могут быть возвращены при оценке политики.

    Объявление

    Swift

    enum LAError : Int { case AuthenticationFailed case UserCancel case UserFallback case SystemCancel case PasscodeNotSet case TouchIDNotAvailable case TouchIDNotEnrolled }

    Objective C

    typedef NS_ENUM (NSInteger, LAError ) { LAErrorAuthenticationFailed = kLAErrorAuthenticationFailed, LAErrorUserCancel = kLAErrorUserCancel, LAErrorUserFallback = kLAErrorUserFallback, LAErrorSystemCancel = kLAErrorSystemCancel, LAErrorPasscodeNotSet = kLAErrorPasscodeNotSet, LAErrorTouchIDNotAvailable = kLAErrorTouchIDNotAvailable, LAErrorTouchIDNotEnrolled = kLAErrorTouchIDNotEnrolled, };

    Константы

    • AuthenticationFailed

      LAErrorAuthenticationFailed

      Аутентификация не была успешна, потому что пользователю не удалось обеспечить допустимые учетные данные.

      Доступный в iOS 8.0 и позже.

    • UserCancel

      LAErrorUserCancel

      Аутентификация была отменена пользователем — например, пользователь коснулся Отмены в диалоговом окне.

      Доступный в iOS 8.0 и позже.

    • UserFallback

      LAErrorUserFallback

      Аутентификация была отменена, потому что пользователь коснулся, кнопка нейтрализации (Введите Пароль).

      Доступный в iOS 8.0 и позже.

    • SystemCancel

      LAErrorSystemCancel

      Аутентификация была отменена системой — например, если другое приложение прибыло в передний план, в то время как произошел диалог аутентификации.

      Доступный в iOS 8.0 и позже.

    • PasscodeNotSet

      LAErrorPasscodeNotSet

      Аутентификация не могла запуститься, потому что код доступа не установлен на устройстве.

      Доступный в iOS 8.0 и позже.

    • TouchIDNotAvailable

      LAErrorTouchIDNotAvailable

      Аутентификация не могла запуститься, потому что Касание ID не доступно на устройстве.

      Доступный в iOS 8.0 и позже.

    • TouchIDNotEnrolled

      LAErrorTouchIDNotEnrolled

      Аутентификация не могла запуститься, потому что Касание ID не имеет никаких зарегистрированных пальцев.

      Доступный в iOS 8.0 и позже.

    Оператор импорта

    Objective C

    @import LocalAuthentication;

    Swift

    import LocalAuthentication

    Доступность

    Доступный в iOS 8.0 и позже.

  • Ошибочный домен для платформы Локальной аутентификации.

    Объявление

    Swift

    let LAErrorDomain: String

    Objective C

    NSString *const LAErrorDomain;

    Константы

    • LAErrorDomain

      Строковая константа, идентифицирующая ошибочный домен для платформы Локальной аутентификации.

      Доступный в iOS 8.0 и позже.