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

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

Разработчик

Ссылка на протокол CBPeripheralManagerDelegate

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

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

CBPeripheralManagerDelegate

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


Не применимый

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


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


Swift

import CoreBluetooth

Objective C

@import CoreBluetooth;

Доступность


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

Делегат a CBPeripheralManager объект должен принять CBPeripheralManagerDelegate протокол, протокол, состоящий из многочисленных дополнительных методов и одного требуемого метода. Дополнительные методы протокола используются делегатом, чтобы проверить публикацию и распространение, и контролировать чтение, записать, и запросы подписки от удаленных центральных устройств. Требуемый метод протокола, указывающий, доступен ли периферийный менеджер, вызывают, когда обновляется состояние периферийного менеджера.

  • Вызванный, когда обновляется состояние периферийного менеджера. (требуемый)

    Объявление

    Swift

    func peripheralManagerDidUpdateState(_ peripheral: CBPeripheralManager!)

    Objective C

    - (void)peripheralManagerDidUpdateState:(CBPeripheralManager *)peripheral

    Параметры

    peripheral

    Периферийный менеджер, состояние которого изменилось.

    Обсуждение

    Вы реализуете этот требуемый метод гарантировать, что низкая энергия Bluetooth поддерживается и доступна для использования на локальном периферийном устройстве. Дайте команды периферийному менеджеру только, когда состояние периферийного менеджера будет включено, как обозначено CBPeripheralManagerStatePoweredOn постоянный. Состояние со значением ниже, чем CBPeripheralManagerStatePoweredOn подразумевает, что распространение остановилось и что любой соединился, centrals были разъединены. Если состояние перемещается ниже CBPeripheralManagerStatePoweredOff, распространение остановилось и должно быть явно перезапущено. Кроме того, локальная база данных очищена, и все службы должны быть явно добавлены снова. Для полного списка и обсуждения возможных значений, представляющих состояние периферийного менеджера, посмотрите CBPeripheralManagerState перечисление в Ссылке класса CBPeripheralManager.

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

    Objective C

    @import CoreBluetooth;

    Swift

    import CoreBluetooth

    Доступность

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

  • Вызванный, когда периферийный менеджер собирается быть восстановленным системой.

    Объявление

    Swift

    optional func peripheralManager(_ peripheral: CBPeripheralManager!, willRestoreState dict: [NSObject : AnyObject]!)

    Objective C

    - (void)peripheralManager:(CBPeripheralManager *)peripheral willRestoreState:(NSDictionary *)dict

    Параметры

    peripheral

    Периферийный менеджер, предоставляющий эту информацию.

    dict

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

    Обсуждение

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

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

    Objective C

    @import CoreBluetooth;

    Swift

    import CoreBluetooth

    Доступность

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

  • Вызванный, когда Вы публикуете службу и любую из ее связанных характеристик и характерных дескрипторов, к локальной базе данных Generic Attribute Profile (GATT).

    Объявление

    Swift

    optional func peripheralManager(_ peripheral: CBPeripheralManager!, didAddService service: CBService!, error error: NSError!)

    Objective C

    - (void)peripheralManager:(CBPeripheralManager *)peripheral didAddService:(CBService *)service error:(NSError *)error

    Параметры

    peripheral

    Периферийный менеджер, предоставляющий эту информацию.

    service

    Служба, добавленная к локальной базе данных GATT.

    error

    Если ошибка произошла, причина отказа.

    Обсуждение

    Когда Ваше приложение вызывает, этот метод вызывается addService: метод для публикации службы к базе данных GATT локального периферийного устройства. Если служба успешно публикуется к локальной базе данных, error параметр nil. Если неуспешный, error параметр возвращает причину отказа.

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

    Objective C

    @import CoreBluetooth;

    Swift

    import CoreBluetooth

    Доступность

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

  • Вызванный, когда Вы начинаете распространять данные локального периферийного устройства.

    Объявление

    Swift

    optional func peripheralManagerDidStartAdvertising(_ peripheral: CBPeripheralManager!, error error: NSError!)

    Objective C

    - (void)peripheralManagerDidStartAdvertising:(CBPeripheralManager *)peripheral error:(NSError *)error

    Параметры

    peripheral

    Периферийный менеджер, предоставляющий эту информацию.

    error

    Если ошибка произошла, причина отказа.

    Обсуждение

    Когда Ваше приложение вызывает, этот метод вызывается startAdvertising: метод, чтобы начать распространять данные локального периферийного устройства. Если успешный, error параметр nil. Если существует проблема, распространяя данные, error параметр возвращает причину отказа.

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

    Objective C

    @import CoreBluetooth;

    Swift

    import CoreBluetooth

    Доступность

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

  • Вызванный, когда удаленное центральное устройство подписывается на значение характеристики.

    Объявление

    Swift

    optional func peripheralManager(_ peripheral: CBPeripheralManager!, central central: CBCentral!, didSubscribeToCharacteristic characteristic: CBCharacteristic!)

    Objective C

    - (void)peripheralManager:(CBPeripheralManager *)peripheral central:(CBCentral *)central didSubscribeToCharacteristic:(CBCharacteristic *)characteristic

    Параметры

    peripheral

    Периферийный менеджер, предоставляющий эту информацию.

    central

    Удаленное центральное устройство, подписавшееся на значение характеристики.

    characteristic

    Характеристика, значение которой было подписано на.

    Обсуждение

    Когда удаленное центральное устройство подписывается на значение одной из характеристик локального периферийного устройства путем включения уведомлений или признаков относительно значения характеристики, этот метод вызывается. Необходимо использовать вызов этого метода как сигнал, чтобы начать отправлять подписанные центральные обновления, когда изменяется значение характеристики. Для отправки обновленных характеристических значений в подписанный centrals используйте updateValue:forCharacteristic:onSubscribedCentrals: метод CBPeripheralManager класс.

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

    Objective C

    @import CoreBluetooth;

    Swift

    import CoreBluetooth

    Доступность

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

  • Вызванный, когда удаленное центральное устройство отписывается от значения характеристики.

    Объявление

    Swift

    optional func peripheralManager(_ peripheral: CBPeripheralManager!, central central: CBCentral!, didUnsubscribeFromCharacteristic characteristic: CBCharacteristic!)

    Objective C

    - (void)peripheralManager:(CBPeripheralManager *)peripheral central:(CBCentral *)central didUnsubscribeFromCharacteristic:(CBCharacteristic *)characteristic

    Параметры

    peripheral

    Периферийный менеджер, предоставляющий эту информацию.

    central

    Удаленное центральное устройство, подписавшееся на значение характеристики.

    characteristic

    Характеристика, значение которой было отписано от.

    Обсуждение

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

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

    Objective C

    @import CoreBluetooth;

    Swift

    import CoreBluetooth

    Доступность

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

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

    Объявление

    Swift

    optional func peripheralManagerIsReadyToUpdateSubscribers(_ peripheral: CBPeripheralManager!)

    Objective C

    - (void)peripheralManagerIsReadyToUpdateSubscribers:(CBPeripheralManager *)peripheral

    Параметры

    peripheral

    Периферийный менеджер, предоставляющий эту информацию.

    Обсуждение

    Когда вызов к updateValue:forCharacteristic:onSubscribedCentrals: метод перестал работать, потому что базовая очередь, используемая для передачи обновленного характеристического значения, полна, peripheralManagerIsReadyToUpdateSubscribers: когда больше пространства в очереди передачи становится доступным, метод вызывается. Можно тогда реализовать этот метод делегата снова послать значение.

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

    Objective C

    @import CoreBluetooth;

    Swift

    import CoreBluetooth

    Доступность

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

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

    Объявление

    Swift

    optional func peripheralManager(_ peripheral: CBPeripheralManager!, didReceiveReadRequest request: CBATTRequest!)

    Objective C

    - (void)peripheralManager:(CBPeripheralManager *)peripheral didReceiveReadRequest:(CBATTRequest *)request

    Параметры

    peripheral

    Периферийный менеджер, предоставляющий эту информацию.

    request

    A CBATTRequest объект, представляющий запрос для чтения значения характеристики.

    Обсуждение

    Каждый раз, когда этот метод вызывается, Вы вызываете respondToRequest:withResult: метод CBPeripheralManager классифицируйте точно один раз для ответа на запрос чтения.

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

    Objective C

    @import CoreBluetooth;

    Swift

    import CoreBluetooth

    Доступность

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

  • Вызванный, когда локальное периферийное устройство получает Протокол Атрибута (ATT) запрос записи на характеристику, имеющую динамическое значение.

    Объявление

    Swift

    optional func peripheralManager(_ peripheral: CBPeripheralManager!, didReceiveWriteRequests requests: [AnyObject]!)

    Objective C

    - (void)peripheralManager:(CBPeripheralManager *)peripheral didReceiveWriteRequests:(NSArray *)requests

    Параметры

    peripheral

    Периферийный менеджер, предоставляющий эту информацию.

    requests

    Список один или больше CBATTRequest объекты, каждый представляющий запрос для записи значение характеристики.

    Обсуждение

    Таким же образом то, что Вы реагируете на запрос чтения, каждый раз, когда этот метод вызывается, Вы вызываете respondToRequest:withResult: метод CBPeripheralManager классифицируйте точно один раз. Если requests параметр содержит многократные запросы, обработайте их, поскольку Вы были бы единственный запрос — если какой-либо отдельный запрос не может быть обработан, Вы не должны выполнять ни одного из них. Вместо этого вызовите respondToRequest:withResult: метод сразу, и обеспечивает результат, указывающий причину отказа.

    При ответе на запрос записи отметьте что первый параметр respondToRequest:withResult: метод ожидает сингл CBATTRequest объект, даже при том, что Вы получили массив их от peripheralManager:didReceiveWriteRequests: метод. Для ответа должным образом передайте в первом запросе requests массив.

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

    Objective C

    @import CoreBluetooth;

    Swift

    import CoreBluetooth

    Доступность

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

  • Ключи раньше передавали опции initWithDelegate:queue:options: метод.

    Объявление

    Swift

    let CBPeripheralManagerRestoredStateServicesKey: String let CBPeripheralManagerRestoredStateAdvertisementDataKey: String

    Objective C

    NSString *const CBPeripheralManagerRestoredStateServicesKey; NSString *const CBPeripheralManagerRestoredStateAdvertisementDataKey;

    Константы

    • CBPeripheralManagerRestoredStateServicesKey

      Массив (экземпляр NSArray) из CBMutableService объекты, который содержит все службы, опубликованные к базе данных локального периферийного устройства в это время приложение, были завершены системой.

      Вся информация о службе восстановлена, включая любые включенные службы, характеристики, характерные дескрипторы, и подписана centrals.

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

    • CBPeripheralManagerRestoredStateAdvertisementDataKey

      Словарь (экземпляр NSDictionary) содержа данные, которые распространял периферийный менеджер в то время, когда приложение было завершено системой.

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