roAssetCollection

6 min

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

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

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:

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.

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.