Incorporar um visualizador

Coloque um visualizador da Any3D na sua página. O quadro carrega um modelo a partir de um endereço https, com um botão que abre o visualizador completo.

  1. 1

    Adicionar o quadro

    Cole um iframe apontando para o Any3D e insira o endereço do seu modelo no parâmetro src. O quadro exibe apenas a tela, com um botão no canto inferior direito que abre o visualizador completo. Abaixo há um exemplo.

    <iframe
      src="https://any3d.cc/pt-BR/embed?src=https%3A%2F%2Fcdn.example.com%2Fmodel.glb"
      title="Modelo 3D"
      style="width:100%;height:480px;border:0"
      loading="lazy"
      allow="fullscreen"
      allowfullscreen
      referrerpolicy="strict-origin-when-cross-origin"
    ></iframe>
    Dica: você pode copiar o prompt abaixo e enviá-lo a um assistente de IA (como Cursor, Claude ou ChatGPT) para gerar o código de incorporação e integrá-lo rapidamente.
    Prompt de integração com IA (clique para expandir/recolher)
    Gere um trecho de código <iframe> para incorporar o visualizador 3D do Any3D em uma página web. Se estiver editando uma página ou componente existente, posicione o <iframe> onde o modelo 3D deve ser exibido. URL base de incorporação: https://any3d.cc/pt-BR/embed Regras de URL e parâmetros: - Parâmetro obrigatório: `src` deve ser a URL HTTPS do modelo, codificada com porcentagem (encodeURIComponent), e enviada como parâmetro de consulta separado (ex.: https://any3d.cc/pt-BR/embed?src=...). Não una a URL bruta diretamente ao caminho. Para 3D Tiles, use o endereço do arquivo tileset.json. - Parâmetros opcionais (omita os que não forem necessários): - `autorotate=1`: gira o modelo automaticamente. Omita para mantê-lo estático. - `theme=light`, `theme=dark` ou `theme=system`: define o tema visual do visualizador. - `bg=transparent`: usa fundo transparente. - `controls`: define os controles do mouse. Deixe vazio ou defina como `auto` para seleção automática com base no tipo de arquivo; ou escolha `standard`, `cad`, `solidworks`, `blender`, `splat` ou `custom`. Controles do mouse: - auto: arquivos CAD usam controles CAD, Gaussian Splatting usa órbita suave e outros arquivos usam órbita padrão. - standard: órbita. Arrastar botão esquerdo gira, botão direito move, roda do mouse aplica zoom. - cad: estilo AutoCAD. Arrastar botão do meio move, Shift+botão do meio gira em órbita, roda do mouse aplica zoom na direção do cursor, sem inércia. Botão esquerdo também gira, direito move. - solidworks: estilo SolidWorks. Botão do meio gira, Ctrl ou Command+botão do meio move, Shift+botão do meio aplica zoom. Roda para frente afasta no cursor, sem inércia. - blender: estilo Blender. Botão do meio gira, Shift+botão do meio move, Ctrl ou Command+botão do meio aplica zoom. Roda aplica zoom no centro da visão, sem inércia. - splat: órbita suave para grandes cenas de Gaussian Splatting. Arraste para orbitar suavemente, clique duplo para definir o ponto de foco. - custom: igual a standard. Requisitos do iframe e observações: - Atributos e estilo: inclua loading="lazy" e style="width:100%;height:480px;border:0" (ajuste conforme o contêiner). - Permissões: deve incluir allow="fullscreen", allowfullscreen e referrerpolicy="strict-origin-when-cross-origin". - Sandbox: caso a página principal aplique sandbox ao iframe, inclua allow-scripts allow-same-origin allow-popups allow-popups-to-escape-sandbox para permitir que o botão no canto inferior direito abra o visualizador completo em uma nova aba. - Hospedagem e CORS: o servidor do modelo deve permitir CORS para https://any3d.cc. O visualizador baixa um único arquivo (como GLB, STL, OBJ, FBX ou PLY); texturas em arquivos separados externos não serão carregadas a menos que estejam embutidas no modelo (como em GLB). Exemplo de referência: <iframe src="https://any3d.cc/pt-BR/embed?src=https%3A%2F%2Fcdn.example.com%2Fmodel.glb" title="Modelo 3D" style="width:100%;height:480px;border:0" loading="lazy" allow="fullscreen" allowfullscreen referrerpolicy="strict-origin-when-cross-origin" ></iframe> Observação: O endereço do modelo no exemplo é um marcador provisório. Substitua src pelo endereço HTTPS real codificado com porcentagem. Não informe controls caso queira que o mouse siga o arquivo automaticamente.
  2. 2

    Onde o modelo fica

    O endereço precisa ser https, e quem hospeda o arquivo precisa permitir que https://any3d.cc leia o arquivo. O navegador de quem visita baixa esse único arquivo, como GLB, STL, OBJ, FBX ou PLY. Para 3D Tiles, use o endereço de tileset.json. A Any3D não guarda uma cópia. Texturas e dados em arquivos separados ficam de fora, a menos que já estejam dentro do modelo, como em um GLB.

  3. 3

    Opções da página

    Os parâmetros abaixo são opcionais. O botão para abrir o visualizador completo permanece visível.

    ParâmetroValorEfeito
    autorotate1Gira o modelo. Sem ele, o modelo fica parado.
    themelight | dark | systemDefine o tema da página.
    bgtransparentDeixa o fundo transparente.
    controlsauto | standard | cad | solidworks | blender | splat | customControles do mouse. Vazio significa auto e segue o arquivo.
    https://any3d.cc/pt-BR/embed
      ?src=https%3A%2F%2Fcdn.example.com%2Fmodel.glb
      &autorotate=1
      &theme=dark
      &bg=transparent
  4. 4

    Abrir o visualizador completo

    O botão abre o visualizador da Any3D correspondente em uma nova aba e passa o mesmo endereço do modelo. Gaussian splats, 3D Tiles e desenhos DWG ou DXF usam o próprio visualizador. Os outros arquivos usam o visualizador de modelos 3D. Se a página de fora colocar o iframe em um sandbox, são necessários allow-popups e allow-popups-to-escape-sandbox para o botão abrir uma aba.