Saltar al contenido
Cómo funcionaPor qué así →

Inducción de filtrado con Música

Por qué así: por-que-asi/induccion-de-filtrado.md · Normativo: MindTune_Induccion_de_Filtrado.md (entero), MindTune_Reglas_v1.md §1.1 y §8, MindTune_Mi_MindTune_y_Perfil.md §2.3, DS §4.39 y §4.40 · Código: lib/features/audio/rampa_mezcla.dart, lib/features/terapias/induccion_filtrado_screen.dart, lib/features/terapias/hoja_como_te_fue.dart, lib/domain/plan_de_descenso.dart, lib/domain/chequeo_induccion.dart, lib/data/ajustes_providers.dart Verificado contra 67c165a el 2026-10-10 · Probado en iPhone: no (IF.3-bis, IF.4-bis, IF.5-bis)

Qué es, en tres frases

El paciente sube su propia música sin modificar hasta el nivel en que justo tapa su tinnitus, o queda apenas por debajo —el punto de mezcla—, y desde ahí el nivel baja solo, despacio, durante 25 a 40 minutos. La sesión cuenta cuando termina esa bajada; la música puede seguir sonando hasta el minuto que el paciente elija. Cada día que hubo una sesión completa, la app propone que la música baje un poco más (el plan de descenso) y, de vez en cuando, antes de empezar, pregunta ¿Cómo te fue? para ajustar ese plan.

Es la terapia más simple de MindTune y la única que no necesita ningún dato del perfil.

Dónde está en la app

Terapias → Inducción de filtrado con Música, la primera del catálogo. La tarjeta cerrada dice Inducir filtrado con tu música · 25 min o más. Necesita una lista de música utilizable y haber leído su lección Cómo usarla en cualquier versión (D-A37). Si la lección se termina desde fuera de la pantalla de la terapia (Aprender, Hoy o el acordeón del catálogo), Entendido lleva a la terapia si con la lección quedó lista, no de vuelta a Aprender ni al catálogo (D-A38, D-A48).

En Hoy, cuando Inducción es la terapia del día, la dosis dice 25 min o más, con tu música. (el número es el fin de la bajada en uso).

En el acordeón de su tarjeta —y en la portada del perfil mientras el perfil esté incompleto— aparece de forma permanente esta nota, que es texto normativo y va literal:

Puedes empezar hoy mismo, sin haber completado tu perfil. Inducción de filtrado con Música no necesita personalización: es música que tú eliges, a un volumen que justo cubre tu tinnitus y que va bajando de a poco. En nuestra experiencia, cerca de 7 de cada 10 personas con tinnitus obtienen algún alivio con ella —en algunos casos parcial, en otros muy alto o total— sin importar las características de su tinnitus. Es la terapia más sencilla de MindTune y, para lo simple que es, sorprendentemente potente. No a todas las personas les alivia por completo. Por eso existe el resto del perfil: para encontrar qué más te puede servir.

⚠️ Desfase: la cifra 7 de cada 10 no tiene fuente publicable. Es una afirmación clínica de Hayo desde el programa CAS, y está pendiente anclarla a un dato o bajarla a «la mayoría» antes de la App Store (PF-P1, DF-17). Hoy el texto está en la app tal cual.

