minetest.sound play/de

From Minetest Developer Wiki
Jump to: navigation, search
Language: English  • Deutsch

Contents

Syntax

minetest.sound_play(SimpleSoundSpec, SoundParameters)

Beshreibung

Spielt einen Sound ab.

Es werden nur Ogg-Vorbis Dateien unterstützt. Für die positionelle Wiedergabe von Sounds werden nur einkanalige (Mono-)Dateien unterstützt. Andernfalls spielt OpenAL sie nicht-positional ab.

SimpleSoundSpec kann ein String(Zeichenkette) mit dem Dateinamen sein. (Ohne die Dateiendung) ooder ein table (Tabelle)mit den Feldern name="name" und gain=float.

SoundParameters ist ein table mit den folgenden Feldern:

  • gain = float: the gain. default = 1.0
  • max_hear_distance = int: die maximale Hörweite. Standart = 32 Blöcke
  • loop = bool: Sound wird in einer Dauerschleife gespielt. Nur Sounds die mit Objekten verbunden sind, können in einer Dauerschleife abgespielt werden. Standartt = false

Der Ort kann mit einem der folgenden Felder in den SoundParametern angegeben werden (wenn keiner verwendet wird, wird er für alle Spieler ortlos abgespielt):

  • to_player = "playername": Der Sound wird ohne Position für dem angegebenen Spieler abgespielt
  • pos = position: Der Sound wird an dieser Position abgespielt.
  • object = ObjectRef: Der Sound wird mit einem Objekt verbunden abgespielt.

Die Funktion gibt einen Sound-Handle zurück, der an die folgende Funktion übergeben werden kann minetest.sound_stop(handle) um den Sound zu stoppen.

Features

Du kannst einen zuffälligen Sound abspielen indem du folgendes Format benutzt deine Sounds müssen also hier modname_soundname.1.ogg modname_soundname.2.oggusw heissen. modname_soundname.N.ogg

Beispiele

minetest.sound_play("testmod_testsound", {
	pos = {x=0, y=0, z=0},
	max_hear_distance = 100,
	gain = 10.0,
})

Spielt den Sound testmod_testsound.ogg an der Position 0,0,0.

minetest.sound_play("testmod_foobar", {
	to_player = "foo",
	gain = 2.0,
})

Spielt den Sound testmod_foobar.ogg zu dem Spieler "foo".

-- testmod/sounds listing:
--	/testmod_foobar.1.ogg
--	/testmod_foobar.2.ogg
--	/testmod_foobar.3.ogg
minetest.sound_play("testmod_foobar")

Spielt einen zufälligen testmod_foobar Sound.

Personal tools
Namespaces

Variants
Actions
Navigation
API
Toolbox