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

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

Разработчик

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

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

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

CBCharacteristic

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

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

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

Swift

import CoreBluetooth

Objective C

@import CoreBluetooth;

Доступность

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

CBCharacteristic и его подкласс CBMutableCharacteristic представляйте дополнительную информацию о службе периферийного устройства. CBCharacteristic объекты в частности представляют характеристики службы удаленного периферийного устройства (удаленные периферийные устройства представлены CBPeripheral объекты). Характеристика содержит единственное значение и любое число дескрипторов, описывающих то значение. Свойства характеристики определяют, как значение характеристики может использоваться и как к дескрипторам можно получить доступ.

Идентификация характеристики
  • UUID Доступный в iOS 5.0 через свойство iOS 7.1

    Специфичный для Bluetooth UUID характеристики. (только для чтения)

    Объявление

    Objective C

    @property(readonly, nonatomic) CBUUID *UUID

    Обсуждение

    Это свойство является 128-разрядным UUID, идентифицирующим характеристику.

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

    Objective C

    @import CoreBluetooth;

    Доступность

    Доступный в iOS 5.0 через iOS 7.1.

  • service Свойство

    Служба, которой принадлежит эта характеристика. (только для чтения)

    Объявление

    Swift

    weak var service: CBService! { get }

    Objective C

    @property(weak, readonly, nonatomic) CBService *service

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

    Objective C

    @import CoreBluetooth;

    Swift

    import CoreBluetooth

    Доступность

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

Доступ к характерным данным
  • value Свойство

    Значение характеристики. (только для чтения)

    Объявление

    Swift

    var value: NSData! { get }

    Objective C

    @property(retain, readonly) NSData *value

    Обсуждение

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

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

    Objective C

    @import CoreBluetooth;

    Swift

    import CoreBluetooth

    Доступность

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

  • descriptors Свойство

    Список дескрипторов, обнаруженных в этой характеристике. (только для чтения)

    Объявление

    Swift

    var descriptors: [AnyObject]! { get }

    Objective C

    @property(retain, readonly) NSArray *descriptors

    Обсуждение

    Значение этого свойства является массивом CBDescriptor объекты, представляющие дескрипторы характеристики. Характерные дескрипторы предоставляют больше информации о значении характеристики. Например, они могут описать значение в человекочитаемой форме и описать, как значение должно быть отформатировано в целях представления. Для получения дополнительной информации о характерных дескрипторах, см. Ссылку класса CBDescriptor.

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

    Objective C

    @import CoreBluetooth;

    Swift

    import CoreBluetooth

    Доступность

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

  • properties Свойство

    Свойства характеристики. (только для чтения)

    Объявление

    Swift

    var properties: CBCharacteristicProperties { get }

    Objective C

    @property(readonly, nonatomic) CBCharacteristicProperties properties

    Обсуждение

    Свойства характеристики определяют, как значение и дескрипторы характеристики могут использоваться и получаться доступ. Для списка возможных значений, представляющих свойства характеристики, посмотрите Характерные Свойства.

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

    Objective C

    @import CoreBluetooth;

    Swift

    import CoreBluetooth

    Доступность

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

  • isNotifying Свойство

    Булево значение, указывающее, уведомляет ли характеристика в настоящее время подписанное центральное из своего значения. (только для чтения)

    Объявление

    Swift

    var isNotifying: Bool { get }

    Objective C

    @property(readonly) BOOL isNotifying

    Обсуждение

    YEStrue если Вы включили уведомления или признаки для характеристики путем успешного вызова setNotifyValue:forCharacteristic: метод CBPeripheral класс. Если значение этого свойства YEStrue, периферийное устройство обновляет подписанное центральное, что оно подключено с тем, каждый раз, когда изменилось значение характеристики. Если значение свойства NOfalse, уведомления (или признаки) не были включены для характеристики, и периферийное устройство не обновляет центральное, что это подключено с тем, каждый раз, когда изменилось значение характеристики.

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

    Objective C

    @import CoreBluetooth;

    Swift

    import CoreBluetooth

    Доступность

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

    См. также

    setNotifyValue:forCharacteristic:

  • isBroadcasted (iOS 8.0) Свойство

    Вы не должны использовать это свойство. (только для чтения)

    Объявление

    Swift

    var isBroadcasted: Bool { get }

    Objective C

    @property(readonly) BOOL isBroadcasted

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

    Objective C

    @import CoreBluetooth;

    Swift

    import CoreBluetooth

    Доступность

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

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

