Create: Computing AgesDoc Brass
Bibliothèques

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.

Tout ordinateur que touche un haut-parleur, et le 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.

Brass
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 sound que tant qu'un Haut-parleur touche une de ses faces : sans lui, sound vaut nil. 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é : sound est 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é sound dans une variable s'arrête avec no speaker: put a Speaker against the computer quand 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 avec sleep.
Fonctions
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])

→ boolean

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 :

Paramètres
instrument string
un des 16 instruments du bloc musical : "harp", "bass", "bell", "bit"... (voir sound.instruments)
note number
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
volume number facultatif
de 0 (muet) à 3 ; 1 s'il est omis
Renvoie
boolean
true si elle a joué, false quand l'ordinateur a déjà joué 8 sons ce tick
note01234567891011
nomfa#solsol#lala#sidodo#réré#mifa

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 :

Brass
sound.note("harp", 6)    -- do
sound.note("harp", 10)   -- mi
sound.note("harp", 13)   -- sol

Une sonnette : une plaque de pression devant la porte est reliée à la face gauche, et deux notes sonnent quand quelqu'un marche dessus.

Brass
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
end

Un 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).

Brass
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)
end

Le 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 :

Terminal
> 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()

→ table

Les noms que prend sound.note, pour les essayer tous ou laisser un joueur choisir.

Renvoie
table
les noms des 16 instruments, dans l'ordre du jeu
Brass
for _, nom in ipairs(sound.instruments()) do
  print(nom)
  sound.note(nom, 12)
  sleep(0.5)
end

Ce sont les instruments qu'un bloc musical prend du bloc posé dessous :

instrumentbloc sous un bloc musical
harptout autre bloc (terre, herbe...)
basedrumpierre, netherrack, obsidienne, béton
snaresable, gravier, béton en poudre
hatverre, lanterne aquatique
bassbois (planches, bûches)
fluteargile
bellbloc d'or
guitarlaine
chimeglace compactée
xylophonebloc d'os
iron_xylophonebloc de fer
cow_bellsable des âmes
didgeridoocitrouille
bitbloc d'émeraude
banjobotte de foin
plingpierre lumineuse

Voir aussi sound.note() note_block.instrument()

Sons du jeu

#

sound.play(name [, volume [, pitch]])

→ boolean

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.

Paramètres
name string
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:...")
volume number facultatif
de 0 (muet) à 3 ; 1 s'il est omis
pitch number 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
Renvoie
boolean
true s'il a joué, false quand l'ordinateur a déjà joué 8 sons ce tick
identifiantce qu'on entend
block.bell.usela cloche du village
entity.experience_orb.pickuple tintement de l'expérience : un travail fini
entity.player.leveluple carillon du niveau gagné
entity.villager.yes, entity.villager.noun villageois d'accord, ou pas
block.anvil.landun lourd fracas métallique
block.lever.click, ui.button.clickun clic
block.beacon.activateune balise qui s'allume
entity.generic.explodeune explosion
Brass
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 doux

Une alarme qui sonne tant que le stress d'une ligne dépasse 90 % de sa capacité, lu sur un Stressomètre :

Brass
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)
end

Un 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()