Paso a paso

  1. ¿Cómo te fue? (solo algunos días). La primera vez que se abre Inducción en el día, si hubo una sesión en un día anterior, la app evalúa el plan de descenso y puede presentar una hoja antes de que suene nada: el ▶ y Empezar la sesión esperan a que se responda o se cierre. Detalle en ¿Cómo te fue? y en El plan de descenso. Si el recorrido de primer uso de la terapia no se vio, va primero el recorrido y la hoja al cerrarlo.
  2. Calibrar el punto de mezcla. «Toca ▶ para que suene tu música y sube el nivel hasta que justo tape tu tinnitus, o quede apenas por debajo. Ni más. Este punto cambia de un día a otro: por eso lo ajustas en cada sesión.» Mientras no suena, bajo el control: Toca ▶ para escuchar, y ajusta el nivel mientras suena. (se va con un fundido al empezar a sonar y no vuelve en esa apertura; DS §4.40). Debajo, siempre: Si no logras taparlo con un volumen cómodo, no te preocupes: busca una intensidad que siga siendo cómoda. Esto funcionará igual. Si hubo una sesión previa: La vez anterior quedó en {nivel}.
  3. Empezar. Botón Empezar la sesión · 25 min o más (el número es el fin de la bajada en uso: 25 hasta el nivel 50 del plan, hasta 40 en el nivel 100). Debajo, la línea de dosis propia de Inducción: De 25 a 35 minutos ya funciona. Puedes repetirla y dejarla sonar todo lo que quieras.
  4. La bajada. «Bajando lentamente desde tu punto de calibración.», cuánto lleva bajado en dB y cuánto menos fuerte se oye la música respecto de la calibración. La barra y la línea de 25:00 · quedan 22:00 cuentan hacia el fin de la bajada, no hacia el final de la música. Bajo el gráfico, fija: Si en algún momento la música te molesta, bájala con los botones de volumen del teléfono. (el descenso es relativo al punto calibrado: bajar el volumen del sistema no rompe la rampa; no hay control de nivel en sesión).
  5. Con la pantalla apagada. «Puedes bloquear la pantalla y guardar el teléfono. La música sigue y se detiene sola en el minuto {m}.» (m = Música hasta; con el nivel 100, el fin de la bajada).
  6. Al terminar la bajada, la sesión de hoy ya está. La tarjeta dice La bajada terminó: la sesión de hoy ya está. La música sigue hasta el minuto {m}; puedes seguir o terminar., Terminar antes pasa a Terminar, la barra queda llena y quieta y la línea solo muestra el tiempo transcurrido. Con el nivel 100 la música llega a −60 dB en ese minuto, se apaga y la sesión termina sola.
  7. Cierre. Sesión completa si llegó al fin de la bajada (también si después tocó Terminar o salió con ‹); si no, Sesión registrada y Escuchaste 20 min de 25 min. Queda registrada tal cual, sin nada que recuperar. Salir con ‹ o con el gesto antes del fin de la bajada no registra nada. Sin celebración.

Se puede hacer más de una vez al día, a cualquier hora, con audífonos o con parlante: la pantalla no exige salida privada. El plan avanza una vez por día calendario, no por sesión.

La dosis: 25 minutos o más

ConceptoLo que hace la app
Lo que cuenta como sesión completaLlegar al fin de la bajada (finRampa): 25 min hasta el nivel 50; de 26 a 40 min sobre 50 (o el inicio y la duración del descenso fijados a mano o por el equipo: finRampa = inicio + duración)
sesionHecha para las reglasInducción: ≥ 25 min escuchados o completa (kDosisMinimaUtil, por terapia: Inducción 25, mMIDST 30)
Música hasta60 min por defecto; el paciente la mueve entre el fin de la bajada y 120 min. Con el nivel 100 no se muestra: la sesión termina cuando la música se apaga
Línea de dosisDe 25 a 35 minutos ya funciona. Puedes repetirla y dejarla sonar todo lo que quieras. (bajo el botón y en Recomendaciones para mí). mMIDST conserva la suya, Con 30 ya cuenta. Más, si quieres.
HoraNinguna fija. El subtítulo de franja de Hoy (Mejor en la tarde, según tu perfil) es una sugerencia, no una regla

Cómo se registra: la sesión guarda dosisPlanificada = el fin de la bajada, de modo que completa (escuchado ≥ dosis), sesionHecha, el Historial, el panel del equipo y la exportación dicen lo mismo. Música hasta no queda en la sesión registrada: vive en los ajustes en uso.

⚠️ Desfase: el Historial muestra escuchado de dosis, así que una sesión que sonó hasta el final de la música dice «60 de 25 min». Es correcto bajo D-IF2 pero se lee raro; la redacción queda para Hayo/Cowork (INFORME_IF.3 §3 D1; DF-34).

El plan de descenso

El nivel del plan p es cuánto baja la sonoridad percibida al terminar la bajada, en puntos enteros de porcentaje: el mismo «20 %» de siempre. Parte en 20. Vive en los ajustes propios de Inducción como descensoSonoridad = p/100, así que la pantalla, Hoy, el catálogo y la foto al servidor leen el mismo número.

