Paquetes

*Este contenido se traduce usando la IA (Beta) y puede contener errores. Para ver esta página en inglés, haz clic en aquí.


Para mantener los activos organizados y reutilizables en tu equipo o en múltiples proyectos, agrupa tus instancias y conviértelas en paquetes reutilizables . .Los paquetes hacen que el proceso general de construir mundos sea más rápido y ergonómico, pero también ayudan con la consistencia, la deduplicación, la colaboración y la versión:

El flujo de trabajo más eficiente es crear un paquete , compartirlo con cualquier colaborador, y configurarlo para actualizarse automáticamente .Y no tienes que esperar a que un modelo esté "listo" antes de usarlo en un paquete.Incluso si el paquete es un marcador en la parte superior de una forma simple, puedes usarlo para greybox tu entorno y luego tener que las copias del marcador se actualicen automáticamente cuando publique versiones más detalladas.

Crear paquetes

Puedes crear un paquete desde cualquier objeto individual o rama de objetos padre e hijo única.Si quieres crear un paquete para un solo objeto, recomendamos agregarlo a un grupo de Model agrupación primero para que puedas añadir, eliminar o escalar la instancia dentro del paquete más tarde sin romper el paquete.

  1. En la ventana Explorador o 3D ventanilla, haz clic derecho en el objeto deseado y selecciona Convertir a paquete .

  2. En la nueva ventana, rellene los detalles del paquete.En particular, si estás trabajando en un grupo determinado, establece la propiedad al grupo apropiado en el que tienes permiso para crear/editar experiencias de grupo.

  3. Haga clic en Enviar .

  4. Una vez que la conversión se complete, el objeto recibe un símbolo de "enlazarcadena" en la ventana del explorador para identificarlo como un paquete.Además, puedes ver un nuevo objeto Enlace de paquete asociado al objeto.

    A maple tree model in the Explorer window with the package icon next to it.
  5. (Opcional) Seleccione el objeto Enlace de paquete y habilite AutoUpdate en la ventana Propiedades .Observe cómo cambia el icono para indicar que el paquete está configurado para actualizaciónautomáticamente.

    A maple tree model in the Explorer window with the auto-update package icon next to it.

Insertar paquetes

Para insertar un paquete que aún no existe en el lugar actual, debe insertarlo inicialmente de la caja de herramientas:

  • Desde Inventario > Mis paquetes para paquetes que has publicado en o obtenido de la Tienda del creador , así como paquetes que un amigo posee y te ha dado permisos para usar .
  • Desde creaciones > paquetes de grupo para paquetes publicados por miembros de tu grupo (incluyendo a ti mismo).
A close up view of the Toolbox with both the Inventory tab and the assets dropdown menu highlighted.

Caja de herramientas ⟩ Inventario ⟩ Mis paquetes
>

A close up view of the Toolbox with the Creations tab highlighted.

Caja de herramientas ⟩ Creaciones ⟩ Paquetes de grupo
>

Una vez que hayas insertado un paquete en el aplicación de modeladode datos de un lugar publicado, aparece en el Gestor de activos y permanece allí incluso si luego eliminas todas las copias de él.

Publicar cambios de paquete

Puedes publicar cualquier cambio que hagas a un paquete como una nueva versión para hacerlos disponibles a otras copias del paquete en todo el lugar y en todas las experiencias.Tenga en cuenta que no es necesario publicar un paquete modificado antes de publicar un lugar (la versión modificada se guarda junto con el lugar para una futura iteración).

Para publicar cambios a un paquete:

  1. En la ventana Explorador o 3D ventanilla, haz clic derecho en la copia modificada y selecciona Publicar al paquete .

  2. Si una copia de paquete tiene actualización automática activada, inmediatamente extrae la versión actualizada cuando abre el lugar que los contiene.Otras copias obtienen un punto blanco en el icono del paquete que indica que una actualización está disponible.Puedes actualizar individualmente o actualizar masivamente según sea necesario.

    Two packages in the Explorer set to auto-update, and one with an update available.
  3. (Opcional) Añade una descripción de tus cambios:

    1. Haga clic con el botón derecho en el paquete y seleccione Detalles del paquete .
    2. En la ventana de configuración de activos, seleccione versiones .
    3. Bajo tu cambio más reciente, selecciona Añadir .
    4. Describe tus cambios y haz clic en Enviar .

