---
title: roAssetCollection
slug: develop/es/roassetcollection
docTags: 
createdAt: 2025-03-11T07:07:17.200Z
---

Este objeto se utiliza para representar una colección de recursos.

Creación de objetos: El objeto *roAssetCollection* se crea sin parámetros.

```text
CreateObject("roAssetCollection")
```

Puede llenar una colección de recursos con llamadas individuales a `AddAsset()` o `AddAssets()`. También puede llenar una colección de recursos utilizando el método *roSyncSpec.GetAssets()*, como se muestra a continuación:

```text
assetCollection = CreateObject("roAssetCollection")
 
localCurrentSync = CreateObject("roSyncSpec")
if localCurrentSync.ReadFromFile("local-sync.xml") then
	assetCollection = localCurrentSync.GetAssets("download")
endif
```

## ifFailureReason

### GetFailureReason() As String

Devuelve información adicional si falla un método.

## ifAssetCollection 

### AddAsset(asset\_info As Dynamic) As Boolean

Agrega un único recurso desde un arreglo asociativo o una cadena con formato JSON. Si el argumento es una cadena, debe coincidir con el formato utilizado para un único recurso en una especificación de sincronización JSON. Devuelve true para indicar éxito y false para indicar fallo. Si se devuelve false, hay información más detallada disponible llamando al método `GetFailureReason`.

### AddAssets(asset\_info\_array As Dynamic) As Boolean

Agrega múltiples recursos desde un objeto enumerable (un objeto *roList*, *roArray*, o una cadena que contiene un arreglo con formato JSON) que contiene arreglos asociativos compatibles. Devuelve true para indicar éxito y false para indicar fallo. Si se devuelve false, hay información más detallada disponible llamando al método `GetFailureReason`.

### GetAssetList() As roList

Devuelve una instancia de *roList* que contiene arreglos asociativos de metadatos de recursos. Este método no es eficiente y, por lo tanto, se recomienda solo para propósitos de depuración y diagnóstico.

Cada arreglo asociativo contiene lo siguiente:

|                  |                |             |                                                                                                                                                                    |
| ---------------- | -------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| name             | String         | Obligatorio | El nombre del recurso. Para que un archivo se materialice, debe tener un nombre de archivo válido (es decir, sin barras diagonales).                               |
| link             | String         | Obligatorio | La ubicación de descarga del recurso                                                                                                                               |
| size             | Integer/String | Opcional    | El tamaño del recurso. Use una cadena si desea especificar un número demasiado grande para caber en un entero (esto permite tamaños de archivo superiores a 2 GB). |
| hash             | String         | Opcional    | Una cadena con el formato "hash\_algorithm\:hash". Consulte la siguiente tabla para ver los algoritmos hash disponibles.                                           |
| change\_hint     | String         | Opcional    | Cualquier cadena que cambie junto con el contenido del archivo. Esto no es necesario si se proporciona el enlace o el hash y siempre cambia.                       |
| auth\_inherit    | Boolean        | Opcional    | Indicación de si este recurso usa o no información de autenticación de *roAssetFetcher*. El valor predeterminado es True.                                          |
| auth\_user       | Boolean        | Opcional    | Usuario que se utilizará para la autenticación al descargar solo este recurso. Esto deshabilita automáticamente "auth\_inherit".                                   |
| auth\_password   | Boolean        | Opcional    | Contraseña que se utilizará al descargar solo este recurso. Esto deshabilita automáticamente "auth\_inherit".                                                      |
| headers\_inherit | Boolean        | Opcional    | El comando para pasar cualquier proveedor de encabezados a *roAssetFetcher* al obtener este recurso. El valor predeterminado es true.                              |

:::hint{type="danger"}
Cualquier campo "optional" que se especifique al rellenar el pool también debe especificarse al recuperar assets del pool (es decir, se convierten en "mandatory" una vez que se usan para un asset). Por ejemplo, si el valor hash se especifica al obtener datos en el pool, entonces también debe especificarse al intentar hacer referencia a archivos en el pool.
:::

Algoritmos hash:

|           |                                                                                                                                                                                                                                                                                                                           |
| --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| sha1      | Si hay un sha1 disponible, puede validar el hash mientras se descarga el archivo. Si dicho hash está disponible, debería utilizarse. Las propiedades link y change\_hint no tienen ningún efecto en el nombre de archivo del pool, por lo que el archivo se comparte incluso si se descarga desde diferentes ubicaciones. |
| besha1    | Este algoritmo aplica hash a parte del archivo junto con el tamaño del archivo para verificar el contenido. También mueve las propiedades link y change\_hint al nombre de archivo del pool.                                                                                                                              |
| MD5       | Utiliza el algoritmo hash MD5 para validar archivos.                                                                                                                                                                                                                                                                      |
| (ninguno) | Sin ningún hash, el archivo no puede verificarse mientras se descarga, y el sistema dependerá de las propiedades link y change\_hint para dar al pool un nombre de archivo único.                                                                                                                                         |