Variáveis de formatação
As variáveis de formatação permitem que April insira valores Discord em mensagens, embeds, URLs de imagem e campos suportados do editor.
Variáveis de mensagem do sistema antigo
Seção intitulada “Variáveis de mensagem do sistema antigo”As boas-vindas, saída e comandos personalizados podem fornecer contexto de utilizador e servidor a variáveis com chavetas simples. Outras funcionalidades fornecem o seu próprio contexto. Os embeds geridos genéricos usam um formatador vazio e não fornecem valores de utilizador ou servidor como as boas-vindas; não dependa da resolução de {user} ou {guild} nesses embeds.
Exemplo:
Welcome {user.mention} to {guild}. You are member {memberCount.ordinal}.Páginas diferentes expõem dados diferentes. Use as variáveis oferecidas para a funcionalidade específica e verifique o resultado real; uma pré-visualização não estabelece a entrega. Inicie sessão e selecione um servidor que possa gerir para editar as mensagens. A April precisa de acesso e permissões de envio e embed no canal de destino; a hierarquia só importa para funcionalidades que alteram funções. Consulte a hierarquia.
Variáveis comuns de utilizador
Seção intitulada “Variáveis comuns de utilizador”| Variável | Significado |
|---|---|
{user} | Nome de utilizador |
{user.mention} | Menção de utilizador Discord |
{user.status.color} | Cor hexadecimal do estado atual do utilizador |
{user.discriminator} | Discriminador Discord quando disponível |
{user.avatar} | URL do avatar do utilizador |
{user.avatar.rounded} | URL do avatar do utilizador para modelos de imagem |
{user.fullname} | Nome de utilizador neste formatador |
{user.id} | ID de utilizador Discord |
{user.created} | Data completa de criação do utilizador |
{user.created.date} | Data de criação do utilizador |
{user.created.ago} | Tempo relativo desde a criação do utilizador |
{user.created.time} | Hora de criação do utilizador |
{user.joined} | Data completa de entrada no servidor |
{user.joined.date} | Data de entrada no servidor |
{user.joined.ago} | Tempo relativo desde a entrada no servidor |
{user.joined.time} | Hora de entrada no servidor |
Variáveis de servidor e canal
Seção intitulada “Variáveis de servidor e canal”| Variável | Significado |
|---|---|
{guild} | Nome do servidor |
{memberCount} | Contagem aproximada de membros |
{memberCount.ordinal} | Contagem de membros como valor ordinal |
{guild.id} | ID do servidor Discord |
{guild.created.ago} | Tempo relativo desde a criação do servidor |
{guild.created.date} | Data de criação do servidor |
{guild.created.time} | Hora de criação do servidor |
{guild.icon} | URL do ícone do servidor |
{channel} | Nome do canal |
{channel.id} | ID do canal Discord |
{channel.mention} | Menção do canal Discord |
{channel.created} | Data completa de criação do canal |
{channel.created.date} | Data de criação do canal |
{channel.created.time} | Hora de criação do canal |
{channel.created.ago} | Tempo relativo desde a criação do canal |
{channel.nsfw} | Se o canal está marcado como NSFW |
{channel.topic} | Tópico do canal |
Variáveis de nível
Seção intitulada “Variáveis de nível”Use-as em mensagens de subida de nível, designs de cartões de classificação e modelos relacionados com níveis quando a página as disponibiliza.
| Variável | Significado |
|---|---|
{user.level} | Nível do utilizador no servidor |
{user.xp} | XP no nível atual |
{user.xpRatio} | Progresso do nível atual de 0 a 1 |
{user.nextLevel} | XP necessária para o próximo nível |
{user.totalXp} | XP total acumulada |
Variáveis de log
Seção intitulada “Variáveis de log”Os eventos de registo podem expor valores anteriores e posteriores quando o Discord envia os dois estados.
| Variável | Significado |
|---|---|
{before.user} | Nome de utilizador anterior |
{before.user.nickname} | Alcunha anterior no servidor |
{before.user.avatar} | URL de avatar anterior |
{before.user.fullname} | Valor completo de utilizador anterior |
{after.user} | Nome de utilizador atualizado |
{after.user.nickname} | Alcunha atualizada no servidor |
{after.user.avatar} | URL de avatar atualizada |
{after.user.fullname} | Valor completo de utilizador atualizado |
{before.channel} | Nome anterior do canal |
{before.channel.id} | ID anterior do canal |
{before.channel.nsfw} | Estado NSFW anterior |
{before.channel.topic} | Tópico anterior do canal |
{after.channel} | Nome atualizado do canal |
{after.channel.id} | ID atualizado do canal |
{after.channel.nsfw} | Estado NSFW atualizado |
{after.channel.topic} | Tópico atualizado do canal |
Alguns eventos de log também adicionam valores específicos do evento, como conteúdo da mensagem ou funções alteradas. Use os botões de variáveis mostrados na página de configuração desse evento.
Variáveis de monitor de transmissão
Seção intitulada “Variáveis de monitor de transmissão”Notificações Twitch podem usar:
| Variável | Significado |
|---|---|
{stream.channel} | Nome apresentado do streamer |
{stream.avatarUrl} | URL do avatar do streamer |
{stream.url} | URL do canal Twitch |
{stream.viewerCount} | Número de espectadores |
{stream.started.ago} | Tempo relativo de início da transmissão |
{stream.type} | Tipo de transmissão |
{stream.length} | Duração da transmissão |
{stream.title} | Título da transmissão |
{stream.preview} | URL da miniatura da transmissão |
{stream.game} | Jogo ou categoria |
Notificações YouTube podem usar {stream.channel.name}, {stream.channel}, {stream.url}, {stream.started.ago} e {stream.title}.
Valores aleatórios
Seção intitulada “Valores aleatórios”Comandos personalizados e outros modelos de mensagem antigos podem usar variáveis de número aleatório:
{random.1-100}{random.1-100} devolve um número inteiro no intervalo inclusivo. Use um limite inferior abaixo do superior.
Variáveis do espaço de trabalho do editor
Seção intitulada “Variáveis do espaço de trabalho do editor”As associações do Editor V2 usam sintaxe de saída estilo Liquid:
| Variável | Exemplo de uso |
|---|---|
{{ user }} | Renderizar o utilizador selecionado em texto |
{{ guild }} | Renderizar o nome do servidor em texto |
{{ channel }} | Renderizar um valor de canal em texto |
As associações do Editor V2 são configuradas no inspetor do espaço de trabalho. Valores com chaveta simples como {user} não são válidos nas associações do Editor V2.
Valores de URL
Seção intitulada “Valores de URL”Variáveis de imagem e ícone devem resolver para URLs válidas. Por exemplo, {user.avatar}, {guild.icon} e {stream.preview} são adequadas para campos de URL de imagem quando a funcionalidade as suporta.
A imagem mostra a interface em inglês.
Pré-visualização local: use o menu de sugestões para inserir uma variável suportada.
Usar uma variável
Seção intitulada “Usar uma variável”- Abra o editor de mensagens da funcionalidade apropriada e selecione uma variável suportada no seletor ou escreva-a exatamente.
- Para boas-vindas, adicione
Welcome {user.mention} to {guild}.à mensagem pública e guarde. - Execute o teste da funcionalidade quando disponível e verifique a saída; uma pré-visualização de teste não é um evento real de membro. Se faltar o valor, confirme que a funcionalidade fornece esse contexto.
Verificar e resolver problemas
Seção intitulada “Verificar e resolver problemas”Por exemplo, adicione Welcome {user.mention} to {guild}. a uma mensagem de boas-vindas ativada e use o comando de teste, verificando separadamente um evento real quando apropriado. Reabra a funcionalidade para alterar ou remover o texto ou desative aí a mensagem. Se o editor estiver a carregar, aguarde; se guardar falhar, verifique o acesso e comprimento dos campos e tente novamente. Se um valor permanecer literal ou inesperado, verifique se a funcionalidade fornece esse contexto e se a escrita corresponde ao seletor. Verifique as permissões do destino se a entrega falhar. Consulte a composição de mensagens.
Antes de configurar, consulte iniciar sessão e selecionar um servidor. Para responsáveis técnicos, consulte o registo técnico de administração.