Le bloc Sélection de fichier permet de déclencher l'ouverture du sélecteur de fichiers de l'appareil (navigateur ou système) pour permettre à l'utilisateur d'importer un ou plusieurs fichiers depuis son appareil vers le graphe Celestory.
Ce bloc est essentiel pour les fonctionnalités d'import de documents, comme l'envoi de CV, de pièces jointes, de sauvegardes ou de médias.
📥 Entrées
- multiple (Booléen, désactivé par défaut) : à activer pour permettre à l'utilisateur de choisir plusieurs fichiers en une seule fois. Si désactivé, un seul fichier peut être sélectionné.
- Aucune autre entrée obligatoire : le bloc s'active via le flux entrant et ouvre directement le sélecteur de fichiers.
📤 Sorties
- out (Flux) : Signal indiquant que la sélection (et le chargement) du ou des fichiers est terminée, permettant de poursuivre le flux en toute sécurité.
- file (Ressource Fichier) : Le fichier choisi par l'utilisateur, exploitable dans le graphe. Présent quand "multiple" est désactivé.
- files (Liste de fichiers) : La liste des fichiers choisis par l'utilisateur. Remplace la sortie "file" quand "multiple" est activé.
💡 Exemple d'utilisation
Scénario : Import d'une photo de profil utilisateur
- L'application affiche un écran demandant à l'utilisateur de choisir une photo de profil.
- Un bouton "Sélectionner une image" est cliqué, déclenchant le passage du flux vers le bloc Sélection de fichier.
- L'explorateur de fichiers système s'ouvre, permettant à l'utilisateur de naviguer et de choisir un fichier (ex: profil.jpg).
- Une fois le fichier sélectionné, le bloc génère la sortie file contenant la ressource, et la sortie out signale la fin du processus.
- Le flux se poursuit vers un bloc de traitement d'image (ex: redimensionnement) ou d'enregistrement dans une base de données.
🧩 Disponibilité et rendu selon le modèle
- Disponible dans les modèles Chatbot et Visual Novel.
- Visual Novel : le bloc affiche un bouton centré (« Choisir un fichier », ou « Choisir des fichiers » quand "multiple" est activé) sur un voile semi-transparent posé sur la scène. L'histoire reprend dès qu'un fichier est choisi ; si le joueur ferme le sélecteur sans rien choisir, le bouton reste affiché.
Disponible dans le modèle Visual Novel à partir de la version 6.1 du Creator.
⚙️ Détails Techniques
- Contraintes de sécurité : Le bloc doit être déclenché par une action utilisateur explicite (ex: clic sur un bouton) pour éviter les blocages par les navigateurs ou les politiques CORS.
- Gestion des erreurs : Si l'utilisateur annule la sélection, le flux peut être redirigé vers une alternative (ex: message d'erreur ou retour en arrière).
- Sélection multiple : Activer "multiple" change aussi la sortie du bloc, qui passe de "file" (un seul fichier) à "files" (une liste de fichiers).
Version documentée : v3