El formato funscript, campo por campo

La estructura

Un funscript es un único objeto JSON guardado como texto UTF-8 con la extensión .funscript. Un archivo pequeño completo, con la forma en que lo guarda AutoScript Sync:

{
  "version": "1.0",
  "inverted": false,
  "range": 100,
  "metadata": {
    "creator": "AutoScript Sync",
    "format": "funscript"
  },
  "actions": [
    {"at": 0,    "pos": 50},
    {"at": 350,  "pos": 95},
    {"at": 720,  "pos": 5},
    {"at": 1080, "pos": 95},
    {"at": 1500, "pos": 5},
    {"at": 5500, "pos": 5}
  ]
}

Los dos últimos puntos mantienen la misma posición durante cuatro segundos: un reposo se escribe como dos puntos con el mismo pos, no como un hueco. En JSON el orden de las claves no importa, y los espacios en blanco son libres.

Los campos

actions

Un array de puntos, cada uno un objeto con at y pos. Es el único campo que necesita un reproductor. Un archivo sin él no es un script utilizable.

at

El momento del punto en milisegundos desde el inicio del vídeo, como número entero. 1500 es segundo y medio.

pos

La posición en la que estar en ese momento, como número entero de 0 a 100. Lo que significan físicamente 0 y 100 depende del dispositivo y sus ajustes; el archivo solo dice "hasta aquí del rango".

version

La versión del formato como cadena, normalmente "1.0".

inverted

true o false. Cuando es true, las posiciones deben leerse invertidas, como 100 − pos.

range

Un número, normalmente 100, que describe la amplitud de pos. La mayoría de los archivos lo dejan en 100.

metadata

Un objeto para cualquier cosa sobre el script: el programa que lo creó, un título, notas, etiquetas. Los reproductores no lo necesitan para reproducir el archivo.

Los archivos de los editores suelen llevar claves adicionales de nivel superior, como capítulos o marcadores. Están permitidas; un lector que no las entienda debería ignorarlas y, idealmente, conservarlas.

Convenciones que sigue un archivo bien formado

• at es un número entero de milisegundos, contado desde el inicio del vídeo, nunca negativo.
• pos es un número entero de 0 a 100.
• Las acciones están ordenadas por at, de la más temprana a la más tardía.
• Dos acciones nunca comparten el mismo at.
• Los números son números JSON, no cadenas: "at": 400, no "at": "400".

Los programas difieren en cuánto toleran un archivo que incumple estas reglas. La aplicación de escritorio repara lo que puede, como se describe más abajo. Nuestra propia herramienta de navegador, Report Studio, no lo hace: da por hecho que las acciones ya están ordenadas, toma la duración de la última acción, ignora inverted y range, y rechaza un archivo cuyos valores at sean cadenas. Un archivo que sigue las cinco convenciones evita esas diferencias.

Cómo lee un archivo AutoScript Sync

Cuando abres un script con Load Funscript…, lo sueltas en la ventana o abres un vídeo con un script del mismo nombre al lado, la aplicación repara las acciones en lugar de rechazar el archivo:

• ordena las acciones por tiempo;
• fusiona las acciones que comparten tiempo y conserva la última;
• limita pos a 0–100 y los tiempos negativos a 0;
• omite las entradas que no puede leer, sin decir cuántas;
• lee range pero nunca lo usa para reescalar, así que un archivo con un rango distinto de 100 se sigue tratando como 0–100;
• conserva version tal como la encuentra ("1.0" si falta).

La próxima actualización (2.121.2, ya compilada pero aún no publicada) hace que el lector acepte más archivos y conserve más de lo que contienen:

• los archivos guardados con marca de orden de bytes (BOM), o en UTF-16, se cargan en lugar de rechazarse;
• inverted: true se aplica una vez al cargar (100 − pos), con un aviso para ti, y el archivo se vuelve a guardar con inverted: false, de modo que cualquier otro reproductor vea el mismo movimiento. La aplicación publicada ignora el indicador, así que un archivo invertido se reproduce al revés;
• los valores fraccionarios de at y pos se redondean al número entero más cercano, y los valores NaN o infinitos se omiten;
• las claves de nivel superior desconocidas, como capítulos o marcadores, se conservan y se vuelven a escribir al guardar; la aplicación publicada las elimina al guardar;
• un archivo que no es texto, no es JSON, no es un objeto o no tiene lista actions recibe un mensaje en lenguaje claro, y un script sin acciones utilizables no se asocia al vídeo.

Cómo escribe un archivo AutoScript Sync

Cada script que guarda la aplicación, generado o editado, sigue las convenciones anteriores, pase lo que pase en el editor:

• Las acciones se escriben en orden de tiempo ascendente, con tiempos únicos, at como número entero no negativo de milisegundos y pos como número entero de 0 a 100. Si dos puntos se redondean al mismo milisegundo, gana el posterior.
• Cabecera: version, inverted y range se escriben tal como están; un script generado recibe "1.0", false y 100.
• Metadatos: creator siempre se establece en "AutoScript Sync" y format en "funscript". Guardar encima del script de otra herramienta sustituye su creador.
• Detalles del análisis en los scripts generados: generador, resumen del reconocimiento, tiempos, ruta de seguimiento y un bloque ai con la etiqueta de tipo de escena de cada ventana de dos segundos, la región seguida, cuánto se rellenó en lugar de medirse y las puntuaciones de la elección de ancla.
• Guardado seguro: el JSON se escribe, con sangría, en un archivo temporal y luego se intercambia, así que un fallo a mitad del guardado no puede corromper el script existente.
• Copia de seguridad: cuando Generate guarda junto al vídeo, cualquier script existente se copia primero a <name>.funscript.bak. Solo se conserva una copia; el siguiente Generate la sobrescribe.

El archivo en disco nunca se ajusta a un dispositivo. Cuando la aplicación envía un script al Autoblow AI Ultra, ajusta una copia a los límites del dispositivo y quita los metadatos del análisis, conservando solo el movimiento y unos pocos campos de cabecera (generator, creator, format, version, range, stroke_expansion y un id si lo hay).

Preguntas

Sigue leyendo

• Comprueba un archivo con el validadorEncuentra en tu navegador los errores de esta página y ofrece una copia reparada.
• Una introducción en lenguaje claroQué es un funscript y cómo lo usa un dispositivo, sin el detalle de los campos.
• Cómo hacer un script, a mano o generadoEl proceso desde el vídeo hasta un archivo guardado y comprobado.
• El centro de aprendizajeLas cuatro páginas de referencia.