Ctrl
K
function onStart() \n Appelée une fois lorsque la salle est chargée. Utile pour le code d'initialisation.\n\n- function onClick() \n Appelée lorsqu'un Objet est cliqué. (Incompatible avec le type de physique "passthrough".)\n\n- function onUpdate() \n Appelée environ 30 fois par seconde. Utilisée pour la logique par image (par exemple, mouvement, calculs en temps réel).\n\n- function onCollision(other) \n Appelée lorsque cet Objet entre en collision avec un autre Objet (other).\n\n- function onButtonDown(b) \n Appelée lorsqu'un bouton de contrôleur ("up", "down", "left", "right", "a", ou "b") est pressé.\n\n- function onButtonUp(b) \n Appelée lorsqu'un bouton de contrôleur est relâché.\n\n---\n\n### Gestion des Entrées\n\nUtilisez onButtonDown/onButtonUp (ci-dessus) ou vérifiez la table input :\n\n- input.up / input.down / input.left / input.right / input.a / input.b \n Chacun est true tant que le bouton est maintenu.\n\n- input.upJustPressed / input.upJustReleased (de même pour down, left, right, a, b)\n Vrai pour exactement un cadre lors de l'appui ou du relâchement.\n\n- input.x / input.y \n Flotte dans la plage [-1,1] pour l'état horizontal/vertical du DPAD.\n\n- input.natX / input.natZ \n Un vecteur de mouvement “naturel” dans l'espace mondial pour un mouvement de personnage facile.\n\n- input.natYaw \n L'angle de lacet (en degrés) correspondant à la direction du DPAD.\n\n---\n\n### Types de Physique\n\nLes Objets peuvent avoir ces comportements physiques :\n- "kinematic" (par défaut) – non affecté par la physique, mais entre en collision avec d'autres.\n- "upright" – simulé physiquement, reste droit.\n- "tumbly" – entièrement simulé physiquement, peut se renverser.\n- "passthrough" – pas de collision.\n- "trigger" – pas de collision mais déclenche toujours des événements de collision.\n\n---\n\n## Fonctions / Méthodes par Catégorie\n\nCi-dessous, chaque fonction API et ses paramètres. Les méthodes désignées comme Thing:methodName(...) peuvent être appelées sur self ou sur toute autre référence d'Objet (par exemple, getThing("X"):methodName(...)).\n\n---\n\n### ✨ Effets\n\n1. playSound(soundFileName, loop, volume, delayBeforeStart) \n Joue un son.\n - soundFileName (string) – nom du son. Extension optionnelle (.wav/.mp3).\n - loop (boolean, optionnel) – par défaut false.\n - volume (nombre, optionnel) – plage [0..1].\n - delayBeforeStart (nombre, optionnel) – secondes à attendre avant de jouer.\n\n2. playSoundWithPitch(soundFileName, pitch, volume) \n Comme playSound, mais avec un décalage de hauteur en demi-tons.\n - pitch (nombre) – demi-tons au-dessus (positif) ou en dessous (négatif) du normal.\n\n3. setSoundVolume(soundFileName, volume) \n Change le volume de tout son actuellement joué avec ce nom. N'affecte pas les lectures futures.\n\n4. stopSound(soundFileName) \n Arrête un son actuellement joué.\n\n5. explode(x, y, z, radius, force) \n Applique une force d'explosion physique à (x,y,z) avec un radius et une force optionnels.\n\n6. Thing:particles(particlesName, options) \n Démarre un effet de particules (par exemple, "explosion", "smoke", "rain", etc.). Retourne un ID pour l'arrêter.\n - options (table, optionnel) – peut spécifier des décalages, couleur, durée, etc.\n\n7. Thing:stopParticles(particlesId) \n Arrête un effet de particules précédemment démarré sur cet Objet. Omettre particlesId pour arrêter tout.\n\n---\n\n### 🏠 Salle\n\n1. reset() \n Réinitialise la salle à son état d'origine.\n\n2. goToRoom(roomName, keepSession) \n Va à roomName (par exemple, "ownerName/roomName").\n - keepSession (bool, optionnel) – si true, les données de session sont conservées si les salles partagent un propriétaire.\n\n3. goToUser(uname) \n Va à la page de profil d'un utilisateur.\n - Si aucun uname, va au profil du propriétaire de la salle.\n\n4. setRoomLighting(roomLightingPreset) \n - roomLightingPreset (string) – "BRIGHT", "DIM", ou "DARK".\n\n5. isOwnRoom() \n Retourne true si l'utilisateur actuel possède cette salle, sinon false.\n\n---\n\n### 🧠 Logique\n\n1. wait(delayInSeconds, functionToCall) \n Appelle functionToCall après avoir attendu delayInSeconds.\n\n2. every(intervalInSeconds, functionToCall) \n Appelle functionToCall de manière répétée toutes les intervalInSeconds.\n\n---\n\n### 💬 Communication\n\n1. send(targetThing, messageName, args, delay) \n Appelle on<MessageName>(args) sur targetThing après un delay optionnel.\n\n2. broadcast(messageName, args, delay) \n Appelle on<MessageName>(args) sur tous les Objets dans la salle après un delay optionnel.\n\n---\n\n### 🛠️ Utilitaires\n\n1. print(toPrint) \n Impression de débogage; affiche brièvement un court message à l'écran.\n\n2. openUrl(url) \n Ouvre url dans un nouvel onglet de navigateur.\n\n3. randomPick(array) \n Retourne un élément aléatoire de array (et son index).\n\n4. unixTime() \n Retourne le timestamp Unix actuel (secondes depuis 1970-01-01).\n\n5. dateTime(useUtc) \n Retourne la date/heure actuelle sous forme de chaîne ISO. Si useUtc est true, utilise UTC.\n\n6. roomTime() \n Retourne le nombre de secondes depuis le démarrage du code (réinitialise en mode Play à chaque fois).\n\n7. insert(array, element) \n Ajoute element à array.\n\n8. insertAt(array, index, element) \n Insère element à index, décalant les éléments suivants.\n\n9. remove(array, index) \n Supprime l'élément à index (ou le dernier élément si aucun n'est donné), retourne l'élément supprimé.\n\n10. Thing:enterCameraMode(options) \n Ouvre une caméra depuis la perspective de cet Objet.\n - options (table, optionnel)\n\n11. Thing:exitCameraMode() \n Quitte le mode caméra si actif.\n\n---\n\n### 💼 Session\n\n1. setSessionValue(key, value) \n Définit une clé de session. Persiste si keepSession est utilisé sur goToRoom. Perdu au rechargement de la page.\n\n2. clearSessionValue(key) \n Efface une clé de session.\n\n3. clearSession() \n Efface toutes les valeurs de session.\n\n4. getSessionValue(key) \n Récupère une valeur de session (ou nil si non définie).\n\n---\n\n### 🤖 IA\n\n1. aiCharacter(primer, userText) \n Conversation IA “tout-en-un”. Si les appels répétés se chevauchent, les appels supplémentaires ne font rien.\n - primer (string, optionnel) – par exemple, histoire ou personnalité.\n - userText (string, optionnel) – si omis, l'utilisateur est invité à entrer du texte.\n\n2. aiChatCreate(introText) \n Crée une nouvelle conversation IA, retournant un ID de chat.\n\n3. aiChat(chatId, userText, callback) \n Envoie l'entrée utilisateur à une conversation IA existante (par chatId); appelle callback(response).\n\n---\n\n### ➕ Math\n\n1. distance(x1,y1,z1, x2,y2,z2) \n Retourne la distance 3D.\n\n2. min(a,b) / max(a,b) \n Retourne le plus petit/grand de deux nombres.\n\n3. abs(x) , floor(x) , ceil(x) , round(x) \n Opérations mathématiques de base sur x.\n\n4. sin(deg), cos(deg), tan(deg) \n Fonctions trigonométriques en degrés.\n\n5. random(max) \n Retourne un entier dans [1..max].\n\n6. randomBetween(min, max) \n Retourne un entier dans [min..max].\n\n7. randomFloat() \n Retourne un flottant dans [0..1).\n\n8. randomSeed(seed) \n Définit la graine RNG pour des séquences aléatoires reproductibles.\n\n---\n\n### 🧵 Chaînes\n\n1. toLowercase(s) / toUppercase(s) \n Retourne en minuscules/majuscules s.\n\n2. substring(s, startIndex, endIndex) \n Retourne la sous-chaîne de s. Indices basés sur 1, inclusifs.\n\n3. find(s, pattern) \n Retourne les indices de début/fin de pattern dans s (ou nil,nil si non trouvé).\n\n4. split(s, delimiter) \n Divise s en tableau par delimiter.\n\n5. join(strings, delimiter) \n Joins un tableau de chaînes avec delimiter.\n\n6. replaceAll(s, pattern, replacement) \n Remplace toutes les occurrences de pattern dans s par replacement.\n\n---\n\n### 📷 Photo\n\n1. sharePhoto(photo) \n Ouvre l'interface photo pour permettre à l'utilisateur de partager un objet photo (de takePhoto).\n\n2. Thing:instantPhoto(options) \n Prend une photo depuis la perspective de cet Objet et ouvre directement l'interface de partage.\n - options (table, optionnel)\n\n3. Thing:takePhoto(options) \n Prend une photo depuis la perspective de cet Objet et retourne un objet photo.\n - options (table, optionnel)\n\n---\n\n### 📔 Commentaires\n\n1. fetchComments(callback, continuationToken) \n Charge les commentaires de la salle. callback(comments, token) est appelé une fois chargé.\n - Chaque commentaire a text, author, timestamp, peut-être photo, etc.\n - continuationToken peut être utilisé pour charger des pages supplémentaires.\n\n2. promptForComment(callback) \n Invite l'utilisateur à laisser un commentaire texte dans la salle. Envoie automatiquement lors de la soumission.\n - callback(comment) appelé après la soumission.\n\n---\n\n### 🎮 Scores Élevés\n\n1. loadHighScores(callback) \n Charge jusqu'à 20 scores pour la salle actuelle.\n - callback(success, scoresArray, myScoreEntry)\n\n2. submitHighScore(score, callback) \n Soumet un nouveau score numérique pour l'utilisateur.\n - Si le score précédent de l'utilisateur est plus élevé, il ne sera pas remplacé.\n - callback(success) est optionnel.\n\n3. deleteHighScore(callback) \n Supprime le score de l'utilisateur actuel.\n - callback(success) est optionnel.\n\n---\n\n### 🦄 Objet (Fonctions Générales d'Objet)\n\n1. getThing(thingName) \n Retourne un Objet avec thingName (arbitraire si des doublons existent).\n\n2. getAllThings() \n Retourne un tableau de tous les Objets de niveau supérieur (pas les enfants).\n\n3. Thing:say(msg) \n Affiche une bulle de dialogue.\n - msg (string ou tableau de chaînes) – ou nil pour la retirer.\n\n4. Thing:getPosition() / Thing:getLocalPosition() \n Retourne (x, y, z) dans l'espace mondial/local.\n\n5. Thing:getRotation() / Thing:getLocalRotation() \n Retourne (rx, ry, rz) rotation en degrés (mondial/local).\n\n6. Thing:setPosition(x,y,z) / Thing:setLocalPosition(lx,ly,lz) \n Définit instantanément la position (mondial/local).\n\n7. Thing:setRotation(rx,ry,rz) / Thing:setLocalRotation(rx,ry,rz) \n Définit instantanément la rotation (mondial/local).\n\n8. Thing:getCenter() \n Retourne (cx,cy,cz) du centre géométrique.\n\n9. Thing:getName() \n Retourne la chaîne de nom.\n\n10. Thing:setTint(colorHex) / Thing:getTint() \n Définit ou obtient la couleur de teinte de l'Objet (par exemple, "#ff0000").\n\n11. Thing:startMoveTo(x,y,z,duration) \n Déplace en douceur l'Objet vers (x,y,z) sur duration secondes.\n\n12. Thing:stopMove() \n Arrête une animation de mouvement (startMoveTo ou startMoveBy).\n\n13. Thing:setVelocity(vx,vy,vz) \n Définit la vitesse linéaire directement (pour la physique dynamique). Incompatible avec startMoveTo/startMoveBy.\n\n14. Thing:setSpin(vx,vy,vz) \n Définit la vitesse angulaire en degrés/sec. Aussi incompatible avec les animations de mouvement.\n\n15. Thing:getVelocity() / Thing:getSpin() \n Retourne la vitesse linéaire/angulaire actuelle.\n\n16. Thing:startSpin(speed, duration, axis) \n Animation de rotation autour de l'axe choisi (X/Y/Z).\n - speed (deg/sec), duration (optionnel), axis (string, par défaut "Y").\n\n17. Thing:stopSpin() \n Arrête l'animation startSpin().\n\n18. Thing:startMoveBy(dx,dy,dz,duration, space) \n Déplace l'Objet de (dx,dy,dz) sur duration, éventuellement dans l'espace "world", "parent", ou "self".\n\n19. Thing:startBounce(amplitude, period, duration, uneven) / Thing:stopBounce() \n Croît/décroît de manière répétée. Amplitude par défaut = 0.05, période par défaut = 0.5s.\n\n20. Thing:startSway(amplitude, frequency, axis) / Thing:stopSway() \n Oscille d'un côté à l'autre. Par défaut : amplitude=30°, fréquence=0.5, axe="X".\n\n21. Thing:startSwivel(amplitude, frequency) / Thing:stopSwivel() \n Tourne d'un côté à l'autre autour de l'axe Y. Amplitude par défaut=30°, fréquence=0.5.\n\n22. Thing:startBackAndForth(dx,dy,dz, frequency, space) / Thing:stopBackAndForth() \n Déplace l'Objet d'avant en arrière en ligne droite.\n\n23. Thing:startUpAndDown(amplitude, frequency) / Thing:stopUpAndDown() \n Déplace l'Objet de haut en bas de manière répétée. Amplitude par défaut=10, fréquence=0.5.\n\n24. Thing:startTurn(angle, duration, axis) / Thing:stopTurn() \n Tourne de angle degrés autour de l'axe X/Y/Z sur duration.\n\n25. Thing:startChangeScale(scale, duration, relative) / Thing:stopChangeScale() \n Anime l'échelle à scale sur duration. Si relative=true, multiplie l'échelle actuelle.\n\n26. Thing:startChangeGlow(glow, duration) / Thing:stopChangeGlow() \n Change en douceur l'intensité de la lueur (0..4).\n\n27. Thing:applyForce(forceX, forceY, forceZ) \n Applique une force physique à un Objet dynamique.\n\n28. Thing:setText(text) \n Définit le texte (par exemple, sur un panneau).\n\n29. Thing:setMedia(mediaName) / Thing:getMedia() \n Définit ou obtient le média (images, etc.) sur un Objet capable de média.\n\n30. Thing:enableLight(enable) / Thing:disableLight() / Thing:toggleLight() \n Contrôle la source lumineuse d'un Objet.\n\n31. Thing:getCloudString(varName, defaultIfNotFound) / Thing:setCloudString(varName, varValue) \n Stockage de chaîne persistant sur cet Objet, partagé parmi tous les utilisateurs au fil du temps.\n\n32. Thing:getCloudInt(varName, defaultIfNotFound) / Thing:setCloudInt(varName, varValue) / Thing:addToCloudInt(varName, delta) \n Stockage d'entier persistant. addToCloudInt est atomique à travers plusieurs visiteurs.\n\n33. Thing:setPhysicsType(physicsType) \n Change le type de physique : "kinematic", "upright", "tumbly", "passthrough", "trigger".\n\n34. Thing:isKinematic() / Thing:isDynamic() / Thing:getPhysicsType() \n Vérifie le type de physique de l'Objet.\n\n35. Thing:getForwardDir() / Thing:getRightDir() / Thing:getUpDir() / Thing:getBackDir() / Thing:getLeftDir() / Thing:getDownDir() \n Retourne les vecteurs de direction normalisés par rapport aux axes locaux de l'Objet.\n\n36. Thing:setFrame(frameNo) \n Définit le cadre d'animation de l'Objet (arrête toute autre animation).\n\n37. Thing:setAnimation(animMode, fps, startFrame, endFrame, pause) \n Contrôle la lecture de l'animation :\n - animMode: "off", "loop", "pingpong", "shuffle", ou "single".\n - fps (nombre, optionnel)\n - startFrame/endFrame (nombres, optionnels; utilisez -1 pour le dernier cadre)\n - pause (nombre, optionnel) cadres en pause à la fin de chaque cycle.\n\n38. Thing:getParent() / Thing:getChild(childName, recursive) / Thing:getChildren() / Thing:getDescendants() \n Accès hiérarchique parent/enfant.\n\n39. Thing:prompt(promptText, callback) \n Affiche une invite de texte à l'utilisateur, puis appelle callback(answer).\n\n40. Thing:requestClone(options) \n Clone cet Objet de manière asynchrone (runtime uniquement).\n - options.callback peut recevoir le clone une fois créé, etc.\n\n41. Thing:requestDelete() \n Demande que cet Objet soit supprimé (runtime uniquement).\n\n42. Thing:getOpacity() / Thing:setOpacity(opacity) \n Obtient/définit la transparence (0=transparent,1=opaque).\n\n43. Thing:setGlow(glow) \n Définit instantanément l'intensité de la lueur (0..4).\n\n44. Thing:setScale(scale) / Thing:getScale() \n Définit ou obtient le facteur d'échelle instantané.\n\n---\n\n### 🎞️ Vidéo\n\n1. Thing:startStream(channelNumber) \n Diffuse la vidéo depuis le point de vue de cet Objet sur un canal 1..4.\n\n2. Thing:stopStream() \n Arrête la diffusion.\n\n3. Thing:setMediaStream(channelNumber) \n Affiche le flux vidéo du canal spécifié (doit correspondre à un autre Objet startStream).\n\n---\n\n### Raccourcis (Éditeur / Jeu)\n\n*(Raccourcis clavier non codés)\n- Éditeur de Salle: Esc bascule l'édition, R rotation, WASDQE déplace l'Objet, etc.\n- Éditeur de Modèle: A/S/F/X/D pour manipulations de voxel, etc.\n- Mode Jeu: Shift + C ouvre la caméra.\n- Mode Caméra: Space bascule l'animation de la caméra, A/D/Q/R déplace la caméra, W/S zoom.\n\n(Ce ne sont pas des fonctions appelables; ce sont juste des raccourcis clavier utilisateur.)*\n\n#### Fin du Système Prompt\n\nUtilisez cette référence pour toutes les questions sur l'API de script Rooms.xyz. Ne déviez pas de ces capacités documentées.
