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

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

Разработчик

Ссылка платформы CoreBluetooth ссылка на протокол CBPeripheralDelegate

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

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

CBPeripheralDelegate

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

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

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

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

Swift

import CoreBluetooth

Objective C

@import CoreBluetooth;

Доступность

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

Делегат a CBPeripheral объект должен принять CBPeripheralDelegate протокол. Делегат использует методы этого протокола для контроля открытия, исследования и взаимодействия служб и свойств удаленного периферийного устройства. В этом протоколе нет никаких требуемых методов.

Discovering Services
  • периферийное устройство (_: didDiscoverServices:) - peripheral:didDiscoverServices:

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

    Объявление

    Swift

    optional func peripheral(_ peripheral: CBPeripheral!, didDiscoverServices error: NSError!)

    Objective C

    - (void)peripheral:(CBPeripheral *)peripheral didDiscoverServices:(NSError *)error

    Параметры

    peripheral

    Периферийное устройство, которому принадлежат службы.

    error

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

    Обсуждение

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

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

    Objective C

    @import CoreBluetooth;

    Swift

    import CoreBluetooth

    Доступность

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

  • периферийное устройство (_: didDiscoverIncludedServicesForService:error:) - peripheral:didDiscoverIncludedServicesForService:error:

    Вызванный, когда Вы обнаруживаете включенные службы указанной службы.

    Объявление

    Swift

    optional func peripheral(_ peripheral: CBPeripheral!, didDiscoverIncludedServicesForService service: CBService!, error error: NSError!)

    Objective C

    - (void)peripheral:(CBPeripheral *)peripheral didDiscoverIncludedServicesForService:(CBService *)service error:(NSError *)error

    Параметры

    peripheral

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

    service

    CBService объект, содержащий включенную службу.

    error

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

    Обсуждение

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

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

    Objective C

    @import CoreBluetooth;

    Swift

    import CoreBluetooth

    Доступность

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

Обнаружение характеристик и характерных дескрипторов
  • периферийное устройство (_: didDiscoverCharacteristicsForService:error:) - peripheral:didDiscoverCharacteristicsForService:error:

    Вызванный, когда Вы обнаруживаете характеристики указанной службы.

    Объявление

    Swift

    optional func peripheral(_ peripheral: CBPeripheral!, didDiscoverCharacteristicsForService service: CBService!, error error: NSError!)

    Objective C

    - (void)peripheral:(CBPeripheral *)peripheral didDiscoverCharacteristicsForService:(CBService *)service error:(NSError *)error

    Параметры

    peripheral

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

    service

    Служба, которой принадлежат характеристики.

    error

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

    Обсуждение

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

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

    Objective C

    @import CoreBluetooth;

    Swift

    import CoreBluetooth

    Доступность

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

  • периферийное устройство (_: didDiscoverDescriptorsForCharacteristic:error:) - peripheral:didDiscoverDescriptorsForCharacteristic:error:

    Вызванный, когда Вы обнаруживаете дескрипторы заданной характеристики.

    Объявление

    Swift

    optional func peripheral(_ peripheral: CBPeripheral!, didDiscoverDescriptorsForCharacteristic characteristic: CBCharacteristic!, error error: NSError!)

    Objective C

    - (void)peripheral:(CBPeripheral *)peripheral didDiscoverDescriptorsForCharacteristic:(CBCharacteristic *)characteristic error:(NSError *)error

    Параметры

    peripheral

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

    characteristic

    Характеристика, которой принадлежат характерные дескрипторы.

    error

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

    Обсуждение

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

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

    Objective C

    @import CoreBluetooth;

    Swift

    import CoreBluetooth

    Доступность

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

Получение характерных и характерных значений дескриптора
  • периферийное устройство (_: didUpdateValueForCharacteristic:error:) - peripheral:didUpdateValueForCharacteristic:error:

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

    Объявление

    Swift

    optional func peripheral(_ peripheral: CBPeripheral!, didUpdateValueForCharacteristic characteristic: CBCharacteristic!, error error: NSError!)

    Objective C

    - (void)peripheral:(CBPeripheral *)peripheral didUpdateValueForCharacteristic:(CBCharacteristic *)characteristic error:(NSError *)error

    Параметры

    peripheral

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

    characteristic

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

    error

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

    Обсуждение

    Когда Ваше приложение вызывает, этот метод вызывается readValueForCharacteristic: метод, или когда периферийное устройство уведомляет Ваше приложение, что значение характеристики, для которой включены уведомления и признаки (через успешный вызов к setNotifyValue:forCharacteristic:) изменился. Если успешный, error параметр nil. Если неуспешный, error параметр возвращает причину отказа.

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

    Objective C

    @import CoreBluetooth;

    Swift

    import CoreBluetooth

    Доступность

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

  • периферийное устройство (_: didUpdateValueForDescriptor:error:) - peripheral:didUpdateValueForDescriptor:error:

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

    Объявление

    Swift

    optional func peripheral(_ peripheral: CBPeripheral!, didUpdateValueForDescriptor descriptor: CBDescriptor!, error error: NSError!)

    Objective C

    - (void)peripheral:(CBPeripheral *)peripheral didUpdateValueForDescriptor:(CBDescriptor *)descriptor error:(NSError *)error

    Параметры

    peripheral

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

    descriptor

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

    error

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

    Обсуждение

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

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

    Objective C

    @import CoreBluetooth;

    Swift

    import CoreBluetooth

    Доступность

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

