Temas de la app (apiVersion 18)¶
Disponible desde Kino 0.9.81
appThemes, go.useTheme, go.setExperience y activeTheme llegan con "apiVersion": 18, que contract.json asocia a
Kino 0.9.81. Todo Kino anterior rechaza un
manifiesto con apiVersion 18 con «Este plugin necesita una versión más nueva de Kino», y appThemes no se ofrece por
enhancements. Por debajo de apiVersion 18 el campo se ignora.
Un plugin puede ofrecer aspectos para toda la app: colores, un fondo, el redondeo de las esquinas, el tamaño del texto, sombras, movimiento, el tamaño de los controles del reproductor y su propio logo, y desde apiVersion 26 superficies pintadas, una imagen de fondo, una fuente y capas de la TV, en todas las pantallas de Kino en el celular y en el TV. Un tema son datos en el manifiesto: no corre código, no usa la red y no necesita ninguna capacidad. La persona elige un tema en Ajustes ▸ Apariencia (o con un botón en tu propia pantalla), puede ajustar lo que tú permitas, y la elección es por perfil y se sincroniza entre sus aparatos.
No es el campo theme de apiVersion 6, que solo colorea tu sección, tu pestaña de Ajustes y el
acento del reproductor. Los dos pueden estar en el mismo manifiesto.
Un plugin que solo trae temas¶
{
"id": "theme-neon",
"name": "Neón",
"version": "1.0.0",
"apiVersion": 18,
"entry": "plugin.js",
"description": "Un tema oscuro con acentos neón",
"hosts": [],
"categories": ["themes"],
"appThemes": [
{
"id": "neon",
"name": { "es": "Neón", "en": "Neon" },
"colors": { "accent": "#00E5FF", "onAccent": "#000000", "background": "#0A0A14", "surface": "#14142A", "surfaceHigh": "#1E1E3A", "railPanel": "#101026" },
"background": { "type": "gradient", "colors": ["#0A0A14", "#1A0A2E"], "angle": 180 },
"shape": { "cardRadius": 14, "channelRadius": 14, "buttonRadius": 24, "chipRadius": 20, "dialogRadius": 20, "inputRadius": 12 },
"typography": { "scale": 1.1, "titleScale": 1.05, "bodyScale": 1.0 },
"tv": { "typography": { "scale": 1.0 } },
"adjustable": {
"colors.accent": { "swatches": ["#00E5FF", "#7C4DFF", "#FFB300"] },
"shape.cardRadius": { "min": 0, "max": 20 },
"typography.scale": { "min": 1.0, "max": 1.3 },
"background": true
}
}
]
}
plugin.js puede estar vacío (export {};): Kino lo carga y no llama nada. Reglas para un plugin así:
- Sin capacidades. Un plugin cuyo único contenido es
appThemespuede omitircapabilities(o agregar soloscreen, para una página de presentación: ver Activar un tema desde tu pantalla). "hosts": []se permite desde apiVersion 18 en un plugin que solo traeappThemes: no llega a ningún lado, y su tarjeta dice que no se conecta a internet."categories": ["themes"]lo lista en Temas en la tienda de plugins de Kino.themeses uno de los nueve valores de la tienda (movies,series,anime,live,radio,subtitles,utilities,themes,adult).- No reproduce nada, así que no abre el paso más allá del primer selector de fuentes de Kino.
- Sin línea de consentimiento: activar un tema es el consentimiento de la persona, y un tema no concede nada (ni red, ni código, ni datos).
- Cualquier otro plugin (un catálogo, un plugin de TV en vivo) también puede traer
appThemesjunto a sus capacidades.
Los campos de un tema¶
appThemes es una lista de 1 a 8 temas. Cada uno:
| Campo | Regla |
|---|---|
id |
Obligatorio. ^[a-z0-9][a-z0-9-]{1,39}$, único en el plugin. Nunca lo cambies después de publicar: de él cuelgan la elección y los ajustes de la persona. |
name |
Obligatorio. { "es", "en" } (si falta uno, toma el otro) o un solo texto para los dos; como máximo 40 caracteres. |
colors, shape, typography, elevation, motion, player |
Los grupos de tokens de abajo. Todos son opcionales: lo que no pongas sigue siendo de Kino. |
background |
{ "type": "solid", "colors": [uno] } o { "type": "gradient", "colors": [2 a 8], "angle": grados enteros } (ángulo por defecto 180). image (apiVersion 26): { "asset", "fit", "dim" }, ver una imagen detrás de la app (un Kino anterior la rechaza). |
tv, phone |
Los mismos grupos y background, que reemplazan al tema solo en ese tipo de aparato. |
adjustable |
Lo que la persona puede cambiar en Ajustes ▸ Apariencia ▸ Personalizar (como máximo 48 tokens): true, { "swatches": ["#RRGGBB", …] } (solo colores) o { "min", "max" } (solo números). |
pluginColors |
"respect" (por defecto) u "override": qué pasa con los colores theme de apiVersion 6 de los otros plugins. |
price |
Opcional { "kinos": 1 a 1000, "payTo": "<64 hex en minúscula>" }. Sin price, el tema es gratis. Ver Temas con precio. |
experience |
Opcional "light" o "full": la experiencia de toda la app con la que el tema se ve mejor. Ver La experiencia. |
logo |
Opcional { "wordmark"?, "mark"?, "decor"? } (al menos uno), solo vectores. Ver Tu propio logo. |
Un error de formato rechaza todo el manifiesto: un campo o token desconocido, un tipo equivocado (un número donde va un
color), un id inválido, dos temas con el mismo id, más de 8 temas, un name de más de 40 caracteres, un price,
experience o logo mal formado. Un valor fuera de su rango no rechaza nada: Kino descarta ese token con una advertencia y
deja su propio valor, así que el tema sigue funcionando. node sdk/validate.mjs . muestra esas advertencias para el celular y
el TV.
Tokens y rangos¶
Los 47 tokens, con los rangos que aplica contract.json (manifest.appThemes):
| Grupo | Token | Tipo y rango | Valor propio de Kino |
|---|---|---|---|
colors |
accent |
#RRGGBB |
#E50914 |
colors |
onAccent (texto e íconos sobre el acento) |
#RRGGBB |
#FFFFFF |
colors |
background |
#RRGGBB (o el campo background) |
#0E0E0E |
colors |
surface (tarjetas, paneles) |
#RRGGBB |
#181818 |
colors |
surfaceHigh (paneles elevados) |
#RRGGBB |
#242424 |
colors |
textPrimary, textSecondary |
#RRGGBB |
#F5F5F5, #B3B3B3 |
colors |
focus, onFocus (el marcador de foco del TV) |
#RRGGBB |
#FFFFFF, #000000 |
colors |
outline, railPanel, placeholderTop, placeholderBottom, success, warning, error, favorite, scrim |
#RRGGBB |
los de Kino |
colors |
border (el color de los bordes, ver Bordes) |
#RRGGBB |
ninguno: sin él se usa outline |
shape |
cardRadius, channelRadius, buttonRadius, chipRadius, dialogRadius, inputRadius |
número, de 0 a 32 | los de Kino |
shape |
dialogBorder, menuBorder, headerBorder, cardBorder, panelBorder (grosor en dp, ver Bordes) |
número, de 0 a 4 | 0: Kino no dibuja bordes |
shape |
heroRadius, railItemRadius (apiVersion 26: esquinas del héroe enmarcado y del riel flotante, ver Superficies pintadas) |
número, de 0 a 32 y de 0 a 24 | 16 y los de Kino |
typography |
scale, titleScale, bodyScale |
número, de 0,85 a 1,3 | 1 |
elevation |
cardShadow, dialogShadow |
número, de 0 a 1 | los de Kino |
elevation |
heroScrim |
número, de 0,3 a 1 | el de Kino |
motion |
focusZoom |
número, de 1 a 1,15 | el de Kino |
motion |
crossfadeMs |
número, de 0 a 800 | el de Kino |
motion |
heroDrift |
"on" u "off" |
el de Kino |
player |
buttonScale |
número, de 0,8 a 1,4 | 1 |
player |
playButtonScale |
número, de 0,8 a 1,6 | 1 |
player |
seekBarScale |
número, de 0,8 a 2 | 1 |
player |
labelScale |
número, de 0,85 a 1,3 | 1 |
player |
buttonShape |
"circle", "rounded" o "square" |
el de Kino |
Cada token se nombra por su ruta: colors.accent, shape.cardRadius, player.buttonShape (así los nombra adjustable).
typography.scale multiplica la escala de letra del sistema (la combinación tiene un tope). En el celular un botón del
reproductor puede verse más pequeño, pero su zona táctil nunca baja de 48 dp; en el TV el botón enfocado conserva el marcador de
foco de Kino, solo recoloreado con focus y onFocus.
Cómo resuelve Kino un tema¶
De menor a mayor prioridad, por token:
- El valor propio de Kino.
- El tema, y luego su bloque
tvophone. - Los ajustes de la persona, solo en tokens de
adjustable, limitados a sumin/max(o a uno de susswatches) y a los rangos de arriba. - El aparato. Con los efectos reducidos (Ajustes ▸ Experiencia visual) los tokens de
motionno hacen nada; si las tarjetas del TV van redondeadas o no lo sigue decidiendo el interruptor «Esquinas redondeadas» de la persona (apagado por defecto en el TV, por rendimiento; Apariencia ofrece encenderlo cuando un tema usa redondeo). Un tema nunca decide lo que un aparato puede dibujar.
Las protecciones de legibilidad¶
Los mismos umbrales que el theme de apiVersion 6 (minTextContrast 4,5 y minUiContrast 3), medidos sobre los colores
efectivos (los de Kino donde tu tema cambió solo un lado). Un par que falla vuelve a los valores de Kino en el lado que tu
tema puso, con una advertencia:
| Par | Necesita | Si falla |
|---|---|---|
| El fondo (cada color del degradado) | oscuro (luminancia relativa de 0,05 como máximo) o claro, si el tema trae su propio textPrimary y textSecondary que se lean sobre el fondo y sobre surface (Kino 0.9.82; antes un fondo claro se rechazaba siempre) |
el fondo de Kino (y, si hace falta, su accent) |
accent sobre el fondo |
3:1 | accent y onAccent de Kino, como par |
onAccent sobre accent |
4,5:1 | accent y onAccent de Kino, como par |
| El acento de Kino sobre tu fondo | 3:1 | el fondo de Kino |
textPrimary y textSecondary sobre el fondo y surface |
4,5:1 | los colores de texto de Kino |
textPrimary sobre surfaceHigh |
4,5:1 | el surfaceHigh de Kino (y después los colores de texto) |
El texto sobre tu surface |
4,5:1 | el surface de Kino |
focus sobre el fondo; onFocus sobre focus |
3:1; 4,5:1 | focus y onFocus de Kino |
A diferencia del theme de apiVersion 6, appThemes no tiene la regla de «no parecerse al rojo de Kino». Los ajustes de la
persona pasan por las mismas comprobaciones: Apariencia rechaza, con palabras de Kino, un color que no se leería.
Lo que un tema nunca cambia¶
Kino dibuja con su propio aspecto, sea cual sea el tema activo: Ajustes ▸ Apariencia misma, su vista previa, las preguntas de
compra y de experiencia, las hojas de consentimiento al instalar y actualizar plugins, el código +18 y los bloqueos de ajustes,
la hoja de go.url, la pantalla de bloqueo y cualquier otra pantalla que le pide una decisión a la persona. El logo propio de
Kino se queda en la pantalla de inicio, la puerta de entrada y esas pantallas de decisión. Los códigos QR siguen en negro sobre
blanco, y lo que se dibuja sobre el video o las imágenes conserva sus colores.
pluginColors¶
Otros plugins pueden tener sus propios colores theme de apiVersion 6. Con "respect" (por defecto) sus páginas y el acento
de su reproductor los conservan; con "override" mandan los colores del tema activo en todas partes. La persona siempre tiene
la última palabra: Apariencia muestra un interruptor Colores de los plugins en todos los temas, declares lo que declares.
Temas con precio (price)¶
Un tema puede costar kinos, la moneda gratuita de Kino (la persona los gana viendo contenido: 1 cada 10 minutos, como máximo 20 por día UTC).
"price": { "kinos": 50, "payTo": "0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef" }
kinoses un número entero de 1 a 1000;payToes tu cuenta de kinos: 64 caracteres hexadecimales en minúscula. Los dos van juntos; cualquier otra cosa rechaza el manifiesto.- Antes de que se active un tema con precio (desde Apariencia, desde la hoja de gestión de tu plugin o desde tu propio
go.useTheme), Kino muestra su propia hoja de compra: «Comprar «nombre»», «Cuesta N kinos.», el saldo de la persona («Tienes N kinos.») y Comprar por N kinos, activo solo si el saldo alcanza (si no, «Te faltan N kinos para comprarlo.»). Una compra que falla no cobra nada. Apariencia muestra el precio en la lista y en el botón de la vista previa, y el saldo junto a los temas con precio. - Los kinos van a
payTo. Una compra por tema y por cuenta, válida en todos los aparatos de la persona. - Tu plugin nunca ve la compra, el saldo ni la sesión de monedas: no necesitas la capacidad
coinspara vender un tema. Declaracoins(apiVersion 16, línea de consentimiento en rojo) solo si tu propia pantalla quiere mostrar el saldo conkino.coins.balance(); cuando rechace condisabled, no muestres nada sobre kinos. - El precio y la cuenta están en tu manifiesto público: son lo que Kino cobra y paga, no un candado sobre tus archivos.
- Tu cuenta. Una cuenta de kinos es el mismo identificador de 64 hexadecimales que Kino Social llama
user_keydel autor: el servicio de monedas lo calcula a partir de la identidad de Telegram de la persona con un secreto, y nunca guarda el id de Telegram. Es el id de quien inició sesión en Kino con Telegram, así quepayTodebe ser la cuenta de quien cobra. Desde Kino 0.9.81 la ves y la copias en Ajustes ▸ App ▸ Tu cuenta de kinos (necesita el interruptor Kinos activado y tu sesión de Telegram): toca la fila para copiar los 64 caracteres completos. - Tu propio tema. El servicio rechaza una compra cuyo comprador y
payToson la misma cuenta (self_purchase): no se cobra nada. Para probar el flujo de compra usa una segunda cuenta, o los mocks del kit y una compilación de depuración. - Reembolsos. No hay: una compra es definitiva, los kinos ya están en el saldo del autor y el servicio no tiene operación de reembolso. Lo que la persona nunca paga es una compra fallida: no cobra nada, y comprar dos veces el mismo tema cobra una vez.
La experiencia (experience, go.setExperience)¶
Kino tiene dos modos para toda la app en Ajustes ▸ Experiencia visual: ligera (sin sombras, sin efectos, esquinas rectas) y completa (todos los efectos, esquinas redondeadas).
- Un tema que se ve mejor con uno lo dice con
"experience": "light"o"full". Cuando la persona activa el tema, Kino pregunta («Este tema se ve mejor con la experiencia completa. ¿La usamos también?», con «Usar la completa» y «Dejar la actual»). Nada cambia sin su sí, y no se pregunta nada si la app ya la tiene. - Tu propia pantalla también puede pedirla:
go: { setExperience: "light" | "full" }, solo desde la pulsación o el envío de la propia persona en tu pantalla (nuncaopen, un temporizador, un cambio, un «cargar más», unonClose, un panel ni un aviso). Kino pregunta antes, nombrando tu plugin («Tu plugin» pide la experiencia completa. ¿La usamos?). Cualquier otro valor descarta elgo, con registro.
Tu propio logo (logo)¶
Un tema puede dibujar su propio logo en lugar del de Kino en el menú lateral y la cabecera del celular y en el riel del TV. Solo vectores (ningún archivo de imagen, nada de red):
"logo": {
"wordmark": { "size": [120, 30], "paths": [{ "d": "M0 0 L26 15 L0 30 Z", "fill": "accent" },
{ "d": "M40 4 H52 V26 H40 Z", "fill": "textPrimary" }] },
"mark": { "size": [30, 30], "paths": [{ "d": "M15 0 L30 15 L15 30 L0 15 Z", "fill": "accent" }] }
}
- Al menos uno de
wordmark(el logo largo: menú y cabecera del celular, el riel abierto del TV) ymark(el cuadrado: el riel cerrado del TV). Lo que no pongas sigue siendo de Kino. sizees[ancho, alto], números enteros de 1 a 1000, como máximo 8 veces más ancho que alto (o al revés).- De 1 a 8
paths, cadadde hasta 2.000 caracteres de datos de trazo SVG (M L H V C S Q T A Z, números, espacios, comas, signos);fillesaccent,onAccent,textPrimary,textSecondary(siguen al tema y a los ajustes de la persona) o un#RRGGBBfijo. decor(Kino 0.9.82) no reemplaza el logo de Kino: se dibuja encima de él, en el wordmark y en la marca, en el espacio de la «o». Es{ "paths": [...] }(de 1 a 8, con el mismo formato). Su centro es el origen (0, 0), y crece hacia abajo; el radio exterior del aro de la «o» es 100. Un sombrero sobre la «o» queda en y < -100, algo que cubra toda la «o» es un disco de radio 100, y el punto de la «i» está cerca de (-353, -132). Úsalo para jugar con el logo de Kino (el sombrero de paja de Luffy, el reactor de Iron Man como «o»).- Kino conserva su propio logo en la pantalla de inicio, la puerta de entrada y toda pantalla que pide una decisión.
Bordes (colors.border, shape.*Border)¶
Disponible con Kino 0.9.82
Sin apiVersion nuevo: un Kino anterior ignora estos tokens y no dibuja bordes.
Kino no tiene bordes. Un tema puede pedirlos con un grosor en dp (de 0 a 4; 0 o ausente = sin borde) por tipo de elemento, y un color:
| Token | Enmarca |
|---|---|
shape.dialogBorder |
los diálogos y las hojas inferiores |
shape.menuBorder |
los menús desplegables |
shape.headerBorder |
las cabeceras: una línea a lo largo de su borde inferior |
shape.cardBorder |
las tarjetas |
shape.panelBorder |
los paneles |
El color es colors.border; si el tema no lo da, se usa outline. El borde sigue las esquinas del elemento (dialogRadius, cardRadius…). Un tema que no pide bordes se ve exactamente como antes.
"colors": { "border": "#8624A0" },
"shape": { "dialogBorder": 2, "cardBorder": 1, "headerBorder": 1 }
Superficies pintadas, capas y archivos (apiVersion 26)¶
Próxima versión de Kino, aún no publicada
Todo esto llega con "apiVersion": 26 (Kino 0.9.87, provisional: el número se mueve si se mueve la versión).
Un tema que las use debe declarar "apiVersion": 26: un Kino que no conoce el 26 rechaza entonces el manifiesto entero («Este
plugin necesita una versión más nueva de Kino») en lugar de leerlo mal. No pongas estas claves en un tema que declara un
apiVersion menor: Kino 0.9.87 las salta ahí, pero un Kino anterior rechaza un tema con un campo desconocido. Sin ninguna de
estas claves el tema se ve exactamente igual que antes, en cualquier Kino.
El nivel 1 daba colores, formas y tamaños. El nivel 2 deja que el tema pinte: un relleno degradado o brillante, un contorno degradado y un resplandor suave en los elementos que Kino dibuja, una imagen de fondo, su propia fuente y dos capas de la TV (un héroe enmarcado y un riel flotante). Sigue siendo datos: no corre código, no usa red en ejecución, y las imágenes y las fuentes viajan en el repositorio de tu plugin.
surfaces: relleno, contorno y resplandor por elemento¶
surfaces es un objeto cuyas claves son los elementos de abajo; cada valor es { "fill"?, "stroke"?, "glow"? }. Un elemento que no
listas conserva el aspecto de Kino.
| Elemento | Dónde pinta |
|---|---|
button |
el botón principal relleno (el confirmar de un diálogo, «Continuar viendo» del héroe) |
buttonGhost |
el botón secundario de al lado (Cancelar, «…») |
navItem, navActive |
las píldoras del menú superior y los ítems del riel, inactivo y activo (el enfocado o elegido) |
rail |
el panel del riel: su relleno y su borde |
iconButton |
los botones redondos de la esquina (perfil, campana, recargar) y el botón de plugins |
card, cardFocus |
una tarjeta de póster o ancha en reposo y enfocada: contorno y resplandor (el relleno es la imagen, así que no lo tiene) |
focus |
el aro de foco de todo lo demás que se enfoca: contorno y resplandor, nunca relleno |
hero |
la tarjeta del héroe enmarcado (contorno y resplandor; sus esquinas son shape.heroRadius) |
progress |
la parte llena de la barra de progreso de «Continuar viendo» |
Los tres tipos de valor:
| Valor | Forma | Rango |
|---|---|---|
fill |
{ "type": "solid", "color": "#RRGGBB" } o { "type": "gradient", "colors": ["#RRGGBB", …], "angle": grados } (ángulo por defecto 180) |
de 2 a 8 colores; un degradado fuera de eso se descarta con un aviso |
stroke |
{ "width": dp, "color": "#RRGGBB" } o { "width": dp, "gradient": { "type": "gradient", … } } (exactamente uno de los dos) |
ancho de 0 a 4 |
glow |
{ "color": "#RRGGBB", "radius": dp, "alpha": 0 a 1 }, un halo difuminado detrás del elemento |
radio de 0 a 24 |
"surfaces": {
"button": { "fill": { "type": "gradient", "colors": ["#D9232F", "#A8060F"], "angle": 180 }, "stroke": { "width": 1, "color": "#FF7B83" } },
"navActive": { "fill": { "type": "solid", "color": "#2A0D12" }, "stroke": { "width": 1.5, "color": "#E50914" }, "glow": { "color": "#E50914", "radius": 10, "alpha": 0.55 } },
"cardFocus": { "stroke": { "width": 2, "color": "#F2E8EA" }, "glow": { "color": "#E50914", "radius": 14, "alpha": 0.45 } },
"card": { "glow": { "color": "#E50914", "radius": 10, "alpha": 0.22 } }
}
Los bloques tv y phone del tema pueden llevar sus propias surfaces; el bloque gana sobre el tema solo en esa forma. El teléfono
pinta button, buttonGhost, iconButton, card y progress; el riel, el menú superior y el héroe enmarcado existen solo en la TV.
style.gloss: un aspecto brillante con un solo número¶
"style": { "gloss": 0 a 1 }. Un elemento sin fill explícito recibe un degradado más claro arriba y más oscuro abajo derivado de
su color base (el acento para button y navActive, surfaceHigh para iconButton y buttonGhost), y button, navActive y
cardFocus reciben un resplandor derivado del acento. Lo que escribas explícitamente gana sobre lo derivado. 0 o ausente = el aspecto
plano de Kino. Un valor fuera de 0 a 1 se recorta con un aviso.
layout: héroe enmarcado y riel flotante (TV)¶
"layout": { "hero": "fullBleed" | "framed", "rail": "strip" | "floating" }, ambos opcionales; los bloques tv y phone pueden llevarlo.
"hero": "framed"dibuja el héroe del Home como una tarjeta redondeada con margen (consurfaces.hero) en lugar de una imagen que llega a los bordes de la pantalla. Sus esquinas sonshape.heroRadius(0 a 32, por defecto 16)."rail": "floating"mantiene el riel izquierdo de la TV como un panel redondeado siempre, cerrado o abierto, con el mismo aire a ambos lados; sus ítems usanshape.railItemRadius(0 a 24).- Solo TV. El teléfono ignora ambas claves y conserva su propia disposición. Una palabra desconocida rechaza el manifiesto; los interruptores del aparato (abajo) apagan cada capa.
assets y background.image: una imagen detrás de la app¶
El tema lista los archivos que trae en assets, cada uno { "id", "path", "sha256", "bytes" }: id ^[a-z0-9][a-z0-9-]{1,39}$,
path una ruta relativa dentro del repositorio de tu plugin, sha256 64 caracteres hexadecimales, bytes el tamaño exacto. Como
máximo 16 archivos.
"assets": [ { "id": "background", "path": "assets/background.webp", "sha256": "0ed54aa7…", "bytes": 8276 } ],
"background": { "image": { "asset": "background", "fit": "cover", "dim": 0.35 } }
background.imagees{ "asset": id, "fit": "cover" | "top", "dim": 0.3 a 1 }:coverllena la página y la centra,topla ancla al borde superior, ydimes cuánto negro se pone encima.colors.backgroundsigue siendo obligatorio como respaldo (mientras carga la imagen, si falla, y para las comprobaciones de contraste). Un bloquetvophonepuede nombrar otra imagen.- Kino baja cada archivo al instalar, desde la misma dirección de la que vino tu manifiesto (nunca de un host nuevo), comprueba el tamaño y el sha256, y los guarda con el plugin: una actualización los reemplaza, quitar el plugin los quita. Una imagen pesa como máximo 2.000.000 bytes y 3.840 x 2.160 píxeles, una fuente 1.000.000, y todos los archivos juntos 6.000.000.
- Un archivo que falta, no pasa su hash, supera un tope o no se puede decodificar se deja fuera, con una nota en el registro: el plugin y el resto del tema se instalan igual, y la página muestra el color de respaldo (o la fuente de Kino). Nunca rechaza la instalación.
- El contraste del texto se comprueba contra el color de respaldo oscurecido por
dim; de la imagen en sí se confía, así que pruébala en Kino. Las imágenes se decodifican una vez, al tamaño de la ventana, fuera del hilo principal.
Los archivos de un tema se instalan desde una dirección de repositorio (GitHub, una URL de manifiesto); un plugin importado desde un
archivo .kinoplugin o empaquetado a mano todavía no lleva sus archivos de tema.
typography.fontFamily: tu propia fuente¶
"typography": { "fontFamily": { "regular": "<id de asset>", "bold": "<id de asset>" } }: bold es opcional, y ambos nombran entradas
de assets (un archivo TTF u OTF de como máximo 1.000.000 bytes). Todo el texto que Kino dibuja con su escala toma la familia, y las
escalas (scale, titleScale, bodyScale) siguen funcionando encima. Una fuente que falta o que Android no puede leer deja la de Kino.
Los dos tokens de forma nuevos¶
shape.heroRadius (0 a 32) y shape.railItemRadius (0 a 24) se suman a la tabla de Tokens y rangos. Por debajo de
apiVersion 26 se saltan sin avisar.
Reglas de seguridad de lo que pintas¶
Cada regla descarta ese valor con un aviso (node sdk/validate.mjs . lo muestra, y también el registro de Kino); nunca rechaza el
manifiesto, así que un tema con un número malo sigue siendo usable:
- El texto debe seguir legible sobre un relleno. El color de texto que Kino pone sobre un relleno (
onAccentenbuttonynavActive, el texto de la página en lo demás) debe mantener 4,5 : 1 contra cada parada de un degradado. Un relleno que falla se descarta: «surfaces.navActive.fill: the text on it isn't readable on every stop (at least 4.5:1); dropped». - El foco nunca queda invisible. Un contorno de
focusocardFocusdemasiado parecido al color de la página se descarta y Kino conserva su propio aro.focustiene contorno y resplandor, nunca relleno (unfillahí se descarta con un aviso). - El número de colores, el ángulo, el ancho, el radio, el alfa y
dimse mantienen en los rangos de arriba (se recortan o se descartan, con aviso). - Con
background.image,dimes como mínimo 0,3.
Los interruptores de la persona¶
El aparato siempre gana sobre el tema. En Ajustes ▸ Experiencia visual ▸ Personalizar uno por uno (también desde el icono Rendimiento del panel de plugins en la TV) la persona puede apagar cada uno de siete efectos por separado, conservando tus colores, formas y tipografía: los resplandores, los rellenos degradados, los contornos degradados, la imagen de fondo, el héroe enmarcado, el riel flotante y la fuente del tema. Son por aparato. En una TV débil, «todos los efectos apagados» apaga los siete. Por eso diseña cada efecto como una adición: un tema con los siete apagados debe verse bien.
Un ejemplo completo¶
kinotvapp/kino-plugin-theme-crimson es un tema pequeño, sin firma, que usa
todas las claves de esta sección: botones brillantes y degradados, una píldora oscura con aro rojo para el menú activo, un resplandor
suave en las tarjetas, un héroe enmarcado, un riel flotante y una imagen de fondo. Instálalo desde Plugins ▸ Agregar con
kinotvapp/kino-plugin-theme-crimson.
Activar un tema desde tu pantalla (go.useTheme, activeTheme)¶
La persona activa un tema en Ajustes ▸ Apariencia (Tema de Kino siempre es la primera opción; una vista previa muestra una
fila del Inicio, un diálogo y los controles del reproductor antes de Usar este tema), desde la hoja de gestión de tu plugin
(«Ver temas», «Activar tema de …») o desde un botón en tu propia pantalla (la capacidad screen, apiVersion
14 o más, que un plugin de temas puede declarar para presentar su tema):
export async function screen({ activeTheme }) {
const on = activeTheme === "neon";
return { type: "ElevatedButton", labelText: on ? "Desactivar" : "Activar", labelTextEn: on ? "Turn off" : "Turn on",
onPressed: { go: { useTheme: { theme: on ? null : "neon" } } } };
}
export async function screenEvent() { return null; }
screenyscreenEventrecibenactiveTheme: el id de tu tema activo ahora, onull. Kino vuelve a llamar ascreendespués de cualquier cambio (también uno hecho en Apariencia), así que un mismo botón puede alternar.go: { useTheme: { theme } }:themees uno de tus ids deappThemes(hace lo mismo que el botón de Apariencia: la misma elección por perfil, la misma sincronización, se conservan los ajustes de la persona) onull(vuelve al tema de Kino, solo mientras uno de los tuyos está activo: nunca puedes quitar el de otro plugin).- Solo desde la pulsación o el envío de la propia persona en tu pantalla: se descarta, con registro, desde
open, un temporizador, un cambio, un «cargar más», elonClosede una ventana, un panel o un aviso, y por debajo de apiVersion 18. Se rechaza, con registro y sin cambiar nada, cuando Apariencia no muestra ese tema como tuyo (el id de otro plugin, tu plugin apagado en este perfil, +18 mientras está bloqueado). - Un tema con precio que la persona no ha comprado abre primero la hoja de compra de Kino; un tema con
experiencepregunta por ella. - Kino muestra su propio aviso, «Tema aplicado» o «Volviste al tema de Kino», y vuelve a pintar toda la app, tu pantalla incluida.
- Una pantalla de presentación que no necesita ícono en el menú puede abrirse solo desde tu página de ajustes:
"screen": { "label": "Neón", "opensFrom": ["settings"], "settingsButton": { "label": "Ver presentación", "labelEn": "See presentation" } }.
Lo que ve la persona¶
- Hay un solo tema activo a la vez, por perfil; la elección y los ajustes se sincronizan entre los aparatos vinculados de la persona, en las dos direcciones.
- Personalizar muestra solo lo que marcaste como
adjustable(muestras de color y un#RRGGBBescrito para los colores: las muestras son lo que funciona con un control remoto; un contador para los números), y «Volver a los valores del tema». - Desactivar o quitar tu plugin vuelve al tema de Kino; la elección se guarda y regresa si se reinstala. Una actualización vuelve
a resolver el tema, y se descartan los ajustes de tokens que ya no son
adjustable. - Cualquier falla al resolver un tema deja el aspecto propio de Kino, nunca un cierre de la app.
Pruébalo con el kit¶
node sdk/validate.mjs . # formato y advertencias de cada tema en celular y TV
node sdk/run.mjs --context '{"activeTheme":"neon"}' . screen # tu pantalla de presentación con tu tema activo
node sdk/run.mjs . screenEvent activate --trigger tap # qué hace Kino con go.useTheme / go.setExperience
validate.mjs muestra líneas como appThemes neon (tv): shape.cardRadius: 40.0 is outside 0.0..32.0; Kino's is used y
appThemes neon (phone): background: is too light (the background must be dark for now); Kino's is used: las mismas
advertencias de la app, palabra por palabra. screen imprime el árbol sin los go mal formados, y screenEvent dice cuándo se descartaría un go.useTheme de una respuesta (no es un toque, no es uno de
tus ids, null sin ninguno de los tuyos activo). El kit no dibuja colores: mira el tema en Kino (Ajustes ▸ Apariencia ▸ la vista
previa).
Lista de verificación¶
- [ ]
"apiVersion": 18, y la persona sabe que necesita Kino 0.9.81 o posterior. - [ ]
node sdk/validate.mjs .pasa y no muestra advertencias que no esperabas, ni en celular ni en TV. - [ ] Cada
idde tema es definitivo;nametieneesyen. - [ ] El fondo es oscuro, o claro con tu propio texto legible, y cada par de las protecciones se lee.
- [ ]
adjustableofrece muestras de color (no solo colores libres) para que se pueda usar con un control remoto. - [ ] Un
pricelleva tupayToreal; no agregastecoinssolo para vender. - [ ] Una pantalla que activa el tema lee
activeThemey usago.useThemesolo desde un toque. - [ ] Las claves del nivel 2 (
surfaces,style,layout,assets,background.image,typography.fontFamily) solo en un tema que declara"apiVersion": 26; elsha256y losbytesde cada asset coinciden con el archivo, y la imagen pesa como máximo 2 MB. - [ ] El tema se ve bien con los siete efectos apagados (Ajustes ▸ Experiencia visual): los colores y las formas lo sostienen, los efectos solo suman.
- [ ]
"categories": ["themes"], y"hosts": []cuando el plugin solo trae temas.