Execute tarefas comuns do Bannerify pelas Quick Actions do Figma sem abrir o painel do plugin. Escolha um dos atalhos nomeados abaixo. Use o painel normal do plugin para configurações detalhadas e para criar conteúdo.
Executar uma Quick Action
Todo atalho exige uma licença válida verificada ou testes restantes. Se a verificação falhar ou seus testes tiverem acabado, abra o painel normal do plugin para ativar sua licença. Abrir o painel continua disponível.
- Selecione as camadas com que você quer trabalhar, se o atalho usar uma seleção.
- Abra as Quick Actions do Figma com Command + / no Mac ou Ctrl + / no Windows.
- Pesquise o plugin e escolha o atalho nomeado abaixo.
- Preencha os campos exibidos. Os campos opcionais podem ser ignorados; use Tab para editá-los. Execute o atalho e confira o resultado ou conclua a caixa de diálogo de salvamento.
Os atalhos de criação pedem nomes ou dimensões diretamente. Os atalhos de camadas selecionadas usam a seleção atual automaticamente. Esses atalhos do dia a dia não pedem Target nem JSON. Escolha Open Bannerify para abrir o painel normal do plugin.
| Atalho | Campos |
|---|---|
| Export Selected Banners (Custom Settings…) | Format (optional), Frames or sections (optional) |
| Create Resized Copies (Custom Settings…) | Name, Width (px), Height (px), Resize mode |
Os campos de opções fixas usam rótulos legíveis. Pesquise pelo rótulo exibido ou pelo valor correspondente; as entradas de agentes continuam usando os valores mostrados na referência de comandos.
Create Resized Copies cria novos banners e mantém os originais. Escolha Standard Resize ou Smart Layout explicitamente; o modo de layout salvo não pode substituir essa escolha.
Executar pelo menu de contexto
Selecione as camadas desejadas, clique com o botão direito e escolha Plugins → Bannerify (os plugins em desenvolvimento aparecem em Development). Escolha uma ação e o formato ou a predefinição dela. Uma predefinição é executada na hora quando não precisa de nenhum campo obrigatório; conclua a caixa de diálogo de salvamento quando ela aparecer.
Cada predefinição define a opção indicada no nome. As opções compatíveis omitidas herdam as configurações salvas do plugin; uma ação ou opção explícita tem prioridade sobre um comportamento salvo conflitante. Somente os campos preenchidos explicitamente ou a opção escolhida no menu substituem essas configurações naquela execução. Se uma configuração nunca foi salva, vale a configuração normal ou a alternativa documentada. As substituições de exportação não são salvas nas suas preferências. Se um formato salvo não estiver disponível como atalho, escolha explicitamente um formato compatível ou use o painel normal. Para combinar opções, escolha Custom Settings… dentro da ação e preencha os parâmetros. As ações que precisam de textos, URLs, nomes ou dimensões continuam pedindo esses campos obrigatórios. Open Bannerify abre o painel normal.
| Opção do menu | Próximo passo |
|---|---|
| Export Selected Banners → Use Saved Settings | É executada na hora |
| Export Selected Banners → HTML5 Banners | É executada na hora |
| Export Selected Banners → Google Ads | É executada na hora |
| Export Selected Banners → MP4 Video | É executada na hora |
| Export Selected Banners → WebM Video | É executada na hora |
| Export Selected Banners → Animated GIF | É executada na hora |
| Export Selected Banners → Animated WebP | É executada na hora |
| Export Selected Banners → Animated PNG | É executada na hora |
| Export Selected Banners → PNG Images | É executada na hora |
| Export Selected Banners → JPG Images | É executada na hora |
| Export Selected Banners → PDF Document | É executada na hora |
| Export Selected Banners → Export Selected Banners (Custom Settings…) | Preencha Format (optional), Frames or sections (optional) |
| Create Resized Copies → Smart Layout | Preencha Name, Width (px), Height (px) |
| Create Resized Copies → Standard Resize | Preencha Name, Width (px), Height (px) |
| Create Resized Copies → Create Resized Copies (Custom Settings…) | Preencha Name, Width (px), Height (px), Resize mode |
Edição detalhada
Use o painel normal do plugin para configurações detalhadas, conteúdos mais longos, criação em massa e navegação por componentes ou templates. O menu de atalhos contém apenas os comandos do dia a dia listados acima.
Mantenha cada campo colado com menos de 150 caracteres: o app para desktop do Figma pode cortar o texto colado nesse limite. Entradas mais longas devem ser feitas no painel normal.
Se um plugin mais antigo mostrar Action, Target e Options, atualize-o para usar estes atalhos nomeados. Um valor de Target é um ID de camada ou uma seleção, nunca o nome de um novo item.
Ações do Bannerify
| Ação | O que faz | Target |
|---|---|---|
export | Exporta os banners selecionados com as configurações de animação salvas, sem publicar | Uma ou mais camadas elegíveis |
layouts | Gera cópias redimensionadas ou com smart layout a partir de frames de banner explícitos (máximo de 200 resultados) | Uma ou mais camadas elegíveis |
export
Exporta os banners selecionados com as configurações de animação salvas, sem publicar. Selecione uma ou mais camadas elegíveis.
| Opção | Tipo | Obrigatória / padrão | Significado e valores aceitos |
|---|---|---|---|
format | string | Alternativa: "html" | Plataforma HTML, formato animado ou PNG/JPG/PDF estático. html, googleads, mp4, webm, gif, webp, apng, png, jpg, pdf |
source | string | Alternativa: "frames" | Modo Frame ou Section/cena. frames, sections |
Os campos obrigatórios aninhados valem quando o objeto pai ou o item do array correspondente é informado. Os valores opcionais omitidos usam o comportamento atual da operação, a menos que um padrão esteja indicado.
Escolha Export Selected Banners (Custom Settings…). Preencha estes campos simples; nenhum JSON é necessário:
- Format: MP4 Video
- Frames or sections: Frames
Entrada para o host do agente
{"command":"shortcut-export","parameters":{"format":"mp4","source":"frames"}}layouts
Gera cópias redimensionadas ou com smart layout a partir de frames de banner explícitos (máximo de 200 resultados). Selecione uma ou mais camadas elegíveis.
| Opção | Tipo | Obrigatória / padrão | Significado e valores aceitos |
|---|---|---|---|
name | string | Obrigatória | Nome do novo item. Mínimo de 1 caractere; máximo de 120 caracteres |
width | number | Obrigatória | Largura em pixels. Mínimo 1; máximo 8192 |
height | number | Obrigatória | Altura em pixels. Mínimo 1; máximo 8192 |
relayoutLayers | boolean | Obrigatória | Usa o gerador de smart layout existente |
Os campos obrigatórios aninhados valem quando o objeto pai ou o item do array correspondente é informado. Os valores opcionais omitidos usam o comportamento atual da operação, a menos que um padrão esteja indicado.
Escolha Create Resized Copies (Custom Settings…). Preencha estes campos simples; nenhum JSON é necessário:
- Name:
Square - Width (px):
300 - Height (px):
300 - Resize mode: Standard Resize
Entrada para o host do agente
{"command":"shortcut-layouts","parameters":{"name":"Square","width":"300","height":"300","relayoutLayers":"false"}}Usar os atalhos com um agente
Leia o registro legível por máquina indicado abaixo e escolha uma ação oferecida na lista de Quick Actions do plugin instalado. O registro usa as definições de opções da Hypermatic, e não o JSON Schema padrão: min e max limitam o tamanho da string, o tamanho do array ou o valor numérico, conforme o tipo do campo; as definições aninhadas usam fields e item. Campos desconhecidos são rejeitados.
O agente precisa de um host capaz de acionar as Quick Actions do Figma e acompanhar o resultado normal do plugin. Os parâmetros não adicionam um disparador REST ou MCP. Os exemplos expansíveis são dados de entrada para um host compatível, não chamadas de API executáveis; as entradas dos atalhos usam strings simples em parameters, incluindo números e escolhas de formato. Nunca afirme que um atalho foi executado só com base na entrada preparada.
Confira o resultado visível: as camadas do Figma alteradas, a exportação salva ou a página publicada. Leia a notificação normal de sucesso/erro e qualquer aviso de exportação parcial. Conclua as caixas de diálogo de salvamento nativas quando necessário; o início de um download não prova que o arquivo foi salvo. Os usuários não precisam abrir as ferramentas de desenvolvedor nem ler um console.
Solução de problemas
| Sintoma | Próximo passo |
|---|---|
| A ação não está disponível | Atualize o plugin e confira a lista de Quick Actions dele; use o painel normal se a ação não estiver disponível. |
| As opções são inválidas ou podem ter sido cortadas | Use valores simples em campos individuais, com menos de 150 caracteres, e apenas os campos aceitos por aquele atalho. |
| O Target está ausente ou não é elegível | Abra a página correta, confira os requisitos de camadas da ação e selecione de novo as camadas desejadas. |
| Aparece um erro de licença ou de teste | Conclua o fluxo normal de ativação do plugin antes de executar de novo. |
| O download foi solicitado, mas nenhum arquivo salvo aparece | Confira a caixa de diálogo de salvamento nativa e o local de download. Inspecione o arquivo em si. |
| Um comando falha, excede o tempo limite ou é cancelado | Confira o documento e o destino remoto antes de tentar de novo; alterações ou uploads anteriores podem já existir. |
Os comandos têm um prazo de cinco minutos. Os erros não implicam a reversão completa. Repetir automaticamente uma criação, substituição ou upload pode duplicar ou sobrescrever trabalho.
O registro de comandos legível por máquina contém os mesmos IDs de ação e definições de opções.
Limites atuais
Exporte os banners selecionados ou crie cópias redimensionadas em um único tamanho nomeado. Crie novos banners, variantes em massa e layouts detalhados no painel normal. Escolha Frames ou Sections nas Custom Settings da exportação.