Quelltext der Seite Plugin-Erstellung/Java/SoundAsset

{{DISPLAYTITLE:{{SUBPAGENAME}}}}
{{SUBPAGENAME}}

Stellt eine benutzerdefinierte Audiodatei dar (dies kann entweder ein Soundeffekt oder ein Musiktitel sein).
<br/>
Unterstützte Dateiformate: ogg, mp2, mp3, midi/mid, wav, flac

Erstellt ein SoundAsset und spielt es für jeden Spieler nach dem Beitritt ab. <br/>
Die Klasse '''MyPlugin''' erbt von  '''[https://javadoc.rising-world.net/latest/net/risingworld/api/Plugin.html Plugin]'''.
<syntaxhighlight lang="java" line start="1">
import net.risingworld.api.Plugin;
import net.risingworld.api.events.EventMethod;
import net.risingworld.api.events.Listener;
import net.risingworld.api.assets.SoundAsset;
import net.risingworld.api.objects.Player;

public class MyPlugin extends Plugin implements Listener
{
    //Our reusable sound asset
    public SoundAsset welcomeSound;

    @Override
    public void onEnable()
    {
       //Create a SoundAsset once and reuse it for every player (not necessary)
       welcomeSound = SoundAsset.loadFromFile(getPath() + "/welcome.ogg");

       //Remember to register the event listener
       registerEventListener(this);
    }

    @Override
    public void onDisable()
    {
        //...
    }

    @EventMethod
    public void onPlayerSpawn(PlayerSpawnEvent event)
    {
        Player player = event.getPlayer();
        player.playSound(welcomeSound, player.getPosition());
    }
} 
</syntaxhighlight>

== Methoden der Oberklasse ==
Unsere Klasse erbt von der '''[https://javadoc.rising-world.net/latest/net/risingworld/api/Plugin.html Plugin]''' Oberklasse  die zu API gehört. <br/>
Die Methode <code>onEnable() </code> wird aufgerufen, wenn das Plugin aktiviert wird. Zu diesem Zeitpunkt sind alle anderen Plugins bereits geladen. 
Die Methode <code>onDisable() </code> wird aufgerufen, wenn das Plugin deaktiviert und entladen wird.

== Java Override Annotation ==
Mit der Java <code> @Override </code>  Annotation können wir dem Compiler mitteilen das wir absichtlich die Methode der '''[https://javadoc.rising-world.net/latest/net/risingworld/api/Plugin.html Plugin]''' Oberklasse überschreiben wollen.

== Siehe auch ==
* [[:Kategorie:Java|Wiki Kategorie: "Java"]]
* [https://javadoc.rising-world.net/latest/net/risingworld/api/assets/SoundAsset.html javadoc RW: Class SoundAsset]
* [https://forum.rising-world.net/thread/12581-code-schnipsel/ Rising World Forum: Code Schnipsel]


[[Kategorie:Plugin-API|SoundAsset]]
[[Kategorie:Java-Codeschnipsel|SoundAsset]]