Documentación

Centro de ayuda

Todo lo que hay aquí describe el comportamiento real de la versión 1.0.0. Cuando algo no está definido o no está disponible, se dice explícitamente en lugar de rellenarlo con una suposición.

Primeros pasos

Qué necesitas, qué ocurre al abrir la aplicación por primera vez y cómo está organizada.

¿Qué necesito para empezar a usar ObyStructure?

Un teléfono Android 8.0 o posterior y la aplicación instalada. No hay registro, no hay inicio de sesión y no hace falta conexión a internet: la aplicación funciona entera en el dispositivo.

¿Qué pasa la primera vez que abro la aplicación?

La aplicación arranca en un estado inicial válido y te pide el nombre de músico que quieres que aparezca en la aplicación. Puedes cambiarlo después desde los ajustes. La biblioteca empieza vacía y cada pantalla explica cuál es el siguiente paso disponible.

¿Cómo está organizada la aplicación?

Hay cinco áreas: Inicio, la biblioteca (canciones, popurrís y conciertos), el editor de cada elemento, el modo directo y los ajustes. La navegación principal está siempre disponible y no cambia de sitio al girar el teléfono.

¿Dónde se guarda lo que escribo?

En el almacenamiento privado de la aplicación, en tu teléfono. Nada sale del dispositivo. Si desinstalas la aplicación, esos datos se borran con ella.

Instalación y compatibilidad

Requisitos, permisos y qué esperar de una versión que aún no está publicada.

¿En qué versiones de Android funciona?

ObyStructure 1.0.0 está compilada para Android 8.0 (API 26) o posterior, con Android 16 (API 36) como objetivo de compilación. No hay versión para iOS, escritorio ni web.

¿Qué permisos pide la aplicación?

Ninguno en tiempo de ejecución. Declara INTERNET, que Android exige para cualquier comunicación de red aunque sea local, y ACCESS_LOCAL_NETWORK en las versiones que lo conocen, para la sesión en red. No hay pantallas pidiendo permisos porque no necesita ninguno.

¿Puedo descargarla ya?

Todavía no. La versión 1.0.0 está terminada y verificada, pero la ficha pública de Google Play no se ha publicado, así que no existe una URL oficial de descarga. Cuando exista, se publicará en esta web y en la página de ObyStructure. Este sitio no ofrece enlaces de terceros ni copias no oficiales.

¿Necesita internet?

No para trabajar. Todo el flujo local (repertorio, edición, directo, metrónomo) funciona sin conexión. La sesión en red usa la red local, no internet.

Crear y organizar canciones

Secciones, compases, acordes y las fórmulas de compás que admite esta versión.

¿Cómo se estructura una canción?

Cada canción tiene título, tempo base, tonalidad base y una lista ordenada de secciones. Cada sección tiene nombre, tipo (por ejemplo intro, verso o una sección personalizada), número de compases, fórmula de compás, subdivisiones, repeticiones y los acordes colocados en su compás y en su pulso.

¿Qué fórmulas de compás admite esta versión?

4/4, 3/4 y 2/4. La rejilla muestra un pulso por celda: cuatro celdas por compás en 4/4, tres en 3/4 y dos en 2/4. El 6/8 no forma parte de esta versión, y la interfaz no lo ofrece como opción.

¿Puedo guardar una canción a medias?

Sí. Un borrador válido se conserva y se puede completar después. La aplicación no aplica una validación global que impida guardar trabajo a medio hacer.

¿Puedo borrar una canción que se está usando?

La eliminación respeta las dependencias: si la canción forma parte de un concierto, la aplicación te lo dice antes de borrar en lugar de dejar una referencia rota.

¿El editor cambia mi canción al guardar?

No. Guardar y volver a abrir debe devolver exactamente la misma estructura. Las posiciones de acorde antiguas que siguen siendo válidas se conservan tal cual; la versión simplificada de la rejilla no las reescribe.

Popurrís y conciertos

Cómo se encadenan temas y cómo se ordena una actuación completa.

¿Qué es un popurrí en ObyStructure?