Actualizar copias obsoletas

Puedes actualizar las copias de paquetes obsoletas a la versión más reciente o puedes seguir usando la versión más antigua.

Para actualizar una o más copias de paquete a la última versión:

  1. En la ventana Explorador , localiza copias obsoletas por el punto blanco en el íconodel paquete.También puedes seleccionar la copia obsoleta en la ventanilla3D, pero puede ser más difícil encontrarla de esta manera.

    Two packages in the Explorer set to auto-update, and one with an update available.
  2. Haga clic con el botón derecho en la copia obsoleta y seleccione Obtener el paquete más reciente .También puede seleccionar múltiples paquetes, hacer clic derecho y Obtener lo más reciente para los paquetes seleccionados .

Actualizaciones masivas

El uso extensivo de paquetes puede resultar en muchas copias de paquetes en múltiples lugares en una experiencia.Además de sincronización individual y actualizaciones automáticas, puedes actualizar todas las copias de un paquete a través de actualización masiva .

  1. (Recomendado) Cierra otras instancias de Studio con cualquiera de los lugares de la experiencia abiertos; esto evita que otra instancia no guardada de un lugar potencialmente reemplace tus actualizaciones.

  2. En la ventana Explorador o 3D ventanilla, haz clic derecho en el paquete deseado y selecciona Actualizar todo .

  3. Elige todos los lugares en la experiencia o algún subconjunto de lugares y haz clic en actualizar .

    A view of the mass update window, showing two places.

    Para evitar sobrescrituras no intencionales, la actualización masiva no afecta versiones modificadas de un paquete.Después de que la actualización masiva se complete, Studio muestra una advertencia con el número de paquetes que no actualizó no , si es que hay alguno.

Actualizaciones automáticas

Para facilitar la sincronización, puedes establecer una copia de paquete para actualizarse automáticamente cada vez que se publique una versión más nueva.La actualización automática de las copias del paquete se llevará a cabo cuando se abra un lugar en Studio.

  1. En la ventana Explorador , expanda el árbol de jerarquía del paquete y seleccione su objeto Enlace de paquete .

    A close up view of a packaged chandelier model in the Explorer window. The PackageLink object is highlighted.
  2. En la ventana Propiedades , habilita la propiedad Actualización automática .Si tienes paquetes anidados , esta propiedad solo se aplica al paquete padre de más alto nivel, lo que significa que las actualizaciones automáticas solo ocurren cuando se actualiza el paquete padre .

Niveles de compartir y acceso

Si lo desea, puede compartir paquetes con amigos o otorgar acceso a roles de usuario específicos dentro de su grupo.

  1. En la ventana Explorador , Caja de herramientas , o Administrador de recursos , haz clic derecho en el paquete deseado y selecciona Detalles del paquete .

  2. En la ventana Configuración de recursos , seleccione Permisos .

    • Para un paquete de propiedad del grupo , expanda el árbol de roles.Luego elige un nivel de permiso para cada rol.Las cajas de selección que están deshabilitadas indican que el permiso ya está configurado para ese rol y no se puede cambiar desde esta ventana.

      A close up view of some settings in the pop-up window. The arrow icon next to the group icon and the member Edit dropdown menu are highlighted.
      PermisoDescripción
      Editar Los miembros del rol pueden usar, vistay editar las versiones actuales y anteriores del paquete, incluidas las publicaciones de cambios en él.Otorgar acceso de edición a un rol desde esta ventana solo otorga acceso al paquete específico .
      Sin acceso Los miembros del rol no tienen acceso a ninguna nueva versión del paquete, aunque mantienen el acceso a la versión actual insertada en el lugar.
    • Para un paquete de propiedad del usuario , busca amigos a través del campo de búsqueda, haz clic en su nombre de usuario y elige un nivel de permiso.

      PermisoDescripción
      Uso y vista El usuario puede usar y ver (pero no editar) las versiones actuales y anteriores del paquete.Una vez que proporciones a un usuario esta capacidad, no puedes revocar el acceso a una copia que ya haya insertado en su experiencia; revocar el acceso impide la reinsertión o las actualizaciones de paquetes, pero las copias de paquetes en su modelo de datos se mantienen intactas.
      Editar El usuario puede usar, vistay editar las versiones actuales y anteriores del paquete, incluidas las publicaciones de cambios en él.

Modificar paquetes

Puedes editar paquetes y sus hijos al igual que otros objetos. Modificar paquetes desactiva la actualización automática hasta que publiques o revertas los cambios.

The pop-up notice that you cannot update a modified package until you publish or revert your changes.

La mayoría de las ediciones marcan el paquete como modificado, aunque los siguientes cambios no se consideran modificaciones de paquetes:

  • Cambiar el nombre del nodo raíz .
  • Cambiar la posición o la rotación de la raíz de un paquete que es un , o .
  • Cambiar la propiedad habilitada de un nodo raíz GuiObject como un ScreenGui , SurfaceGui o BillboardGui .
  • Cambiar una referencia de parte de un Weld dentro del paquete que se refiere a una instancia fuera del paquete.

Una vez modificado, los paquetes con cambios no publicados obtienen un icono modificado en la ventana Explorador:

The Explorer window with an icon that identifies unpublished package changes.

Añadir o actualizar configuraciones

Puedes incluir atributos de instancia en la raíz de un paquete para personalizar su comportamiento, por ejemplo, la velocidad máxima de un vehículo empaquetado o el tiempo de debounce para un botón empaquetado.

Cuando publique un paquete, el conjunto actual de atributos/valores se convertirá en las configuraciones predeterminadas del paquete .En cualquier copia dada de un paquete, las configuraciones se muestran en negrita bold y esos valores de atributos se pueden cambiar en una base por instancia.Cuando las copias de paquetes se actualizan , se preservarán los valores de configuración modificados, mientras que otros atributos se actualizarán al último valor predeterminado.

The Attributes section of the Properties window. Two properties are highlighted as having their default values while two other italicized properties are highlighted to show they have been configured.

Paquetes anidados

Puedes anidar paquetes dentro de otros paquetes para mantener y colaborar en complejas jerarquías, como una serie de mecánicas de vehículos que se pueden modificar de forma independiente del paquete padre del vehículo.Este ejemplo muestra un paquete de automóvil que contiene cuatro copias del mismo paquete de ruedas:

An expanded hierarchy in the Explorer window showing how packages can contain packages.

Scripts de paquete

Cada script dentro de un paquete no modificado se lee solo y muestra una notificación en la parte superior con un enlace hipertexto para desbloquear el script.

A script tab with a yellow notification that you can click to modifiy the script that's within an unmodified package.

Hacer clic en el enlace hipertextual:

  • Marca el paquete como modificado independientemente de si edita el script.
  • Elimina la notificación/hipervínculo de otros scripts dentro del paquete.

Una vez que el paquete se publique y se mueva a un estado no modificado , los scripts bajo él se vuelven de solo lectura con un enlace para modificar.

Revertir cambios de paquete

En lugar de deshacer una serie completa de cambios de paquetes uno por uno, puedes revertir cambios no publicados en una acción, restaurar un paquete a una versión anterior o revertir cambios a configuraciones específicas .

Revertir cambios no publicados

Para deshacer toda una serie de cambios no publicados :

  1. En la ventana Explorador , localiza copias modificadas por el punto de exclamación junto a sus nombres.También puedes seleccionar copias modificadas en la ventanilla3D, lo que podría ser más fácil.

  2. Haga clic derecho en una copia modificada única y seleccione Deshacer cambios al paquete , o seleccione múltiples copias (al menos una de ellas modificada), haga clic derecho y seleccione Deshacer cambios a los paquetes seleccionados .

