This translation is community contributed and may not be up to date. We only maintain the English version of the documentation. Read this manual in English
El flujo de montaje principal usa liveupdate.add_mount(), liveupdate.remove_mount() y liveupdate.get_mounts(). Consulta la referencia completa de la API liveupdate para conocer todas las funciones disponibles.
Usa liveupdate.is_built_with_excluded_files() cuando el código necesite distinguir un bundle cuyo manifiesto de build espera contenido excluido de Live Update:
if liveupdate.is_built_with_excluded_files() then
print("The bundle expects excluded Live Update content")
end
Esto solo informa sobre los metadatos del manifiesto de build. No significa que haya un archivo montado en ese momento ni que un recurso concreto esté disponible. Usa liveupdate.get_mounts() para inspeccionar los montajes activos y collectionproxy.get_resources() para inspeccionar los hashes de recursos registrados en el manifiesto de un proxy de colección.
El flujo recomendado consiste en descargar y montar un archivo Zip completo con una URI zip:.
liveupdate.get_mounts() devuelve los montajes activos en la sesión actual. Cada entrada contiene una cadena uri, una prioridad numérica priority y un hash name. La lista también incluye los montajes base del motor, que tienen prioridades inferiores a cero y no pueden eliminarse.
El motor no restaura los montajes después de reiniciar. Si la aplicación necesita contenido descargado previamente en una sesión posterior, debe guardar la URI, el nombre y la prioridad del paquete en sus propios datos persistentes y volver a llamar a liveupdate.add_mount() durante el inicio.
Cuando hay varios paquetes montados, resulta útil validar los metadatos que define la aplicación. Como mount.name es un hash, úsalo como clave de tabla o compáralo con hash("mount-name"); no lo concatenes en una ruta de recurso. El siguiente ejemplo asocia cada hash de nombre con una ruta de recurso de metadatos única:
local function remove_old_mounts()
local mounts = liveupdate.get_mounts() -- tabla con montajes
local version_resources = {
[hash("level-pack")] = "/version_level_pack.json",
[hash("season-pack")] = "/version_season_pack.json",
}
for _, mount in ipairs(mounts) do
local version_resource = version_resources[mount.name]
local version_data = version_resource and sys.load_resource(version_resource)
if version_data then
version_data = json.decode(version_data)
elseif mount.priority >= 0 then
version_data = {version = 0} -- si no tiene archivo de versión, probablemente sea un archivo antiguo o no válido
end
-- Ignora los montajes base del motor, que tienen prioridades negativas.
if version_data and version_data.version < sys.get_config_int("game.minimum_lu_version") then
liveupdate.remove_mount(mount.name)
end
end
end
Usa rutas de metadatos únicas para paquetes distintos. La búsqueda de recursos sigue la prioridad de los montajes, por lo que usar la misma ruta en varios paquetes haría que se leyera la copia del montaje de mayor prioridad.
Un proxy de colección (collection proxy) que se ha excluido del bundling funciona como un proxy de colección normal, con una diferencia importante. Enviarle un mensaje load mientras todavía tiene recursos que no están disponibles en el almacenamiento del bundle hará que falle.
En el flujo de trabajo basado en archivos comprimidos de Live Update, por lo general decides de antemano qué archivo comprimido o archivos comprimidos necesita un proxy y los montas antes de cargar. Para inspeccionar los hashes de recursos registrados en el manifiesto de un proxy excluido conocido, usa collectionproxy.get_resources().
Después de montar un paquete, un proxy excluido y no cargado también puede redirigirse a otra colección compilada con collectionproxy.set_collection(). Consulta Cambiar la colección de un proxy excluido para conocer las restricciones y la secuencia de carga.
En una build basada en archivos comprimidos que publica contenido de Live Update, el manifiesto principal incluido en el bundle omite las entradas excluidas de Live Update, mientras que el manifiesto del paquete publicado las conserva. collectionproxy.get_resources() lee los metadatos de dependencias del manifiesto; no comprueba que todos los blobs de datos referenciados estén disponibles:
collectionproxy.get_resources("#proxy") devuelve una tabla vacía {}.{
"a1b2c3...",
"d4e5f6...",
"7890ab...",
...
}
El siguiente código de ejemplo asume que los recursos están disponibles mediante la URL especificada en la configuración game.http_url.
-- Debes llevar el seguimiento de qué archivo contiene cada contenido.
-- En este ejemplo, solo usamos un archivo de Live Update que contiene todos los recursos que faltan.
-- Si usas varios archivos, debes organizar las descargas en consecuencia.
local lu_infos = {
liveupdate = {
name = "liveupdate",
priority = 10,
}
}
local function get_lu_info_for_level(level_name)
if level_name == "level1" then
return lu_infos['liveupdate']
end
end
local function mount_zip(self, name, priority, path, callback)
liveupdate.add_mount(name, "zip:" .. path, priority, function(_self, _name, _uri, _result) -- <1>
callback(_name, _uri, _result)
end)
end
local function has_mount(name)
local name_hash = hash(name)
for _, mount in ipairs(liveupdate.get_mounts()) do
if mount.name == name_hash then
return true
end
end
return false
end
function init(self)
self.http_url = sys.get_config_string("game.http_url", nil) -- <2>
local level_name = "level1"
local info = get_lu_info_for_level(level_name) -- <3>
msg.post("#", "load_level", {level = "level1", info = info }) -- <4>
end
function on_message(self, message_id, message, sender)
if message_id == hash("load_level") then
local proxy_resources = collectionproxy.get_resources("#" .. message.level) -- <5>
-- Una build que publica contenido de Live Update omite las entradas excluidas del
-- manifiesto incluido en el bundle, por lo que esta tabla estará vacía hasta que se monte
-- el manifiesto del paquete correspondiente. Después contendrá los hashes de recursos del proxy.
if message.info and #proxy_resources == 0 and not has_mount(message.info.name) then
msg.post("#", "download_archive", message) -- <6>
else
msg.post("#" .. message.level, "load")
end
elseif message_id == hash("download_archive") then
local zip_filename = message.info.name .. ".zip"
local download_path = sys.get_save_file("mygame", zip_filename)
local url = self.http_url .. "/" .. zip_filename
-- Comprueba si el archivo ya existe. Si existe, intenta montarlo.
if sys.exists(download_path) then
mount_zip(self, message.info.name, message.info.priority, download_path, function(name, uri, result) -- <8>
if result == liveupdate.LIVEUPDATE_OK then
msg.post("#", "load_level", message) -- intenta cargar el nivel de nuevo
else
os.remove(download_path) -- elimina el archivo e intenta
msg.post("#", "load_level", message) -- descargar de nuevo
end
end)
else
-- Realiza la solicitud. Puedes usar credenciales.
http.request(url, "GET", function(self, id, response) -- <7>
if response.status == 200 or response.status == 304 then
mount_zip(self, message.info.name, message.info.priority, download_path, function(name, uri, result) -- <8>
if result == liveupdate.LIVEUPDATE_OK then
msg.post("#", "load_level", message) -- intenta cargar el nivel de nuevo
else
print("Failed to mount archive", download_path, ":", result)
end
end)
else
print("Failed to download archive", download_path, "from", url, ":", response.status)
end
end, nil, nil, {path=download_path})
end
elseif message_id == hash("proxy_loaded") then -- el nivel está cargado y podemos activarlo
msg.post(sender, "init")
msg.post(sender, "enable")
end
end
liveupdate.add_mount() monta un solo archivo comprimido usando un nombre, una prioridad y un archivo ZIP especificados. Luego los datos quedan disponibles de inmediato para cargarse (no es necesario reiniciar el motor). El montaje solo permanece activo durante la sesión actual. Guarda la ruta del paquete descargado y los ajustes de montaje deseados en tus propios datos persistentes y vuelve a llamar a liveupdate.add_mount() después de cada reinicio.collectionproxy.get_resources() para inspeccionar los metadatos del contenido excluido del proxy. Devuelve {} hasta que se monta el manifiesto del paquete correspondiente, y una tabla no vacía de hashes de recursos después de montarlo. Estos hashes describen dependencias; el resultado no comprueba por sí mismo que todos los blobs de datos estén disponibles.download_path.Con el código de carga en su lugar, podemos probar la aplicación. Sin embargo, ejecutarla desde el editor no descargará nada. Esto se debe a que Live Update es una funcionalidad de bundle. Cuando se ejecuta en el entorno del editor nunca se excluyen recursos. Para asegurarnos de que todo funciona bien, necesitamos crear un bundle.