Para manter os recursos organizados e reutilizáveis em toda a sua equipe ou em vários projetos, agrupe suas instâncias e converta-as em pacotes reutilizáveis reutilizáveis .Pacotes tornam o processo geral de construir mundos mais rápido e ergonômico, mas também ajudam com consistência, deduplicação, colaboração e versão:
- Atualize facilmente todas as cópias de um pacote para a versão mais recente (ou apenas atualize cópias específicas).
- Defina pacotes para atualizar automaticamente sempre que houver uma nova versão.
- Dê aos colaboradores Editar ou Usar permissões para os conteúdos de um pacote.
- Veja o histórico completo de versões para um pacote, compare versões e restaure versões antigas.
O fluxo de trabalho mais eficiente é criar um pacote, compartilhá-lo com quaisquer colaboradores e definir para atualização automática.E você não precisa esperar que um modelo seja "feito" antes de usá-lo em um pacote.Mesmo que o pacote seja um placeholder no topo de uma forma simples, você pode usá-lo para cinzar sua caixa de areia e, em seguida, ter as cópias do placeholder atualizadas automaticamente quando você publicar versões mais detalhadas.
Criar Pacotes
Você pode criar um pacote a partir de qualquer objeto único ou de qualquer filho e filho único de objetos.Se você quiser criar um pacote para um único objeto, recomendamos adicioná-lo a um grupo de Model agrupamento primeiro para que você possa adicionar, remover ou escalar a instância dentro do pacote mais tarde sem quebrar o pacote.
Na janela Explorer ou janela de visualização 3D, clique com o botão direito no objeto desejado e selecione Converter em Pacote .
Na nova janela, preencha os detalhes do pacote.Em particular, se você estiver trabalhando em um grupo, defina Propriedade para o grupo apropriado em que você tem permissão para criar/editar experiências de grupo.
As transferências de propriedade não são suportadas pelo sistema de recursos, então considere cuidadosamente o proprietário ao criar um pacote
Clique em Enviar .
Após a conversão concluída, o objeto recebe um símbolo de "链接" na janela do Explorer para identificá-lo como um pacote.Além disso, você pode ver um novo objeto Link de Pacote parentado ao objeto.
(Opcional) Selecione o objeto Link de Pacote e habilite AutoUpdate na janela Propriedades .Observe como o ícone muda para indicar que o pacote está definido para atualizar automaticamente.
Não exclua ou mova a instância PackageLink ! Fazendo isso para qualquer cópia de pacote converte a cópia de volta em um objeto normal e perde capacidades de pacote, como a capacidade de atualizar quando há uma nova versão.
Inserir pacotes
Para inserir um pacote que ainda não existe no local atual, você deve inicialmente inseri-lo da Caixa de Ferramentas :
- A partir de Inventário ⟩ Meus Pacotes para pacotes que você publicou ou obteve da Loja do Criador, bem como pacotes que um amigo possui e lhe deu permissões para usar.
- A partir de Criações ⟩ Pacotes de Grupo para pacotes publicados por membros do seu grupo (incluindo você).
Uma vez que você inseriu um pacote no modelo de dados de um local publicado, ele aparece no Gerenciador de Recursos e permanece lá mesmo se você excluir todas as cópias dele mais tarde.
Tenha cuidado ao inserir recursos que você não criou em suas experiências, pois eles podem conter scripts maliciosos.Salve sua experiência primeiro e depois investigue quaisquer scripts dentro de recursos desconhecidos para que você possa facilmente voltar à versão do lugar.
Publicar alterações no pacote
Você pode publicar quaisquer alterações que você faça em um pacote como uma nova versão para torná-las disponíveis para outras cópias do pacote em todo o local e em todas as experiências.Observe que não é necessário publicar um pacote modificado antes de publicar um local (a versão modificada é salva junto com o local para uma futura iteração) .
Para publicar alterações em um pacote:
Na janela Explorer ou janela de visualização 3D, clique com o botão direito na cópia modificada e selecione Publicar no Pacote .
Se uma cópia de pacote tiver atualização automática ativada, ela imediatamente puxa a versão atualizada quando você abre o local que os contém.Outras cópias recebem um ponto branco no ícone do pacote que indica que uma atualização está disponível.Você pode atualizar individualmente ou atualizar em massa conforme necessário.
(Opcional) Adicione uma descrição de suas alterações:
- Clique com o botão direito no pacote e selecione Detalhes do Pacote .
- Na janela de Configuração de Recursos, selecione Versões .
- Sob a sua alteração mais recente, selecione Adicionar .
- Descreva suas alterações e clique em Enviar .
Atualizar cópias desatualizadas
Você pode atualizar cópias de pacote desatualizadas para a versão mais recente ou pode continuar a usar a versão mais antiga.
Para atualizar uma ou mais cópias de pacote para a versão mais recente:
Na janela Explorador , localize cópias desatualizadas pelo ponto branco no ícone do pacote.Você também pode selecionar a cópia desatualizada na janela de visualização 3D, mas pode ser mais difícil encontrar dessa maneira.
Clique com o botão direito na cópia desatualizada e selecione Obter o Pacote Mais Recente .Você também pode selecionar vários pacotes, clique com o botão direito e Obter o mais recente para pacotes selecionados .
Atualizações em massa
O uso extensivo de pacotes pode resultar em muitas cópias de pacotes em vários locais em uma experiência.Além de sincronização individual e atualizações automáticas, você pode atualizar todas as cópias de um pacote através de atualização em massa .
(Recomendado) Feche outras instâncias do Studio com qualquer um dos locais da experiência abertos; isso impede que outra instância não salva de um local substitua potencialmente suas atualizações.
Na janela Explorer ou na janela de visualização 3D, clique com o botão direito no pacote desejado e selecione Atualizar todos .
Escolha todos os locais na experiência ou algum subconjunto de locais e clique em Atualizar .
Para evitar substituições não intencionais, a atualização em massa não afeta versões modificadas de um pacote.Após a atualização em massa concluir, o Studio exibe um aviso com o número de pacotes que não foram atualizados não , se houver.
Atualização em massa de pacotes automaticamente salva os locais selecionados, mas não os publica .
Atualizações automáticas
Para tornar a sincronização mais fácil, você pode definir uma cópia de pacote para atualizar automaticamente sempre que uma versão mais recente for publicada.A atualização automática das cópias do pacote ocorrerá quando um local for aberto no Studio.
Na janela Explorer , expanda a árvore de hierarquia do pacote e selecione seu objeto Link de Pacote .
Na janela Propriedades , habilite a propriedade Atualização Automática .Se você tiver pacotes aninhados , esta propriedade se aplica apenas ao pacote pai de mais alto nível, o que significa que as atualizações automáticas ocorrem apenas quando o pacote pai for atualizado.
Atualização automática não se aplica a modificadas cópias de pacote.Uma vez que você modifica uma instância de pacote, sua propriedade Atualização Automática fica desativada e é ignorada.
Níveis de compartilhamento e acesso
Você pode conceder permissão a amigos, experiências, grupos ou papéis de usuário de grupo específico para que eles possam usar livremente seus pacotes em suas criações.Para mais informações sobre acesso a recursos, veja Privacidade de recursos.
Para alterar as permissões do pacote para um colaborador, como um amigo ou grupo:
Na janela Explorer , Caixa de Ferramentas , ou Gerenciador de Recursos , clique com o botão direito no pacote desejado e selecione Detalhes do Pacote .
Na janela Configuração de Recursos , selecione Permissões .
Usando a barra de pesquisa, insira e selecione um colaborador que você deseja conceder permissão para usar seu pacote, então escolha um nível de permissão.
Permissão Descrição Usar e Ver O colaborador pode usar e visualizar (mas não editar) as versões atuais e anteriores do pacote.Uma vez que você fornece a um colaborador essa capacidade, você não pode revogar o acesso a uma cópia que já inseriu em sua experiência; revogar o acesso impede a reinsserção ou atualizações de pacotes, mas as cópias de pacotes em seu modelo de dados permanecem intactas. Editar O colaborador pode usar, visualizar e editar as versões atuais e anteriores do pacote, incluindo publicar alterações nele.
Modificar Pacotes
Você pode editar pacotes e seus filhos como outros objetos. Modificar pacotes desabilita a atualização automática até que você publique ou reverta as alterações.
A maioria das edições marca o pacote como modificado, embora as seguintes alterações não sejam consideradas modificações de pacote :
- Mudar o nome do nó raiz .
- Mudar a posição ou rotação da raiz de um pacote que é um , ou .
- Mudar uma referência de peça de um Weld dentro do pacote que referencia uma instância fora do pacote.
Uma vez modificado, pacotes com alterações não publicadas recebem um ícone modificado na janela Explorador:
Adicionar ou atualizar configurações
Você pode incluir atributos de instância na raiz de um pacote para personalizar seu comportamento, por exemplo, a velocidade máxima de um veículo embalado ou o tempo de debounce para um botão embalado.
Quando você publica um pacote, o conjunto atual de atributos/valores se tornará as configurações padrão do pacote defectivas .Em qualquer cópia de um pacote, as configurações são mostradas em itálico em negrito e esses valores de atributo podem ser alterados em uma base por instância.Quando as cópias de pacotes forem atualizadas, os valores de configuração modificados serão preservados, enquanto outros atributos serão atualizados para o último valor padrão
Atualmente, a única maneira de lidar com valores de configuração é adicionar scripts no pacote que leem e aplicam o comportamento com base na configuração em tempo de execução.
Se você simplesmente quiser atualizar os valores padrão para configurações, você pode alterar esses valores de atributo e republicar o pacote (o pacote não será marcado como modificado neste caso).Se você quiser publicar outras modificações, mas não alterar os valores de configuração padrão, você deve publicar em um pacote sem alterações de valor ou reverter as configurações para seus padrões antes de publicar.
Pacotes aninhados
Você pode aninhar pacotes dentro de outros pacotes para manter e colaborar em hierarquias complexas, como uma série de mecânicas de veículos que podem ser modificadas independentemente do pacote pai do veículo.Este exemplo mostra um pacote de carro que contém quatro cópias do mesmo pacote de rodas:
Se você modificar um pacote aninhado, tanto o pacote aninhado e o pacote pai são considerados modificados.Você deve publicar alterações em qualquer pacote aninhado antes de poder publicar alterações em seu pacote pai , pois publicar o pai marcaria como atual/não modificado e entraria em conflito com as modificações do pacote aninhado.
Pacotes de scripts
Cada script dentro de um pacote não modificado é leitura-apenas e mostra uma notificação no topo com um hiperlink para desbloquear o script.
Clicando no hiperlink:
- Marca o pacote como modificado independentemente de você editar o script.
- Remove a notificação/hiperligação de outros scripts dentro do pacote.
Uma vez que o pacote é publicado e movido para um estado não modificado , os scripts sob ele se tornam apenas leitura com um hiperlink para modificar.
Reverter as alterações do pacote
Em vez de desfazer toda uma série de alterações de pacote uma por uma, você pode reverter alterações não publicadas em uma ação, restaurar um pacote para uma versão anterior , ou reverter alterações para configurações específicas .
Reverter alterações não publicadas
Para desfazer toda uma série de mudanças não publicadas :
Na janela Explorer , localize cópias modificadas pelo ponto de exclamação ao lado de seus nomes.Você também pode selecionar cópias modificadas na janela de visualização 3D, que pode ser mais fácil.
Clique com o botão direito em uma única cópia modificada e selecione Desfazer Alterações ao Pacote , ou selecione várias cópias (pelo menos uma delas modificada), clique com o botão direito e selecione Desfazer Alterações aos Pacotes Selecionados .
Restaurar para a versão
Para restaurar um pacote para uma versão previamente publicada :
Na janela Explorer , janela de visualização 3D, Caixa de Ferramentas , ou Gerenciador de Recursos , clique com o botão direito no pacote desejado e selecione Detalhes do Pacote .
Na janela Configuração de Recursos , selecione Versões .A janela exibe detalhes para cada versão publicada, incluindo a data e a hora de publicação, além de quaisquer descrições das alterações.
Clique na marca de seleção ao lado da versão que você deseja restaurar e clique em Enviar .
Reverter as alterações em um pacote não redefine a configuração para o padrão. Veja Revertendo Configuração.
Reverter configurações
Para reverter qualquer atributo de configuração para o padrão, selecione a opção Redefinir do menu de equipamento na seção Atributos da janela Propriedades .
Comparar versões de pacote
Quando um pacote tem várias versões, você pode comparar alterações entre versões usando o visualizador de diferenças, que é útil para revisar atualizações de pacotes, comparar suas alterações locais contra a versão mais recente e verificar o conteúdo de versões anteriores antes de restaurar.
A ferramenta tem um menu de hierarquia de pacotes que indica todas as instâncias adicionadas, removidas ou modificadas entre as versões usando os ícones correspondentes, com as seguintes abas disponíveis:
Visão Geral Visual mostra as diferenças visuais da renderização 3D sob diferentes posições de câmera.É a visualização padrão para pacotes com um objeto 3D (modelos, peças) como objeto raiz, e está atualmente disponível apenas para o objeto raiz.
Propriedades mostra alterações de propriedades e atributos.É a visualização padrão para pacotes com um objeto não-3D (scripts, luzes, objetos 2D) como objeto raiz, e está disponível para todas as instâncias em um pacote.
Script mostra diferenças de script linha por linha.Está disponível para pacotes que contêm scripts, independentemente de se o script é o objeto raiz ou não.
Para comparar versões de pacote:
Na janela Explorer ou janela de visualização 3D, clique com o botão direito no pacote alvo e selecione Comparar Versões do Pacote .
Por padrão, a janela compara as alterações entre sua cópia local e a versão mais recente. Use os dois menus suspensos para comparar diferentes versões.
Algumas versões mais antigas podem ser incompatíveis com a ferramenta de dif de pacote.
Após selecionar versões:
Para comparar as renderizações visuais do modelo raiz, se aplicável, selecione a aba Visão Geral Visual e ajuste o controle da câmera para o ângulo desejado.Controles são sincronizados através de vistas:
- Passe a câmera usando cliques de mouse à esquerda.
- Gire a câmera usando cliques de mouse direitos.
- Aproxime e afaste a câmera com a roda do mouse.
- Recentrar usando o atalho de teclado -F.
Para comparar propriedades e atributos de uma instância, selecione a instância e a aba Propriedades .
Para comparar diferenças de script, se aplicável, selecione qualquer script para abrir a aba Script para alterações linha a linha entre as versões selecionadas, semelhante a aplicações de controle de origem.
Essa ferramenta só permite que você compare alterações de script entre a versão atual e a versão mais recente publicada ou localizada, sem indicar os colaboradores que fizeram a alteração.
Alternativamente, você pode abrir a ferramenta de diferença de script diretamente:
- Na janela Explorer ou janela de visualização 3D, clique com o botão direito no pacote alvo, que deve ser um script ou conter scripts, e selecione Ver Alterações de Scripts .
- Na aba de diferenças que se abre, compare todas as alterações do script selecionado entre a cópia atual do pacote e a versão mais recente publicada ou local.