search

alexlagorce / CohomaUnity

1 stars 0 forks source link

readme

CoHoMa Unity

Projet Unity client à héberger sur un casque de réalité virtuelle Pico 4. Permet de communiquer avec un serveur ROS afin d'échanger des informations avec des drones.

Installation

Être à la racine de ce dossier pour exécuter toutes les commandes

Prérequis

Installation de Unity Hub

Unity Hub est un outil qui permet de gérer les différentes versions de Unity et les différents projets installés sur votre machine. Il est recommandé de l'installer pour faciliter la gestion des projets Unity.

Pour cela, ajoutez les droits en exécutant la commande suivante:

chmod +x install_unity_hub.sh

Puis, exécuter le script suivant dans votre terminal:

./install_unity_hub.sh

Ensuite, ouvrez Unity Hub et veuillez créer un compte Unity.

Enfin, veuillez ajouter une License personnal.

Installation de l'éditeur Unity

L'éditeur Unity est l'outil de développement pour les projets Unity. C'est ce logiciel qui permet de créer, modifier et compiler les projets Unity. Le projet CoHoMa Unity a été développé avec la version 2021.3.33f1 de Unity. Il est recommandé d'installer cette version pour éviter tout problème de compatibilité. Pour cela, ajoutez les droits en exécutant la commande suivante:

chmod +x install_unity_editor.sh

Puis, exécuter le script suivant dans votre terminal:

./install_unity_editor.sh

Ensuite, veuillez suivre l'assistant de téléchargement de Unity en acceptant les conditions d'utilisation et en choisissant le composant Unity 2021.3.33f1 et le composant Android Build Support.

Installation du projet CoHoMaUnity

Pour installer le projet CoHoMa Unity, il faut créer un nouveau projet Unity et y importer les fichiers du projet CoHoMa Unity.

Pour cela, ajoutez les droits en exécutant la commande suivante:

chmod +x create_unity_project.sh

Puis, exécuter le script suivant dans votre terminal:

./create_unity_project.sh

Ensuite, fermez la fenêtre de Unity ou quittez le terminal qui à crée le projet pour passer à la section suivante.

Création du lien symbolique du dossier Assets

Cette étape est nécessaire pour que le projet Unity puisse accéder aux fichiers du projet CoHoMa Unity. Elle consiste à supprimer le dossier Assets du projet Unity et à le remplacer par un lien symbolique pointant vers le dossier Assets du projet CoHoMa Unity.

Pour cela, ajoutez les droits en exécutant la commande suivante:

chmod +x create_unity_symbolics_links.sh

Puis, exécuter le script suivant dans votre terminal:

./create_unity_symbolics_links.sh

Une fois cette étape terminée, vous pouvez ouvrir le projet Unity CoHoMa Unity.

Utilisation

Ouverture du projet CohomaUnity

Cette étape consiste à ouvrir le projet Unity CoHoMa Unity.

Ajoutez les droits en exécutant la commande suivante:

chmod +x open_unity_project.sh

Puis, exécuter le script suivant dans votre terminal:

./open_unity_project.sh

Ajout du package ROS

Dans l'onglet Window, ouvrir le Package Manager et cliquer sur le bouton + en haut à gauche. Sélectionner Add package from git URL et entrer https://github.com/Unity-Technologies/ROS-TCP-Connector.git?path=/com.unity.robotics.ros-tcp-connector afin d'installer le package.

RosPackage

Réglages ROS2 et Docker

Dans l'onglet Robotics/ROS Settings, entrez l'adresse IP de la machine qui lance le conteneur Docker (127.0.0.1 par défaut) et changer le Protocol en ROS2.

Ros2Settings

Ajout du package PICO-Unity-Ingegration-SDK

Dans l'onglet Window, ouvrir le Package Manager et cliquer sur le bouton + en haut à gauche, Sélectionner Add package from git URL et entrer https://github.com/Pico-Developer/PICO-Unity-Integration-SDK.git? afin d'installer le package ( même manipulation que pour le package ROS ).

Ajout des autres packages

Dans l'onglet Window, ouvrir le Package Manager et cliquer sur le bouton + en haut à gauche, Sélectionner Add package by name et entrer le nom du package à installer. Par exemple pour installer le package Burst, entrer com.unity.burst.

Les packages à installer sont les suivants: