Saltar al contenido
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Instantáneas

Los servidores de contenido compilarán periódicamente resúmenes de las entidades activas que alojan, llamados instantáneas. Son archivos regulares archivos y pueden descargarse usando su identificador.

Las instantáneas se crean diariamente, semanalmente, mensualmente y anualmente. Cada una contiene el conjunto de entidades activas que cambiaron desde la instantánea anterior para ese intervalo.

Las instantáneas contendrán versiones en conflicto de las mismas entidades (es decir, diferentes archivos manifest asociados al mismo pointer) a medida que se actualizan. Al analizarlas, los clientes deben conservar la versión de la instantánea más reciente. Dado que los servidores de contenido pueden eliminar archivos inactivos, no se garantiza que las versiones obsoletas de las entidades estén disponibles para su descarga.

Cuando una nueva instantánea reemplaza a las anteriores (por ejemplo, una instantánea semanal que combina una serie de instantáneas diarias), sus metadatos indican qué archivos previos son reemplazados para que los clientes no necesiten descargarlos.

El conjunto completo de entidades activas puede descubrirse combinando todas las instantáneas disponibles (más sobre esto a continuación), conservando la entidad más reciente referenciada por cada pointer descubierto en el camino.

Puedes experimentar con las instantáneas usando código funcional en la práctica sección.

Descubriendo instantáneas

Para localizar el conjunto actual de instantáneas, usa el instantáneas endpoint. La respuesta contiene una matriz de elementos con estos campos:

Campo
Valor

generationTimestamp

La marca de tiempo UTC de Unix cuando se creó esta instantánea.

hash

La instantánea archivo.

numberOfEntities

La cantidad de entradas en el archivo de instantánea.

replacedSnapshotHashes

Una matriz con los hash hashes de cualquier instantánea reemplazada por esta.

timeRange.initTimestamp

La marca de tiempo UTC de Unix (en milisegundos) para el inicio del intervalo de la instantánea.

timerange.endTimestamp

La marca de tiempo UTC de Unix (en milisegundos) para el final del intervalo de la instantánea.

Por ejemplo:

{
  "generationTimestamp": 1684979298844,
  "hash": "bafybeiflmm46nr4vv2h3wuzbx3pukcz7ju4fhbfzt6yxmoo533uktlgru4",
  "numberOfEntities": 12345,
  "replacedSnapshotHashes": [ "bafybeicw6x75ieaxfwynekbyhpcsgctpjkt6cb4j6oa7s57qjj6e4b5phd" ],
  "timeRange": {
     "initTimestamp": 1684281600000,
     "endTimestamp": 1684886400000
  }
}

Descargando instantáneas

Usando el hash campo timeRange de una instantánea, los clientes pueden descargar las entidades asociadas contenidas creadas o actualizadas en ese intervalo de tiempo.

Las instantáneas comienzan con esta línea exacta:

Después de eso, cada línea es un documento JSON que describe una entidad con los siguientes campos:

Campo
Valor

entityId

El identificador inmutable de esta entidad.

entityType

Uno de escena, perfil, wearable, emote, store o outfits.

pointers

Una matriz de pointers que resuelven (o resolvían) a esta entidad.

entityTimestamp

La marca de tiempo UTC de Unix (en milisegundos) cuando se cargó esta entidad.

authChain

El cadena de autenticación para esta entidad.

Una entrada típica luce así:

Si tienes intención de analizar una instantánea línea por línea, recuerda omitir (o mejor aún, validar) la primera con el encabezado, y prepárate para manejar una línea vacía al final del archivo.

Iniciar un índice de entidades

Los clientes que quieran indexar el conjunto completo de entidades activas deben procesar todas las instantáneas actualmente disponibles, y conservar la más reciente entidad para cada pointer.

La estrategia más simple es procesar las instantáneas en orden cronológico inverso (es decir, primero la más reciente), ignorando los pointers que ya se hayan descubierto, para conservar la referencia a la entidad más reciente.

En pseudocódigo:

Dado que las entidades individuales pueden ser referenciadas por múltiples pointers (como suele ocurrir con escenas), todos ellos deben comprobarse antes de decidir si conservar o descartar el elemento.

Los archivos de instantáneas para los intervalos de tiempo más largos pueden ser muy grandes. Para propósitos de desarrollo y experimentación que no requieran indexar todo el conjunto de entidades, se recomienda usar las instantáneas más pequeñas. El conjunto resultante de entidades será incompleto pero válido.

Actualizar un índice de entidades

Los clientes que mantengan un índice de entidades actualizado pueden hacer llamadas periódicas al instantáneas endpoint, y determinar si descargar cada archivo considerando:

  • ¿Se ha descargado ya la instantánea identificada por hash ?

  • ¿Está hash en la replacedSnapshotHashes lista de otra instantánea que ya se descargó?

  • ¿Es la timeRange relevante para los propósitos actuales?

Si hay que procesar nuevas instantáneas, puede usarse la misma estrategia que arriba para actualizar un conjunto de datos existente.

Ejemplos

En la práctica sección, encontrarás ejemplos de código que funcionan con el sistema de instantáneas.

Última actualización