Struct bluer::Session

pub struct Session { /* fields omitted */ }

This is supported on crate feature bluetoothd only.

Bluetooth session.

Encapsulates a connection to the system Bluetooth daemon.

Implementations

impl Session

pub async fn new() -> Result<Self>

Create a new Bluetooth session.

This establishes a connection to the system Bluetooth daemon over D-Bus.

pub async fn adapter_names(&self) -> Result<Vec<String>>

Enumerate connected Bluetooth adapters and return their names.

pub fn adapter(&self, adapter_name: &str) -> Result<Adapter>

Create an interface to the Bluetooth adapter with the specified name.

pub async fn register_agent(&self, agent: Agent) -> Result<AgentHandle>

This registers a Bluetooth authorization agent handler.

Every application can register its own agent and for all actions triggered by that application its agent is used.

It is not required by an application to register an agent. If an application does chooses to not register an agent, the default agent is used. This is on most cases a good idea. Only application like a pairing wizard should register their own agent.

An application can only register one agent. Multiple agents per application is not supported.

Drop the returned AgentHandle to unregister the agent.

pub async fn register_profile(&self, profile: Profile) -> Result<ProfileHandle>

This registers a Bluetooth profile implementation for RFCOMM connections.

The returned ProfileHandle provides a stream of connection requests.

Drop the handle to unregister the profile.

pub async fn events(&self) -> Result<impl Stream<Item = SessionEvent>>

Stream adapter added and removed events.

Trait Implementations

impl Clone for Session

fn clone(&self) -> Session

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Session

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.