Una pieza que encadena varias canciones o tramos de canciones con un orden explícito. Cada pieza indica de qué canción sale, qué tramo de secciones usa, cuántas veces se repite y cómo se sale de ella (directa, con silencio, con aviso o manual).

¿Un popurrí copia las canciones o las enlaza?

Las enlaza por identificador. Un popurrí guarda referencias a las canciones y sus tramos, no una copia del contenido, y la aplicación comprueba que las referencias siguen existiendo.

¿Qué es un concierto?

La secuencia de lo que se va a tocar: canciones y popurrís en orden. El concierto conserva ese orden al editar, guardar, cerrar y ejecutar. Entre elementos de un concierto puede haber una pausa del director; dentro de una canción o de un popurrí no se introduce esa pausa.

¿Puedo repetir el mismo tema dos veces en un concierto?

Sí. Si lo pones dos veces en la secuencia, son dos elementos distintos en el concierto, y así se conserva en el archivo que exportas. Eso no es un duplicado: es lo que escribiste.

El modo directo

Qué muestra la pantalla de ejecución y cómo se comporta la cuenta atrás.

¿Qué muestra la pantalla de directo?

La canción que suena, la sección y el compás, el acorde actual, el acorde siguiente, la fila de pulsos, el estado de reproducción y el transporte. En horizontal, la zona de información siguiente muestra el cifrado que viene y su cuenta atrás.

¿Qué es la cuenta atrás y cuándo aparece?

Es un indicador obligatorio del directo: cuenta los pulsos que faltan para el cambio de acorde cuando ese cambio cae dentro del compás actual. Un cero significa que el cambio entra en el pulso actual. Si el cambio está programado en un compás posterior, la aplicación no inventa una cifra: mantiene el acorde siguiente y su estado informativo.

¿La cuenta atrás puede desaparecer al cambiar el diseño?

No. Forma parte del contrato del producto y se mantiene visible y legible en vertical y en horizontal. Ningún ajuste visual puede quitarla, ocultarla ni desactivarla.

¿Quién manda en la posición de reproducción?

Un único motor de tiempo. La posición, el acorde actual, el siguiente y la cuenta atrás salen de ese motor, no de un segundo temporizador de la interfaz.

¿Puedo tocar en horizontal?

Sí. Vertical y horizontal conservan la misma información esencial y el mismo comportamiento.

Archivos .oby: importar y exportar

Qué es un archivo .oby, qué garantiza y cómo se importa sin sorpresas.

¿Qué es un archivo .oby?

Es un archivo de texto en formato JSON que transporta contenido musical de ObyStructure entre instalaciones: canciones, popurrís, conciertos o el repertorio completo. No necesita servidor, ni cuenta, ni conexión.

¿Qué garantiza el archivo?

Que el contenido no se alteró por el camino: el archivo incluye un resumen SHA-256 del contenido musical y se comprueba al importar. No garantiza quién lo creó: el formato no lleva firma ni cifrado, así que un archivo se puede abrir con un editor de texto.

¿Cómo importo un archivo?

Desde la propia aplicación, con «Importar archivo» y el selector de documentos del sistema. También puedes abrir un .oby recibido desde otra aplicación, que lleva al mismo sitio. En los dos casos la aplicación lee el archivo, lo analiza y te pide confirmación: nada se importa al abrirlo.

¿Qué pasa si el archivo ya lo tenía?

El identificador de cada elemento es su identidad, no el título. Si el elemento no existe, se importa; si existe y es idéntico, se reutiliza sin escribir nada; si existe con el mismo identificador y contenido distinto, se conserva lo tuyo y se te informa de cuántos elementos se han conservado. Reimportar el mismo archivo no duplica nada.

¿Y si al archivo le falta una canción que el concierto necesita?

Se rechaza el paquete completo. Importar «lo que se pueda» dejaría un concierto apuntando a canciones que no existen.

¿El archivo lleva el audio?

No. El formato transporta la estructura musical, no pistas de audio. El campo de audio del modelo es una ruta local del dispositivo de origen.

¿Hay un tamaño máximo?

