Profils Bluetooth

L'API Bluetooth permet d'utiliser des profils Bluetooth. Un profil Bluetooth est une spécification d'interface sans fil pour la communication Bluetooth entre des appareils, comme le profil mains libres. Pour qu'un appareil mobile puisse se connecter à un casque sans fil, les deux appareils doivent être compatibles avec le profil mains libres.

L'API Bluetooth fournit des implémentations pour les profils Bluetooth suivants :

  • Casque. Le profil Headset permet d'utiliser des casques Bluetooth avec des téléphones mobiles. Android fournit la classe BluetoothHeadset, qui est un proxy permettant de contrôler le service de casque Bluetooth. Cela inclut les profils de casque Bluetooth et mains libres (v1.5). La classe BluetoothHeadset est compatible avec les commandes AT. Pour en savoir plus, consultez Commandes AT spécifiques au fournisseur.
  • A2DP. Le profil A2DP (Advanced Audio Distribution Profile) définit la manière dont un contenu audio de haute qualité peut être diffusé d'un appareil à un autre via une connexion Bluetooth. Android fournit la classe BluetoothA2dp, qui est un proxy permettant de contrôler le service Bluetooth A2DP.
  • Appareil de santé. Android est compatible avec le profil d'appareil de santé Bluetooth (HDP). Cela vous permet de créer des applications qui utilisent le Bluetooth pour communiquer avec des appareils de santé compatibles Bluetooth, tels que des moniteurs de fréquence cardiaque, des tensiomètres, des thermomètres et des balances. Pour obtenir la liste des appareils compatibles et de leurs codes de spécialisation de données d'appareil correspondants, consultez Spécialisations de données d'appareil HDP Bluetooth. Ces valeurs sont également référencées dans la spécification ISO/IEEE 11073-20601 [7] en tant que MDC_DEV_SPEC_PROFILE_* dans l'annexe des codes de nomenclature. Pour en savoir plus sur le profil HDP, consultez Health Device Profile.

Voici les étapes de base pour utiliser un profil :

  1. Obtenez l'adaptateur par défaut, comme décrit dans Configuration du Bluetooth.
  2. Configurez un BluetoothProfile.ServiceListener. Cet écouteur avertit les clients BluetoothProfile lorsqu'ils sont connectés au service ou déconnectés de celui-ci.
  3. Utilisez getProfileProxy() pour établir une connexion à l'objet proxy de profil associé au profil. Dans l'exemple suivant, l'objet proxy de profil est une instance de BluetoothHeadset.
  4. Dans onServiceConnected(), obtenez un handle vers l'objet proxy du profil.
  5. Une fois que vous disposez de l'objet proxy de profil, utilisez-le pour surveiller l'état de la connexion et effectuer d'autres opérations pertinentes pour ce profil.

L'extrait de code suivant montre comment se connecter à un objet proxy BluetoothHeadset afin de pouvoir contrôler le profil du casque :

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);

Commandes AT spécifiques au fournisseur

Les applications peuvent s'enregistrer pour recevoir des annonces du système de commandes AT prédéfinies spécifiques au fournisseur envoyées par des casques (comme une commande Plantronics +XEVENT). Par exemple, une application peut recevoir des diffusions indiquant le niveau de batterie d'un appareil connecté, et peut en informer l'utilisateur ou prendre d'autres mesures si nécessaire. Créez un broadcast receiver pour l'intent ACTION_VENDOR_SPECIFIC_HEADSET_EVENT afin de gérer les commandes AT spécifiques au fournisseur pour le casque.

Profil d'appareil de santé

Android est compatible avec le profil d'appareil de santé Bluetooth (HDP, Bluetooth Health Device Profile). L'API Bluetooth Health inclut les classes BluetoothHealth, BluetoothHealthCallback et BluetoothHealthAppConfiguration, qui sont décrites dans la section Classes et interfaces clés.

Lorsque vous utilisez l'API Bluetooth Health, il est utile de comprendre les concepts clés du profil HDP :

Source
Un appareil de santé, tel qu'un pèse-personne, un glucomètre ou un thermomètre, qui transmet des données médicales à un appareil connecté, tel qu'un téléphone ou une tablette Android.
Récepteur
L'appareil connecté qui reçoit les données médicales. Dans une application HDP, le récepteur est représenté par un objet BluetoothHealthAppConfiguration.
Inscription
Processus utilisé pour enregistrer un récepteur afin de communiquer avec un appareil de santé particulier.
Connexion
Processus utilisé pour ouvrir un canal entre un appareil de santé (source) et un appareil connecté (récepteur).

Créer une application HDP

Voici les étapes de base pour créer une application HDP :

  1. Obtenez une référence à l'objet proxy BluetoothHealth. Comme pour les casques et les appareils de profil A2DP standards, vous devez appeler getProfileProxy() avec un BluetoothProfile.ServiceListener et le type de profil HEALTH pour établir une connexion avec l'objet proxy de profil.

  2. Créez un BluetoothHealthCallback et enregistrez une configuration d'application (BluetoothHealthAppConfiguration) qui sert de récepteur d'état.

  3. Établir une connexion à un appareil de santé.

  4. Une fois la connexion à un appareil de santé établie, lisez et écrivez sur l'appareil de santé à l'aide du descripteur de fichier. Les données reçues doivent être interprétées à l'aide d'un gestionnaire de santé, qui implémente les spécifications IEEE 11073.

  5. Une fois l'opération terminée, fermez le canal de santé et désinscrivez l'application. Le canal se ferme également en cas d'inactivité prolongée.