Incorporare un visualizzatore

Metti un visualizzatore Any3D nella tua pagina. Il riquadro carica un modello da un indirizzo https, con un pulsante che apre il visualizzatore completo.

  1. 1

    Aggiungere il riquadro

    Incolla un iframe che punta ad Any3D e inserisci l'indirizzo del modello nel parametro src. Il riquadro mostra solo la tela, con un pulsante in basso a destra che apre il visualizzatore completo. Di seguito trovi un esempio.

    <iframe
      src="https://any3d.cc/it-IT/embed?src=https%3A%2F%2Fcdn.example.com%2Fmodel.glb"
      title="Modello 3D"
      style="width:100%;height:480px;border:0"
      loading="lazy"
      allow="fullscreen"
      allowfullscreen
      referrerpolicy="strict-origin-when-cross-origin"
    ></iframe>
    Suggerimento: puoi copiare il prompt sottostante e passarlo a un assistente IA (come Cursor, Claude o ChatGPT) per generare rapidamente il codice di incorporamento.
    Prompt per integrazione IA (fai clic per espandere/comprimere)
    Genera un frammento di codice <iframe> per incorporare il visualizzatore 3D di Any3D in una pagina web. Se stai modificando una pagina o un componente esistente, inserisci l'<iframe> nella posizione in cui deve comparire il modello 3D. URL di base per l'incorporamento: https://any3d.cc/it-IT/embed Regole URL e parametri: - Parametro obbligatorio: `src` deve essere l'URL HTTPS del modello, codificato in percentuale (encodeURIComponent), e passato come parametro di query indipendente (es. https://any3d.cc/it-IT/embed?src=...). Non unire l'URL grezzo direttamente al percorso. Per 3D Tiles, usa l'indirizzo del file tileset.json. - Parametri opzionali (omettere quelli non necessari): - `autorotate=1`: ruota automaticamente il modello. Omettere per mantenerlo fermo. - `theme=light`, `theme=dark` o `theme=system`: imposta il tema del visualizzatore. - `bg=transparent`: imposta uno sfondo trasparente. - `controls`: sceglie la disposizione dei controlli del mouse. Lascia vuoto o imposta `auto` per la selezione automatica in base al tipo di file; oppure imposta `standard`, `cad`, `solidworks`, `blender`, `splat` o `custom`. Controlli del mouse: - auto: i file CAD usano i controlli CAD, Gaussian Splatting usa l'orbita fluida, gli altri file usano l'orbita standard. - standard: orbita. Trascina con tasto sinistro per ruotare, tasto destro per traslare, rotellina per zoomare. - cad: stile AutoCAD. Trascina con tasto centrale per traslare, Shift+tasto centrale per ruotare, rotellina zooma verso il cursore, senza inerzia. Tasto sinistro ruota anche, tasto destro trasla. - solidworks: stile SolidWorks. Tasto centrale ruota, Ctrl o Cmd+tasto centrale trasla, Shift+tasto centrale zooma. Rotellina in avanti rimpicciolisce sul cursore, senza inerzia. - blender: stile Blender. Tasto centrale ruota, Shift+tasto centrale trasla, Ctrl o Cmd+tasto centrale zooma. Rotellina zooma al centro della vista, senza inerzia. - splat: orbita fluida ideale per grandi scene Gaussian Splatting. Trascina per orbitare in modo continuo, doppio clic per impostare il punto di fuoco. - custom: corrisponde a standard. Requisiti dell'iframe e note: - Attributi e stile: includere loading="lazy" e style="width:100%;height:480px;border:0" (adatta alle dimensioni del contenitore). - Permessi: deve includere allow="fullscreen", allowfullscreen e referrerpolicy="strict-origin-when-cross-origin". - Sandbox: se la pagina genitore applica sandbox all'iframe, aggiungere allow-scripts allow-same-origin allow-popups allow-popups-to-escape-sandbox affinché il pulsante in basso a destra possa aprire il visualizzatore completo in una nuova scheda. - Hosting e CORS: il server che ospita il modello deve consentire CORS a https://any3d.cc. Il visualizzatore scarica un singolo file (es. GLB, STL, OBJ, FBX, PLY); le texture in file esterni separati non verranno caricate a meno che non siano integrate nel modello (come nei file GLB). Esempio di riferimento: <iframe src="https://any3d.cc/it-IT/embed?src=https%3A%2F%2Fcdn.example.com%2Fmodel.glb" title="Modello 3D" style="width:100%;height:480px;border:0" loading="lazy" allow="fullscreen" allowfullscreen referrerpolicy="strict-origin-when-cross-origin" ></iframe> Nota: L'indirizzo del modello nell'esempio è un segnaposto. Sostituisci il valore di src con l'indirizzo HTTPS reale codificato in percentuale. Non impostare controls quando i controlli del mouse devono adattarsi automaticamente al file.
  2. 2

    Dove sta il modello

    L’indirizzo deve essere https, e chi ospita il file deve consentire a https://any3d.cc di leggerlo. Il browser di chi visita scarica quel solo file, per esempio GLB, STL, OBJ, FBX o PLY. Per i 3D Tiles usa l’indirizzo di tileset.json. Any3D non ne conserva una copia. Texture e dati in file separati mancano, a meno che non siano già dentro il modello, come in un GLB.

  3. 3

    Opzioni della pagina

    I parametri seguenti sono facoltativi. Il pulsante che apre il visualizzatore completo resta visibile.

    ParametroValoreEffetto
    autorotate1Fa ruotare il modello. Se lo ometti, resta fermo.
    themelight | dark | systemImposta il tema della pagina.
    bgtransparentRende lo sfondo trasparente.
    controlsauto | standard | cad | solidworks | blender | splat | customControlli del mouse. Vuoto significa auto e segue il file.
    https://any3d.cc/it-IT/embed
      ?src=https%3A%2F%2Fcdn.example.com%2Fmodel.glb
      &autorotate=1
      &theme=dark
      &bg=transparent
  4. 4

    Aprire il visualizzatore completo

    Il pulsante apre il visualizzatore Any3D adatto in una nuova scheda e passa lo stesso indirizzo del modello. I Gaussian splat, i 3D Tiles e i disegni DWG o DXF usano il proprio visualizzatore. Gli altri file usano il visualizzatore di modelli 3D. Se la pagina che contiene l’iframe usa sandbox, servono allow-popups e allow-popups-to-escape-sandbox perché il pulsante apra una scheda.