Restaurar a la versión

Para restaurar un paquete a una versión previamente publicada :

  1. En la ventana Explorador , 3D ventanilla, Caja de herramientas , o Administrador de recursos , haz clic derecho en el paquete deseado y selecciona Detalles del paquete .

  2. En la ventana Configuración de recursos , seleccione Versiones .La ventana muestra detalles para cada versión publicada, incluidas la fecha y la hora de publicación, junto con cualquier descripción de los cambios.

  3. Haga clic en la marca de verificación junto a la versión que desea restaurar y haga clic en Enviar .

    The pop-up window for a chandelier asset. It displays multiple versions.

Revertir configuraciones

Para revertir cualquier atributo de configuración a su valor predeterminado, seleccione la opción Reestablecer de la sección Atributos de la ventana Propiedades .

The Attributes section of the Properties window. The gear menu is expanded and the Reset menu item is highlighted.

Comparar versiones de paquetes

Cuando un paquete tiene múltiples versiones, puedes comparar cambios entre versiones usando el visor de diferencias, que es útil para revisar actualizaciones de paquetes, comparar tus cambios locales contra la última versión y verificar el contenido de versiones anteriores antes de restaurar.

La herramienta tiene un menú de jerarquía de paquetes que indica todas las instancias agregadas, eliminadas o modificadas entre versiones utilizando los iconos correspondientes, con las siguientes pestañas disponibles:

  • Visión general visual muestra las diferencias visuales del renderizado 3D bajo diferentes posiciones de cámara.Es la vista predeterminada para paquetes con un objeto 3D (modelos, partes) como objeto raíz, y actualmente solo está disponible para el objeto raíz.

    An example of the Visual Overview tab in the diff viewer. One version of a building displays on the left-hand side, and another on the right-hand side.
  • Propiedades muestra cambios de propiedades y atributos.Es la vista predeterminada para paquetes con un objeto no 3D ( scripts, luces, objetos 2D ) como objeto raíz, y está disponible para todas las instancias en un paquete.

    An example of the Properties tab in the diff viewer. Modified properties in different versions are highlighted.
  • Script muestra diferencias de script de línea en línea.Está disponible para paquetes que contienen scripts, independientemente de si el script es el objeto raíz o no.

    An example of the Script tab in the diff viewer. Modified script lines in different versions are highlighted.

Para comparar versiones de paquetes:

  1. En la ventana Explorador o 3D ventanilla, haz clic derecho en el paquete objetivo y selecciona Comparar versiones de paquetes .

  2. Por defecto, la ventana compara cambios entre tu copia local y la versión más reciente. Usa los dos menús desplegables para comparar diferentes versiones.

    A close up view of an example diff viewer. The compare settings are highlighted.
  3. Después de seleccionar versiones:

    • Para comparar las representaciones visuales del aplicación de modeladoraíz, si es aplicable, seleccione la pestaña visualización general y ajuste el control de la cámara para el ángulo deseado.Los controles se sincronizan entre vistas:

      • Panear la cámara usando clics izquierdos del mouse.
      • Gira la cámara usando los clics derechos del ratón.
      • Acercar y alejar la cámara con la rueda del ratón.
      • Recentrar usando el atajo de teclado -F.
    • Para comparar las propiedades y atributos de una instancia, seleccione la instancia y la pestaña Propiedades .

    • Para comparar diferencias de script, si es aplicable, seleccione cualquier script para abrir la pestaña Script para cambios de línea a línea entre las versiones seleccionadas, similar a las aplicaciones de control de fuentes.

Alternativamente, puede abrir la herramienta de diferencia de script directamente:

  1. En la ventana Explorador o 3D ventanilla, haz clic derecho en el paquete objetivo, que debe ser un script o contener scripts, y selecciona Ver cambios de script .
  2. En la pestaña de diferencias que se abre, compara todos los cambios del script seleccionado entre la copia del paquete actual y la versión más reciente publicada o local.