Ice 3.7 C++11 API Reference
Public Member Functions | List of all members
IceBT::Plugin Class Referenceabstract

Represents the IceBT plug-in object. More...

#include <IceBT/IceBT.h>

Inheritance diagram for IceBT::Plugin:
Inheritance graph
[legend]
Collaboration diagram for IceBT::Plugin:
Collaboration graph
[legend]

Public Member Functions

virtual DeviceMap getDevices () const =0
 Retrieve a snapshot of all known remote devices. More...
 
virtual void startDiscovery (const std::string &address, std::function< void(const std::string &addr, const PropertyMap &props)> cb)=0
 Start Bluetooth device discovery on the adapter with the specified address. More...
 
virtual void stopDiscovery (const std::string &address)=0
 Stops Bluetooth device discovery on the adapter with the specified address. More...
 
- Public Member Functions inherited from Ice::Plugin
virtual void destroy ()=0
 Called when the communicator is being destroyed. More...
 
virtual void initialize ()=0
 Perform any necessary initialization steps. More...
 
virtual ~Plugin ()
 

Detailed Description

Represents the IceBT plug-in object.

Member Function Documentation

◆ getDevices()

virtual DeviceMap IceBT::Plugin::getDevices ( ) const
pure virtual

Retrieve a snapshot of all known remote devices.

The plug-in obtains a snapshot of the remote devices at startup and then dynamically updates its map as the host adds and removes devices.

Returns
A map containing properties for each known device.

◆ startDiscovery()

virtual void IceBT::Plugin::startDiscovery ( const std::string &  address,
std::function< void(const std::string &addr, const PropertyMap &props)>  cb 
)
pure virtual

Start Bluetooth device discovery on the adapter with the specified address.

The given callback will be invoked for each discovered device. The same device may be reported more than once. Discovery remains active until explicitly stopped by a call to stopDiscovery(), or via other administrative means.

Parameters
addressThe address associated with the Bluetooth adapter.
cbThe callback to invoke when a device is discovered.

◆ stopDiscovery()

virtual void IceBT::Plugin::stopDiscovery ( const std::string &  address)
pure virtual

Stops Bluetooth device discovery on the adapter with the specified address.

All discovery callbacks are removed when discovery stops.

Parameters
addressThe address associated with the Bluetooth adapter.

The documentation for this class was generated from the following file: