Profili Bluetooth

L'API Bluetooth include il supporto per l'utilizzo dei profili Bluetooth. Un profilo Bluetooth è una specifica di interfaccia wireless per la comunicazione basata su Bluetooth tra dispositivi, ad esempio il profilo vivavoce. Affinché un dispositivo mobile possa connettersi a un headset wireless, entrambi i dispositivi devono supportare il profilo vivavoce.

L'API Bluetooth fornisce implementazioni per i seguenti profili Bluetooth:

  • Cuffie. Il profilo Headset consente di utilizzare le cuffie Bluetooth con i cellulari. Android fornisce la classe BluetoothHeadset, che è un proxy per il controllo del servizio cuffie Bluetooth. Sono inclusi i profili Cuffie Bluetooth e Vivavoce (v1.5). La classe BluetoothHeadset include il supporto per i comandi AT. Per saperne di più su questo argomento, consulta Comandi AT specifici del fornitore.
  • A2DP. Il profilo Advanced Audio Distribution Profile (A2DP) 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. Android fornisce la classe BluetoothA2dp, che è un proxy per il controllo del servizio Bluetooth A2DP.
  • Dispositivo per la salute. Android supporta il profilo Bluetooth Health Device Profile (HDP). In questo modo puoi creare app che utilizzano il Bluetooth per comunicare con dispositivi per la salute che supportano il Bluetooth, come cardiofrequenzimetri, misuratori di pressione, termometri e bilance. Per un elenco dei dispositivi supportati e dei relativi codici di specializzazione dei dati del dispositivo, consulta Specializzazioni dei dati dei dispositivi HDP di Bluetooth. Questi valori sono indicati anche nella specifica ISO/IEEE 11073-20601 [7] come MDC_DEV_SPEC_PROFILE_* nell'allegato Nomenclature Codes. Per ulteriori informazioni su HDP, consulta Health Device Profile.

Ecco i passaggi di base per lavorare con un profilo:

  1. Ottieni l'adattatore predefinito, come descritto in Configurazione Bluetooth.
  2. Configura un BluetoothProfile.ServiceListener. Questo listener avvisa i client BluetoothProfile quando sono stati connessi o disconnessi dal servizio.
  3. Utilizza getProfileProxy() per stabilire una connessione all'oggetto proxy del profilo associato al profilo. Nell'esempio seguente, l'oggetto proxy del profilo è un'istanza di BluetoothHeadset.
  4. In onServiceConnected(), ottieni un handle per l'oggetto proxy del profilo.
  5. Una volta ottenuto l'oggetto proxy del profilo, utilizzalo per monitorare lo stato della connessione ed eseguire altre operazioni pertinenti per quel profilo.

Il seguente snippet di codice mostra come connettersi a un oggetto proxy BluetoothHeadset per controllare il profilo Headset:

Kotlin

var bluetoothHeadset: BluetoothHeadset? = null

// Get the default adapter
val bluetoothAdapter: BluetoothAdapter? = BluetoothAdapter.getDefaultAdapter()

private val profileListener = object : BluetoothProfile.ServiceListener {

    override fun onServiceConnected(profile: Int, proxy: BluetoothProfile) {
        if (profile == BluetoothProfile.HEADSET) {
            bluetoothHeadset = proxy as BluetoothHeadset
        }
    }

    override fun onServiceDisconnected(profile: Int) {
        if (profile == BluetoothProfile.HEADSET) {
            bluetoothHeadset = null
        }
    }
}

// Establish connection to the proxy.
bluetoothAdapter?.getProfileProxy(context, profileListener, BluetoothProfile.HEADSET)

// ... call functions on bluetoothHeadset

// Close proxy connection after use.
bluetoothAdapter?.closeProfileProxy(BluetoothProfile.HEADSET, bluetoothHeadset)

Java

BluetoothHeadset bluetoothHeadset;

// Get the default adapter
BluetoothAdapter bluetoothAdapter = BluetoothAdapter.getDefaultAdapter();

private BluetoothProfile.ServiceListener profileListener = new BluetoothProfile.ServiceListener() {
    public void onServiceConnected(int profile, BluetoothProfile proxy) {
        if (profile == BluetoothProfile.HEADSET) {
            bluetoothHeadset = (BluetoothHeadset) proxy;
        }
    }
    public void onServiceDisconnected(int profile) {
        if (profile == BluetoothProfile.HEADSET) {
            bluetoothHeadset = null;
        }
    }
};

// Establish connection to the proxy.
bluetoothAdapter.getProfileProxy(context, profileListener, BluetoothProfile.HEADSET);

// ... call functions on bluetoothHeadset

// Close proxy connection after use.
bluetoothAdapter.closeProfileProxy(BluetoothProfile.HEADSET, bluetoothHeadset);

Comandi AT specifici del fornitore

Le app possono registrarsi per ricevere annunci di sistema di comandi AT predefiniti specifici del fornitore inviati dalle cuffie (ad esempio un comando Plantronics +XEVENT). Ad esempio, un'app potrebbe ricevere trasmissioni che indicano il livello batteria di un dispositivo connesso e potrebbe avvisare l'utente o intraprendere altre azioni, se necessario. Crea un broadcast receiver per l'intent ACTION_VENDOR_SPECIFIC_HEADSET_EVENT per gestire i comandi AT specifici del fornitore per le cuffie.

Health Device Profile

Android supporta il profilo Bluetooth Health Device Profile (HDP). L'API Bluetooth Health include le classi BluetoothHealth, BluetoothHealthCallback e BluetoothHealthAppConfiguration, descritte in Classi e interfacce principali.

Quando utilizzi l'API Bluetooth Health, è utile comprendere questi concetti chiave di HDP:

Origine
Un dispositivo per la salute, come una bilancia, un glucometro o un termometro, che trasmette dati medici a uno smart device, come uno smartphone o un tablet Android.
Sink
Lo smart device che riceve i dati medici. In un'app HDP, il sink è rappresentato da un oggetto BluetoothHealthAppConfiguration.
Registrazione
Il processo utilizzato per registrare un sink per la comunicazione con un determinato dispositivo per la salute.
Connessione
Il processo utilizzato per aprire un canale tra un dispositivo per la salute (origine) e uno smart device (sink).

Crea un'app HDP

Ecco i passaggi di base per creare un'app HDP:

  1. Ottieni un riferimento all'oggetto proxy BluetoothHealth. Come per i normali dispositivi con profilo per cuffie e A2DP, devi chiamare getProfileProxy() con un BluetoothProfile.ServiceListener e il tipo di profilo HEALTH per stabilire una connessione con l'oggetto proxy del profilo.

  2. Crea un BluetoothHealthCallback e registra una configurazione dell'app (BluetoothHealthAppConfiguration) che funge da sink di integrità.

  3. Stabilisci una connessione a un dispositivo per la salute.

  4. Una volta stabilita la connessione a un dispositivo per la salute, leggi e scrivi sul dispositivo per la salute utilizzando il descrittore del file. I dati ricevuti devono essere interpretati utilizzando un gestore della salute, che implementa le specifiche IEEE 11073.

  5. Al termine, chiudi il canale di integrità e annulla la registrazione dell'app. Il canale si chiude anche in caso di inattività prolungata.