FANDOM


Les éléments de type Son permettent de jouer des effets sonores. Vous pouvez créer et uploader des sons dans votre projet puis les jouer grâce au scripting.

Vous pouvez accéder à un élément Son dans un script via la fonction CraftStudio.FindAsset.

Il y a deux approches pour jouer des sons : soit directement en utilisant votre élément Sound (ce qui ne vous donne pas beaucoup de contrôle mais est suffisant pour lancer un court effet sonore facilement) ou bien en crééant une instance de son (SoundInstance), qui vous permettra de stopper / mettre en pause / relancer / faire boucler / changer le volume du son pendant qu'il se joue.

Sound:PlayModifier

Sound:Play( [number] volume=1, [number] pitch=0, [number] pan=0 )

Lire le son spécifié une fois. Vous pouvez appeler plusiquers fois le même son a différents moments.

Le volume peut être n'importe quoi entre 0 (nul) et 1 (maximum). Vous pouvez aussi controler la hauteur du son (les veleurs négatives et positives sont acceptées) et le haut parleur duquel seras émit le son (1=droite, -1=gauche,0=les deux).

Pour lire en boucle ou arreter un son allez voir Soud:CreateInstance en dessous.

Exemple: Jouer un sonModifier

local son = CraftStudio.FindAsset( "mon son" )

-- lit le son avec les paramètres par defaut (volume au maximum)
son:Play()

-- Lit le sons avec la moitié du volume, un son plus aigu et à droite.
son:Play( 0.5, 0.8, 1 )

Sound:CreateInstanceModifier

[SoundInstance] Sound:CreateInstance()

Créer une instance d'un son.

Les instances peuvent êtres mises en pause / relancées / stopées / mises en boucle et leurs paremètres peuvent êtres mis à jour pendant la lecture.

Exemple: Mettre en boucle un sonModifier

local son = CraftStudio.FindAsset( "mon son" )

-- Créer l'instance du son
local monInstance = son:CreateInstance()

-- Mettre en boucle l'instance
monInstance:SetLoop( true )

-- La lire
monInstance:Play()

-- ... Plus tard ...
-- L'arrêter
monInstance:Stop()

SoundInstance:Play, SoundInstance:StopModifier

SoundInstance:Pause, SoundInstance:ResumeModifier

SoundInstance:Pause()
SoundInstance:Resume()

Mêtre en pause ou relancer le son.

SoundInstance:GetStateModifier

[SoundInstance.State] SoundInstance:GetState()

Retourne l'état de l'instance.

Les états possibles sont SoundInstance.State.Playing, SoundInstance.State.Paused and SoundInstance.State.Stopped.

SoundInstance:SetLoop, SoundInstance:GetLoopModifier

SoundInstance:SetLoop( [boolean] loop )
[boolean] SoundInstance:GetLoop()

Definit ou obtient si le son doit être/est en boucle.

SoundInstance:SetVolume, SoundInstance:GetVolumeModifier

SoundInstance:SetVolume( [number] volume )
[number] SoundInstance:GetVolume()

Definit le volume de l'instance, la valeur doit etre entre 0.0 et 1.0. Avec une boucle et une incrémentation ça peut etre utilisé pour faire un fondu.

Exemple: Faire démarer le son en fonduModifier

function Behavior:Awake()
    local son = CraftStudio.FindAsset( "du son" )
    self.monInstance = son:CreateInstance()
    self.monVolume = 0
    
    self.monInstance:SetVolume( 0 )
    self.monInstance:Play()
end

function Behavior:Update()
    if self.monVolume < 1 then
        self.monVolume = self.monVolume + 0.05
        self.monInstance:SetVolume( self.monVolume )
    end
end

SoundInstance:SetPitch, SoundInstance:GetPitchModifier

SoundInstance:SetPitch( [number] pitch )
[number] SoundInstance:GetPitch()

SoundInstance:SetPan, SoundInstance:GetPanModifier

SoundInstance:SetPan( [number] pan )
[number] SoundInstance:GetPan()

Interférence d'un bloqueur de publicité détectée !


Wikia est un site gratuit qui compte sur les revenus de la publicité. L'expérience des lecteurs utilisant des bloqueurs de publicité est différente

Wikia n'est pas accessible si vous avez fait d'autres modifications. Supprimez les règles personnalisées de votre bloqueur de publicité, et la page se chargera comme prévu.

Sur le réseau FANDOM

Wiki au hasard