Loop Container v1.0

Um Loop é desenhado em um viewport vertical de 360 × 640 (9:16). A plataforma escala essa mesma experiência para celular e desktop.

• No feed, o Loop permanece dentro do card social.
• No desktop, o contêiner vertical continua limitado; o código do Loop não toma conta da página.
• Link Loops incorporáveis declaram Responsivo, Desktop 16:9 ou Celular 9:16. O feed vertical preserva projetos de proporção fixa com barras, sem cortar o conteúdo.
• A área de 140 × 56 px no canto superior direito pertence aos controles do Liveloop: pausa, som e tela cheia. Coloque o HUD do Loop em outro lugar.

O código hospedado é limitado a 1024 KB antes de montar. Mantenha o código autocontido e use assets de dados do Liveloop para conjuntos públicos maiores.

Os formatos hospedados são HTML, React, Markdown, Story de vídeo interativa e chatbots limitados. Projetos externos são Link Loops e permanecem fora do ambiente de execução do Liveloop.

O código hospedado roda em um iframe de origem opaca, com scripts permitidos e sem permissão same-origin. A estrutura da plataforma e as contas dos visitantes ficam fora do container.

• Sem acesso a cookies do Liveloop, armazenamento persistente do navegador, DOM pai, navegação ou estilo da plataforma.
• Sem rede de saída arbitrária ou envio de formulários. Só assets públicos controlados pela plataforma e uma lista curta de bibliotecas criativas com versão fixa ficam disponíveis.
• Câmera, microfone, localização, pagamentos, USB, Bluetooth, área de transferência e tela cheia nativa não estão disponíveis para código arbitrário de Loop.
• Um Link Loop compatível pode rodar em um frame interno isolado após confirmação de responsabilidade e verificação de incorporação. Ele mantém seu próprio domínio, não recebe a sessão do Liveloop e não pode alterar a estrutura da plataforma.

O SDK injetado window.liveloop é opcional: HTML comum continua funcionando. Ele pode expor layout, visibilidade, coordenação de mídia, estado por visitante, dados restritos ao Loop, salas realtime, turnos de chatbot limitados e captura de leads com consentimento.

window.liveloop

Cada solicitação da bridge é vinculada ao Loop atual, validada pelo pai e limitada por taxa. Um Loop nunca recebe uma credencial geral do banco ou a sessão da conta.

O código do Loop executa no navegador de quem vê. Frames públicos podem ser cacheados na CDN; frames fora da tela são pausados ou removidos, e previews pequenos usam um orçamento menor de renderização. Um Loop intenso também deve pausar seu trabalho quando a visibilidade mudar.

SDKs e clientes de IA podem buscar o manifesto JSON versionado abaixo em vez de extrair esta página. Novas versões de contrato receberão um endpoint novo; a v1 permanece estável.

https://www.liveloop.space/api/loop-container/v1

{
  "version": "1.0",
  "viewport": {
    "width": 360,
    "height": 640,
    "aspectRatio": "9:16"
  },
  "presentation": {
    "modes": [
      "feed",
      "fullscreen"
    ],
    "desktop": "bounded-portrait",
    "linkEmbeds": {
      "displayModes": [
        "responsive",
        "desktop",
        "mobile"
      ],
      "feed": "portrait-letterboxed",
      "desktop": "creator-declared"
    },
    "reservedChrome": {
      "corner": "top-right",
      "width": 140,
      "height": 56,
      "owner": "Liveloop"
    }
  },
  "source": {
    "maxBytes": 1048576,
    "supportedKinds": [
      "html",
      "react",
      "markdown",
      "video",
      "chatbot"
    ]
  },
  "execution": {
    "runtime": "viewer-browser",
    "iframeSandbox": "allow-scripts",
    "opaqueOrigin": true,
    "iframeLifecycle": "viewport-scoped",
    "thumbnailFrameRateCap": 30
  },
  "publishing": {
    "accountRequired": true,
    "externalLinkLoopsExecuteInsideLiveloop": true,
    "externalLinkLoopRequirements": [
      "public-https",
      "creator-attestation",
      "framing-permitted"
    ]
  }
}

Clientes de IA que publicam em nome de um criador também devem usar a conexão MCP com escopo do Liveloop.