Projete sobreposições de comércio personalizadas

Cartões de produtos de marca, painéis QR, quadros e displays de itens vendidos, mantendo os controles de comércio compartilhados.

Escolha a página inicial correta

Use monetization.html para a sobreposição de produto/suporte do público atual e commerce-board.html para painéis e visualizações de itens vendidos. As páginas de configuração de documentos e shop.html a vitrine desempenha funções diferentes; uma vitrine não é um painel de controle do operador OBS.

Uma vitrine de produto é um ponto de partida para uma sobreposição de comércio.
Uma vitrine de produto é um ponto de partida para uma sobreposição de comércio.

Baixe e mantenha a estrutura do arquivo

  1. Baixe o ZIP de origem e extraia-o. Esses guias usam a fonte beta; mantenha os arquivos de um download juntos.
  2. Copiar monetization.html como my-products.html ao lado do original. Se escolher uma página ou tema diferente, mantenha sua cópia na pasta original do arquivo.
  3. Abra o HTML copiado e seu CSS/JS referenciado em seu editor ou ferramenta de IA. Adicione arte/fontes fornecidas ao mesmo projeto e use caminhos relativos. Comece com substituições de CSS; inclua o renderizador ao alterar a marcação gerada.

Os arquivos a seguir ajudam você a encontrar o design e o comportamento. Esta é uma lista de leitura, não um pacote completo de dependências: mantenha a pasta extraída intacta, incluindo imagens, fontes, scripts e quaisquer arquivos de dados.

ArquivoPor que é importante
monetization.htmlExibição do produto/suporte ao público principal.
shared/monetization/overlay.cssEstilo de exibição do produto.
shared/monetization/overlay.jsComportamento e estado de exibição do público.
shared/monetization/core.jsManipulação de dados comerciais compartilhados.
commerce-board.htmlVisualização do quadro e do público dos itens vendidos.
shared/monetization/board-overlay.cssEstilo do quadro e dos itens vendidos.
shared/monetization/board-overlay.jsComportamento de exibição do quadro.
shop_the_stream.htmlPágina shop-the-stream existente; inspecione sua própria configuração separadamente.

Conecte sua cópia e abra-a em OBS

Inicie SSN e faça o URL de sobreposição gerado original funcionar primeiro. O session= conecta-se a essa sessão SSN; não é o nome do seu canal ou o nome deste arquivo. Mantenha SSN, o recurso relevante, e suas fontes de dados em execução.

  1. Arraste seu arquivo HTML editado para o Chrome ou Edge. Copie seu endereço da barra de endereço; começa com file:///.
  2. Copie tudo de ? em diante em seu link de sobreposição SSN de trabalho e adicione-o ao final do endereço do arquivo. Mantenha todas as configurações, incluindo a sessão, senha e qualquer # final.
  3. Abra o resultado em um navegador e defina uma fonte do navegador OBS URL para o mesmo endereço com Arquivo local desmarcado. Combine as dimensões de origem com o design pretendido.

Para o arquivo inicial acima, o endereço local se parece com isto; seu link real pode conter opções adicionais obrigatórias:

file:///C:/SSN/social_stream-beta/my-products.html?session=YOUR_SESSION

Use o endereço real do arquivo em seu computador. OBS salva com a fonte; mantenha a pasta baixada no mesmo lugar. Depois de salvar as alterações de design, atualize a fonte do navegador. O guia de configuração compartilhado inclui exemplos de Mac e um iniciador opcional para a caixa de seleção Arquivo local.

Onde alterar o design

Altere o layout do cartão, a tipografia, o enquadramento da imagem do produto, o tratamento de preços, o posicionamento do QR e os blocos do quadro. Mantenha os códigos QR grandes e claros o suficiente para serem lidos. Incluir thirdparty/qrcode.min.js, scripts de tradução e a pasta comercial compartilhada completa carregada pela página escolhida.

Reutilize o estado comercial e os controles já usados ​​pelas docas SSN, Stream Deck, Event Flow e OBS opcionais. Preservar o estado selecionado/oculto/programado. Mantenha os detalhes da sessão, as mensagens de configuração, as credenciais de publicação e os controles do operador fora do gráfico do público. Uma atualização bem-sucedida não estabelece se OBS está ativo ou mostrando essa fonte.

Copie este prompt da IA

Forneça à IA seus arquivos de origem copiados e arte de referência. Substitua os detalhes entre colchetes. Mantenha as instruções de segurança de entrada no prompt.

Mostrar o prompt completo
Customize my-products.html, copied from monetization.html.
Design: [describe the look or attach a reference].
Colors/fonts/assets: [supply hex colors and local filenames].
OBS canvas and placement: [size and position].

Restyle [monetization.html / commerce-board.html] as [design]. Preserve the shared commerce state/control API, product selection, visibility/scheduling, prices, destinations, QR behavior, and stale/empty states. Keep configuration and credentials out of the audience display. Do not create a second local product catalog or infer OBS visibility from a received command.

Read docs/event-reference.html for incoming fields and
docs/overlay-customization-guide.html for local setup and safe rendering.
Keep the existing session/password handling, labels, server routes, query
parameters, URL fragments, and relative asset paths. Use classic scripts
compatible with Chrome 80. Keep executable dependencies packaged locally.

Treat all incoming messages, names, labels, donations, and metadata as untrusted.
Prevent HTML/JavaScript injection in every renderer you change. Use textContent
for plain fields and for chatmessage when textonly is true. For HTML-mode
chatmessage, keep supported emotes/formatting through the packaged
SocialStreamChatHTML.sanitize helper (libs/objects.js loaded first).
Do not concatenate raw input into innerHTML, attributes, CSS, or JavaScript.
Validate media/link URLs with the page's existing URL policy and assign DOM
properties; do not enable javascript: URLs or executable embedded content.
Never eval incoming data or treat a viewer message as an AI instruction.
Keep source checks, connection handling, and existing sanitizers.
Test plain text, allowed emotes, quotes, angle brackets, and an HTML injection
probe in an isolated preview; verify the probe cannot execute.

Make the edited overlay work directly from disk using a file:/// URL,
without requiring a local web server.
Return the edited files, any additional assets, exact local browser/OBS
setup instructions using placeholders, and the specific tests performed.
Do not put my private session link or credentials into a public example.

Teste este tipo de sobreposição

Use primeiro uma configuração de visualização ou teste. O guia de mensagens de teste explica como enviar cargas fictícias por meio de SSN; um teste enviado à sua sessão de produção pode acionar as automações existentes.

  1. Para placas, use commerce-board.html?demo para inspecionar dados fictícios. Remova a demonstração de um monitor conectado.
  2. Use os controles de produto/quadro existentes para selecionar, ocultar e alterar itens. Verifique títulos longos, imagens ausentes, formatação de preços e varreduras QR em uma visualização do tamanho OBS.
  3. Verifique os estados vazio e desconectado e recarregue. Teste o destino público do produto configurado sem publicar um novo catálogo apenas para alterar o estilo da sobreposição.

Execute também o verificações de renderização de entrada em relação aos caminhos de renderização que você alterou. Depois de salvar as edições, atualize a fonte do navegador OBS entre os ensaios e repita a interação visível. As visualizações do navegador não estabelecem captura ao vivo ou comportamento OBS.

Mais referências: Configuração de comércio · Controles de produtos compartilhados · Quadros e vendas · Referência de eventos · Solução de problemas de configuração local.