Константы
  • Характерные свойства

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

    Объявление

    Swift

    struct CBCharacteristicProperties : RawOptionSetType { init(_ rawValue: UInt) init(rawValue rawValue: UInt) static var Broadcast: CBCharacteristicProperties { get } static var Read: CBCharacteristicProperties { get } static var WriteWithoutResponse: CBCharacteristicProperties { get } static var Write: CBCharacteristicProperties { get } static var Notify: CBCharacteristicProperties { get } static var Indicate: CBCharacteristicProperties { get } static var AuthenticatedSignedWrites: CBCharacteristicProperties { get } static var ExtendedProperties: CBCharacteristicProperties { get } static var NotifyEncryptionRequired: CBCharacteristicProperties { get } static var IndicateEncryptionRequired: CBCharacteristicProperties { get } }

    Objective C

    typedef enum { CBCharacteristicPropertyBroadcast = 0x01, CBCharacteristicPropertyRead = 0x02, CBCharacteristicPropertyWriteWithoutResponse = 0x04, CBCharacteristicPropertyWrite = 0x08, CBCharacteristicPropertyNotify = 0x10, CBCharacteristicPropertyIndicate = 0x20, CBCharacteristicPropertyAuthenticatedSignedWrites = 0x40, CBCharacteristicPropertyExtendedProperties = 0x80, CBCharacteristicPropertyNotifyEncryptionRequired = 0x100, CBCharacteristicPropertyIndicateEncryptionRequired = 0x200, } CBCharacteristicProperties;

    Константы

    • Broadcast

      CBCharacteristicPropertyBroadcast

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

      Это свойство не позволяется для локальных характеристик, опубликованных через addService: метод CBPeripheralManager класс. Это означает, что Вы не можете использовать это свойство при инициализации нового CBMutableCharacteristic объект через initWithType:properties:value:permissions: метод CBMutableCharacteristic класс.

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

    • Read

      CBCharacteristicPropertyRead

      Значение характеристики может быть считано.

      Используйте readValueForCharacteristic: метод CBPeripheral класс чтения значение характеристики.

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

    • WriteWithoutResponse

      CBCharacteristicPropertyWriteWithoutResponse

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

      Используйте writeValue:forCharacteristic:type: метод CBPeripheral класс записи к значению характеристики, с помощью CBCharacteristicWriteWithoutResponse постоянный как параметр для type:. Если характеристика имеет этот набор свойств, никакую ошибку не передают обратно центральному, когда запись в значение характеристики неуспешна.

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

    • Write

      CBCharacteristicPropertyWrite

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

      Если характеристика имеет этот набор свойств, ошибка отправляется для поддержки к центральному, когда запись в значение характеристики неуспешна. Это свойство допускает значения, которые будут записаны в значение характеристики, которые более длинны, чем разрешенные CBCharacteristicPropertyWriteWithoutResponse постоянный. Используйте writeValue:forCharacteristic:type: метод CBPeripheral класс записи к значению характеристики, с помощью CBCharacteristicWriteWithResponse постоянный как параметр для type:.

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

    • Notify

      CBCharacteristicPropertyNotify

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

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

    • Indicate

      CBCharacteristicPropertyIndicate

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

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

    • AuthenticatedSignedWrites

      CBCharacteristicPropertyAuthenticatedSignedWrites

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

      Если характеристика имеет этот набор свойств, никакую ошибку не передают обратно центральному, когда запись в значение характеристики неуспешна.

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

    • ExtendedProperties

      CBCharacteristicPropertyExtendedProperties

      Дополнительные характерные свойства определяются в характерном дескрипторе расширенных свойств.

      Это свойство не позволяется для локальных характеристик, опубликованных с помощью addService: метод CBPeripheralManager класс. Т.е. Вы не можете использовать это свойство при инициализации a CBMutableCharacteristic объект с помощью initWithType:properties:value:permissions: метод CBMutableCharacteristic класс.

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

    • NotifyEncryptionRequired

      CBCharacteristicPropertyNotifyEncryptionRequired

      Только доверенные устройства могут включить уведомления о значении характеристики.

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

    • IndicateEncryptionRequired

      CBCharacteristicPropertyIndicateEncryptionRequired

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

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

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

    Objective C

    @import CoreBluetooth;

    Swift

    import CoreBluetooth

    Доступность

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