# Bluetooth Low Energie

## **Description**

Le Bluetooth Low Energy, ou BLE, est utilisé pour connecter sans fil deux appareils entre eux. Le composant BLE permet de trouver et de se connecter à des dispositifs BLE et de communiquer directement avec eux.

{% hint style="info" %}
La fonctionnalité BLE ne peut pas être testée avec l'application [Thunkable Live](https://docs.thunkable.com/get-started/live-test) sur iOS. Pour tester la fonctionnalité BLE de votre application sur iOS, veuillez [télécharger](https://docs.thunkable.com/download#download-and-install-ios-app) votre application.
{% endhint %}

## Vue d'ensemble

La version 1 du composant BLE dans Thunkable ✕ contient 5 fonctions, chacune d'entre elles étant documentée plus en détail ci-dessous.

* Scanner
* Se connecter à l'identifiant de l'appareil
* Se connecter au nom de l'appareil
* Recevoir
* Transmettre

## **Scanner**

Cette fonction est utilisée pour rechercher les appareils BLE ou Bluetooth à proximité. Le balayage s'effectue pendant 10 secondes. Une fois le balayage terminé avec succès, une liste des identifiants d'appareils disponibles et une liste des noms disponibles seront renvoyées. Si la fonction de balayage ne peut pas être terminée, une erreur sera renvoyée.

![](https://549775582-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fthunkable%2F-MT63stds0aOHZjA8FL6%2F-MT68EEN9Q5QFAWPqJbV%2F1.png?generation=1612880083195432\&alt=media)

| Paramètre    | Tapez  | Description                                                  |
| ------------ | ------ | ------------------------------------------------------------ |
| Device IDs   | Liste  | Renvoie une liste des identifiants des appareils disponibles |
| Device Names | Liste  | Renvoie une liste des noms des appareils disponibles         |
| error        | Chaîne | Renvoie un message d'erreur à partir de la fonction          |

## **Se connecter à l'identifiant de l'appareil**

La fonction "`Connect to Device Id`" permet à votre application de se connecter à un appareil compatible BLE basé sur l'identifiant de cet appareil.

![](https://549775582-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fthunkable%2F-MT63stds0aOHZjA8FL6%2F-MT68EEOcJpC7lKS3u-3%2F2.png?generation=1612880083185879\&alt=media)

| Paramètre   | Tapez  | Description                                                                                   |
| ----------- | ------ | --------------------------------------------------------------------------------------------- |
| Device ID   | Chaîne | Attend une chaîne de texte avec l'identifiant de l'appareil auquel vous voulez vous connecter |
| Device Name | Chaîne | Renvoie le nom de l'appareil auquel vous venez de vous connecter                              |
| error       | Chaîne | Renvoie un message d'erreur à partir de la fonction                                           |

## **Se connecter au nom de l'appareil**

Lorsque vous connaissez le nom de l'appareil BLE auquel vous souhaitez vous connecter, vous pouvez utiliser le bloc "`Connect to Device Name`" pour vous y connecter directement. Veuillez noter que les noms des dispositifs ne sont pas uniques et qu'il est relativement facile de changer le nom d'un dispositif BLE.

![](https://549775582-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fthunkable%2F-MT63stds0aOHZjA8FL6%2F-MT68EEP4zA1GYowVfVZ%2F3.png?generation=1612880083184582\&alt=media)

| Paramètre   | Tapez  | Description                                                             |
| ----------- | ------ | ----------------------------------------------------------------------- |
| Device Name | Chaîne | Attend un bloc de texte avec le nom de l'appareil à connecter           |
| Device ID   | Chaîne | Renvoie l'identifiant de l'appareil auquel vous venez de vous connecter |
| error       | Chaîne | Renvoie un message d'erreur à partir de la fonction                     |

## **Recevoir**

Si vous disposez d'un appareil BLE capable d'envoyer des données à un autre appareil, vous devrez utiliser la fonction de `Receive` de votre application afin d'écouter ou de recevoir les données provenant de l'appareil BLE.

![](https://549775582-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fthunkable%2F-MT63stds0aOHZjA8FL6%2F-MT68EEQYhOKmWcuHJe5%2F4.png?generation=1612880083198084\&alt=media)

| Paramètre           | Tapez  | Description                                                                                         |
| ------------------- | ------ | --------------------------------------------------------------------------------------------------- |
| characteristic UUID | Chaîne | Attend un bloc de texte avec un UUID de 32 bits pour le type de BLE, le service ou le profil requis |
| data                | Chaîne | Renvoie une chaîne contenant les informations reçues du dispositif BLE                              |
| error               | Chaîne | Renvoie un message d'erreur à partir de la fonction                                                 |

## **Transmettre**

Si vous devez envoyer des données à un dispositif BLE, vous pouvez utiliser la fonction `Transmit` pour envoyer ces informations.

![](https://549775582-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2Fthunkable%2F-MT63stds0aOHZjA8FL6%2F-MT68EERZYMA-ZBVGdLo%2F5.png?generation=1612880083207420\&alt=media)

| Paramètre           | Tapez  | Description                                                                                         |
| ------------------- | ------ | --------------------------------------------------------------------------------------------------- |
| characteristic UUID | Chaîne | Attend un bloc de texte avec un UUID de 32 bits pour le type de BLE, le service ou le profil requis |
| data                | Chaîne | Attend un bloc de texte avec le message que vous voulez envoyer à votre appareil BLE                |
| error               | Chaîne | Renvoie un message d'erreur à partir de la fonction                                                 |
