O Importador permite que você importe modelos 3D, imagens, sons e arquivos de vídeo para o Estúdio. A importação de modelos 3D suporta malhas com texturas PBR, malhas com rigging, skinning e dados de animação, além de malhas projetadas como itens de avatar.
Importe modelos 3D personalizados gerais para o Estúdio.
Use o Importador para importar ativos com componentes de itens de avatar.
Para importar um ativo:
- No menu Arquivo do Estúdio, 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 enviado para sua área de transferência. Para modelos, isso copia o ID do ativo do Model.
- Encontrar no Espaço de Trabalho (somente modelos 3D) - Posiciona automaticamente a câmera na localização do objeto importado no espaço de trabalho.
Para importar ativos diretamente usando requisiçõ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 Estúdio 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 molde, 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. Veja Ativos de Áudio para mais detalhes. |
| Vídeo | Você pode importar ativos de vídeo nos formatos .mp4 ou .mov, desde que todos os requisitos sejam 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 Estúdio, selecione 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, veja 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 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 ajustar qualquer configuração de importação individual.
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 estã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 você selecionou um ativo individual da fila de importação. Esta janela de prévia fornece controles individuais para os diversos 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 hamburguer 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 de câmera e visualizações.
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, veja 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 de 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.
Arquivo geral
O Importador fornece as seguintes configurações para todas as malhas:
| Configuração | Descrição |
|---|---|
| Nome | Define o nome do ativo importado conforme 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. |
| Enviar para Roblox | Se habilitado, o Importador adiciona o modelo ao seu inventário do Caixa de Ferramentas e Gerenciador de Ativos como um novo ativo. Por padrão, isso está habilitado. Se desabilitado, o ativo é mantido local ao seu espaço de trabalho e não recebe um ID de ativo. Isso é ideal para testar e iterar em um modelo antes de integrá-lo ao seu projeto. |
| Importar como Pacote | Adiciona seu ativo ao espaço de trabalho como um pacote, um formato escalável, compartilhável e autoatualizável recomendado para ativos que são reutilizados ou redistribuídos com frequência. Por padrão, isso está desabilitado. |
| Criador | Define o criador ou grupo criador para o ativo. |
| Adicionar ao Espaço de Trabalho | Se habilitado, o Importador insere o modelo no Workspace. Se importando de uma experiência salva ou publicada, essa configuração também concede permissão à experiência para usar o ativo restrito. Por padrão, isso está habilitado. Se desabilitado, esta configuração apenas adiciona o modelo ao seu inventário e não concede permissão à experiência para usar o ativo. |
| Inserir Usando Posição da Cena | Se habilitado, o Importador usa a posição da cena atual ao inserir o modelo no espaço de trabalho. Por padrão, isso está desabilitado. |
| Manter Ossos Sem Influência Zero | Se habilitado, o importador mantém os ossos que não influenciam a malha. Por padrão, isso está desabilitado. Se desabilitado, o importador remove os ossos sem influência. |
| Definir Ponto de Pivô para Origem da Cena | Se habilitado, o Importador define o ponto de pivô do modelo inteiro 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 Malha de Moldagem | Se habilitado, o Importador encontra malhas de molde no modelo e as converte em objetos WrapInstance, como WrapLayer ou WrapTarget. Se desabilitado, o Importador as trata como malhas regulares. Se o Importador inicialmente detectar malhas de molde no modelo, isso está habilitado por padrão. |
Rig geral
O Importador fornece as seguintes configurações para malhas com dados de rigging, tipicamente corpos de personagens ou acessórios de roupa:
| 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 Estúdio abre os ativos na ferramenta Configuração de Avatar, permitindo que você comece rapidamente a testar e enviar 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 de 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 e a contagem de polígonos do modelo inteiro. Você pode editar as seguintes configurações para todas as malhas:
| Configuração | Descrição |
|---|---|
| Unidade de Escala | Define quais unidades o arquivo foi modelado para que tenha o tamanho apropriado 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. |
Objeto geral
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 unidirecionais. Vértices unidirecionais significam que você pode ver através deles de um lado. Se habilitado, define os vértices como bidirecionais. Vértices que são bidirecionais são renderizados visualmente em ambos os lados. Bidirecional tem um maior impacto no 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 aplicá-las 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 Estúdio: O comportamento de importação padrão.
- Última Importada: 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, restaurando as configurações para o estado padrão da 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 nova: Define as configurações atuais como uma nova predefinição. Uma caixa de diálogo aparece permitindo que você defina um nome.
- Definir como padrão: Define a predefinição atual como a padrão para todas as importações futuras.
- Renomear: Renomeia a predefinição atual.
- Excluir: Exclui a predefinição atual. Restaura para a predefinição Padrão do Estúdio.
Avisos e erros
Se o Estúdio 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.
