Installation

(1) Configuration avec Scratch 2.0

L'ensemble de ces actions ne sont nécessaires qu'à la première utilisation. Par la suite, il suffira juste de lancer Blackvoxel et Scratch et de charger l'extension Javascript pour Scratch.

La première action est de configurer Blackvoxel en mode fenêtré. De cette manière, vous pourrer travailler avec Blackvoxel et Scratch sur le même écran.

• Lancez Blackvoxel et cliquez sur "Options", puis sur "Display" et décochez la case "Full Screen"
• Eventuellement, vous pouvez configurer une résolution plus basse de manière à avoir une fenêtre plus petite
  
• Cliquez sur "Save" et quittez Blackvoxel
  

Ensuite, il est nécessaire d'activer l'extension serveur de communication dans Blackvoxel. Celui ci est désactivé par défaut. Ce dernier permet à un logiciel externe comme Scratch d'envoyer des commandes au robot piloté (Remote Robot).

• Relancez Blackvoxel, cliquez sur "Options", puis dans "Gameplay".
• Cochez la case "Web Extnsions".
• Eventuellement, cochez la case "School Mode" (si vous désirez jouer en mode normal, ne la cochez pas).
• Cliquez sur "Save" et revenez au menu principal.
  
• Maintenant, vous pouvez lancer le jeu.
• Sur le système d'exploitation Windows, une boite de dialogue du firewall apparaitra demandant s'il faut autoriser Blackvoxel à utiliser le réseau pour communiquer. Blackvoxel utilise le système de sockets réseau TCP/IP pour communiquer avec Scratch, il faut donc autoriser cette communication pour que cela fonctionne.
  
• Vous êtes maintenant dans le jeu. Si vous avez activé le mode éducation "School Mode", vous pouvez utiliser les touches "J" et "K" keys pour obtenir le robot piloté (couleur orange). Si le mode jeu n'est pas activé, vous devrez suivre les instructions de fabrication comme pour n'importe quel autre élément du jeu.
  
• Placez le robot piloté dans l'univers.
  

La dernière chose à faire est de lancer Scratch dans votre navigateur. L'utilisation avec Blackvoxel nécessite de charger une extension écrite en Javascript. Pour cela, nous allons utiliser la version de Scratch appelée "ScratchX" car la version standard ne permet pas de charger des extensions. Votre navigateur doit supporter le Flash Player pour faire tourner Scratch 2.0.

• Téléchagez le plug-in d'extension Blackvoxel pour Scratch ici et décomprimez cette archive.
  
• Lancez votre navigateur.
• Rendez vous à l'adresse suivante : http://www.scratchx.org/#scratch
• Repérez le bouton "Load Experimental  Extension" dans le coin en haut à droite. Maintenez la touche SHIFT et cliquez dessus en maintenant la touche. Il est très important que la touche soit maintenue enfoncée pendant le clic.
  
• Dans le sélecteur de fichier, indiquez l'endroit ou vous avez décomprimé l'archive téléchargée plus haut. Plusieurs fichiers sont disponibles. Choissez celui qui correspond à votre langue.
• A ce point, tout est prêt à l'usage. Les blocs pour contrôler le robot dans Blackvoxel se trouvent dans la section "More Blocks" de Scratch.
• Utilisez la touche F4 quand vous êtes dans Blackvoxel pour passer à Scratch. Pour repasser à Blackvoxel, il suffira de cliquer dans la fenêtre de Blackvoxel.
  

Blackvoxel utilise le systeme réseau TCP/IP pour communiquer avec Scratch, il est possible de lancer Blackvoxel sur un ordinateur et de lancer Scratch sur un autre (ou sur une tablette). Vous devrez pour cela utiliser dans Scratch le bloc de commande "Avancé" avec l'option "IP" pour sélectionner l'adresse IP de la machine Blackvoxel dans Scratch.

(2) Utiliser un autre langage externe.

L'extension serveur de communication dans Blackvoxel est basé sur un système standard de type "requête Ajax". Il n'est pas limité à l'usage avec Scratch et peut être utilisé avec n'importe quel langage, y compris Javascript dans un navigateur. Quans l'extension serveur de communication est activée, Blackvoxel fournit un serveur web http qui attend les requêtes de commande pour le robot sur le port 48559. Plus d'informations viendront. Dans l'attente, vous pouvez regarder dans les extensions Javascript pour Scratch qui montrent l'ensemble des commandes possibles.