Xojo Conferences
MBSSep2018MunichDE
XDCMay2019MiamiUSA

Platforms to show: All Mac Windows Linux Cross-Platform

CBPeripheralMBS.DidDiscoverCharacteristicsForService(service as CBServiceMBS, error as NSErrorMBS)
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
event Bluetooth MBS Bluetooth Plugin 18.1 Yes No No No No
Function: Invoked when you discover the characteristics of a specified service.
Notes:
peripheral: The peripheral providing this information.
service: The service that the characteristics belong to.
error: If an error occurred, the cause of the failure.

This event is invoked when your app calls the discoverCharacteristics method. If the characteristics of the specified service are successfully discovered, you can access them through the service's characteristics property. If successful, the error parameter is nil. If unsuccessful, the error parameter returns the cause of the failure.

Feedback, Comments & Corrections

CBPeripheralMBS.DidDiscoverDescriptorsForCharacteristic(characteristic as CBCharacteristicMBS, error as NSErrorMBS)
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
event Bluetooth MBS Bluetooth Plugin 18.1 Yes No No No No
Function: Invoked when you discover the descriptors of a specified characteristic.
Notes:
peripheral: The peripheral providing this information.
characteristic: The characteristic that the characteristic descriptors belong to.
error: If an error occurred, the cause of the failure.

This event is invoked when your app calls the discoverDescriptorsForCharacteristic method. If the characteristic descriptors of the specified characteristic are successfully discovered, you can access them through the characteristic’s descriptors property. If successful, the error parameter is nil. If unsuccessful, the error parameter returns the cause of the failure.

Feedback, Comments & Corrections

CBPeripheralMBS.DidDiscoverIncludedServicesForService(service as CBServiceMBS, error as NSErrorMBS)
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
event Bluetooth MBS Bluetooth Plugin 18.1 Yes No No No No
Function: Invoked when you discover the included services of a specified service.
Notes:
peripheral: The peripheral providing this information.
service: The CBService object containing the included service.
error: If an error occurred, the cause of the failure.

This event is invoked when you app calls the discoverIncludedServices method. If the included services of the specified service are successfully discovered, you can access them through the service’s includedServices property. If successful, the error parameter is nil. If unsuccessful, the error parameter returns the cause of the failure.

Feedback, Comments & Corrections

CBPeripheralMBS.DidDiscoverServices(error as NSErrorMBS)
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
event Bluetooth MBS Bluetooth Plugin 18.1 Yes No No No No
Function: Invoked when you discover the peripheral’s available services.
Notes:
peripheral: The peripheral that the services belong to.
error: If an error occurred, the cause of the failure.

This event is invoked when your app calls the discoverServices method. If the services of the peripheral are successfully discovered, you can access them through the peripheral’s services property. If successful, the error parameter is nil. If unsuccessful, the error parameter returns the cause of the failure.

Feedback, Comments & Corrections

CBPeripheralMBS.DidModifyServices(invalidatedServices() as CBServiceMBS)
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
event Bluetooth MBS Bluetooth Plugin 18.1 Yes No No No No
Function: Invoked when a peripheral’s services have changed.
Notes:
invalidatedServices: A list of services that have been invalidated.

This method is invoked whenever one or more services of a peripheral have changed. A peripheral’s services have changed if:
  • A service is removed from the peripheral’s database
  • A new service is added to the peripheral’s database
  • A service that was previously removed from the peripheral’s database is readded to the database at a different location
If you previously discovered any of the services that have changed, they are provided in the invalidatedServices parameter and can no longer be used. You can use the discoverServices method to discover any new services that have been added to the peripheral’s database or to find out whether any of the invalidated services that you were using (and want to continue using) have been added back to a different location in the peripheral’s database.

Feedback, Comments & Corrections

CBPeripheralMBS.DidOpenL2CAPChannel(channel as CBL2CAPChannelMBS, error as NSErrorMBS)
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
event Bluetooth MBS Bluetooth Plugin 18.1 Yes No No No No
Function: Called when channel is opened.

Feedback, Comments & Corrections

CBPeripheralMBS.DidReadRSSI(RSSI as String, error as NSErrorMBS)
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
event Bluetooth MBS Bluetooth Plugin 18.1 Yes No No No No
Function: Invoked after you call readRSSI to retrieve the value of the peripheral’s current RSSI while it is connected to the central manager.
Notes:
peripheral: The peripheral providing this information.
RSSI: The RSSI, in decibels, of the peripheral.
error: If an error occurred, the cause of the failure.

This event is invoked when your app calls the readRSSI method. If successful, the error parameter is nil and the parameter RSSI reports the receiver’s signal strength, in decibels. If unsuccessful, the error parameter returns the cause of the failure.

Feedback, Comments & Corrections