Dentro de la sesión la música baja por escalones (IF.7, normativo §2.4): se queda estable un tramo (meseta), baja un escalón con medio coseno en dB, se queda estable otra vez, y así hasta el fin de la bajada. El tramo (Largo de cada tramo) es de 3 min por defecto, 1–15. Caben N = max(1, ⌊R/(2·tramo) + 0,5⌋) escalones —la mitad exacta sube, igual en Dart y en el oráculo— y el tramo que suena es R/(2N), para terminar justo en el fin de la bajada: con 25 min son 4 escalones de 3,125 min; con 40, 7 de 2,86. Cada bajada entrega descenso/N dB. Lo que no cambia: el descenso total, el fin de la bajada, Música hasta, qué cuenta como completa y el plan. mMIDST baja con la misma forma (D-IF17), desde MM.3 en la segunda mitad de su sesión y con tramos de 5 min (ver mMIDST); en el oráculo es SessionRamp(curve="escalones", step_min=…) y tools/oracle/escalones_golden.json ata las dos implementaciones punto a punto. La pantalla nunca cuenta escalones ni anuncia bajadas. Hasta IF.6 la bajada era una recta en dB; lo registrado antes se lee formaDescenso = lineal.

Los niveles

La secuencia completa son 32 niveles y 31 avances: siete pasos de 20 a 50 y veinticinco de 50 a 100, alrededor de un mes si cada día hay sesión completa y nada la frena. Esta tabla la ata un test al dominio (test/if6_docs_induccion_test.dart contra plan_de_descenso.dart):

Nivel n.ºp (%)dB al final de la bajadaBajada (min)
120−3,225
225−4,225
330−5,125
435−6,225
540−7,425
645−8,625
750−10,025
852−10,626
954−11,226
1056−11,827
1158−12,527
1260−13,228
1362−14,029
1464−14,729
1566−15,630
1668−16,430
1770−17,431
1872−18,432
1974−19,432
2076−20,633
2178−21,833
2280−23,234
2382−24,735
2484−26,435
2586−28,436
2688−30,636
2790−33,237
2892−36,438
2994−40,638
3096−46,439
3198−56,439
32100−60,0 y silencio40

Sobre 80 % la caída en dB se acelera (−23 → −60 en diez pasos). Está por oírse en el iPhone (IF-P1).

Cuándo cambia el nivel

La evaluación ocurre una vez por día calendario, al abrir Inducción en calibración (nunca desde el recorrido de Aprender), y solo si hay sesiones de Inducción en un día anterior que todavía no se juzgó. Mira el último día con sesiones y decide en este orden; al lado de cada salida, el motivo que queda en la bitácora:

flowchart TD
  A[Primera apertura del día en calibración] --> B{Sesiones de Inducción en un día anterior, sin juzgar}
  B -->|no| N0[No se evalúa: nada cambia, sin hoja]
  B -->|sí| E{Indicación del equipo aceptada, sin apartarse del descenso}
  E -->|sí| EQ[Manda el equipo, el plan no corre · equipo]
  E -->|no| C{Alguna sesión de ese día llegó al fin de la bajada}
  C -->|no| MI[Se mantiene · mantiene_incompleta]
  C -->|sí| NG{Señal negativa en el chequeo de hoy}
  NG -->|sí| ND{El chequeo respondido anterior también fue negativo}
  ND -->|sí| RE[Retrocede 5, piso 20 · retrocede]
  ND -->|no| MN[Se mantiene · mantiene_negativa]
  NG -->|no| DF{Señal de dificultad}
  DF -->|sí| MD[Se mantiene · mantiene_dificultad]
  DF -->|no| AV[Avanza un paso · avance]

Cómo leerlo:

⚠️ Desfase: Inducción §2.2 dice «una indicación … que fija el descenso»; el código cuenta cualquier indicación aceptada de Inducción (INFORME_IF.4 §3 D8). Decisión abierta para Cowork/Hayo; DF-33.

La propuesta y el acuerdo

El cambio se propone, no se aplica solo. En la hoja va el bloque Para hoy, con estos textos literales:

CasoTexto
AvanzaTe proponemos que la música baje un poco más: {nuevo} % (antes {anterior} %), en {rampa} min.
Avanza a 100Te proponemos que la música baje hasta apagarse, en {rampa} min.
Se mantieneHoy seguimos igual: la música baja un {p} % en {rampa} min.
RetrocedeTe proponemos que hoy baje un poco menos: {nuevo} % (antes {anterior} %). Así la sesión se siente más llevadera.
EquipoTu equipo fijó cómo baja la música en esta terapia.