Запись характерных и характерных значений дескриптора
  • периферийное устройство (_: didWriteValueForCharacteristic:error:) - peripheral:didWriteValueForCharacteristic:error:

    Вызванный, когда Вы пишете данные в значение характеристики.

    Объявление

    Swift

    optional func peripheral(_ peripheral: CBPeripheral!, didWriteValueForCharacteristic characteristic: CBCharacteristic!, error error: NSError!)

    Objective C

    - (void)peripheral:(CBPeripheral *)peripheral didWriteValueForCharacteristic:(CBCharacteristic *)characteristic error:(NSError *)error

    Параметры

    peripheral

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

    characteristic

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

    error

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

    Обсуждение

    Этот метод вызывается только, когда Ваше приложение вызывает writeValue:forCharacteristic:type: метод с CBCharacteristicWriteWithResponse постоянный указанный как тип записи. Если успешный, error параметр nil. Если неуспешный, error параметр возвращает причину отказа.

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

    Objective C

    @import CoreBluetooth;

    Swift

    import CoreBluetooth

    Доступность

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

  • периферийное устройство (_: didWriteValueForDescriptor:error:) - peripheral:didWriteValueForDescriptor:error:

    Вызванный, когда Вы пишете данные в значение характерного дескриптора.

    Объявление

    Swift

    optional func peripheral(_ peripheral: CBPeripheral!, didWriteValueForDescriptor descriptor: CBDescriptor!, error error: NSError!)

    Objective C

    - (void)peripheral:(CBPeripheral *)peripheral didWriteValueForDescriptor:(CBDescriptor *)descriptor error:(NSError *)error

    Параметры

    peripheral

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

    descriptor

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

    error

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

    Обсуждение

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

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

    Objective C

    @import CoreBluetooth;

    Swift

    import CoreBluetooth

    Доступность

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

Управление уведомлениями для значения характеристики
  • периферийное устройство (_: didUpdateNotificationStateForCharacteristic:error:) - peripheral:didUpdateNotificationStateForCharacteristic:error:

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

    Объявление

    Swift

    optional func peripheral(_ peripheral: CBPeripheral!, didUpdateNotificationStateForCharacteristic characteristic: CBCharacteristic!, error error: NSError!)

    Objective C

    - (void)peripheral:(CBPeripheral *)peripheral didUpdateNotificationStateForCharacteristic:(CBCharacteristic *)characteristic error:(NSError *)error

    Параметры

    peripheral

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

    characteristic

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

    error

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

    Обсуждение

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

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

    Objective C

    @import CoreBluetooth;

    Swift

    import CoreBluetooth

    Доступность

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

Получение данных Received Signal Strength Indicator (RSSI) периферийного устройства
  • peripheralDidUpdateRSSI (_: ошибка:) - peripheralDidUpdateRSSI:error: (iOS 8.0)

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

    Объявление

    Swift

    optional func peripheralDidUpdateRSSI(_ peripheral: CBPeripheral!, error error: NSError!)

    Objective C

    - (void)peripheralDidUpdateRSSI:(CBPeripheral *)peripheral error:(NSError *)error

    Параметры

    peripheral

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

    error

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

    Обсуждение

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

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

    Objective C

    @import CoreBluetooth;

    Swift

    import CoreBluetooth

    Доступность

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

    Осуждаемый в iOS 8.0.

Наблюдение изменений к имени или службам периферийного устройства
  • peripheralDidUpdateName (_:) - peripheralDidUpdateName:

    Вызванный, когда смены имени периферийного устройства.

    Объявление

    Swift

    optional func peripheralDidUpdateName(_ peripheral: CBPeripheral!)

    Objective C

    - (void)peripheralDidUpdateName:(CBPeripheral *)peripheral

    Параметры

    peripheral

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

    Обсуждение

    Метод вызывается каждый раз, когда изменилось имя устройства Типового профиля доступа (GAP) периферийного устройства. Так как периферийное устройство может изменить свое имя устройства GAP, можно реализовать этот метод, если приложение должно вывести на экран текущее имя периферийного устройства.

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

    Objective C

    @import CoreBluetooth;

    Swift

    import CoreBluetooth

    Доступность

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

  • - peripheralDidInvalidateServices: (iOS 7.0)

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

    Оператор осуждения

    Используйте peripheral:didModifyServices: метод вместо этого.

    Объявление

    Objective C

    - (void)peripheralDidInvalidateServices:(CBPeripheral *)peripheral

    Параметры

    peripheral

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

    Обсуждение

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

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

    Objective C

    @import CoreBluetooth;

    Доступность

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

    Осуждаемый в iOS 7.0.

  • периферийное устройство (_: didModifyServices:) - peripheral:didModifyServices:

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

    Объявление

    Swift

    optional func peripheral(_ peripheral: CBPeripheral!, didModifyServices invalidatedServices: [AnyObject]!)

    Objective C

    - (void)peripheral:(CBPeripheral *)peripheral didModifyServices:(NSArray *)invalidatedServices

    Параметры

    peripheral

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

    invalidatedServices

    Список лишенных законной силы служб.

    Обсуждение

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

    • Служба удалена из базы данных периферийного устройства

    • Новая служба добавляется к базе данных периферийного устройства

    • Служба, ранее удаленная из базы данных периферийного устройства, повторно добавляется к базе данных в различном расположении

    Если Вы ранее обнаружили какую-либо из служб, изменившихся, им предоставлены в invalidatedServices параметр и больше не может использоваться. Можно использовать discoverServices: метод для обнаружения любых новых служб, добавленных к базе данных периферийного устройства или узнать, была ли какая-либо из лишенных законной силы служб, которые Вы использовали (и хотят продолжать использовать) добавлена назад к различному расположению в базе данных периферийного устройства.

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

    Objective C

    @import CoreBluetooth;

    Swift

    import CoreBluetooth

    Доступность

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