O Importador permite que você importe modelos 3D, imagens, sons e arquivos de vídeo para o Studio. A importação de modelos 3D suporta malhas com texturas PBR, malhas com rigging, skinning e dados de animação, e malhas projetadas como itens de avatar.
Importe modelos 3D personalizados gerais para o Studio.
Use o Importador para importar ativos com componentes de itens de avatar.
Para importar um ativo:
- No menu Arquivo do Studio, selecione Importar.
- No navegador de arquivos, selecione o tipo de arquivo suportado que você pretende importar.
- Configure suas configurações de importação e verifique quaisquer mensagens de aviso ou erro.
- Clique em Importar.
- Após a importação, você pode clicar com o botão direito no ativo importado no importador e realizar o seguinte:
- Copiar ID do ativo - Copia o ID do ativo carregado para sua área de transferência. Para modelos, isso copia o ID do ativo do Model.
- Encontrar no Espaço de Trabalho (apenas modelos 3D) - Posiciona automaticamente a câmera na localização do objeto importado no espaço de trabalho.
Para importar ativos diretamente usando solicitações HTTP, consulte o guia de uso do Open Cloud para ativos.
Tipos de arquivo suportados
Antes de importar um objeto 3D, certifique-se de que o .fbx, .gltf ou .obj atende aos requisitos de malha do Studio para reduzir erros ou comportamentos inesperados.
| Tipo de Ativo | Detalhes |
|---|---|
| Imagem | Você pode importar imagens nos formatos .png, .jpg, .gif, .tga ou .bmp para uso como texturas/decais em partes, rótulos de imagem, texturas de malha, texturas para materiais personalizados, texturas para efeitos especiais e mais. |
| Malha | Você pode importar malhas nos formatos .fbx, .obj ou .gltf. Os formatos .fbx e .gltf suportam múltiplos objetos de malha e hierarquias, texturas básicas e PBR, objetos de malha de gaiola, rigs, componentes de avatar, dados de animação e cores de vértice. |
| Áudio | Você pode importar ativos de áudio nos formatos .ogg, .mp3, .flac ou .wav. Consulte Ativos de Áudio para detalhes. |
| Vídeo | Você pode importar ativos de vídeo nos formatos .mp4 ou .mov se todos os requisitos forem atendidos. |
Fila de importação
Se você selecionou vários arquivos com o Importador, pode usar a fila de importação para gerenciar em massa suas várias importações.
A barra superior permite que você adicione novos arquivos, limpe a fila, pesquise e filtre, e importe todos os ativos habilitados.
A fila de importação lista todos os arquivos adicionados, com menus suspensos de acesso rápido para alterar criador, predefinições e caminhos de arquivo.
Adicionar arquivos à fila
Para abrir um navegador de arquivos e adicionar arquivos adicionais à fila de importação, você pode:
- Clicar no botão Adicionar arquivo na barra superior da janela da fila de importação.
- No menu Arquivo do Studio, selecionar Importar.
Remover arquivos da fila
Para remover todos os arquivos da fila, clique no botão Limpar fila com o ícone de vassoura. Para remover um arquivo individual da fila, clique com o botão direito em um item na fila e selecione Excluir da fila.
Aplicar configurações de predefinição
Use a coluna Predefinição de Importação para selecionar uma configuração predefinida a ser aplicada ao seu ativo. Para mais informações, consulte Predefinições.
Você também pode aplicar as configurações de um item a todos os itens clicando com o botão direito em um item com as configurações desejadas e selecionando Aplicar configurações a todos.
Acessar prévia e configurações individuais
Se você estiver importando um modelo 3D, clique no nome do Ativo individual de um modelo não importado para acessar a prévia de importação para esse item. Use a prévia de importação para visualizar e verificar seu modelo, bem como definir quaisquer configurações de importação individuais.
Importar arquivos
Certifique-se de que cada item que você deseja importar tenha uma caixa de seleção habilitada na primeira coluna. Por padrão, todos os itens são selecionados se forem importáveis.
Pressione o botão Importar para iniciar o processo de importação.
Prévia de importação (Modelos)
A janela de prévia de importação aparece se você estiver importando um único arquivo de modelo ou se selecionou um ativo individual da fila de importação. Esta janela de prévia fornece controles individuais para os vários objetos em seu modelo.
A janela de prévia é dividida em várias seções:
O caminho do arquivo do seu arquivo de modelo. Clique em Procurar para editar.
A predefinição aplicada à sua importação. Use o menu suspenso para selecionar várias predefinições, ou o menu de hambúrguer para definir uma nova predefinição.
A prévia 3D do seu modelo. Use os botões do mouse e os ícones no canto superior direito para várias opções e visões da câmera.
A hierarquia de objetos do objeto importado. Inclui objetos de malha e outros componentes suportados.
As configurações de importação para sua importação. Para uma lista completa de configurações, consulte Configurações de importação.
Configurações de importação
Dependendo do objeto selecionado no painel de hierarquia, o painel do inspetor exibe os seguintes grupos de configurações:
- Arquivo Geral: Afeta todo o arquivo importado.
- Rig Geral: Afeta o objeto de malha selecionado se os dados de rigging estiverem presentes.
- Transformação do Arquivo: Afeta as propriedades de transformação do arquivo importado.
- Geometria do Arquivo: Afeta as propriedades de geometria do arquivo importado.
- Objeto Geral: Afeta o objeto filho selecionado.
- Geometria do Objeto: Afeta a geometria do objeto filho selecionado.
Geral do arquivo
O Importador fornece as seguintes configurações para todas as malhas:
| Configuração | Descrição |
|---|---|
| Nome | Define o nome do ativo importado como aparecerá em seu projeto. |
| Importar Apenas Como Modelo | Se habilitado, o Importador importa o modelo como um único ativo, mesmo que o modelo contenha múltiplos filhos. Por padrão, isso está habilitado. Se desabilitado, o Importador importa o modelo e todos os descendentes, como as múltiplas malhas, como ativos individuais. |
| Carregar para Roblox | Se habilitado, o Importador adiciona o modelo ao seu inventário do Toolbox e Asset Manager como um novo ativo. Por padrão, isso está habilitado. Se desabilitado, o Importador não adiciona o modelo ao seu inventário para uso posterior. Isso é ideal quando você deseja testar e iterar no design de um modelo sem criar várias cópias no Toolbox e Asset Manager. |
| Importar como Pacote | Adiciona seu ativo ao espaço de trabalho como um pacote, um formato escalável, compartilhável e de atualização automática recomendado para ativos que são reutilizados ou comumente redistribuídos. Por padrão, isso está desabilitado. |
| Criador | Define o criador ou grupo de criadores para o ativo. |
| Adicionar ao Espaço de Trabalho | Se habilitado, o Importador insere o modelo no Workspace. Se importando de um jogo salvo ou publicado, essa configuração também concede permissão ao jogo para usar o ativo restrito. Por padrão, isso está habilitado. Se desabilitado, essa configuração apenas adiciona o modelo ao seu inventário e não concede ao jogo permissão para usar o ativo. |
| Inserir Usando Posição da Cena | Se habilitado, o Importador usa a posição atual da cena ao inserir o modelo no espaço de trabalho. Por padrão, isso está desabilitado. |
| Manter Ossos de Zero Influência | Se habilitado, o importador mantém ossos que não influenciam a malha. Por padrão, isso está desabilitado. Se desabilitado, o importador remove ossos de zero influência. |
| Definir Pivô para Origem da Cena | Se habilitado, o Importador define o ponto de pivô de todo o modelo para a origem da cena. Por padrão, isso está habilitado. |
| Ancorado | Se habilitado, o Importador define a propriedade Anchored como true em todas as MeshParts importadas. Isso está desabilitado para malhas com dados de rig / avatares. Por padrão, isso está desabilitado. |
| Usa Gaiola | Se habilitado, o Importador encontra malhas de gaiola no modelo e as converte em objetos WrapInstance, como WrapLayer ou WrapTarget. Se desabilitado, o Importador as trata como malhas regulares. Se o Importador detectar inicialmente malhas de gaiola no modelo, isso está habilitado por padrão. |
Geral do rig
O Importador fornece as seguintes configurações para malhas com dados de rigging, tipicamente corpos de personagens ou acessórios de vestuário:
| Configuração | Descrição |
|---|---|
| Tipo de Rig | Define o tipo de rig com o qual a malha deve estar associada. As opções são: - R15 - Personalizado - Sem Rig Por padrão, o Importador tenta selecionar a configuração mais apropriada com base nos dados de rigging e skinning detectados da malha. |
| Validar Corpo UGC | Após a importação, o Studio abre os ativos na ferramenta Configuração de Avatar, permitindo que você comece rapidamente a testar e carregar ativos de avatar para o Marketplace. |
| Escala do Rig | Se o Tipo de Rig estiver definido como R15, o importador fornece opções adicionais para especificar escala do tipo de corpo. As opções são: - Padrão - Rthro - Rthro Estreito |
Transformação do arquivo
O Importador fornece as seguintes configurações para todas as malhas:
| Configuração | Descrição |
|---|---|
| Frente do Mundo | Define o eixo voltado para frente do objeto. Por padrão, isso está definido como Frente. |
| Cima do Mundo | Define o eixo voltado para cima do objeto. Por padrão, isso está definido como Cima. |
Geometria do arquivo
A geometria do arquivo inclui informações sobre as dimensões do arquivo e a contagem de polígonos de todo o modelo. Você pode editar as seguintes configurações para todas as malhas:
| Configuração | Descrição |
|---|---|
| Unidade de Escala | Define em quais unidades o arquivo foi modelado para que seja dimensionado adequadamente ao ser importado. Por padrão, isso está definido como Studs. |
| Mesclar Malhas | Se habilitado, mescla todas as MeshParts no modelo em uma única MeshPart e cria uma MeshPart em vez de um Modelo. Por padrão, isso está desabilitado. |
| Inverter Faces Negativas | Inverte a orientação das faces negativas na malha. Por padrão, isso está desabilitado. |
Geral do objeto
Ao selecionar um objeto filho específico de sua malha, o Importador preenche as configurações Gerais do Objeto. Você pode editar as seguintes configurações para os objetos filhos selecionados:
| Configuração | Descrição |
|---|---|
| Nome | Define o nome do objeto filho selecionado dentro do modelo. |
| Ancorado | Se habilitado, define a propriedade Anchored como true no objeto filho selecionado. Por padrão, isso está desabilitado. |
| Usar Pivô Importado | Se habilitado, importa o objeto usando o ponto de pivô definido dentro do objeto filho. Por padrão, isso está habilitado. |
Geometria do objeto
A Geometria do Objeto inclui informações sobre as dimensões e a contagem de polígonos do objeto filho selecionado do modelo. Você pode editar as seguintes configurações para os objetos filhos selecionados:
| Configuração | Descrição |
|---|---|
| Fazer Dupla Face | Se desabilitado, define os vértices como unidimensionais. Vértices unidimensionais significam que você pode ver através deles de um lado. Se habilitado, define os vértices como bidimensionais. Vértices que são duplos renderizam visualmente em ambos os lados. Bidimensionais são mais intensivos em desempenho. Por padrão, isso está desabilitado. |
| Ignorar Cores de Vértice | Se habilitado, ignora os dados de cor de vértice no objeto filho. Por padrão, isso está desabilitado. |
Predefinições
Você pode salvar predefinições de várias configurações de importação para aplicar rapidamente mais tarde dentro da prévia de importação ou da fila de importação.
Por padrão, você pode selecionar entre duas predefinições:
- Padrão do Studio: O comportamento de importação padrão.
- Última Importação: Usa as configurações aplicadas à importação mais recente.
Você pode usar o menu ⋯ ao lado do menu suspenso de Predefinições para opções adicionais:
- Redefinir tudo: Remove quaisquer alterações na configuração atual, colocando as configurações de volta ao estado padrão para a predefinição atual.
- Salvar seleção: Permite que você salve quaisquer novas alterações nas configurações do importador na predefinição atualmente selecionada.
- Salvar como novo: Define as configurações atuais como uma nova predefinição. Uma caixa de diálogo é exibida permitindo que você defina um nome.
- Definir como padrão: Define a predefinição atual como padrão para todas as importações futuras.
- Renomear: Renomeia a predefinição atual.
- Excluir: Exclui a predefinição atual. Redefine para a predefinição Padrão do Studio.
Avisos e erros
Se o Studio detectar quaisquer problemas com seu modelo, um pequeno indicador será exibido no painel de hierarquia ou no painel de configurações.
Se você vir um ícone de aviso na hierarquia, expanda a hierarquia até chegar ao objeto filho específico para ver mais informações sobre o problema. Mensagens de aviso e erro são exibidas no painel de configurações ou como uma dica de ferramenta.
