PlayMusic(id[, table])

Bitte beachten Sie, dass vor Hollywood 6.0 nur eine Musik abgespielt werden konnte. Ab 6.0 ist diese Einschränkung zwar nicht mehr vorhanden, wird aber immer noch erzwungen, um mit älteren Skripten kompatibel zu bleiben. Wenn also ein Musikobjekt bereits abgespielt wird und Sie diesen Befehl aufrufen, wird die erste Musik gestoppt, bevor die Wiedergabe der neuen Musik beginnt. Wenn Sie mehrere MusikObjekte zur gleichen Zeit abspielen wollen, müssen Sie explizit diese Einschränkung deaktivieren, indem Sie den Befehl LegacyControl() aufrufen und den Tag SingleMusic auf False setzen. PlayMusic() stoppt nun nicht mehr jede Musik. Siehe LegacyControl für Details.

Vor Hollywood 4.5 war das zweite Argument optional und gab an, wie oft die Musik abgespielt werden soll. Ab Hollywood 4.5 ist das zweite Argument nun ein optionales Tabellenargument. Natürlich wird die alte Syntax noch wegen der Kompatibilität unterstützt. Neue Skripte sollten allerdings die neue Syntax verwenden. Das optionale Argument table erkennt die folgenden Tags:

Times:

Diesen Tag können Sie verwenden, um anzugeben, wie oft die Musik abgespielt werden soll. Dieser Tag ist auf 1 voreingestellt, womit das Musikobjekt nur einmal abgespielt wird. Wenn Sie ein Musikobjekt als Endlosschleife spielen wollen, geben Sie hier 0 ein.

Volume:

Geben Sie hier die gewünschte Lautstärke an. Der Bereich geht von 0 bis 64. Wenn nichts angegeben wurde, wird die Standardlautstärke der Musikobjekte verwendet werden. (Sie können die Standardlautstärke eines Musikobjekts ändern, indem Sie den Befehl SetMusicVolume() benutzen).

Channel:

Hier können Sie den Kanal für die Wiedergabe des Musikobjekts einstellen. In der Standardeinstellung wählt PlayMusic() automatisch einen freien Kanal und wird fehlschlagen, wenn es keinen freien Kanal mehr hat. Um dieses Verhalten zu ändern, können Sie dieses Feld verwenden. Wenn ein Kanal angegeben wurde, wird Hollywood immer die Wiedergabe auf dem hier angegebenen Kanal erzwingen. Wenn der Kanal bereits verwendet wird, wird er zunächst gestoppt werden. (V6.1)

id

Identifikator der Musik, die gespielt werden soll

table

optional: Tabellenargument für weitere Optionen (V4.5)