Para hoy se recalcula en vivo mientras el paciente responde (una No puede cambiar la propuesta en el momento). Botones del mismo ancho, abajo: De acuerdo (primario, con háptica) aplica el nivel nuevo y la bajada de la fórmula; si el plan cambia, debajo Seguir con {anterior} % deja el nivel anterior para hoy y en adelante (la evaluación de hoy queda gastada; mañana se evalúa desde ahí). Si el plan no cambia y no hay preguntas, no aparece hoja: la evaluación se consume en silencio.

Cerrar la hoja con el gesto conserva lo respondido y decide con el plan tal como se leía en Para hoy: si no cambiaba, equivale a De acuerdo; si cambiaba, a Seguir con {anterior} %. Un cambio nunca se acepta sin decirlo.

⚠️ Desfase: Inducción §3 (D-IF13) dice que cerrar equivale a De acuerdo sin respuestas; descartar las respuestas podía cambiar el plan en silencio (Me costó mantiene; sin ella, avanza), así que el código las conserva (INFORME_IF.5 §3 D3). Para que Cowork lo confirme; DF-32.

Configuración de la sesión (el desplegable de la calibración): Música hasta, Cuánto baja (5–100 %, de a 1; moverlo fija el nivel del plan, que sigue avanzando desde ahí, y queda en la bitácora como manual) y Duración del descenso (10–60 min, de a 1; lo puesto a mano vale hasta que se acepte un nivel nuevo del plan (con Seguir con… se mantiene), que trae la duración de la fórmula) y, desde IF.7, Largo de cada tramo (1–15 min, de a 1). Si la bajada pasa a Música hasta, Música hasta sube sola. El resumen del desplegable dice Música hasta {m} min · baja {p} % en {rampa} min ({db} dB) · tramos de {tramo} min; con el nivel 100, Baja {p} % en {rampa} min ({db} dB) · tramos de {tramo} min.

Quien ya usaba Inducción antes del plan parte en su descensoSonoridad en uso redondeado al entero (si estaba bajo 20, parte ahí y avanza de 5 en 5); su duración de sesión pasa a Música hasta (como mínimo, el fin de la bajada) y su bajada se acota a 10–60 min.

La pantalla nunca muestra el plan como progreso hacia 100 %: ni barra, ni «día 12 de 31», ni cuánto falta. El nivel es un parámetro de hoy, dicho en la hoja y en el resumen de ajustes.

¿Cómo te fue? — el chequeo antes de la sesión

Es la misma hoja del plan (DS §4.39), en el mismo momento. Solo existe en Inducción.

Cuándo aparece

Qué pregunta

Título ¿Cómo te fue en tu última sesión? (sin preguntas y con plan nuevo, Para hoy). Arriba, un dato y no una pregunta: La última fue ayer: {n} min., o La última fue el {dia}: {n} min. con el día de la semana (2 a 6 días) o el día y el mes (7 o más). Después, dos preguntas, un par distinto del anterior y con al menos una de la familia efecto: de los diez pares posibles quedan nueve (fácil + durante no vale). Las respuestas van en chips de una línea, ninguna obligatoria; tocar la elegida la deselecciona.

idFamiliaPregunta (literal)RespuestasSeñal
faciluso¿Te resultó fácil hacer la sesión?Sí · Más o menos · Me costóMe costó → dificultad
duranteuso¿Cómo te sentiste durante la sesión?Bien · Regular · Con molestiaCon molestia → dificultad
alivioefecto¿Sentiste algún alivio, aunque fuera parcial, durante la sesión o justo después?Sí · Un poco · NoNo → negativa
horasefectoEn las horas después de la sesión, ¿sentiste alivio en tu tinnitus?Sí · Un poco · No · No me fijéNo → negativa
rebroteefecto¿Hubo algún momento en que tu tinnitus subió con mucha fuerza, durante la sesión o después?No · Un poco · Sí, bastanteSí, bastante → negativa

Un poco nunca es negativa. No me fijé es sin dato. Bajo las preguntas, siempre que las haya, la frase de Hayo, literal (excepción escrita a DS §6, D-IF14):

No te preocupes: estas preguntas no son para determinar el éxito de la terapia, sino para ajustar sus parámetros.

