roAssetRealizer
Este objeto contiene funciones para realizar archivos (es decir, extraer archivos de un grupo de recursos y colocarlos en el directorio de archivos estándar). No se recomienda realizar un grupo de recursos completo porque el proceso puede ser lento. En su lugar, el script debe recuperar las ubicaciones de los archivos del grupo usando el objeto roAssetPoolFiles y utilizarlas para hacer referencia a archivos directamente. El objeto roAssetRealizer sigue siendo útil para realizar archivos que deben estar en el directorio raíz para funcionar (por ejemplo, archivos de autorun y actualización de firmware). El equivalente en JavaScript es assetrealizer.
Creación del objeto: El objeto roAssetRealizer requiere dos parámetros al crearse: un objeto roAssetPool y un directorio de destino.
CreateObject("roAssetRealizer", pool As roAssetPool, destination_directory As String)Ejemplo
pool = CreateObject("roAssetPool", "pool")
realizer = CreateObject ("roAssetRealizer", pool, "/")IfUserData
SetUserData(user_data As Object)
Establece los datos de usuario que se devolverán cuando se generen eventos.
GetUserData() As Object
Devuelve los datos de usuario que se establecieron previamente mediante SetUserData(). Devolverá Invalid si no se ha establecido ningún dato.
ifAssetRealizer
GetFailureReason() As String
Proporciona información útil adicional si el valor de retorno de una función indica un error.
EstimateRealizedSizeInMegabytes(spec As Object) As Integer
Devuelve la cantidad estimada de espacio que ocuparía la especificación de sincronización indicada.
Realize(spec As roSyncSpec/roAssetCollection) As roAssetRealizerEvent
Coloca los archivos en el directorio de destino especificado en el roSyncSpec o roAssetCollection proporcionado. Si el grupo no contiene el conjunto completo de archivos requeridos, este método fallará inmediatamente antes de que se modifique cualquier archivo (este método intenta hacer la mayor cantidad de trabajo posible antes de modificar destructivamente el sistema de archivos). Este método verifica automáticamente la longitud del archivo y cualquier hash que coincida con la especificación. Si hay una discrepancia, el archivo afectado se elimina y la realización falla. Este método indica éxito o fallo devolviendo un objeto roAssetRealizerEvent.
El grupo y el destino deben estar en el mismo sistema de archivos.
ValidateFiles(spec As Object, options As Object) As roAssociativeArray
Verifica el hash de cada archivo en la especificación con el archivo correspondiente en la ruta de destino y devuelve un arreglo asociativo que contiene cada nombre de archivo no coincidente asignado al motivo. El parámetro options es un roAssociativeArray, que actualmente puede admitir una sola opción:
- "DeleteCorrupt": Elimina automáticamente cualquier archivo que no coincida con el hash esperado. De forma predeterminada, estos archivos no se eliminan.