Documentació Escenari i dispositius
Entorns de l'espectacle de llums
Tria el tipus d'espectacle de llums que vols i instal·la'n de nous al teu servidor com a paquets.
Un entorn és un tipus d'espectacle de llums: una manera de posar en escena una cançó. Rainy analitza cada cançó una vegada, i tots els entorns segueixen aquesta mateixa anàlisi. El que canvia és el que veus: un escenari de concert, un món en 3D o una cosa completament diferent. Cada entorn també posa en escena les lletres a la seva manera.
Clàssic ve amb Rainy i sempre hi és. Els altres entorns són paquets que un administrador instal·la al servidor. Un cop instal·lats, qualsevol persona d'aquell servidor els pot triar.
Triar un entorn
- Obre Configuració > Espectacle de llums.
- A la targeta Entorn, fes clic al que vulguis. Cadascun té una imatge, una descripció breu, i la seva versió i autor.
També pots canviar amb l'espectacle en marxa: fes clic al botó del cub, a la barra de la part superior de l'espectacle, per passar a l'entorn següent. El botó només apareix quan n'hi ha més d'un per triar.
La teva tria es desa al teu compte, de manera que t'acompanya a tots els dispositius.
Una targeta per entorn. El seleccionat porta la vora del color d'accent.
Un entorn pot demanar alguna cosa que el teu dispositiu potser no té. En aquest cas la seva targeta surt atenuada i diu què hi falta, per exemple Necessita WebGL 2, que aquest dispositiu no té. El teu compte conserva la tria, i aquell dispositiu mostra Clàssic.
Què canvia un entorn
A més del que dibuixa, un entorn decideix com s'organitza el reproductor a pantalla completa al seu voltant.
- Un entorn d'escenari, com Clàssic, deixa el reproductor tal com és, amb la caràtula, els controls i la cua, i fa anar l'espectacle al darrere.
- Un entorn immersiu, com Voyage, ocupa tota la pantalla. La cua es plega, la cançó i els seus controls passen a ser una targeta petita a la part inferior, i tot plegat s'atenua al cap d'uns segons sense moure el punter. Mou el punter per recuperar-ho. Un botó de cua a la barra superior mostra la cua per sobre de l'espectacle.
Tot el que hi ha a Configuració > Espectacle de llums s'aplica a tots els entorns: intensitat, lletres a l'escenari, desfasament de sincronització, Redueix els flaixos i Mode de baix rendiment.
Voyage, un entorn immersiu: el terreny a banda i banda de la carretera és el so de la cançó, de manera que el que tens al davant és la música que està a punt de sonar.
Instal·lar un entorn
Només els administradors poden instal·lar entorns.
Un entorn és codi. S'executa al navegador de tothom qui fa servir el teu servidor, dins de Rainy i amb la seva sessió. Rainy comprova que un paquet estigui ben format; no pot comprovar que sigui segur. Instal·la només paquets d'autors en qui confiïs.
- Aconsegueix el paquet: un fitxer
.zip. El repositori de Rainy en té dos que pots construir tu mateix, descrits més avall. - Obre Configuració > Espectacle de llums i baixa fins a Entorns instal·lats.
- Fes clic a Instal·la un paquet (.zip) i tria el fitxer.
- Llegeix l'avís i confirma.
L'entorn apareix a la llista i a la targeta Entorn de tothom. Les altres persones el veuen la propera vegada que obren Rainy.
Entorns instal·lats, al final de Configuració > Espectacle de llums. Només la veuen els administradors.
Un paquet pot ocupar fins a 20 MB. Rainy en rebutja un que estigui mal format, que intenti sortir de la seva pròpia carpeta o que estigui escrit per a una versió de Rainy més nova que la teva, i et diu per què.
Actualitzar, desactivar o treure
| Per | Fes això | Què passa |
|---|---|---|
| Actualitzar | Torna a instal·lar un paquet amb el mateix id. | La versió nova substitueix l'anterior. Si estava desactivat, continua desactivat. |
| Desactivar | Apaga l'interruptor que té al costat. | Desapareix de les opcions de tothom, però continua instal·lat. Encén l'interruptor per recuperar-lo. |
| Treure | Fes clic a Treu i confirma. | El paquet s'esborra del servidor. |
Qui tingui l'espectacle en marxa en un entorn que es desactiva o es treu torna a Clàssic, amb un avís. El seu compte conserva la tria, de manera que l'entorn torna per a aquella persona si el tornes a instal·lar o a activar.
Els paquets instal·lats es desen a la base de dades de Rainy, de manera que sobreviuen a una actualització i a un contenidor Docker reconstruït, i formen part de la còpia de seguretat de la teva base de dades.
Paquets al repositori de Rainy
El repositori de Rainy inclou el codi font de dos entorns a packages/. Cap dels dos ve instal·lat per defecte.
| Paquet | Què és |
|---|---|
packages/voyage |
Voyage: vola per la cançó en 3D. Hi ha un arc a cada pols i un portal a cada canvi de secció, la caràtula de l'àlbum és el sol al final de la carretera, i les lletres es construeixen a l'aire davant teu. Necessita WebGL 2. |
packages/example-pulse |
Pulse: un exemple petit amb anells al compàs i un espectre. Existeix com a punt de partida per escriure el teu. |
Per convertir-ne un en un paquet, executa això des de la carpeta de Rainy:
python scripts/pack_environment.py packages/voyage
Escriu dist/voyage-1.0.0.zip, que és el fitxer que cal instal·lar.
Quan alguna cosa va malament
«… no està disponible en aquest dispositiu. Es torna a Clàssic.» L'entorn no ha pogut arrencar o ha deixat de funcionar, i Rainy ha tornat a Clàssic perquè l'espectacle continuï. Es queda a Clàssic en aquell dispositiu fins que recarreguis la pàgina o s'actualitzi el paquet. La causa és a la consola del navegador; passa-la a l'autor del paquet.
«… ja no està instal·lat en aquest servidor. Es torna a Clàssic.» Un administrador ha desactivat o tret l'entorn que feies servir.
Una targeta diu «Necessita una versió més recent de Rainy». El paquet està escrit per a una versió més nova de l'API d'entorns. Actualitza Rainy.
L'espectacle va a batzegades en un entorn i no en un altre. Els entorns són molt diferents en el que demanen a la targeta gràfica. Activa el Mode de baix rendiment, o tria un entorn més lleuger en aquell dispositiu.