Export translations

Settings

Group

Language

Format

Export for off-line translation

Export in native format

Export in CSV format

{{DISPLAYTITLE:Expressões}}<languages/>
{{Noticebox/Official}}
[[File:Action_Menu_Expressions.png|thumb|Um exemplo do menu Expressões no menu de Ação.]]
"Expressões" são um recurso de [[Special:MyLanguage/avatars|avatares]] do VRChat, que consiste em menus personalizados pelo usuário que permitem ativar ações ou alternar opções em seu avatar; projetadas para acesso fácil e flexível a recursos exclusivos do avatar.

Mais informações estão disponíveis em {{VRC link|https://creators.vrchat.com/avatars/expression-menu-and-controls|Documentação para Criadores de Avatares}}.

<span id="Expressions_menu"></span>
<div class="mw-translate-fuzzy">
==Menu de expressões==
</div>

O menu de Expressões dentro do jogo pode ser acessado através do [[Special:MyLanguage/Action Menu|Menu de Ação]], ou da aba Expressões no [[Special:MyLanguage/Quick Menu|Menu Rápido]] e [[Special:MyLanguage/Main Menu|Menu Principal]] em qualquer versão do VRChat. As alterações nas expressões de um avatar são compartilhadas globalmente com outros usuários na mesma [[Special:MyLanguage/Platforms|plataforma]] e podem ser configuradas para [[Special:MyLanguage/Guides:Synchronization|sincronização]] entre plataformas.

<span id="Expressions_in_the_SDK"></span>
<div class="mw-translate-fuzzy">
==Expressões no SDK==
</div>

As expressões são editadas usando vários parâmetros no [[Special:MyLanguage/VRChat SDK|SDK do VRChat]].

<span id="Base_expressions"></span>
<div class="mw-translate-fuzzy">
===Expressões base===
</div>

Quando nenhuma expressão é configurada, um menu de expressões padrão com animações base é adicionado ao avatar, contendo as seguintes animações:
* Wave (Acenar)
* Clap (Palmas)
* Point (Apontar)
* Cheer (Torcer)
* Dance (Dança)
* Backflip (Mortal para trás)
* Die (Morrer)
* Sadness (Tristeza)

<span id="Custom_expressions"></span>
<div class="mw-translate-fuzzy">
===Expressões personalizadas===
</div>

Para adicionar expressões personalizadas, crie um recurso de '''Menu de Expressões''' e um recurso de '''Parâmetros de Expressão''' no Unity, depois atribua-os na seção ''Expressões'' do Descritor de Avatar do VRChat. O menu define quais controles aparecem no menu do jogo, enquanto o recurso de parâmetros define os nomes, tipos, valores padrão e comportamento de sincronização dos valores que esses controles alteram.

Cada parâmetro personalizado pode ser marcado como ''Salvo'' e ''Sincronizado''. Parâmetros personalizados sincronizados contam para o limite de sincronização de 256 bits do avatar, enquanto avatares podem definir até 8192 parâmetros personalizados no total. Os parâmetros desse recurso também podem ser alterados por [[Special:MyLanguage/Contacts|Receptor de Contato]], [[Special:MyLanguage/parameter drivers|acionadores de parâmetros]], [[Special:MyLanguage/physbones|PhysBones]] e [[Special:MyLanguage/Open Sound Control|OSC]].

O SDK também inclui um botão de ''Parâmetros Padrão''. Ele restaura os três parâmetros de alias usados pelos controladores AV3 padrão do VRChat: <code>VRCEmote</code>, <code>VRCFaceBlendH</code> e <code>VRCFaceBlendV</code>.

<span id="Controls"></span>
<div class="mw-translate-fuzzy">
====Controles====
</div>

Você pode criar até 8 controles por página. Ao criar um controle, escolha o tipo:

* '''Button''' define um valor enquanto estiver pressionado, depois o redefine após o VRChat enviar a alteração.
* '''Toggle''' define um valor quando ativada e o redefine quando desativada.
* '''Sub Menu''' abre outro menu de Expressões e, opcionalmente, pode definir um parâmetro enquanto esse submenu estiver aberto.
* '''Two Axis Puppet''' controla dois parâmetros float a partir da entrada horizontal e vertical, geralmente no intervalo de <code>-1.0</code> a <code>1.0</code>.
* '''Four Axis Puppet''' controla quatro parâmetros float, um para cada direção, geralmente no intervalo de <code>0.0</code> a <code>1.0</code>.
* '''Radial Puppet''' controla um parâmetro float de <code>0.0</code> a <code>1.0</code>.

<span id="Puppet_Menu_Example"></span>
<div class="mw-translate-fuzzy">
=====Exemplo de Menu de Marionetes=====
</div>

[[File:PuppetMenu.gif|thumb|Exemplo do Menu de Ação e do Espelho Facial em uso. (GIF animado)]]
Ao mover o joystick, o touchpad ou o mouse em diferentes direções, você altera os parâmetros de animação para misturar diferentes expressões (por exemplo, "feliz" e "surpreso"). Qualquer parâmetro pode ser controlado neste menu.

Você pode abrir um menu com qualquer uma das mãos (ou com ambas). Por padrão, dê um toque para selecionar uma opção. Nas configurações do Menu de Ação, você pode optar por usar o Gatilho. Para sair de uma marionete no menu de Expressões, pressione o gatilho.

Quando um controle estiver aberto, o VRChat sincroniza seus valores em tempo real usando o modo de sincronização ''IK'', que é mais rápido. Após ser fechado, o valor congelado permanece até ser alterado novamente.

<span id="Expression_Parameter"></span>
<div class="mw-translate-fuzzy">
==Parâmetro de Expressão ==
</div>

Os parâmetros de expressão são usados para controlar as funcionalidades do avatar através do menu de expressões, [[Special:MyLanguage/Contacts|receptor de contato]], [[Special:MyLanguage/Open Sound Control|OSC]], [[Special:MyLanguage/parameter drivers|acionadores de parâmetro]] ou [[Special:MyLanguage/physbones|physbones]]. Esses parâmetros são então mapeados para os parâmetros do Controlador de Animação nos controladores de Efeitos (FX), Gestos ou Ações do seu avatar.

<span id="Settings"></span>
== Configurações ==

Cada entrada no recurso de Parâmetros de Expressão armazena:
* '''Nome''', que deve corresponder exatamente ao nome do parâmetro no Animator.
* '''Tipo''', que pode ser <code>Bool</code>, <code>Int</code> ou <code>Float</code>.
* '''Padrão''', usado quando o avatar é redefinido.
* '''Salvo''', que controla se o valor persiste entre sessões.
* '''Sincronizado''', que controla se o valor é enviado para outros usuários.

Por padrão, a sincronização de parâmetros personalizados usa o modo de sincronização ''Playable'' do VRChat. Controles (puppet controls) usam temporariamente a sincronização ''IK'', que é mais rápida, enquanto estiverem abertos.

<span id="Built-in_parameters"></span>
=== Parâmetros Integrados ===

O VRChat também fornece parâmetros integrados do Animator. Eles não precisam ser adicionados ao recurso de Parâmetros de Expressão e não contam para o limite de parâmetros personalizados.

Parâmetros integrados são somente leitura. Eles são adicionados diretamente ao Animator Controller de uma camada playable pelo nome, e o VRChat os atualiza automaticamente em tempo de execução. Eles não são definidos em sub-animators, apenas em animators de camadas playable.

Parâmetros integrados adicionais incluem:

* <code>Viseme</code> (Int) — Definido pela sincronização labial de <code>0</code> (silêncio) até <code>14</code> (a vogal "u") quando a Sincronização Labial do Descritor de Avatar estiver definida como Forma de Mistura de Visema ou Apenas Parâmetro de Visema.
* <code>Voice</code> (Float) — Volume percebido do microfone de <code>0.0</code> a <code>1.0</code>, afetado pela distância e pelas configurações de Protetores de Ouvido.
* <code>VelocityX</code>, <code>VelocityY</code>, <code>VelocityZ</code>, <code>VelocityMagnitude</code> (Float) — Velocidade de movimento em m/s ao longo de cada eixo e magnitude total. Localmente, o movimento da área de jogo não conta; remotamente, conta.
* <code>Upright</code> (Float) — <code>0</code> quando de bruços, <code>1</code> quando em pé.
* <code>Grounded</code> (Bool) — Define se o usuário está tocando o chão.
* <code>MuteSelf</code> (Bool) — Define se o microfone do usuário está silenciado.
* <code>Earmuffs</code> (Bool) — Define se o usuário está com os Protetores de Ouvido ativados.
* <code>IsOnFriendsList</code> (Bool) — Define se o observador é amigo do usuário que está usando o avatar (mostra False localmente).
* <code>ScaleFactor</code>, <code>ScaleFactorInverse</code>, <code>EyeHeightAsMeters</code>, <code>EyeHeightAsPercent</code> (Float) — Parâmetros relacionados ao escalonamento do avatar. <code>EyeHeightAsMeters</code> é recomendado para sistemas compatíveis com escala, pois é linear e não depende da altura de upload.

Cada parâmetro integrado possui um tipo de sincronização que determina quando ele é enviado para usuários remotos: ''IK'' para valores derivados do rastreamento (gestos, velocidade, contato com o chão), ''Speech'' para valores relacionados à voz (viseme, voz), ''Playable'' para valores de estado do usuário (silenciar, Protetores de Ouvido, tipo de rastreamento, escala) ou ''None'' para valores apenas locais (IsLocal, PreviewMode).

<span id="Network_synchronization"></span>
=== Sincronização de rede ===

Apenas parâmetros de expressão sincronizados e certos parâmetros integrados são enviados pela rede. A lista completa de dados enviados para cada avatar inclui:
* '''IK targets (Alvos de IK)''' — Cabeça, mandíbula e mãos para desktop e rastreamento de 3 pontos; adicionalmente quadril e pés para rastreamento de corpo inteiro. Usuários de controles Index também sincronizam as posições dos dedos.
* '''Synced expression parameters (Parâmetros de expressão sincronizados)''' — Apenas parâmetros marcados como Sincronizados são transmitidos. Os valores são quantizados: valores Int sincronizam no intervalo de 0–255, valores Float sincronizam como múltiplos de 1/127 entre −1 e 1, e Bools sincronizam como verdadeiro ou falso.
* '''Built-in VRC parameters (Parâmetros VRC integrados)''' — Incluindo gestos, velocidade, voz e outros parâmetros em tempo de execução.
* '''PhysBones''' — Dados de posição da pose são enviados para usuários que entram posteriormente.

Para um suporte confiável a usuários que entram posteriormente, um padrão recomendado é separar a lógica do Animator usando o parâmetro <code>IsLocal</code>: camadas do lado local lidam com contatos, acionadores de parâmetros e toda a lógica, depois definem os parâmetros sincronizados, enquanto camadas do lado remoto apenas leem esses parâmetros sincronizados para reproduzir a visualização correta.

<span id="Gestures_and_facial_expressions"></span>
=== Gestos e Expressões Faciais ===

Os parâmetros integrados <code>GestureLeft</code> e <code>GestureRight</code> identificam o gesto de mão do usuário, enquanto <code>GestureLeftWeight</code> e <code>GestureRightWeight</code> expõem a pressão analógica do gatilho. Em avatares humanoides, a camada playable Gesture é comumente usada para poses das mãos, enquanto expressões faciais geralmente são controladas pela camada FX usando blendshapes, propriedades de material ou outras animações não humanoides.

Em controles com rastreamento onde o rastreamento dos dedos substitui a animação por padrão, criadores podem usar um comportamento de estado Tracking Control para alternar os dedos relevantes de ''Tracking'' para ''Animation'' quando necessário.

<span id="Expression_Parameter_Mismatching"></span>
<div class="mw-translate-fuzzy">
== Divergências de parâmetros de expressão==
</div>

A divergência de parâmetros de expressão refere-se à prática de usar tipos de parâmetros diferentes entre os parâmetros de expressão e os parâmetros do controlador de animação local. Embora seja recomendável manter a consistência dos tipos de parâmetros, existe suporte para essa divergência e o sistema converterá os valores entre os tipos de acordo com regras específicas. Isso pode ser útil em certas configurações <u>avançadas</u>. O mesmo comportamento de conversão também pode ser usado com parâmetros integrados do Animator do VRChat.

O sistema Animator do Unity usa floats no backend para todos os tipos de parâmetros, enquanto o VRChat armazena parâmetros personalizados sincronizados em formatos compactos otimizados para rede. A interface do usuário no Unity e no VRCSDK permite que criadores escolham tipos de parâmetros para maior conveniência, mas, internamente, a conversão de valores é possível. Isso significa que os parâmetros não são convertidos no sentido de casting do C#, mas sim usados de forma incompatível entre sistemas. Esse comportamento também é suportado por ferramentas populares como Av3Emulator e Gesture Manager.

<span id="Expression_Parameter_Bool"></span>
<div class="mw-translate-fuzzy">
===Parâmetro de Expressão Booleano===
</div>
{| class="wikitable"
|+Parâmetro do Controlador de Animação
!Tipo
!Expressão Booleana = Falso
!Expressão Booleana = Verdadeiro
|-
|Bool → Bool
|Bool = False
|Bool = True
|-
|Bool → Int
|Int = 0
|Int = 1
|-
|Bool → Float
|Float = 0.0
|Float = 1.0
|}
<span id="Expression_Parameter_Int"></span>
<div class="mw-translate-fuzzy">
===Parâmetro de Expressão Inteiro===
</div>
{| class="wikitable"
|+Parâmetro do Controlador de Animação
!Tipo
!Comportamento
|-
|Int → Bool
|Qualquer valor inteiro diferente de 0 define uma variável booleana como Verdadeiro.
|-
|Int → Int
|Comportamento Esperado
|-
|Int → Float
|Conversão Direta: por exemplo, Inteiro = 2 → Float = 2.0
|}
<span id="Expression_Parameter_Float"></span>
<div class="mw-translate-fuzzy">
===Parâmetro de Expressão Float===
</div>
{| class="wikitable"
|+Parâmetro do Controlador de Animação
!Tipo
!Comportamento
|-
|Float → Bool
|Qualquer valor Float diferente de 0 define uma variável booleana como Verdadeiro.
|-
|Float → Int
|Conversão Arredondada: ≥0,5 → 1 ; <0,5 → 0
|-
|Float → Float
|Comportamento Esperado
|}
<span id="Resources"></span>
<div class="mw-translate-fuzzy">
==Recursos==
</div>

*{{VRC link|https://vrchat.com/home/world/wrld_6168d07b-f55c-40bc-8077-749dde39983c|Mundo Avatar 3.0 Hub}} no VRChat
*[https://creators.vrchat.com/avatars/expression-menu-and-controls/ Menu de Expressões e Controles] no Creator Docs
*[https://docs.vrchat.com/docs/action-menu#expression-menu Menu de Ações - Menu de Expressões] no Creator Docs
*[https://creators.vrchat.com/avatars/animator-parameters/ Parâmetros do Animator] no Creator Docs
*[https://creators.vrchat.com/avatars/playable-layers Camadas Playable] no Creator Docs
*[https://creators.vrchat.com/avatars/state-behaviors/ Comportamentos de Estado] no Creator Docs

<span id="See_also"></span>
<div class="mw-translate-fuzzy">
==Veja também==
</div>

*[[Special:MyLanguage/Avatars|Avatares]]
**[[Special:MyLanguage/Avatar Dynamics|Dinâmica de Avatar]]
*[[Special:MyLanguage/Action Menu|Menu de Ação]]
*[[Special:MyLanguage/VRChat SDK|SDK do VRChat]]

<span id="References"></span>
<div class="mw-translate-fuzzy">
==Referências==
</div>

* [https://vrc.school/docs/Avatars/Expressions-Menu-Params VRC School: Expressions Menu and Parameters]
* [https://vrc.school/docs/Avatars/Gestures VRC School: Hand Gestures/Facial Expressions]
* [https://vrc.school/docs/Avatars/VRC-Parameters VRC School: Built-In VRC Parameters]
* [https://vrc.school/docs/Other/Network-Sync VRC School: Network Sync]
* [https://vrc.school/docs/Other/Parameter-Mismatching VRC School: Expression Parameter Mismatching]

[[Category:Avatar features{{#translation:}}]]

Anonymous

Search

Export translations

Namespaces

More

Page actions

Navigation

Navigation

Contributing

Official Links

Official Guides

Community Content

Wiki tools

Wiki tools

Anonymous

Search

Export translations

Navigation

Wiki tools

Page tools