La piattaforma Android include il supporto per lo stack di rete Bluetooth, che consente a un dispositivo di scambiare dati in modalità wireless con altri dispositivi Bluetooth. Il framework dell'app fornisce l'accesso alla funzionalità Bluetooth tramite le API Bluetooth. Queste API consentono alle app di connettersi ad altri dispositivi Bluetooth, attivando funzionalità wireless point-to-point e multipoint.
Utilizzando le API Bluetooth, un'app può eseguire le seguenti operazioni:
- Cerca altri dispositivi Bluetooth.
- Eseguire query sull'adattatore Bluetooth locale per i dispositivi Bluetooth accoppiati.
- Stabilire canali RFCOMM.
- Connettiti ad altri dispositivi tramite Service Discovery.
- Trasferire dati da e verso altri dispositivi.
- Gestire più connessioni.
Questo documento si concentra su Bluetooth Classic. Il Bluetooth classico è la scelta giusta per le operazioni che consumano più batteria, tra cui lo streaming e la comunicazione tra dispositivi. Per i dispositivi Bluetooth con requisiti di alimentazione ridotti, valuta la possibilità di utilizzare connessioni Bluetooth Low Energy.
Questa documentazione descrive i diversi profili Bluetooth e spiega come utilizzare le API Bluetooth per svolgere le quattro attività principali necessarie per comunicare tramite Bluetooth:
- Configurazione del Bluetooth.
- Ricerca di dispositivi accoppiati o disponibili nell'area locale.
- Connessione dei dispositivi.
- Trasferimento di dati tra dispositivi.
Nozioni di base
Affinché i dispositivi con Bluetooth possano trasmettere dati tra loro, devono prima formare un canale di comunicazione utilizzando una procedura di accoppiamento. Un dispositivo, un dispositivo rilevabile, si rende disponibile per le richieste di connessione in entrata. Un altro dispositivo trova il dispositivo rilevabile utilizzando un processo di Service Discovery. Dopo che il dispositivo rilevabile accetta la richiesta di accoppiamento, i due dispositivi completano un processo di associazione in cui si scambiano le chiavi di sicurezza. I dispositivi memorizzano queste chiavi nella cache per un utilizzo successivo.
Al termine dei processi di accoppiamento e associazione, i due dispositivi si scambiano informazioni. Al termine della sessione, il dispositivo che ha avviato la richiesta di accoppiamento rilascia il canale che lo aveva collegato al dispositivo rilevabile. Tuttavia, i due dispositivi rimangono accoppiati, quindi possono riconnettersi automaticamente durante una sessione futura, purché siano nel raggio d'azione l'uno dell'altro e nessuno dei due abbia rimosso l'accoppiamento.
L'utilizzo delle API Bluetooth richiede la dichiarazione di diverse autorizzazioni nel file manifest. Successivamente, accedi a BluetoothAdapter e
determina se il Bluetooth è disponibile sul dispositivo. Se il Bluetooth è disponibile, segui questi tre passaggi:
- Trovare dispositivi Bluetooth nelle vicinanze, sia quelli già accoppiati sia quelli nuovi.
- Connettiti a un dispositivo Bluetooth.
- Trasferisci i dati con il dispositivo connesso.
Alcuni dispositivi utilizzano un profilo Bluetooth specifico che dichiara i dati che fornisce.
Classi e interfacce principali
Tutte le API Bluetooth sono disponibili nel pacchetto android.bluetooth.
Di seguito sono riportate le classi e le interfacce necessarie per creare connessioni Bluetooth:
BluetoothAdapter- Rappresenta l'adattatore Bluetooth locale (radio Bluetooth).
BluetoothAdapterè il punto di accesso per tutte le interazioni Bluetooth. Utilizzando questo, puoi rilevare altri dispositivi Bluetooth, eseguire query su un elenco di dispositivi accoppiati, creare un'istanza di unBluetoothDeviceutilizzando un indirizzo MAC noto e creare unBluetoothServerSocketper ascoltare le comunicazioni da altri dispositivi. BluetoothDevice- Rappresenta un dispositivo Bluetooth remoto. Utilizza questa classe per richiedere una connessione
con un dispositivo remoto tramite un
BluetoothSocketo per eseguire query su informazioni relative al dispositivo, come nome, indirizzo, classe e stato di accoppiamento. BluetoothSocket- Rappresenta l'interfaccia per un socket Bluetooth (simile a un
SocketTCP). Questo è il punto di connessione che consente a un'app di scambiare dati con un altro dispositivo Bluetooth utilizzandoInputStreameOutputStream. BluetoothServerSocket- Rappresenta un socket server aperto che rimane in ascolto delle richieste in arrivo (simile a un
ServerSocketTCP). Per connettere due dispositivi, uno deve aprire un socket server con questa classe. Quando un dispositivo Bluetooth remoto effettua una richiesta di connessione a questo dispositivo, quest'ultimo accetta la connessione e restituisce unBluetoothSocketconnesso. BluetoothClass- Descrive le caratteristiche e le funzionalità generali di un dispositivo Bluetooth. Si tratta di un insieme di proprietà di sola lettura che definisce le classi e i servizi del dispositivo. Sebbene queste informazioni forniscano un suggerimento utile sul tipo di dispositivo, gli attributi di questa classe non descrivono necessariamente tutti i profili e i servizi Bluetooth supportati dal dispositivo.
BluetoothProfile- Un'interfaccia che rappresenta un profilo Bluetooth. Un profilo Bluetooth è una specifica di interfaccia wireless per la comunicazione basata su Bluetooth tra dispositivi. Un esempio è il profilo vivavoce. Per ulteriori informazioni sui profili, consulta la sezione Profili Bluetooth.
BluetoothHeadset- Fornisce supporto per l'utilizzo di cuffie Bluetooth con i cellulari. Sono inclusi sia il profilo per cuffie Bluetooth sia il profilo vivavoce (v1.5).
BluetoothA2dp- Definisce il modo in cui l'audio di alta qualità può essere riprodotto in streaming da un dispositivo a un altro tramite una connessione Bluetooth utilizzando il profilo Advanced Audio Distribution Profile (A2DP).
BluetoothHealth- Rappresenta un proxy del profilo del dispositivo per la salute che controlla il servizio Bluetooth.
BluetoothHealthCallback- Una classe astratta che utilizzi per implementare i callback
BluetoothHealth. Devi estendere questa classe e implementare i metodi di callback per ricevere aggiornamenti sulle modifiche allo stato di registrazione dell'app e allo stato del canale Bluetooth. BluetoothHealthAppConfiguration- Rappresenta una configurazione dell'app che l'app di terze parti Bluetooth Health registra per comunicare con un dispositivo Bluetooth Health remoto.
BluetoothProfile.ServiceListener- Un'interfaccia che invia una notifica ai client di comunicazione tra processi (IPC)
BluetoothProfilequando vengono connessi o disconnessi dal servizio interno che esegue un determinato profilo.