Différences
Ci-dessous, les différences entre deux révisions de la page.
Les deux révisions précédentes
Révision précédente
Prochaine révision
|
Révision précédente
Prochaine révision
Les deux révisions suivantes
|
fonctionnement_de_l_api [24/03/2022 09:32] tom.pouderoux |
fonctionnement_de_l_api [24/03/2022 09:39] tom.pouderoux |
==== Utiliser l'API ==== | ==== Utiliser l'API ==== |
| |
Pour utiliser l'API, il suffit d'appeler la classe **API**, de lui spécifier le nombre de valeurs avant d'envoyer les résultats (Défaut : 10), de donner la fonction de retour prenant comme paramètre un tableau bidimensionnel, puis d'appeler **start()** | Pour utiliser l'API, il suffit d'appeler la classe **API**, de lui spécifier le nombre de valeurs avant d'envoyer les résultats (Défaut : 10), de donner la fonction de retour prenant comme paramètre un tableau bidimensionnel, puis d'appeler **start()**. |
| |
| La connexion au casque prend un peu de temps lors de l'appel de **api.connect(port)** et cette fonction est bloquante. L'appel de **start()** provoque un multithreading, rendant cette fonction non bloquante et permettant de faire autre chose une fois **start()** appelé. Il est important d'appeler **stop()** lors de la fin de vie du programme sans quoi le thread restera ouvert et devra être **kill**. |
| |
<code python> | <code python> |
</code> | </code> |
| |
Pour lancer une récupération unique de données plutôt qu'un stream de données, il existe une fonction **acquire** qui récupère des données correspondant à X secondes d'acquisition et retourne ces valeurs sans devoir définir une fonction de retour ou de handler particulier. Idéal pour récupérer des données sous forme de **Dataset** | Pour lancer une récupération unique de données plutôt qu'un stream de données, il existe une fonction **acquire** qui récupère des données correspondant à X secondes d'acquisition et retourne ces valeurs sans devoir définir une fonction de retour ou de handler particulier. Idéal pour récupérer des données sous forme de **Dataset**. |
| |
| **Important : Il est impossible d'appeler __acquire()__ et __start()__ en simultanéité, ces 2 fonctions utilisant la même architecture commune interne posant des conflits graves si utilisés en même temps !** |
| |
<code python> | <code python> |
| |
data = api.acquire(20) #Récupère 20 secondes de valeurs, attend la fin de la récupération puis retourne les valeurs | #Récupère 20 secondes de valeurs, attend la fin de la récupération puis retourne les valeurs |
| data = api.acquire(20) |
| |
</code> | </code> |