Sí: 8 MiB por archivo, hasta 4 000 canciones, 2 000 popurrís y 1 000 conciertos (6 000 entidades en total). Un repertorio de banda real ocupa decenas de kilobytes.

Sesiones en red

Tocar el mismo concierto entre varios dispositivos en la misma red local.

¿Qué es una sesión en red?

Una forma de coordinar varios dispositivos en la misma red local: uno dirige y reparte el concierto, y los demás lo reciben, comprueban que es el mismo y tocan su parte. Funciona sin internet.

¿Qué roles hay?

Dos: director (crea y anuncia la sesión) y músico (se une a una sesión anunciada). La aplicación muestra el rol y el estado de la conexión de cada participante.

¿Qué pasa si alguien pierde la conexión?

Su música sigue sonando con el contenido que ya tiene, y la sesión se recupera cuando el dispositivo vuelve. Al terminar la sesión, el repertorio local sigue disponible.

¿La sesión en red y los archivos .oby son lo mismo?

No. Son dos funciones distintas con dos formatos distintos: la sesión coordina la ejecución en vivo dentro de la red local; el archivo .oby intercambia contenido entre instalaciones.

Problemas frecuentes

Qué hacer cuando algo no se comporta como esperas.

Al importar, la aplicación dice que el archivo puede estar incompleto.

El archivo no llegó entero. Suele pasar cuando se corta una transferencia por mensajería. Pide el archivo otra vez y vuelve a intentarlo; el resumen de integridad es lo que detecta ese caso.

La aplicación dice que el archivo es de una versión que no sabe leer.

El archivo se creó con una versión más nueva del formato. Actualiza la aplicación; la aplicación no intenta leer «lo que se pueda» de una versión futura.

No encuentro cómo importar un archivo que me han enviado.

Dentro de la aplicación, usa «Importar archivo» y el selector de documentos del sistema. Es la vía que funciona siempre: la asociación de la extensión .oby con la aplicación no es fiable en todos los clientes de mensajería.

He perdido un cambio al editar otra cosa.

Editar un elemento no debe modificar otro, y volver a inicio no reinicia tus datos. Si ves un comportamiento distinto, es un fallo: repórtalo con el nombre del elemento, la acción y el resultado esperado.

En una sesión no aparece nadie o no se ve la sesión.

Comprueba que los dispositivos están en la misma red local, que la sesión está anunciada y que el dispositivo que dirige no ha terminado la sesión. Una conexión correcta no demuestra por sí sola que la sincronización musical sea correcta: verifica el estado que muestra cada pantalla.

Soporte y contacto

Cómo reportar un problema y qué información ayuda a resolverlo.

¿Cómo reporto un problema?

Todavía no hay un canal público de soporte verificado. Cuando la ficha de Google Play se publique, incluirá el correo de soporte del desarrollador y esta web lo enlazará. No se ha inventado una dirección de contacto: ver la página de contacto para el estado exacto.

¿Qué información ayuda a resolver un problema?

El modelo de teléfono y la versión de Android, la versión de la aplicación, la pantalla donde ocurre, los pasos que llevaron al problema y lo que esperabas que pasara. Si el problema tiene que ver con un archivo .oby, indica de dónde vino y qué mensaje apareció.

¿Hay alguna limitación conocida?

Sí, y se documenta en lugar de ocultarse: esta versión no admite 6/8 ni selección de subdivisiones; no transporta audio en los archivos .oby; las sesiones en red funcionan solo en la red local; y la ficha de Google Play todavía no está publicada.

Documentación pendiente

Lo que falta y por qué falta, para que nadie lo confunda con una función inexistente.

  • Capturas del modo directo. No hay una captura publicable que no contenga el repertorio real de una persona, y no se van a usar esas.
  • Canal de soporte. Falta el correo público del desarrollador; lo define el propietario y se publicará con la ficha de Google Play.
  • Ficha de Google Play. Sin publicar. Hasta entonces no hay URL oficial de descarga.
  • Recetario de contenido. La biblioteca de recursos crecerá cuando existan archivos verificados que publicar.

¿No está tu caso?

La página de contacto explica qué canal hay disponible y qué información conviene tener preparada para reportar un problema.

Ver contacto