
sound
Les notes et les sons du jeu, joués par un haut-parleur qui touche l'ordinateur, ou par le haut-parleur d'un smartphone.
La bibliothèque sound fait entendre un ordinateur : un carillon quand un train entre en gare, une sonnette à la porte, une alarme quand une ligne est surchargée, de la musique pour un jeu. Elle joue les notes des 16 instruments du bloc musical, et n'importe quel son du jeu.
sound.note("harp", 12) -- le fa# au milieu d'un bloc musical
sound.play("block.bell.use") -- la cloche du villageÀ savoir avant de commencer :
- Un haut-parleur. Un ordinateur n'a
soundque tant qu'un Haut-parleur touche une de ses faces : sans lui,soundvautnil. Le Haut-parleur se fabrique à l'établi à l'âge des tubes à vide (planches, papier, un Électroaimant, un Tube à vide) et marche avec tous les ordinateurs, Calculateur à tubes compris. Posez-le contre n'importe quelle face, comme un moniteur : un Câble de données ne transporte pas le son. - Le smartphone a un haut-parleur intégré :
soundest toujours là, et le son suit le joueur qui le porte. - Elle va et vient. La bibliothèque apparaît quand on pose le premier Haut-parleur et s'en va avec le dernier, même pendant qu'un programme tourne. Un programme qui peut tourner sans haut-parleur vérifie d'abord :
if sound then ... end. Un programme qui a gardésounddans une variable s'arrête avecno speaker: put a Speaker against the computerquand son haut-parleur disparaît. - Où on l'entend. Le son sort du Haut-parleur, comme d'un bloc musical : les joueurs l'entendent jusqu'à 16 blocs au volume 1, 48 blocs au volume 3, plus fort à mesure qu'ils s'approchent. Avec plusieurs Haut-parleurs, il sort de l'un d'eux, pas plus fort. Il suit le curseur « Juke-box/Blocs musicaux » des réglages de son du jeu.
- Huit par tick. Un ordinateur joue 8 sons par tick au plus, notes et sons ensemble : assez pour un accord, jamais un déluge. Les appels suivants du même tick ne jouent rien et renvoient
false; le compte repart au tick suivant. Une mélodie attend entre ses notes avecsleep.
sound.note(instrument, note [, volume]) | Joue une note, comme le ferait un bloc musical de cet instrument après autant de clics. Les notes de la première octave, pour la harpe : |
sound.instruments() | Les noms que prend sound.note, pour les essayer tous ou laisser un joueur choisir. |
sound.play(name [, volume [, pitch]]) | Joue n'importe quel son du jeu, ou d'un mod. Un nom sans espace de noms est un son de Minecraft : "block.bell.use" et "minecraft:block.bell.use" sont le même son. Taper /playsound dans le chat les propose tous au fil de la frappe. |
Notes
sound.note(instrument, note [, volume])
Joue une note, comme le ferait un bloc musical de cet instrument après autant de clics. Les notes de la première octave, pour la harpe :
instrumentstring- un des 16 instruments du bloc musical :
"harp","bass","bell","bit"... (voirsound.instruments) notenumber- la hauteur en demi-tons, de 0 à 24, comme les clics d'un bloc musical : 0 est un fa#, 12 le fa# une octave plus haut, 24 deux octaves plus haut
volumenumber facultatif- de 0 (muet) à 3 ; 1 s'il est omis
- boolean
truesi elle a joué,falsequand l'ordinateur a déjà joué 8 sons ce tick
| note | 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| nom | fa# | sol | sol# | la | la# | si | do | do# | ré | ré# | mi | fa |
De 12 à 23, ce sont les mêmes notes une octave plus haut, et 24 est le fa# le plus aigu. Une note entre deux, comme 12.5, joue un quart de ton ; une note sous 0 ou au-dessus de 24 devient 0 ou 24, et de même pour un volume hors de 0 à 3. Les autres instruments jouent les mêmes notes dans leur propre octave : la basse deux octaves plus bas, la cloche deux octaves plus haut.
Trois notes dans le même tick font un accord :
sound.note("harp", 6) -- do
sound.note("harp", 10) -- mi
sound.note("harp", 13) -- solUne sonnette : une plaque de pression devant la porte est reliée à la face gauche, et deux notes sonnent quand quelqu'un marche dessus.
local avant = false
while true do
os.pull_event("redstone")
local appui = rs.get("left") > 0
if appui and not avant then
sound.note("bell", 18)
sleep(0.3)
sound.note("bell", 14)
end
avant = appui
endUn air est une liste de notes, chacune avec sa durée. Un temps de 0,15 seconde fait 3 ticks : sleep compte en ticks (voir Évènements).
local air = {{6, 2}, {8, 2}, {10, 2}, {6, 2}, {10, 2}, {11, 2}, {13, 4}}
for _, n in ipairs(air) do
sound.note("flute", n[1])
sleep(n[2] * 0.15)
endLe programme intégré music joue un air entier de cette façon : music bell le joue avec un autre instrument.
Un instrument absent de la liste arrête le programme, et l'erreur donne la liste des bons :
> brass Brass 1.0 - type 'exit' to leave. brass> sound.note("kazoo", 12) brass:1: unknown instrument 'kazoo' (harp, basedrum , snare, hat, bass, flute, bell, guitar, chime, xyl ophone, iron_xylophone, cow_bell, didgeridoo, bit, banjo, pling) brass> exit
Les voix qu'une tête de créature donne à un bloc musical ne sont pas des instruments : jouez-les avec sound.play, par exemple sound.play("block.note_block.imitate.creeper").
Voir aussi sound.instruments() sound.play() note_block.play()
sound.instruments()
Les noms que prend sound.note, pour les essayer tous ou laisser un joueur choisir.
- table
- les noms des 16 instruments, dans l'ordre du jeu
for _, nom in ipairs(sound.instruments()) do
print(nom)
sound.note(nom, 12)
sleep(0.5)
endCe sont les instruments qu'un bloc musical prend du bloc posé dessous :
| instrument | bloc sous un bloc musical |
|---|---|
harp | tout autre bloc (terre, herbe...) |
basedrum | pierre, netherrack, obsidienne, béton |
snare | sable, gravier, béton en poudre |
hat | verre, lanterne aquatique |
bass | bois (planches, bûches) |
flute | argile |
bell | bloc d'or |
guitar | laine |
chime | glace compactée |
xylophone | bloc d'os |
iron_xylophone | bloc de fer |
cow_bell | sable des âmes |
didgeridoo | citrouille |
bit | bloc d'émeraude |
banjo | botte de foin |
pling | pierre lumineuse |
Voir aussi sound.note() note_block.instrument()
Sons du jeu
sound.play(name [, volume [, pitch]])
Joue n'importe quel son du jeu, ou d'un mod. Un nom sans espace de noms est un son de Minecraft : "block.bell.use" et "minecraft:block.bell.use" sont le même son. Taper /playsound dans le chat les propose tous au fil de la frappe.
namestring- l'identifiant d'un son, comme dans la commande
/playsound:"block.bell.use","minecraft:entity.cat.ambient", ou un son d'un autre mod ("create:...") volumenumber facultatif- de 0 (muet) à 3 ; 1 s'il est omis
pitchnumber facultatif- de 0.5 (une octave plus bas, deux fois plus lent) à 2 (une octave plus haut, deux fois plus vite) ; 1 s'il est omis
- boolean
trues'il a joué,falsequand l'ordinateur a déjà joué 8 sons ce tick
| identifiant | ce qu'on entend |
|---|---|
block.bell.use | la cloche du village |
entity.experience_orb.pickup | le tintement de l'expérience : un travail fini |
entity.player.levelup | le carillon du niveau gagné |
entity.villager.yes, entity.villager.no | un villageois d'accord, ou pas |
block.anvil.land | un lourd fracas métallique |
block.lever.click, ui.button.click | un clic |
block.beacon.activate | une balise qui s'allume |
entity.generic.explode | une explosion |
sound.play("entity.experience_orb.pickup")
sound.play("entity.cat.ambient", 1, 1.5) -- un miaou plus aigu et plus vif
sound.play("block.anvil.land", 0.3) -- bien plus douxUne alarme qui sonne tant que le stress d'une ligne dépasse 90 % de sa capacité, lu sur un Stressomètre :
local jauge = peripheral.find("stressometer")
while true do
if jauge.stress() > jauge.capacity() * 0.9 then
sound.play("block.bell.use", 2)
end
sleep(1)
endUn nom qui n'est pas un son arrête le programme : sound.play("block.bel.use") donne unknown sound 'block.bel.use'. Un son long joue jusqu'au bout : un disque de musique ("music_disc.cat") joue tout le morceau, et rien ne peut l'arrêter.
Bon à savoir
- Loin de l'ordinateur. Le Haut-parleur touche l'ordinateur. Pour faire du son au loin, posez des blocs musicaux sur le Câble de données de l'ordinateur et jouez-les comme périphériques (
Bloc musical), ou envoyez un message à un autre ordinateur qui a son propre Haut-parleur (net). - Un smartphone en poche. Les joueurs autour de vous l'entendent aussi, comme un bloc musical que vous porteriez.
- Le silence. Un volume de 0 ne joue rien d'audible, mais compte quand même dans les 8 sons du tick.
Voir aussi sound.note()