Tipos de Pergunta de Mídia

Upload de Arquivo

Permita que os respondentes enviem arquivos do dispositivo deles. Suporta restrições configuráveis de tipo de arquivo e limites de tamanho.

Identificador de tipo: file_upload

Propriedades

Propriedade	Tipo	Descrição	Padrão
`choices`	Choice[]	Quando usado em uploads de arquivo, o campo `label` de cada opção especifica um tipo MIME ou extensão de arquivo permitidos (por exemplo, `"application/pdf"`, `"image/*"`). Se vazio, todos os tipos de arquivo são aceitos.	`[]` (todos os tipos)
`max`	number	Tamanho máximo do arquivo em megabytes (MB).	Nenhum (aplica-se o limite da plataforma)

Armazenamento de Arquivos

Os arquivos enviados são armazenados no Vercel Blob. Cada registro de upload inclui:

Campo	Descrição
`blobUrl`	A URL de armazenamento do arquivo no Vercel Blob.
`originalName`	O nome original do arquivo enviado pelo usuário (por exemplo, `resume.pdf`).
`uuidName`	Nome baseado em UUID armazenado no blob (por exemplo, `a1b2c3d4.pdf`).
`size`	Tamanho do arquivo em bytes.
`contentType`	Tipo MIME (por exemplo, `application/pdf`, `image/png`).

Acompanhamento de Armazenamento

O consumo total de armazenamento de arquivos de cada usuário é registrado em bytes (storageUsedBytes no modelo User). Os limites de armazenamento variam por nível de plano.

Validação

Se required for true, o respondente deve enviar um arquivo antes de prosseguir.

Operadores de Salto de Lógica

equals, not_equals, is_answered, is_not_answered

Formato da Resposta

A resposta é armazenada como um objeto FileUploadValue:

json

{
  "fileId": "abc123",
  "originalName": "resume.pdf",
  "size": 245760,
  "contentType": "application/pdf",
  "downloadUrl": "/api/files/resume.pdf?id=abc123"
}

Os uploads de arquivo são atribuídos ao ID do formulário e, opcionalmente, ao ID do usuário. Uploads de respondentes (anônimos) têm userId definido como null, enquanto uploads de mídia do construtor (imagens para perguntas) têm o ID do usuário definido.

Desenho

Uma tela de desenho à mão livre onde os respondentes podem esboçar ilustrações, diagramas ou anotações.

Identificador de tipo: drawing

Propriedades

Propriedade	Tipo	Descrição	Padrão
`canvasSize`	string	O tamanho da tela de desenho. Opções: `small`, `medium`, `large`.	`medium`

Tamanhos de Tela

Tamanho	Descrição
`small`	Uma tela compacta adequada para esboços simples ou ícones.
`medium`	Uma tela padrão para diagramas e ilustrações.
`large`	Uma tela ampliada para desenhos detalhados.

Interação

A tela de desenho suporta desenho à mão livre com mouse ou toque.
Os respondentes podem desenhar, apagar e desfazer seu trabalho.
O desenho final é exportado como um arquivo de imagem.

Validação

Se required for true, o respondente deve criar um desenho antes de prosseguir.

Operadores de Salto de Lógica

equals, not_equals, is_answered, is_not_answered

Formato da Resposta

A resposta é armazenada como um objeto FileUploadValue (o desenho é salvo como um arquivo de imagem):

json

{
  "fileId": "def456",
  "originalName": "drawing.png",
  "size": 102400,
  "contentType": "image/png",
  "downloadUrl": "/api/files/drawing.png?id=def456"
}

A pergunta de Desenho não exibe um botão "OK" separado. Os respondentes enviam o desenho usando os controles de navegação padrão do formulário.

Gravação de Vídeo/Áudio

Capture respostas em vídeo ou áudio diretamente pelo navegador do respondente, usando a câmera e o microfone do dispositivo.

Identificador de tipo: recording

Propriedades

Propriedade	Tipo	Descrição	Padrão
`recordingMode`	string	O tipo de gravação. Opções: `video`, `audio`.	`video`
`maxDuration`	number	Duração máxima da gravação em segundos.	`120` (2 minutos)

Modos de Gravação

Modo	Descrição
`video`	Grava vídeo e áudio usando a câmera e o microfone do dispositivo.
`audio`	Grava apenas áudio usando o microfone do dispositivo. Nenhuma câmera é necessária.

Interação

O respondente clica em um botão "Start Recording".
O navegador solicita as permissões de câmera/microfone (se ainda não concedidas).
Uma pré-visualização ao vivo é exibida durante a gravação.
O respondente clica em "Stop Recording" para finalizar.
Uma pré-visualização da gravação é exibida.
O respondente pode regravar ou prosseguir.

Requisitos de Navegador

Requer um navegador moderno com suporte à API MediaRecorder.
O respondente deve conceder as permissões de câmera e/ou microfone.
HTTPS é obrigatório para captura de mídia (todas as URLs do NueForm são HTTPS por padrão).

Validação

Se required for true, o respondente deve concluir uma gravação antes de prosseguir.

Operadores de Salto de Lógica

equals, not_equals, is_answered, is_not_answered

Formato da Resposta

A resposta é armazenada como um objeto FileUploadValue:

json

{
  "fileId": "ghi789",
  "originalName": "recording.webm",
  "size": 524288,
  "contentType": "video/webm",
  "downloadUrl": "/api/files/recording.webm?id=ghi789"
}

Gravações de vídeo podem produzir arquivos grandes. Considere definir um maxDuration razoável para manter os tamanhos de arquivo gerenciáveis. Uma gravação de vídeo de 2 minutos em qualidade padrão normalmente produz um arquivo entre 5 e 15 MB.

Assinatura

Um painel de assinatura digital onde os respondentes podem desenhar sua assinatura usando mouse, caneta stylus ou o dedo.

Identificador de tipo: signature

Propriedades

O tipo de pergunta de Assinatura não tem propriedades adicionais além das propriedades comuns de pergunta.

Interação

Um painel de assinatura é exibido com uma tela em branco.
O respondente desenha sua assinatura usando mouse, caneta stylus ou toque.
Um botão "Clear" está disponível para recomeçar.
A assinatura é capturada como um caminho vetorial ou imagem.

Validação

Se required for true, o respondente deve desenhar uma assinatura antes de prosseguir.

Operadores de Salto de Lógica

equals, not_equals, is_answered, is_not_answered

Formato da Resposta

A resposta é armazenada como uma string (normalmente uma data URL ou imagem da assinatura codificada em base64).

As assinaturas são leves em comparação com desenhos e gravações. Elas normalmente são armazenadas como caminhos SVG ou pequenas imagens PNG, resultando em arquivos bem abaixo de 100 KB.

Anexos de Mídia em Perguntas de Mídia

Assim como todos os outros tipos de pergunta, as perguntas de captura de mídia suportam anexos de mídia (imagens, vídeos, ícones, QR codes). Isso permite exibir um exemplo ou uma instrução ao lado da interface de captura. Por exemplo, você pode mostrar uma imagem de assinatura de exemplo como mídia em uma pergunta de Assinatura, ou exibir um QR code em uma pergunta de Upload de Arquivo que leva a uma página complementar de upload no celular.

Veja o guia de Criando Formulários para detalhes sobre as opções de mídia e as configurações de layout.