CBPeripheralMBS.DidUpdateName
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
event Bluetooth MBS Bluetooth Plugin 18.1 Yes No No No No
Function: Invoked when a peripheral’s name changes.
Notes: The event is invoked whenever the peripheral device’s Generic Access Profile (GAP) device name has changed. Since a peripheral device can change its GAP device name, you can implement this method if your app needs to display the current name of the peripheral device.

Feedback, Comments & Corrections

CBPeripheralMBS.DidUpdateNotificationStateForCharacteristic(characteristic as CBCharacteristicMBS, error as NSErrorMBS)
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
event Bluetooth MBS Bluetooth Plugin 18.1 Yes No No No No
Function: Invoked when the peripheral receives a request to start or stop providing notifications for a specified characteristic’s value.
Notes:
characteristic: The characteristic for which notifications of its value are to be configured.
error: If an error occurred, the cause of the failure.

This event is invoked when your app calls the setNotifyValue method. If successful, the error parameter is nil. If unsuccessful, the error parameter returns the cause of the failure.

Feedback, Comments & Corrections

CBPeripheralMBS.DidUpdateRSSI(error as NSErrorMBS)
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
event Bluetooth MBS Bluetooth Plugin 18.1 Yes No No No No
Function: Invoked when you retrieve the value of the peripheral’s current RSSI while it is connected to the central manager.
Notes:
error: If an error occurred, the cause of the failure.

This event is invoked when your app calls the readRSSI method. If successful, the error parameter is nil. If unsuccessful, the error parameter returns the cause of the failure.

Feedback, Comments & Corrections

CBPeripheralMBS.DidUpdateValueForCharacteristic(characteristic as CBCharacteristicMBS, error as NSErrorMBS)
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
event Bluetooth MBS Bluetooth Plugin 18.1 Yes No No No No
Function: Invoked when you retrieve a specified characteristic’s value, or when the peripheral device notifies your app that the characteristic’s value has changed.
Notes:
peripheral: The peripheral providing this information.
characteristic: The characteristic whose value has been retrieved.
error: If an error occurred, the cause of the failure.

This method is invoked when your app calls the readValueForCharacteristic: method, or when the peripheral notifies your app that the value of the characteristic for which notifications and indications are enabled (via a successful call to setNotifyValue for Characteristic) has changed. If successful, the error parameter is nil. If unsuccessful, the error parameter returns the cause of the failure.

Feedback, Comments & Corrections

CBPeripheralMBS.DidUpdateValueForDescriptor(descriptor as CBDescriptorMBS, error as NSErrorMBS)
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
event Bluetooth MBS Bluetooth Plugin 18.1 Yes No No No No
Function: Invoked when you retrieve a specified characteristic descriptor’s value.
Notes:
peripheral: The peripheral providing this information.
descriptor: The characteristic descriptor whose value has been retrieved.
error: If an error occurred, the cause of the failure.

This event is invoked when your app calls the readValueForDescriptor method. If successful, the error parameter is nil. If unsuccessful, the error parameter returns the cause of the failure.

Feedback, Comments & Corrections

CBPeripheralMBS.DidWriteValueForCharacteristic(characteristic as CBCharacteristicMBS, error as NSErrorMBS)
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
event Bluetooth MBS Bluetooth Plugin 18.1 Yes No No No No
Function: Invoked when you write data to a characteristic’s value.
Notes:
peripheral: The peripheral providing this information.
characteristic: The characteristic whose value has been written.
error: If an error occurred, the cause of the failure.

This event is invoked only when your app calls the writeValue for Characteristic method with the CBCharacteristicWriteWithResponse constant specified as the write type. If successful, the error parameter is nil. If unsuccessful, the error parameter returns the cause of the failure.

Feedback, Comments & Corrections

CBPeripheralMBS.DidWriteValueForDescriptor(descriptor as CBDescriptorMBS, error as NSErrorMBS)
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
event Bluetooth MBS Bluetooth Plugin 18.1 Yes No No No No
Function: Invoked when you write data to a characteristic descriptor’s value.
Notes:
descriptor: The characteristic descriptor whose value has been written.
error: If an error occurred, the cause of the failure.

This event is invoked when your app calls the writeValue for Descriptor method. If successful, the error parameter is nil. If unsuccessful, the error parameter returns the cause of the failure.

Feedback, Comments & Corrections

CBPeripheralMBS.IsReadyToSendWriteWithoutResponse
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
event Bluetooth MBS Bluetooth Plugin 18.1 Yes No No No No
Function: The peripheral providing this update..
Notes: This event is invoked after a failed call to writeValue for Characteristic, when peripheral is again ready to send characteristic value updates.

Feedback, Comments & Corrections

The items on this page are in the following plugins: MBS Bluetooth Plugin.





Links
MBS Xojo PDF Plugins