Sin colores por valencia: la respuesta negativa elegida se pinta igual que la positiva. Sin háptica salvo De acuerdo.

La señal

senal ∈ {negativa, dificultad, ninguna, sinDato} sale de las respuestas del día. Con señales distintas en el par manda negativa > dificultad > ninguna. Sin respuestas (no tocaba preguntar, o las dejó en blanco) es sinDato, que para el plan cuenta como «cualquier otro caso».

Dónde queda

Parámetros y valores por defecto

ParámetroPor defectoRangoDónde se cambiaQuién
Nivel del plan (Cuánto baja)20 % (−3,2 dB)5 – 100 %La hoja (propuesta) · configuración de la sesión · indicación del equipoEl plan, el paciente, el equipo
Duración del descenso25 min (la fórmula del nivel)10 – 60 minConfiguración de la sesión · indicaciónPaciente, equipo
Música hasta60 minfin de la bajada – 120 minConfiguración de la sesión · indicación (10–120)Paciente, equipo
Largo de cada tramo (IF.7)3 min1 – 15 minConfiguración de la sesión · indicación (tramoMin)Paciente, equipo
Cuándo empieza a bajarde inmediato (minuto 0)0 – 60 minSolo por indicación del equipoEquipo
Dosis mínima útil25 min—kDosisMinimaUtil—
Frecuencia del chequeok ≥ 3 o 0,5—chequeo_induccion.dart—

El servidor valida las indicaciones de Inducción con sus propios rangos (descenso 0,05–1,00, bajada 10–60, Música hasta 10–120) y rechaza Música hasta menor que inicio + bajada cuando vienen las dos (backend/clinica/dominio.py). mMIDST conserva su tope de 60 % de descenso.

Qué guarda y qué sube

DatoLocalC1C2C3
La sesión: punto de mezcla calibrado, escuchado, dosisPlanificada (= fin de la bajada), descenso en dBhistorialsísíagregado
sesion.iniciada / sesion.fin (dosisS = fin de la bajada)bitácorasísíagregado
induccion.chequeo — sesionId, preguntas: [{id, respuesta}] (solo las respondidas, vocabulario cerrado), omitido, senal. Una línea en cada evaluación, haya tocado preguntar o nobitácoracon C1 ≥ v4 (hoy v5)con C2 ≥ v4 (hoy v5)agregado
induccion.plan — de, a, rampaMin, motivo (avance, mantiene_incompleta, mantiene_negativa, mantiene_dificultad, retrocede, equipo, manual), aceptado. Una línea en cada evaluación y al mover Cuánto bajabitácoracon C1 ≥ v4 (hoy v5)con C2 ≥ v4 (hoy v5)agregado
terapias.ajuste_editado (el paciente movió un ajuste)bitácorasísíagregado
Los ajustes en uso: el nivel (descensoSonoridad), la bajada y Música hastaAjustesPropios (versionEsquema 2)noen la foto de subir/estado/no
La contabilidad del plan (planDeDescenso) y la rotación del chequeo (chequeo: k, el par anterior, las respuestas por sesión)AjustesPropiosnonono

Las respuestas de ¿Cómo te fue? son dato de salud nuevo: por eso C1 y C2 subieron a v4 (D-C11, 9 de octubre de 2026). Quien tenía v3 queda por renovar y no sube nada hasta aceptar la v4; un induccion.* que el canal no puede subir corta el lote antes de él (no se salta ni se reordena). Al aceptar la v4 sube también lo anotado mientras regía la v3. C3 está en v4 desde el 2026-10-20 (H6.16), por otra razón: la frase de por qué decir Sí. El servidor recibe los dos tipos (sync/catalogo.py) y rechaza con 403 un lote con C1-v3 o C2-v3.

Lo que nunca sube: texto libre (no lo hay: todo es vocabulario cerrado), el azar de la rotación, ni el plan como meta. Música hasta no queda en la sesión registrada; viaja solo en la foto de los ajustes en uso, con C2.

Lo que NO hace, a propósito

Capturas (claro/oscuro)

No se publican en este sitio (INFORME_DOC.1 §3.5). Los tests de pantalla de IF.3, IF.4 e IF.5 verifican la pantalla y la hoja en los dos modos con texto al 100 y al 200 %; no se generaron capturas PNG en ese lote.