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:
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:
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í:
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.
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á
hashen lareplacedSnapshotHasheslista de otra instantánea que ya se descargó?¿Es la
timeRangerelevante 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