- Documentation
- Fonctionnalités
Guide du portail
Un portail est une porte qui montre un autre monde. Elle se dresse sur votre sol (ou dans un poster), vous regardez à travers, et avec le suivi du monde vous pouvez la traverser : le monde remplit l'écran, et tourner le téléphone permet de regarder autour. Repassez la porte et la vraie pièce revient. De l'intérieur, la porte est un trou dans le monde : regardez en arrière à travers elle et vous voyez la vraie pièce.
Essayez-le depuis la bibliothèque d'expériences : Une porte sur le sol (Android avec Chrome) et Une fenêtre dans un poster (tout téléphone).
Dans un fichier de scène
Un portail est un asset, et un nœud le montre sur une ancre. Son monde est une photo 360 ou une pièce en 3D.
{
"assets": [
{ "id": "savanna", "type": "image", "src": "savanna.jpg", "projection": "equirect" },
{ "id": "door", "type": "portal", "world": "savanna", "width": 1, "height": 2,
"frame": { "color": "#c9a45c", "thickness": 0.06 } }
],
"nodes": [{ "id": "gate", "asset": "door", "anchor": "spot" }],
"behaviors": [
{ "on": "enter", "from": "gate", "do": "show", "node": "welcome" },
{ "on": "exit", "from": "gate", "do": "hide", "node": "welcome" }
]
}
| Champ | Ce qu'il fait |
|---|---|
world | L'asset derrière la porte : une image avec "projection": "equirect" (une photo 360, deux fois plus large que haute), ou un model (une pièce). |
width, height | La taille de l'ouverture, dans les unités du suivi : des mètres pour le suivi du monde, des largeurs d'image pour une cible image. Par défaut 1 et 2. |
frame | Un cadre autour de l'ouverture, color et thickness. Sans lui, l'ouverture n'a pas de cadre. |
worldScale | Change l'échelle du monde. 1 garde un modèle dans ses unités. Pour un poster, une petite valeur comme 0.05 réduit le monde pour qu'il tienne. |
background | La couleur du ciel autour d'un monde en modèle. Une photo 360 n'en a pas besoin. |
La porte se tient sur l'ancre : le milieu de son bord bas est la position du nœud, elle regarde vers +Z, et le monde est derrière elle, le long de -Z. Construisez une pièce avec sa porte dans le plan z = 0, le sol à y = 0 et la pièce qui part vers -Z. Tout ce qui dépasse devant la porte est coupé.
Deux façons de l'utiliser
- Suivi du monde (Android, Chrome) : le portail se dresse sur le sol ou un mur. On peut entrer. Les comportements
enteretexitnomment le nœud portail avecfrom. - Cible image (tout téléphone) : le portail est une fenêtre dans l'image. On regarde dedans, on ne peut pas entrer : une cible image est perdue de vue quand le téléphone s'approche.
enteretexitsont refusés dans une scène image.
Sans RA (iPhone, pour l'instant), une scène du monde avec un viewer montre le monde dans la visionneuse 3D, sans porte, pour qu'on puisse regarder autour.
Bon à savoir
- Les photos 360 sont gardées à 4096 sur 2048 pixels au plus. Un JPEG de 1 Mo est une bonne taille.
- Lumière : un monde en modèle est éclairé par les lumières de la scène, comme tout modèle. Une photo 360 n'est pas éclairée : elle s'affiche telle quelle.
- Téléphones : aucun tampon stencil n'est utilisé, donc cela marche pareil dans A-Frame, Three.js et le Viewer. Le coût est un dessin de plus pour la porte.
- La console de test (
?test) montreoutside,insideet la distance à la porte.